After you have installed the FileSystem Companion, you must configure it. The FileSystem Companion runs as a separate service, called an instance, on the respective file server machine. Each of the instances of the service has its own configuration xml file specifying the unique name of the instance, the address of the Cumulus Server and the technical user which is used to connect to that Cumulus Server. The configuration needed varies depending on the operating system. On all systems use an UTF-8 compatible editor for editing the configuration file.
NOTE: Make sure the technical user you employ for the connection to the Cumulus Server has sufficient permissions for all functions necessary to fulfill the tasks. In any case the Cumulus Administrator has all permissions that could be required.
Configuring under Windows
You can find a config.xml file in the installation folder of the FileSystem Companion. Configure this file by defining the unique name of the instance, the Cumulus Server that the application should connect to [IP address or name of the computer running the Cumulus Server], the user name that should be used when connecting to the Cumulus Server, and the password for the user name.
Configuring under Linux
You can find a config.xml file in the installation folder of the FileSystem Companion. Configure this file by defining the unique name of the instance, the Cumulus Server that the application should connect to [IP address or name of the computer running the Cumulus Server], the user name that should be used when connecting to the Cumulus Server, and the password for the user name.
Once you have configured it, start the Cumulus FileSystem Companion using the CumulusFileSystemCompanion.sh with the parameter start: sh CumulusFileSystemCompanion.sh start
Other available parameters for CumulusFileSystemCompanion.sh are: console, stop, restart, status, and dump
FileSystem Companion as a Service
For installing the FileSystem Companion as a service, Canto provides following scripts:
• InstallCumulusFileSystemCompanion.bat for Windows
• InstallCumulusFileSystemCompanionService.sh for Linux
These scripts can be found in the FileSystem Companion installation folder, e.g. C:\Program Files\Canto\Cumulus FileSystemCompanion
NOTE: The script has to be executed with administrator permissions. (Windows: Use right-click to invoke them.)
Start the Cumulus FileSystem Companion service after you have configured it via: Computer Management > Services
Configuring Instances
Beyond the basic settings in the config.xml file, the instances of the Cumulus FileSystem Companion are configured via the FileSystem Companion Manager of the Cumulus Server Console. For each instance this comprises the unique name of the instance (as defined in its config.xml file), the specification of the folder(s) to be watched as well as the catalog, Asset Handling Set and Permission Template to be used, certain time out values and a list of items to be ignored by an instance of the FileSystem Companion. Last but not least, these instances can be activated/deactivated via the FileSystem Companion Manager. For a description on how to work with the FileSystem Companion Manager see chapter “Server Console” in the Cumulus help.