Setting Up Transfer Groups

You can set up transfer settings based on your system's user groups. If users within a group do not have individual transfer settings, then the group's transfer settings will be applied. Please note that Connect Server doesn't create user groups on the operating system for you, so you must ensure that the groups currently exist before adding them to your Aspera product. Follow the steps below to add user groups to Connect Server in a Terminal.

  1. Determine the user groups you would like to add to your Aspera transfer product.
    Ensure that you have an existing user group on your operating system, or create a new user group. Please refer to your operating system's documentation for information on creating user groups. Connect Server reads group information from the following file:
    /etc/group
  2. Add the user group to your Aspera transfer product
    When a transfer group is specified, it overwrites global settings and applies group configuration to corresponding users. To add group-specific transfer settings, you can use asconfigurator commands with the following syntax:
    # asconfigurator -x "set_group_data;group_name,groupname;parameter,value"

    For more information on available settings, see User, Group and Default Configurations and the references in the table below.

    Category Description
    Configuration Precedence When a user is a member of multiple groups, the precedence setting can be used to determine priority.
    aspera.conf - Authorization Connection permissions, token key, and encryption requirements.
    aspera.conf - Transfer Incoming and outgoing transfer bandwidth and policy settings.
    aspera.conf - File System Docroot, file and directory creation, access permissions, block sizes, and so on.

    You can also manually edit aspera.conf with a text editor.

    Add the following section to aspera.conf:

    <?xml version='1.0' encoding='UTF-8'?>
    <CONF version="2">
       <aaa>
          <realms>
             <realm>
                <users>
                   ... <!-- user-specific settings -->
                </users>
                <groups>
                   <group> <!-- Each group tag contains a group's profile. -->
                      <name>aspgroup</name> <!-- The group name. -->
                      <precedence>0</precedence> <!-- Group precedence. -->
                      <authorization>...</authorization> <!-- Authorization settings. -->
                      <transfer>...</transfer> <!-- Transfer settings. -->
                      <file_system>...</file_system> <!-- File System settings. -->
                   </group>
                   <group>
                      ... <!-- Another group's settings-->
                   </group>
                </groups>
             </realm>
          <realms>
       </aaa>
       ...
    </CONF>
  3. Verify your configuration.
    When you have finished updating the group's settings in aspera.conf, use the following command to verify it (in this example, verify the group asp-group's settings):
    # /opt/aspera/bin/asuserdata -g asp-group
  4. Restart asperanoded and asperacentral to activate your changes.
    Run the following commands to restart asperanoded:
    # /etc/init.d/asperanoded restart
    Run the following command in a Terminal window to restart asperacentral:
    # /etc/init.d/asperacentral stop
    # /etc/init.d/asperacentral start