|Understanding the Watchfolder Architecture|
As of Connect Server version 3.7.1, Aspera Watches and Watchfolders are managed by the Aspera Watch Service Manager (asperarund), which allows easy management of the asperawatchfolderd and asperawatchd services. Most importantly, asperarund allows admins to start services under different users without having to switch between the different contexts.
If you upgraded from Connect Server version 3.6.1, and you had the asperawatchd and asperawatchfolderd services enabled and configured, you must manually migrate any services that are run by a user other than root.
If the user is root, the installer first stops the asperawatchd and asperawatchfolderd services and removes them from running services. The installer restarts the services using the following command:
# /opt/aspera/sbin/asperawatchd --user root # /opt/aspera/sbin/asperawachfolderd --user root
Due to the new deployment model, users running asperawatchd and asperawatchfolderd services must have a docroot set in aspera.conf. If you didn't have a docroot set for your user, see Updating the Docroot of a Running asperawatchfolderd Service.
If the user is not root, the installer does not automatically migrate the services. You must manually start the service under the user that was running the asperawatchd and asperawatchfolderd services. Before you perform the migration steps, confirm or set the following for the user running the services:
You can set the docroot with the following asconfigurator command:
# /opt/aspera/bin/asconfigurator -x "set_user_data;user_name,username;absolute,docroot"
The asconfigurator command adds the following configuration to the <aaa> section of aspera.conf (in this example, the docroot is set to /):
<aaa> <realms> <realm> <users> <user> <name>root</name> <file_system> <access> <paths> <path> <absolute>/</absolute> </path> </paths> </access> </file_system> </user> </users> </realm> </realms> </aaa>
You can find the aspera.conf configuration file at:
# /opt/aspera/bin/asuserdata -v
After setting the docroot and ensuring the user has write permissions to the log directory, start the services with the following commands:
# /opt/aspera/sbin/asperawatchd --user username # /opt/aspera/sbin/asperawatchfolderd --user username
This command starts the services running under the designated user.