Installing Orchestrator on Linux

During Orchestrator installation, all commands should be run as root.

  1. (Preliminary Step) Contact your Sales representative to obtain the Orchestrator license file.
    The license filename will be in the following format:
    orchestrator-license_number.aspera-license
  2. Download the product installer.
    1. Go to http://downloads.asperasoft.com/en/downloads/27, click Linux, and select the Orchestrator installer(the first file (.rpm) in the dropdown list).
    2. Click Direct download and enter the user name and password supplied by Aspera. If you have trouble locating your login credentials, contact Support.
    3. Click Save File > OK and save the program to the same location as the Aspera Common Components (under /tmp for example).
  3. Run the setup command.
    Run the following commands, as root:
    $ cd /tmp
    $ rpm -ivh aspera-orchestrator-2.4.0.build_version-0.x86_64 
    Preparing...########################################### [100%]
    The system will now prompt you to run the following to complete your setup:
    # asctl orchestrator:setup
  4. Complete your Orchestrator setup.
    Enter "s", the default, to select streamlined setup; select all default options during setup. Enter "y" to confirm your settings.
  5. Install the Orchestrator license.
    Copy the Orchestrator license into the following directory:
    /opt/aspera/var/config/orchestrator/licenses/

    If you do not install the license in this step, you will receive a prompt from the GUI to add the license after you start Orchestrator.

  6. Start Aspera Orchestrator.
    Run the following:
    $ asctl orchestrator:start 
  7. Open the Aspera Orchestrator user interface.
    In a web browser, go to the following URL, where orchestrator-ipaddress is the IP address or fully qualified name of the Orchestrator machine.
    https://orchestrator-ipaddress/aspera/orchestrator/

    HTTP is redirected internally to HTTPS.

  8. Change your password.
    In the Change Password dialog, leave the current password field blank and enter a strong password, then enter the password again to confirm it.
  9. If you did not install the Orchestrator license in Step 5, do so now.
    The Update License dialog appears. Either click Choose File to browse and upload the license file, or copy and paste the license key in the Provide License Contents text box. Click Update and validate license to install.
    At this point, you can navigate to any view in the UI.
  10. Confirm that all processes are running.
    Click Engine > Processes and review the Status column to confirm that all processes are running. For any process with a Stopped status, click Start to resume.