QUICK START GUIDE


The aim of this guide is to help users quickly get started with using the DivineCloud product. To achieve that, we will walk you through a simple example of on-boarding 2 servers and managing those servers using Divine Cloud, as shown in figure below:

We will be performing following actions in this quick start guide:

  • On-board 2 Servers using DivineCloud
  • Execute sample ad-hoc command across the 2 servers in parallel.
  • Execute sample script across the 2 servers in parallel.
  • Connect to one of the server using the classic terminal mode.
  • Execute sample run-book across the 2 servers.

 

On-boarding Servers using DivineCloud


As shown in the figure above, let's say we want to on-board following details about the 2 servers, so that we can start using DivineCloud to manage them:

Server Name Display ID Tag Name IP Credential OS Username
Server 1 S1 APP_SERVER 192.168.1.4 Private Key : demo.pem root
Server 2 DB1 DB_SERVER 192.168.1.8 Password : welcome1 ubuntu

 

Following 3 steps are required to on-board the above servers successfully using DivineCloud:

Step 1 : Create two new Credentials entries, one for each credential

 

New Credentials Forms

 

Step 2 : Create two new Tags : APP_SERVER & DB_SERVER

 

New Tags Forms

Step 3 : Add two new Node entries, one for each node

New Node Forms

 

Executing Ad-hoc Commands Across Multiple Servers


Now that we have on-boarded the two servers successfully, let's execute a simple hostname command on each of the 2 servers in parallel.

Figure below shows the screenshot of executing hostname command on 2 servers:

Ad-Hoc Command Execution - Group Terminal Mode

 

Executing Scripts Across Multiple Servers


In this example let's execute a simple python script on each of the 2 servers in parallel. Script takes 2 arguments and prints the sum of the 2 numbers as output.

Figure below shows the screenshot of executing sample python scripts on the 2 servers.

Python Script Execution - Group Terminal Mode

The example above uses python as a language, which can easily be replaced by any other script languages including Shell Scripts, Ruby, Perl, etc.

 

Classic Terminal Mode


There are times when there is need to use the good old classic terminal. DivineCloud provides a classic terminal mode for just that.

Figure below shows the screenshot of executing commands on the 2 servers using classic terminal mode:

Classic Terminal Mode

 

Executing RunBooks Across Multiple Servers


Divine Cloud's true power is in executing run-books. No matter how complex the deployment scenario is, with RunBook Orchestrator it is completely feasible to achieve it.

Let's create a RunBook called "Greetings Sample RunBook" with 2 steps. The first step will be executed on Server 1 and will include a simple "Hello RunBook Step 1", followed by hostname. The second step will be executed on Server 2 and will include a PERL script which prints a greeting and prints hostname.

Figure below shows the Greetings Sample RunBook:

RunBook Sample - Code

In figure below we select Server 1 (S1) for executing Step 1 & we select Server 2 (DB1) for executing Step 2:

RunBook Sample - Selecting Servers Per Step

Figure below shows the output of the Greetings Sample RunBook execution:

RunBook Sample - Output