Adding Nodes

Ensure that you have the following information available:
  1. On the IBM Aspera Shares Home window, click NODE+ to add a new node and complete the New Node configuration form.


    Field Description Example Value
    Name A description of the node. New Node
    Host The node computer's hostname or IP address, along with a port and path. The port field represents the port on which the node service is running. The default is 9092. The path field is an advanced feature used for URL Proxy operations. In nearly all cases, you may leave this field blank.
    Note: When adding a local node multiple times, you must ensure each node uses localhost as the host.
    In this example, Shares and Enterprise Server are installed on the same computer. That means our hostname is localhost and our node service port is HTTPS 9092. If the node is on a remote host, use the IP address or resolvable hostname.
    API Username The node API username that you created when you set up Aspera Enterprise Server on the node machine. This user is kept in the redis database for authentication between the Shares application and the node service. xferuser
    API Password The node API password that you created when you set up Enterprise Server on the node machine. password
    Use SSL

    To encrypt the connection to the node using SSL, select this check box. Although the node is configured to use an Aspera pre-installed and self-signed certificate (/opt/aspera/etc/ aspera_server_cert.pem), you can use your own certificate. To generate a new certificate, see the Setting UP SSL for Node topic in the IBM Aspera Enterprise Server Admin Guide.

    Note: After generating a new certificate, you must create a cert.pem file that contains the private key and the certificate. To do so, copy and paste the entire body of the key and cert files into a single text file. Then save the file as filename_cert.pem.
    Enabled, by default.
    Verify SSL Certificate To verify the SSL certificate, select this check box. Enabled, by default.
    Timeout Sets the number of seconds Shares will wait for this node to respond to a request. 30, by default
    Open Timeout Sets the number of seconds Shares will wait for the connection to this node to open. 10, by default
    Bytes free - warn Issues a warning message when the node has equal to or less than a specified number of storage bytes free. You can enter the number as G, MB, terrabytes, and bytes. 50G
    Percent free - warn Issues a warning message when the node has equal to or less than a specified percent of its storage free. 25
    Bytes free - error Issues an error message when the node has equal to or less than a specified number of storage bytes free. You can input the number as G, MB, terrabytes, and bytes. 10G
    Percent free - error Issues an error message when the node has equal to or less than a specified percent of its storage free.. 10
  2. Click Create Node to save your entries. If your node has been created, it appears under the Nodes section on your Home page.
  3. Browse or edit a node by selecting the node’s drop-down menu.

    From this drop-down menu, you can perform following tasks.

    • Browse the node
    • Edit the node
    • View shares
    • View administrative activity
    • Delete the node

    For detailed information on these functions, see Modifying Nodes.

    Tip: You can add one machine as a node multiple times to create nodes with different access credentials to different areas of the system defined by the node users' docroot settings. When adding a local node multiple times, you must ensure each node uses localhost as the host.