2017 R1

Administration TasksPermanent link for this heading

Management of Fabasoft Folio ServicePermanent link for this heading

To back up or clean up Fabasoft Folio Service the command line tool fscadmin can be used. The tool can be found in /opt/fabasoft/bin.

To be able to use this tool, you have to switch to user fscsrv:

# sufscsrv

Example:

  • To list all Fabasoft Folio Service use the following command:
    ./fscadmin --action list --host localhost
  • To back up the content areas of service four execute the following command:
    ./fscadmin --action backup --service 4 --host localhost
  • To clean up all content areas of the Fabasoft Folio Domain until yesterday use the following command:
    ./fscadmin --action cleanup --service all --time 1 --host localhost
  • To check the content consistency of the Fabasoft Folio Domain use the following command:
    ./fscadmin -–action checkconsistency -–service all –-host localhost
  • To synchronize the daily backup directory of a CAS area use the following command:
    ./fscadmin –-action cleanup –-service all –-synctobackup 2010-06-06 –-host localhost
  • To restore the daily backup directory of a CAS area use the following command:
    ./fscadmin –-action cleanup –-service all –-syncfrombackup 2010-06-06 -–host localhost
  • To clean up the daily backup directory of a CAS area use the following command:
    ./fscadmin –-action cleanup –-service all –-cleanupbackup 2010-06-06 -–host localhost

To clean up a CAS backup directory with the need of a minimum number of passed days since the deletion of a file in the CAS Area the command line tool cleanbackup can be used.

To be able to use this tool, you have to install fsc-cas-utils.rpm.

Example:

  • To remove files from the backup directory which have been deleted for at least 60 days in the CAS Area:
    cleanbackup –root /path/to/backupdirectory –days 60

Management of the Fabasoft Folio Server CachePermanent link for this heading

To save or load the cached Fabasoft Folio objects of the Fabasoft Folio COO Service also the command line tool fscadmin can be used.

Example:

  • To save the COO addresses of all currently cached objects into a file use the following command:
    ./fscadmin --action savecache –-file <filename> –-service <COO service number>
  • To load objects, of an already saved cache state, into the Fabasoft Folio server cache use the following command:
    ./fscadmin --action loadcache –-file <filename> –-service <COO service number>
  • To load all objects, and all referenced objects, of a database query result into the Fabasoft Folio server cache use the following command:
    ./fscadmin --action loadbyquery –-query “Select objname from COOSYSTEM@1.1:UserEnvironment”
    This query initializes the Fabasoft Folio server cache with all User Environments and all referenced objects (e.g. commonly used objects COOSYSTEM@1.1:usrenvlocalobjects).

Execution of Fabasoft app.ducx ExpressionsPermanent link for this heading

To execute Fabasoft app.ducx Expressions the command line tool fsceval can be used. This tool can be found in the /opt/fabasoft/bin directory also.

Usage: fsceval { argument }

  -verbose         ... verbose

  -dumptokens      ... enabledumptokens

  -eval <expr>     ... evaluate <expr>

  -file <path>     ... evaluate contents of file <path>

  -local           ... use previous result as local scope

  -global          ... use previous result as global scope

  -trace           ... use debugger interfaces for trace

  -flags <f>       ... use thread flags <f>

  -threads <t>     ... number of threads <f>

  -login <logname> ... login for user <logname>, privileged account required

  -userfile <path> ... login based on user list in <path>

  -statistics      ... add runtime statistics to output

Example:

Execution of a simple expression (as one command line):
su - fscsrv -c "/opt/fabasoft/sbin/envdir /var/opt/fabasoft/instances/WebService_100/env fsceval -eval \"coort.Trace('hello world')\""

Checking Log FilesPermanent link for this heading

In case of problems log files may provide useful information. The Fabasoft Folio log files can be found here:

  • /var/opt/fabasoft/log/*
  • /tmp/fscsetup.log
  • /var/log/messages

Additional Administration TasksPermanent link for this heading

  • To clear the generated object images of an object the action FSCCONV@1.1001:ClearObjectImages can be used. Doing so the preview images of the object will be regenerated by the next access to the images:
    Example: <object>.FSCCONV@1.1001:ClearObjectImages();
  • To clear the generated object images of a set of objects defined by  a Fabasoft Folio Query the action FSCCONV@1.1001:ClearObjectImages can be used:
    Example: coouser.FSCCONV@1.1001:ClearObjectImages("SELECT objname FROM COOSYSTEM@1.1:ContentObject WHERE .FSCCONV@1.1001:objimgnextretry IS NOT NULL", "/tmp/log.txt");
  • To upgrade all saved object versions and resave the object versions with the current state the action COOSYSTEM@1.1:UpgradeVersions can be used. Object versions stored in delta tables (prior to Fabasoft Folio version 7) will be resaved as blob-based version. The first parameter specifies the Fabasoft Folio version up to which object versions should be upgraded. A value of 1407 means that all versions created with Fabasoft Folio versions smaller 14.0.7 will be migrated. The action can be called on a domain object meaning that all object versions in all Fabasoft Folio COO Services will be upgraded. Alternatively a call on a dedicated COO Service is also possible, which makes parallelization possible. In case of a domain object, a Fabasoft Folio query can be specified to restrict the upgrade process to the query result.
  • Examples:
    • #TV.TV_LOGFILE = "c:\\upgradeversions.log";
      coodomain.UpgradeVersions(1407);
    • #TV.TV_LOGFILE = "c:\\upgradeversions.log";
      <
      coosrv>.UpgradeVersions(1407);
    • #TV.TV_LOGFILE = "c:\\upgradeversions.log";
      coodomain.UpgradeVersions(1407, "SELECT objname FROM NOTE@1.1:NoteObject");