Installing Shares

Before You Begin...

Shares includes an Nginx web server listening on ports 80 and 443. For best results, Aspera recommends using a machine that does not run a web server. If you are using a web server, keep port 80 or 443 open, configure either that server or the Nginx server to use different ports. If you are installing an IBM Aspera High-Speed Transfer Server and Shares on the same host and configure a firewall, close all ports that are not required (see IBM Aspera High-Speed Transfer Server: Configuring the Firewall).

Review the system requirements section of the release notes.
Download the latest version of IBM Aspera Shares from http://downloads.asperasoft.com/en/downloads/34.
Verify that the hosts file has an entry for 127.0.0.1 localhost/. You can find this file at /etc/hosts).
Disable SELinux.
SELinux must be set to "permissive" or "disabled", not "enforced". To check the status of SELinux, run the following:
```
# sestatus
```
If SELinux is set to "enforced", see Disabling SELinux.

Install Shares

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.

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

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.

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.