Installing Custom Ruby Gems

This procedure describes how to install a custom Ruby gem during the installation process for Orchestrator.

Note: You must reinstall custom gems after an upgrade of Orchestrator, because Ruby gems are not preserved during an upgrade.
  1. Download the custom gem to the server where Orchestrator is installed.
  2. From the command line, set GEM_HOME to the path for the installation of Orchestrator.
    For example: 
    C:\Program Files (x86)\Aspera\Orchestrator\vendor\ruby\lib\ruby\gems\2.3.0
  3. To install the custom gem to GEM_HOME defined above, run the following from the command line: 
    # gem install
  4. Add the name of the custom gem to the Gemfile: 
    # path_to_custom_gem/custom_gem_name install
  5. Confirm that all dependencies in your Gemfile are available to your application: 
    # bundle install
  6. Confirm that the gem is installed: 
    gem list -i <gem_name> -v version
  7. Perform the steps in Installing Orchestrator with MySQL on the same server (see the section, Running the Installers).
  8. Start Orchestrator. 
    # asctl orchestrator:start