How to use fscadmin

Last update: 4 August 2017

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