Introduction

This document describes how to install Melodic platform on one machine, from scratch.

Prerequisites

Requirements for Melodic’s machine

OS: Ubuntu 16.04/18.04

RAM: 64GB+

Storage: 100GB+

Following ports accessible:

Installation steps

Full installation includes installing of both: Upperware and the Executionware components of Melodic platform.

Installation instructions

1. SSH login into machine (ubuntu 16.04/18.04)

2. Run the following commands (this will download installation files):

   git clone https://bitbucket.7bulls.eu/scm/mel/utils.git

3. (optional) To use integration (non-stable, newest changes) version of Melodic checkout the rc3.0 branch:
   ⚠️ skip this step if you need the STABLE version

   cd ~/utils git checkout rc3.0

4. Run the Melodic’s installation script:

   sudo ~/utils/melodic_installation/installMelodic.sh

5. After installation new “.profile” is created in home dir of the user. Load it by executing the following:

   cd ~/ . .profile

6. Now the machine is ready to download and run latest docker images from Melodic and Cloudiator artifact repository. To download and start the components simply use the following:

   drestart

7. Running this for the first time can take some more time as docker swarm is being initialised. After the above command components shoud be started. You can check the status by running the following 2 commands:

   dps mping

   

   False-negative NOKs

   If you experience mping printing NOKs even if everything is up an running please consider [How to] Extended connection test script for VMs.

8.  In order to managing of Melodic’c users, please configure ldap policy and create new ldap user.  For the convenience there is simple script packaged with the Melodic allowing to configure ldap and add a user with admin permissions by the following commands:

   cd ~/utils/melodic_installation/ ./configureLdap.sh

9.  You need to add gui-backend self-signed certificate to trusted certificates in your browser. (ATTENTION: Execution of this point is required after each changes of Melodic IP, e.g. after each running of ‘ipupdate’ command). The easiest way:
   1. open https://{PUBLIC_MELODIC_IP}:8078 in your browser
   2. confirm the security exception
10. Login to GUI on https://{{PUBLIC_MELODIC_IP}}
    1. by the first usage of Melodic machine with new public IP in your browser,  you need to confirm the security exception
11. Go to Provider settings and update your Cloud credentials
12. 
13. Now this machine should be ready for deploying some application.

GUI should be available under: {PUBLIC_MELODIC_IP} (log in with your ldap credentials)

Process GUI is present in UI and http://{PUBLIC_MELODIC_IP}:8095 (log in with your ldap credentials)

Usefull aliases

Below you can find usefull commands to manage melodic components: