Install Cloud Exchange on a Virtual Machine

Prerequisites

• ESXi 6.7 or later.
• Minimum 8 CPUs and 16 GB RAM available in ESXi.
• Minimum 152 GB of free disk space.
• Download the Latest OVA file from here.
  MD5: 1760e181f2e1577cf53cd4f15992e743
  SHA256: 4e61142fa43b3a7d152e6c849c2748abc463a3e7a2d9ca2f44cce78875b5cbb2

Configure the OVA

1. Log in to your vSphere Client.
2. Select VMs and Templates from the menu.

   

3. Select the Datacenter where you want to deploy Cloud Exchange.
4. Right-click on the Datacenter and click Deploy OVF Template.

   

5. Deploy the OVF Template wizard.
   1. For Select the OVF template, select Local file, upload the latest OVA file, and then click Next.

      

   2. For Select a name and folder, enter the virtual machine name, select the location for virtual machine, and then click Next.
      

      

   3. For Select a compute resource, find the wanted resource, and then click Next.

      

   4. For Review the details, verify the settings, and then click Next.

      

   5. For Select storage, ensure that it has a minimum of 150 GB of free disk space available, and then click Next.

      

   6. For Select networks, pick a network, and then click Next.

      

   7. For Ready to complete, verify the settings, and then click Finish.
      
6. Wait for the import task to be finished.

   

7. Select the deployed VM and click Edit Settings.

   

8. Change the CPU and Memory of the VM according to your profile requirements (for a medium profile, 8 CPU and 16 GB RAM are required), and then click OK.
   

   

9. Power on the VM.

   

10. Launch the web console after powering on the VM.

    

11. Wait for the login prompt, and log in using the credentials below. Be sure to change the password with a more secure string.
    Username: cteadmin
    Password : Cl0ud3xc4ang3!
    

    

12. If your network has DHCP enabled, the VM will get its IP assigned. Run the command $ ip addr to verify whether the IP is assigned to the eth0 interface or not. If the IP is not assigned automatically, reach out to your IT administrator, and follow these steps (or How to assign static IP using netplan).
    1. Edit the file netskope_netplan_sample.yaml under /home/cteadmin.
       

       vi /home/cteadmin/netskope_netplan_sample.yaml

    2. In the file, add the IP address that you want to assign, and then save the file. (Check with the IT System Administrator for the IP address.)
       

       

    3. Copy the yaml file inside /etc/netplan:
       

       cp /home/cteadmin/netskope_netplan_sample.yaml /etc/netplan

    4. Restart the network service before applying the netplan changes.
       sudo systemctl restart systemd-networkd
    5. Apply and assign the IP address: sudo netplan apply
    6. Validate that IP address is assigned using the following command: ip addr

       

13. Go to the Cloud Exchange directory:
    

    cd /opt/cloudexchange/cloudexchange/

14. Copy and edit the cloudexchange config file.
    

    sudo cp cloudexchange.config.example cloudexchange.config
    sudo vi cloudexchange.config

15. Configure the CloudExchange configuration file by setting the parameters according to your requirements.

16. Execute the setup script.

    sudo python3 ./setup

17. Launch Cloud Exchange.
    

    sudo ./start

