Installing Shares

For instructions on upgrading Shares see Upgrading Shares

  1. Download the Shares installer.
    Download the installer from http://downloads.asperasoft.com/en/downloads/34. Use the credentials provided to your organization by Aspera for access. If you need help determining your organization's access credentials, contact your Aspera account manager.
  2. Unpack the installer.
    Run the following command as root, where version is the package version:
    [root] # rpm -Uvh aspera-shares-version.rpm

    The following is an example of the output generated during the unpacking:

    Preparing...                ########################################### [100%]
       1:aspera-shares          ########################################### [100%]
    
    To use a remote MySQL server and disable the local MySQL server,
    add the connection information to this file:
    
        /opt/aspera/shares/etc/my.cnf.setup
    
    To complete the installation, please run this script as the root user:
    
        [root]$ /opt/aspera/shares/u/setup/bin/install
    
    For more information about using a remote MySQL server, see Using Another MySQL Server During Installation.
  3. Run the install script.
     # /opt/aspera/shares/u/setup/bin/install
    The following is an example of the output generated during installation:
    Starting aspera-shares ...
    Started
    Testing 20 times if MySQL is accepting connections ...
    Waiting for MySQL server to answer.
    mysqld is alive
    Writing /etc/init.d/aspera-shares ...
    Running chkconfig to add the service to the runlevels ...
    Generating a private key and self-signed certificate ...
    To install your own private key and certificate authority-signed certificate, replace these files
      /opt/aspera/shares/etc/nginx/cert.key
      /opt/aspera/shares/etc/nginx/cert.pem
    Creating the shares database ...
    Loading the shares database schema ...
    Initializing the shares database ...
    
    To create an admin user, run this command:
    
        /opt/aspera/shares/u/shares/bin/run rake aspera:admin NAME="admin" PASSWORD="jFOBTzkgoJBk836cVW3zFXTX7XvOJSg" EMAIL="aspera@example.com"
    
    Creating the stats collector database ...
    Generating stats collector keys ...
    Done
  4. Create an admin user.
    The admin user account on the Shares server is used to configure Shares, including configuring users, security settings, and shares. Shares randomly generates a password that you can copy and paste to create the admin user, or you can create your own password.

    To create or reset the admin user settings, run the following command from the Shares server root shell:

    # /opt/aspera/shares/u/shares/bin/run rake aspera:admin NAME="admin_username"
    PASSWORD="password" EMAIL="email_address"
Shares is now running and accessible from the IP address or domain name configured during installation. For more information about accessing Shares and logging in for the first time, see First Log In and Licensing.