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 Private Key : demo.pem root
Server 2 DB1 DB_SERVER 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