18. Wait for 5-10 minutes and then access the CE using the IP address of VM. (https://<ip>).

Default User Login

By default, a single user is created with administrative capabilities with these credentials:

• Username: admin
• Password: admin

This user will have Administrator level access to the application. This user will have write access, and will be able to create new users as well.

On the first login, you will be required to change these credentials. After that, log in using your new credentials.

Security Guidelines

• We recommend changing the password of the VM to a super secure password and remember it for future logins to the VM. If the new password is forgotten, then there is no way to recover the VM.
• Restrict SSH access to specific IP addresses. Please consult with your IT team for the same.

Increase the Size of Disk/Volume (Optional)

The following these steps will only increase the disk/volume size. After performing these steps, follow How to Extend Linux LVM Logical Volume to increase the file system size.

1. Select the VM in which you want to increase disk space.
2. Power Off the virtual machine.

   

3. Click Edit Settings.

   

4. Change the Hard disk 1 size per your requirements and click OK.

   

5. Power On the VM.

   

6. After the machine starts, follow How to Extend Linux LVM Logical Volume.

Prerequisites

• A Hyper-V instance.
• Minimum 8 CPUs and 16GB RAM available in the server.

• Minimum 152 GB of free disk space
• Download the Hyper-V virtual machine zip file from here.
  MD5: bb0bc476289d47697d4718553d77c65c
  SHA256: ddb464cad0e09f6d9b3a534f2515ea925ea906dc0d82bc13a56312c2754b5c65

Configure Hyper-V

1. Unzip the downloaded virtual machine file.
2. Open the Hyper-V manager and right-click on the server where you want to install Cloud Exchange, and then click New > Virtual Machine..
3. Click Next on the Before you begin page.
4. Specify name and location for the virtual machine, and then click Next.
5. For Specify Generation, select Generation 2, and then click Next.
6. For Assign Memory, change the RAM according to your profile (medium, large, etc.), and then click Next.
7. For Configure Networking, on the connection dropdown, select the appropriate virtual switch per your organization recommendations, and click Next.
8. For Connect Virtual Hard Disk, choose Use an existing virtual hard disk. Then, under Location, click Browse… to select the CE vhdx file path where you extracted the zip file and click Next.
9. Click Finish.
10. Wait for machine to be created, right-click on the newly created virtual machine, and then click Settings.
11. Click on Security, uncheck Enable Secure Boot, and then click Apply.
12. Click Processor, change the processor according to your profile (medium, large, etc.), and then click Apply.
13. Now start the virtual machine. Right-click on your virtual machine and click Start.
14. Connect to the virtual machine. Right-click on your virtual machine and click Connect…
15. Wait for login prompt, log in using the following credentials, and then change the password with a more secure string.
    • Username: cteadmin
    • Password : Cl0ud3xc4ang3!
16. If your network has DHCP enabled, the VM will get its IP assigned. Run the command $ ip addr to verify whether an IP is assigned to the eth0 interface or not. If an IP is not assigned automatically, reach out to your IT administrator and follow these steps (or How to configure static IP using Netplan).
    1. Edit the file netskope_netplan_sample.yaml under /home/cteadmin:
       

       vi /home/cteadmin/netskope_netplan_sample.yaml

    2. In the file, add the IP address that you want to assign, and then save the file. (Check with the IT System Administrator for the IP address.)
    3. Copy the yaml file inside /etc/netplan:
       

       cp /home/cteadmin/netskope_netplan_sample.yaml /etc/netplan

    4. Restart the network service before applying the netplan changes:
       

       sudo systemctl restart systemd-networkd

    5. Apply and assign the IP address:
       

       sudo netplan apply

17. Validate that IP address is assigned using the following command:
    

    ip addr

18. Go to the Cloud Exchange directory:
    

    cd /opt/cloudexchange/cloudexchange/

19. Copy and edit the cloudexchange config file.
    

    sudo cp cloudexchange.config.example cloudexchange.config
    sudo vi cloudexchange.config

20. Configure the CloudExchange configuration file by setting the parameters according to your requirements.

21. Execute the setup script.

    sudo python3 ./setup

22. Launch Cloud Exchange.
    

    sudo ./start

23. Wait for 5-10 minutes and then access the CE using the IP address of VM.

Default User Login

By default, a single user is created with administrative capabilities with these credentials:

• Username: admin
• Password: admin

This user will have Administrator level access to the application. This user will have write access, and will be able to create new users as well.

On the first login, you will be required to change these credentials. After that, log in using your new credentials.

Security Guidelines

• We recommend changing the password of the VM to a super secure password, and remember it for future login to the VM. If the new password is forgotten, then there is no way to recover the VM.
• Restrict SSH access to specific IP addresses. Consult with your IT team for the same.

Increase Size of Disk/Volume (Optional)

The following steps will only increase the disk/volume size. After performing these steps, follow the instructions in the next section Extend File system to new size of Disk/Volume (Optional) to increase the file system size.

1. Turn off Virtual Machine for which you want to increase disk size.
2. Select the Virtual Machine and right-click on it to open the Options menu.
   

   

3. Open Settings for the Virtual Machine that you want to increase the disk size from Hyper-V manager of windows server.
4. Select the Virtual Machine and right-click on it to open the Options menu.
   

   

5. Select Hard Drive for SCSI Controller, and click Edit.
   

   

6. Click Next for Locate Disk.
   

   

7. Select Expand and click Next for Choose Action.
   

   

8. Enter a New size per your requirement in the Configure Disk section, and then click Next.
   

   

9. Verify the new disk size and click Finish.
   

   

10. Click OK in Settings for virtual machine.
    

    

11. Select the Virtual Machine and right-click on it to open Options menu.
    

    

12. Start the VM and proceed to the Extend File system to new size of Disk/Volume (Optional) section below.

Extend the File System to a New Size of Disk/Volume (Optional)

These steps are applicable only after you have increased the size of the Disk/Volume.
Follow these steps to increase the disk space of the Cloud Exchange virtual machine.

1. Change the Disk size of the VM per your requirement (for example, 200GB).
2. Now start the VM and SSH into the machine.
3. Check the current disk size:
   

   df -h /

4. Check disks and identify the device name associated with the disk (like /dev/sda):
   

   sudo fdisk -l

5. Modify the disk and create a new partition:
   

   sudo fdisk /dev/<device-name>(like $ sudo fdisk /dev/sda)

6. There will be an error message like:
   

   “GPT PMBR size mismatch (317263871 != 335544319) will be corrected by write.”
   This represents that there is some space available in the disk.

7. Create new partition by entering the n command in the fdisk CLI. Command (m for help): n
8. Enter the partition number, and the first and last sector of the new partition (Keep all the values to default). Click enter to keep the values to default.
   • Partition number (4-128, default 4):
   • First sector (317261824-335544286, default 317261824):
   • Last sector, +/-sectors or +/-size{K,M,G,T,P} (317261824-335544286, default 335544286):
9. Write partition changes by entering the w command in the fdisk CLI. Command (m for help): w
10. Now fdisk will be exited automatically with the following message:
    

    “The partition table has been altered.
    Syncing disks.”

11. Create a physical volume:
    

    sudo pvcreate /dev/<device-name><partition-number>(like $ sudo pvcreate /dev/sda4)

12. Extend the physical volume to the Cloud Exchange volume group:
    

    sudo vgextend ce_vg /dev/<device-name><Partition-number>(like $ sudo vgextend ce_vg /dev/sda4)

13. Extend the logical volume to OS volume of Cloud Exchange volume group:
    

    sudo lvextend -l +100%FREE /dev/ce_vg/OS

14. Resize the OS volume:
    

    sudo resize2fs /dev/ce_vg/OS

15. Verify the disk size:
    

    df -h /