Install Composer

Arvados Composer is a web-based javascript application for building Common Workflow Languge (CWL) Workflows.

  1. Install dependencies
  2. Update config.yml
  3. Update Nginx configuration
  4. Install arvados-composer
  5. Restart the API server and controller
  6. Confirm working installation

Install dependencies

In addition to Arvados core services, Composer requires Arvados hosted git repositories which are used for storing workflow files.

Update config.yml

Edit config.yml and set Services.Composer.ExternalURL to the location from which it is served:

    Services:
      Composer:
        ExternalURL: https://workbench.CusterID.example.com/composer

Update nginx configuration

Composer may be served from the same host as Workbench. Composer communicates directly with the Arvados API server. It does not require its own backend and should be served as a static file.

Add the following location sections to /etc/nginx/conf.d/arvados-workbench.conf .

server {
  [...]

  location /composer {
    root   /var/www/arvados-composer;
    index  index.html;
  }

  location /composer/composer.yml {
    return 200 '{ "API_HOST": "ClusterID.example.com" }';
  }
}

Install arvados-composer

Red Hat and Centos

# yum install arvados-composer

Debian and Ubuntu

# apt-get install arvados-composer

Restart the API server and controller

Make sure the cluster config file is up to date on the API server host then restart the API server and controller processes to ensure the configuration changes are visible to the whole cluster.

# systemctl restart nginx arvados-controller

Confirm working installation

Visit https://workbench.ClusterID.example.com/composer in a browser. You should be able to log in using the login method you configured previously.


Previous: Install Workbench 2 Next: Install the websocket server

The content of this documentation is licensed under the Creative Commons Attribution-Share Alike 3.0 United States licence.
Code samples in this documentation are licensed under the Apache License, Version 2.0.