Migrating Watch Services on Upgrade

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.

Scenario 1: User is "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.

Scenario 2: User is Not "root"

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:

  • a docroot in aspera.conf.
  • permissions to write to the default log directory if no directory is specified.

You can set the docroot with the following asconfigurator command:

# /opt/aspera/bin/asconfigurator -x "set_user_data;user_name,username;absolute,docroot"
Note: URI docroots (for example, paths to cloud storage or file://path) are not currently supported by asperawatchd and asperawatchfolderd. Only local file systems can be monitored.

The asconfigurator command adds the following configuration to the <aaa> section of aspera.conf (in this example, the docroot is set to /):

You can find the aspera.conf configuration file at:

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.

Creating and Managing Watch Folders

You can use the following tools to create and manage watch folders: