Setting Up Transfer Nodes |
A node is a local, remote, or cloud workstation running an Aspera transfer server product (IBM Aspera Enterprise Server, IBM Aspera Connect Server). In order to make transfers, Shares communicates with a node through the Node API. The Node API is a daemon on the transfer server that offers REST-inspired file operations and a transfer management API. Aspera web applications authenticate to remote node services using a Node API username and password. Different nodes may use different Node API username and password pairs.
# ascp -A
Connect Server License max rate
If you need to update your transfer server license, follow the instructions in IBM Aspera Enterprise Server Admin Guide: Updating Product License.
# useradd username
The following steps use the asconfigurator utility to modify the aspera.conf configuration file, located at /opt/aspera/etc/aspera.conf.
$ asconfigurator -x "set_user_data;user_name,username;absolute,/ docroot/path"
$ asconfigurator -x "set_user_data;user_name,xfer_user;absolute,/project1"
> asconfigurator -x "set_user_data;user_name,username;authorization_transfer_in_value,token" > asconfigurator -x "set_user_data;user_name,username;authorization_transfer_out_value,token" > asconfigurator -x "set_user_data;user_name,username;token_encryption_key,encryption_key"
> asconfigurator -x "set_user_data;user_name,xfer_user;authorization_transfer_in_value,token" > asconfigurator -x "set_user_data;user_name,xfer_user;authorization_transfer_out_value,token" > asconfigurator -x "set_user_data;user_name,xfer_user;token_encryption_key,gj5o930t78m34ejme9dx"
# asconfigurator -x "set_server_data;server_name,ip_or_hostname"
# asconfigurator -x "set_server_data;server_name,aspera.example.com"
# /opt/aspera/bin/asuserdata -c central server option set: address: "127.0.0.1" port: "40001" backlog: "200" schema_validation: "enable" mgmt_backlog: "200" mgmt_port: "0" transfer_list_path: "" persistent_store: "enable" persistent_store_path: "" persistent_store_max_age: "86400" persistent_store_on_error: "ignore" event_buffer_capacity: "1000" event_buffer_overrun: "block" compact_on_startup: "enable" files_per_session: "1000000" file_errors: "true" ignore_empty_files: "true" ignore_skipped_files: "true" ignore_no_transfer_files: "true" db_synchronous: "off" db_journal: "wal"
$> asconfigurator -x "set_central_server_data;persistent_store,enable"Restart the asperacentral service to update the node configuration:
service asperacentral restart
# /opt/aspera/bin/asnodeadmin -a -u node_api_username -p node_api_passwd -x system_username
# /opt/aspera/bin/asnodeadmin -a -u node_user -p XF324cd28 -x xfer_user
# /opt/aspera/bin/asnodeadmin -l
user system/transfer user acls
==================== ======================= ====================
node_user xfer_user
# mkdir -p /home/username/.ssh
# mkdir -p /home/xfer_user/.ssh
# cat /opt/aspera/var/aspera_id_dsa.pub >> /home/username/.ssh/authorized_keys
# chown -R username:username /home/username/.ssh # chmod 600 /home/username /.ssh/authorized_keys # chmod 700 /home/username # chmod 700 /home/username /.ssh
For instructions on adding a node to Shares, see Adding Nodes.