Page Comparison

...

• Download the Devo domain certs:
• Connect to your Devo domain web interface.
• Access to Administration -> Credentials in the left pane.
  
• Select X.509 certificates in the upper menu.
• Select your certificate, download them and rename them as:
  • Click on CHAIN CA in the upper right corner ->chain.crt.
  • Click on certificate on the certificate row -> domain.crt.
  • Click on private key on the certificate row -> domain.key.
    
• Copy the files to $HOME/devo-ua-deployer/domain-certs.

Installation on Ubuntu 18

• Check that user configured can run sudo command without prompt.

  Run the following line in an SSH session where you did not previously run any sudo command:

  Code Block
  sudo ls

  If the previous command still asks for password, you can use the next command to avoid it:

  Code Block
  sudo /bin/bash -c "echo \"$(whoami) ALL=(ALL:ALL) NOPASSWD: ALL\" >> /etc/sudoers "

  
  

• Check python3 is installed with following command:

  Code Block
  python3 --version

  If the previous command return errors, you can install python3 with next command:

  Code Block
  sudo apt-get install python3

  
  

• Install Ansible from official repository:

  Code Block
  sudo apt-add-repository ppa:ansible/ansible sudo apt update sudo apt install ansible

  
  

• Change the working directory to the path where the installation package was extracted:

  Code Block
  cd $HOME/devo-ua-deployer

  
  

• Install the Ansible playbooks' dependencies:

  Code Block
  ansible-galaxy install -r playbooks/roles/requirements.yaml

  
  

• Edit the inventories/py3-1host-example.yaml file.

  Set the following properties under all.hosts.devo-ua-manager yaml section:

  • ansible_host: Devo Universal Agent Manager IP. Agents and web interface will use this IP.

  • ansible_user: User that will run Devo UAM. The same user as the one that has been configured previously in sudoers.

  • ansible_password: Password.

  And the following properties under all.vars yaml section:

  • duam_relay_entrypoint : tcp://FQDN_CENTRAL_RELAY:443. Where FQDN_CENTRAL_RELAY is the FQDN of your central Devo relay. To know which entrypoint corresponds to the used domain, follow the next steps (to send the data via a Devo Relay instead of sending it directly to Devo see the appendix below):

    • Access Devo Web Interface with your credentials.

    • Go to Administration -> Relays in the left pane.
      

    • Copy the field Address of the central relay.
      

• Create docker/user/config.json file with valid empty JSON body:

  Code Block
  echo '{}' > docker/user/config.json

  
  

• Run Ansible playbook:

  Code Block
  ansible-playbook -i inventories/py2py3-1host-example.yaml playbooks/devo-universal-agent.yaml

  
  

...

• Download the Devo domain certs:
• Connect to your Devo domain web interface.
• Access to Administration -> Credentials in the left pane.
  
• Select X.509 certificates in the upper menu.
• Select your certificate, download them and rename them as:
  • Click on CHAIN CA in the upper right corner ->chain.crt.
  • Click on certificate on the certificate row -> domain.crt.
  • Click on private key on the certificate row -> domain.key.
    
• Copy the files to $HOME/devo-ua-deployer/domain-certs.

Installation on Ubuntu 18

• Check that user configured can run sudo command without prompt.

  Run the following line in an SSH session where you did not previously run any sudo command:

  Code Block
  sudo ls

  If the previous command still asks for password, you can use the next command to avoid it:

  Code Block
  sudo /bin/bash -c "echo \"$(whoami) ALL=(ALL:ALL) NOPASSWD: ALL\" >> /etc/sudoers "

  
  

• Check python3 is installed with following command:

  Code Block
  python3 --version

  If the previous command return errors, you can install python3 with next command:

  Code Block
  sudo apt-get install python3

  
  

• Install Ansible from official repository:

  Code Block
  sudo apt-add-repository ppa:ansible/ansible sudo apt update sudo apt install ansible

  
  

• Change the working directory to the path where the installation package was extracted:

  Code Block
  cd $HOME/devo-ua-deployer

  
  

• Install the Ansible playbooks' dependencies:

  Code Block
  ansible-galaxy install -r playbooks/roles/requirements.yaml

  
  

• Edit the inventories/py2py3-1host-example.yaml file.

  Set the following properties under all.hosts.devo-ua-manager yaml section:

  • ansible_host: Devo Universal Agent Manager IP. Agents and web interface will use this IP.

  • ansible_user: User that will run Devo UAM. The same user as the one that has been configured previously in sudoers.

  • ansible_password: Password.

  And the following properties under all.vars yaml section:

  • duam_relay_entrypoint : tcp://FQDN_CENTRAL_RELAY:443. Where FQDN_CENTRAL_RELAY is the FQDN of your central Devo relay. To know which entrypoint corresponds to the used domain, follow the next steps (to send the data via a Devo Relay instead of sending it directly to Devo see the appendix below):

    • Access Devo Web Interface with your credentials.

    • Go to Administration -> Relays in the left pane.
      

    • Copy the field Address of the central relay.
      

• Create docker/user/config.json file with valid empty JSON body:

  Code Block
  echo '{}' > docker/user/config.json

  
  

• Run Ansible playbook:

  Code Block
  ansible-playbook -i inventories/py2-1host-example.yaml playbooks/devo-universal-agent.yaml

  
  

...