How to use fscadmin
How to use fscadmin
Summary
fscadmin is a supporting tool which is used to manage Fabasoft Components services.
Information
The tool fscadmin is installed with the Fabasoft Server Management and located in the following directory:
- Microsoft Windows
%ProgramFiles%\Fabasoft\Components\Management\fscadmin.exe - Linux
/opt/fabasoft/bin/fscadmin
Note: Usually the tool is accessable by the path environment variable.
By calling fscadmin.exe respectively fscadmin the commandline help is displayed.
General information about the provided examples
All given examples were written for Microsoft Windows. If you are using Linux watch out for some differences:
- In Linux the syntax is a little bit different. Arguments are written with a doubledash (e.g. "--action"). Furthermore there is possibility to shorten the syntax (e.g. "-a" for "--action"). For further information see the fscadmin help.
- In Linux you might set the hostname as well as the port while in Microsoft Windows these informations are not necessary. Host and port is the listen hostname and port of COO-Service 1. For example:
fscadmin --host --port -a list
Command Line Parameters
Arguments: -action Type of action to execute -service Execute against this service [-host ] IP address of COO service host [-port ] TCP port of COO service Linux only: -princ|--principal Kerberos principal for backend communication (optional) cleanup, backup, checkconsistency: [-logfile ] Path to logfile (default: fscadmin.log) cleanup: [-time ] Cleanup unreferenced files saved before now-days [-areadir ] Cleanup specified area [-casrange -] Restrict to the directories specified by the range (format: xx-xx; e.g. 00-3f) This option cannot be used in conjunction with synctobackup or syncfrombackup [-synconly] Synchronize CAS areas without removing unreferenced files [-synctobackup [,]] Synchronize written CAS contents to daily backup directories without removing unreferenced files (date format: YYYY-MM-DD) [-syncfrombackup [,]] Synchronize written CAS contents from daily backup directories without removing unreferenced files (date format: YYYY-MM-DD) savecache, loadcache: [-file ] Filename for reading or writing cached object IDs loadbyquery: [-query ] Fabasoft Folio Query for cache initialization Actions: list List all services in this domain cleanup Cleanup content area backup Backup content area checkconsistency Check content consistency savecache Save cache of a COO Service loadcache Load cache of a COO Service loadbyquery Load query results in COO Service Caches collectsysinfo Collect system information Linux only: updatemode Enable or disable the update mode setdtmbackupmode Set DTM backup mode for all COO services and retrieve a consistent backup state for all database instances part of the domain Service: ID of a service Object address of a service all Use all services in this domain
Please consider that some of the parameters are not available in older Fabsoft Folio versions.
Examples:
fscadmin.exe -action list fscadmin.exe -action backup -service all fscadmin.exe -action cleanup -service 2 -host 192.168.40.236 -port 18070 -logfile C:\fscmmc1.log -time 30