C H A P T E R
15
Installing Cisco Elastic Services Controller on a
Kernel-based Virtual Machine
This chapter describes how to install Cisco Elastic Services Controller on a Kernel-based Virtual Machine and includes the following sections:
•
Installing Cisco Elastic Services Controller in a Kernel-based Virtual Machine, on page 83
•
Next Steps: Cisco Elastic Services Controller Kernel-based Virtual Machine, on page 86
Installing Cisco Elastic Services Controller in a Kernel-based
Virtual Machine
Cisco Elastic Services Controller can be installed in a Kernel-based Virtual Machine. You can install Cisco
Elastic services controller in a Kernel-based Virtual Machine using libvirt.
Preparing to Install Cisco Elastic Services Controller on a Kernel-based Virtual
Machine
If you plan to run Cisco Elastic Services Controller on a kernel-based virtual machine, make sure the following are setup:
Python 2.7 or 3.x
python-setuptools
Notes
Installed by default on Linux
Installed by default on Linux
Cisco Elastic Services Controller 5.5 Install and Upgrade Guide
83
Installing Cisco Elastic Services Controller on a Kernel-based Virtual Machine (KVM)
Preparing to Install Cisco Elastic Services Controller on a Kernel-based Virtual Machine pip
OpenStack clients genisoimage libvirt and virtinst
Notes
On RHEL 6.x/7.x: :
# easy_install pip
Since the installation using pip compiles source files, the gcc and python development packages are also required on RHEL. To install these packages on
RHEL:
# yum install gcc python-devel
On RHEL8.x:
# yum install gcc
On Ubuntu : Installed by default. Since the installation using pip compiles source files, the gcc and python development packages are also required on Ubuntu.
To install these packages on Ubuntu:
# apt-get install python-dev
# pip install python-keystoneclient
# pip install python-cinderclient
# pip install python-novaclient
# pip install python-neutronclient
On RHEL :
# yum install genisoimage
On Ubuntu :
# apt-get install genisoimage
For Python 2
On RHEL 6.x
:
# yum install libvirt-python python-virtinst
On RHEL 7.x
:
# yum install libvirt-python virt-install
On Ubuntu :
# apt-get install libvirt-dev
# pip install libvirt-python
For Python 3:
On Ubuntu
# sudo apt-get install -y python3-libvirt
On RHEL
# yum install -y python3-libvirt
Virt-Manager git clone https://github.com/virt-manager/virt-manager.git
/usr/share/virt-manager-py3
84
Cisco Elastic Services Controller 5.5 Install and Upgrade Guide
Installing Cisco Elastic Services Controller on a Kernel-based Virtual Machine (KVM)
Installing Elastic Services Controller on a Kernel-Based Virtual Machine
Other
Notes
On RHEL 8.x
# yum install libcurl-devel
# yum install openssl-devel
# pip3 install pycurl
# pip3 install urlgrabber
Note libvirt will create the default network automatically.
Installing Elastic Services Controller on a Kernel-Based Virtual Machine
To install standalone Elastic Services Controller (ESC) on a kernel-based virtual machine, do the following:
Procedure
Step 1
Step 2
Step 3
Step 4
Step 5
Step 6
Load the variables from the openerc file that contains OpenStack credentials: cat ./openrc.sh
export OS_TENANT_NAME='< OS tenant username >' export OS_USERNAME='< OS username >' export OS_PASSWORD='< OS password >' export OS_AUTH_URL='http://<Openstack Host>:5000/v2.0/' source ./openrc.sh
Copy the ESC qcow2 image and the bootvm.py into the kernel-based VM.
Boot ESC on a kernel-based VM on the default network that was created when libvirt was installed, use one of the following command:
./bootvm.py --user_pass <username>:<password> --user_confd_pass <username>:<password>
--libvirt --image <image_name> esc-vm --net <default network>
Boot ESC on a kernel-based VM on the default network with static IP, using the following command:
./bootvm.py --user_pass <username>:<password> --user_confd_pass <username>:<password>
--libvirt --image <image_name> esc-vm --net <network> --ipaddr <ip_address>
Get a list of used IP addresses in your network. Use IP addresses that are not in the list for both HA
Active/Standby bootvm.py command and for kad_vip. Determine the first 3 octets of your network (i.e.
192.168.122) and pass it in the below command : arp -an | grep 192.168.122
To install ESC on a kernel-based VM in high availability, use the following command twice for both the HA nodes:
Note For the second bootvm.py command, use the other HA instance name.
Cisco Elastic Services Controller 5.5 Install and Upgrade Guide
85
Installing Cisco Elastic Services Controller on a Kernel-based Virtual Machine (KVM)
Next Steps: Cisco Elastic Services Controller Kernel-based Virtual Machine
./bootvm.py --user_pass <username>:<password> --user_confd_pass <username>:<password>
--libvirt --image <image_name> --ha_mode drbd --gateway_ip <default_gateway_ip_address>
--ipaddr <ip_address>
--ha_node_list <ha peer ip addresses separated by comma> --kad_vip <vip address> esc-ha-1
--net <network>
Next Steps: Cisco Elastic Services Controller Kernel-based
Virtual Machine
Logging in to Cisco Elastic Services Controller Portal
Verifying ESC installation for a Kernel-based Virtual Machine (KVM)
After deploying ESC on a Kernel-based virtual machine, use the following procedure to verify the deployment.
Procedure
Step 1
Step 2
Step 3
Check that the ESC VMs have booted using the following command:
$ virsh list
Get the IP address of the ESC VM, using the following command:
$ arp -an | grep <ip_address>
Connect to ESC using SSH and verify the processes are running:
$ ssh USERNAME@ESC_IP
Troubleshooting Tips
When SSH access is not available, due to network conditions or ESC startup failures, you can connect to ESC through console(if enabled in ESC VM image) or VNC access. To access ESC VM through VNC, do the following:
1.
Identify the vnc port.
virsh dumpxml 10 | fgrep vnc
2.
Create a ssh tunnel to the local vnc port to allow connection from your remote VNC client.
86
Cisco Elastic Services Controller 5.5 Install and Upgrade Guide
P A R T
V
Installing Cisco Elastic Services Controller on
Amazon Web Services (AWS)
•
Installing Cisco Elastic Services Controller on Amazon Web Services, on page 89
