Skip to content

Install

Jump to bottom
Prasad Talasila edited this page Jan 17, 2019 · 4 revisions

Prerequisite

  1. Ubuntu server 18.04 operating system.
  2. Record the IP Address / domain name of the server machine. If your machine has multiple IP addresses, please use the public IP address for installation purposes. Because of ease of use, domain name (DNS) is a preferred option for hostname in all the configuration files.
    Most likely, your machine may be on a corporate private network with a gateway / proxy server / firewall connection to Internet. In that case, please use your machine's private IP address.
    You can locate the configured IP address of your machine using the following command. 
    ip addr show

Installation

  1. Download the code repository
    wget https://github.com/AutolabJS/executionnodes/archive/dev.zip -O enodes.zip
    unzip enodes.zip
    mv executionnodes-dev enodes

  2. Change to deploy directory.
    cd enodes/deploy

  3. Configure the execution nodes by modifying enodes file. For non-production setups, you can leave the defaults. For production setups, at least perform the following configuration changes.

    • Change host name of the installation.
      The host name of server machine is represented using ansible_host variable which is set to localhost as default. You need to change ansible_host to either host name or IP address of the server machine. Otherwise, the execution nodes will not be accessible to the rest of AutolabJS setup.
      Just to be clear, the host name to be used here is the host name of the server on which the execution nodes are going to be installed.

    • AutolabJS config. Set the configuration of AutolabJS as required by the following variables.

      Variable Default Value Explanation
      lb_hostname ansible_host=localhost The host name or IP address of the load balancer component.
      gitlab_hostname ansible_host=localhost The host name or IP address of the gitlab component.
      lb_port 8081 Port used by the load balancer component
      gitlab_port 80 Port used by the gitlab component
      gitlab_username root Administrator's username for GitLab
      gitlab_password 12345678 Administrator's password for GitLab

    All the values of variables given in above table should match with the values given in single_machine file.

    See AutolabJS Configuration Guide for details of all the configuration options.

  4. Install third-party software dependencies required for execution nodes.
    Note: This step also downloads and builds the docker containers which are bulky and takes a lot of time. Due to network issues, this step might fail. You can run this step as many times as required till it succeeds.
    bash dependencies.sh enodes

  5. Install execution nodes:
    sudo ansible-playbook playbook.yml --ask-become-pass
    The password to be provided is that of sudo user of the machine.
    Ansible installs the execution node components of AutolabJS. If the previous step executes successfully, the installation is complete.

Further Steps

  1. In case of installation failure due to incorrect configuration, please uninstall and then try to reinstall.

    1. The uninstall command is:
      ansible-playbook uninstall.yml --ask-become-pass
      The username and the password to be provided are the credentials of sudo user of the machine.

    2. Repeat the installation step-(5) given above to install the execution nodes again.

  2. Installation creates containers for execution nodes. For further information on managing these containers see container maintenance page.

Clone this wiki locally