Knowledgebase

Before using the Angani Cloud, you need to have the following in place:
1. Web browser of your choice
2. SSH client of your choice.
- Most Linux and Mac PCs have a terminal with SSH client
- Windows users might need to install putty from here: http://www.putty.org

Note:
1. SSH key is required to login into any of the Angani templates. Root user and password logins are disabled by default but can be enabled at user’s discretion after initial login. The default user is angani and sudo can be used for privileged operations in the instance.
2. Instances are Virtual Machines (VMs)

Step 1: Login
Please use the credentials provided by Angani support team to login in the following URL https://portal.nbo.angani.co/client/

Step 2: Creating an SSH Key Pair in CloudStack
To log in, you will need to generate a key pair.
In your CloudStack portal:
1. Go to “Accounts”
2. Go to “Select View”
3. Select “SSH Key Pairs”
4. Click on “Create a SSH Key Pair” button
5. Once the Key Pair is created, copy the private key to a text file, and save it in asecure location.
For Linux and Mac, make sure the file has 400 file permissions:
chmod 400 <pathtokey>

Note: You can also upload your own public key by copying it in at the “Public Key” text
box and use it with your secret key to log in to your instance. Follow link below for
guidelines.
https://www.digitalocean.com/community/tutorials/how-to-set-up-ssh-keys--2

Step 3: Creating an Instance
1. Go to “Instances”
2. Click on the “Add Instance” button
3. Select “Template”
4. Select “Operating System”
5. Select “Instance Size”; you have a choice from “Tiny” to “Extra Large”
6. Select “Disk Offering” appropriate for the Operating System. By default, the templates have 20GB root volume
7. Select “Affinity” if you have any configured, otherwise skip
8. Select “Network” and finish up with appropriate name
9. Select “SSH Key Pair”, created in step 2 above (only for Linux VMs)
10. Review your settings and click “Launch VM” button
Wait a few minutes for an Instance to be created with your IP address

Step 4: Connecting to an Instance
Linux: 
1. Login using the SSH Key Pair created:
ssh angani@IP-address-of-instance -i <pathtokey>
For Windows users using putty, please refer to putty documentation on how to connect using a private key. Be sure to convert the key to .ppk for use with putty.
2. Once logged in you can switch to root user by typing the command:
sudo su

Windows:
1. Login using RDP with username Administrator and the password provided.

Step 5: Creating a New Volume
1. In the left navigation bar, click “Storage”
2. In “Select View”, choose “Volumes”
3. To create a new volume, click “Add Volume”. Fill up the fields as follows:
o Name - Give the volume a name
o Disk Offering - Choose the size desired
A new volume appears in the list of volumes with the state “ Allocated ”.

Step 6: Attaching a Volume
1. Click “Storage”
2. In Select View, choose “Volumes”
3. Click the volume name in the Volumes list, then click the “Attach Disk” button
4. Choose the instance you need to attach to and click “OK”. A notification of successful attachment will appear on the notifications section (top right of the screen)
5. To view the volume attached, click “Instances”, click on the instance name and click “View Volumes”
Note: Volumes created are raw block storage. You need to format and partition.

Step 7: Detaching a Volume
1. Click “Storage”, and choose “Volumes” in “Select View”. Alternatively, if you know which instance the volume is attached to, you can click “Instances”, click the instance name, and click “View Volumes”.
2. Click the name of the volume you want to detach, then click the “Detach Disk button”.
Step 8: Taking a Snapshot of a Volume
1. Click “Storage”.
2. In “Select View”, be sure “Volumes” is selected.
3. Click the name of the volume you want to snapshot.
4. Click the “Snapshot button”.

Step 9: Deleting an Instance
1. Click “Instances”.
2. Choose the instance you want to delete.
3. Click the “Destroy Instance” button.

Step 10 : Changing a user password - Windows VMs only
1. Click “Accounts”
2. Click “Quickview” and select “View users”
3. Click on the account name that you wish to reset password
4. Click on the change password icon
5. A “Change Password” box will pop up as below