Cleanup of MMC-Service areas
Cleanup of MMC-Service areas
Summary
For cleaning up MMC-Service areas the tool fscadmin is used. This tool is able to delete all files in the target MMC-Service area which are not referenced in the Database.
Information
The tool fscadmin is installed with the Fabasoft Server Management.
By calling fscadmin.exe respectively fscadmin the command-line help is displayed.
For further inforation see our How to use fscadmin article.
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
Basic parameters of fscadmin
Arguments:
-action Type of action to execute - we use the cleanup parameter
list List all services in this domain
cleanup Cleanup content area
checkconsistency Check content consistency of target MMC Service
-service Execute against this service
[-logfile ] Path to logfile (default Linux: /var/opt/fabasoft/log/fscadmin.log)
(default Microsoft Windows: C:\Users\\fscadmin.log
[-time ] Cleanup unreferenced files saved before now-days
[-areadir ] Specific area to cleanup
[-casrange - Restricts to the directories specified by the range
[-host ] IP address of COO service host
[-port ] TCP port of COO service
Please consider that some of the parameters are not available in older Fabsoft Folio versions.
Finding out the ID of a specific Service:
In order to clean up a particular MMC-Service area you need to figure out the Service ID of the affected service.
To create a list of services and their assigned ID you have to execute the following command:
fscadmin.exe -action list
Cleanup of all areas of all MMC-Services
fscadmin.exe -action cleanup -service all -time 30
- -service allThe command is executed against all services
- -time 30The cleanup is restricted to files which were saved at least 30 days ago.
Cleanup of all areas of a specificMMC-Service
fscadmin.exe -action cleanup -service 2 -time 30 -logfile C:\temp\MMCSVC2.log
- -service 2The command is executed against a specific service with the ID 2
- -logfile C:\temp\MMCSVC2.logThe logfile is saved to C:\temp\MMCSVC2.log - When a command is executed against a specific
servicewe recommendsetting the logfile parameter for an easier analysis in case of an error
Cleanup of single area of a MMC-Service
fscadmin.exe -action cleanup -service 2 -areadir MMCArea1 -time 30
- -areadir MMCArea1
The command is restricted to a specific MMC area with the name MMCArea1
Partial cleanup in CAS areas
fscadmin.exe -action cleanup -service 2 -areadir MMCArea1 -casrange 00-3f -time 30
- -areadir MMCArea1The command is restricted to a specific MMC area with the name MMCArea1
- -casrange 00-3fThe command only cleans up files in the CAS range between 00-3f.
Consistency check of MMC-Service areas
fscadmin.exe -action checkconsistency -service 2
- -action checkconsistencyChecks the content for its consistancy in target MMC-Service
- -service 2The command is executed against a specific service
Frequently encoutered errors
- Execution failed. (No method found for action "COOSYSTEM@1.1:CleanupContentAreas" in object class "COOSYSTEM@1.1:COOService") Cause: Target service is a COO-Service.
- Error: Service not found
Cause: Target service ID is not existant - Action not supported Cause: Spelling mistake at the parameter "-action"
References
Applies to
- Fabasoft Folio
- Fabasoft eGov-Suite