Installing the File System Agent.
Before you begin
The file system agent must be installed on a linux machine.
Installing the agent
The actual installation is done like this:
apt-get -y install atomia-fsagent
After that you need to change the config file /etc/default/fsagent and configure access to the cronagent.
FS_STORAGE_PATH=/storage/content
FS_STORAGE_BACKUP_PATH=/storage/content/backup
FS_ROOT_DIRS_PATTERNS=^/[0-9][0-9]$
FS_ARBITRARY_DIRS_PATTERNS=^/awstats-sites/$
FS_USERNAME=atadmin
FS_PASSWORD=Tw3Zw5cmOE8Y2h5YxzrQ
FS_PARENT_ACCOUNT=100000
FS_ADD_GROUP=33
FS_AGENT_PORT=10201
We will explain the individual configuration options here:
| OPTION | MEANING |
|---|---|
| FS_STORAGE_PATH | Path to the shared storage. If environment is setup according to Atomia manual default value should be correct. |
| FS_STORAGE_BACKUP_PATH | Path to the back up direvtory. This directory is private to the file system agent and is used for internal actions. |
| FS_ROOT_DIRS_PATTERNS | Semi-colon separated regular expression patterns for allowed root user directories. By default, root user directories are two-digits named directories: /00 ~ /99. If storage is setup according to Atomia manual this need not to be changed. |
| FS_ARBITRARY_DIRS_PATTERNS | Semi-colon separated regular expression patterns for allowed arbitrary root directories. This directories are used for some additional user folders that are out of users control, like awstats directories. By default, only awstats directory is allowed. If storage is setup according to Atomia manual this need not to be changed. |
| FS_USERNAME | Username used for authentication to file system agent. |
| FS_PASSWORD | Password used for authentication to file system agent. |
| FS_PARENT_ACCOUNT | Top parent account of all accounts. This is usually account with number 100000. This information is needed by the file system for internal use. |
| FS_ADD_GROUP | Additional unix group. By default, file system agent allows it’s users to set owner/group of a file or directory to their own account/group, i.e. account 100010 can set owner/group to 100010/100010. This setting allows additional group to be added. Default value is 33 which is www-data group. If storage is setup according to Atomia manual this need not to be changed. |
| FS_AGENT_PORT | Port for the management interface to listen on. Default is 10201. |
Finally we can start the service:
/etc/init.d/atomia-fsagent restart