IMG 1010 - Virtual Machine - Installation and Setup

Deploy/Import the GCEMS on CentOS 7.3 KVM (Dialogic VM)

The procedures below describe how to create a Virtual Machine (VM) profile using the KVM. Once the VM is built on the server, the image that was created to run the GCEMS can then be imported and installed. Follow the procedures below to create the VM.

The procedures below describes creating a VM using KVM software in Ubuntu. This is the virtualization software used during testing and development. However, other brands of virtualization software available can be used. It is up to the system administrator to know the procedures and processes required to create, run, and maintain the virtualization software.

 

  • Open the KVM software and select Virtual Machine Manager from the Applications > System Tools menu.

  • Click on Create a new virtual machine and choose the Import existing disk image option. Click on Forward.

    • Change image ownership using the following command as root user:

chown -R owner-user:owner-group /path/KVM_GCEMS_IMG1053SP17.qcow2

Browse to and select the path labeled KVM_GCEMS_IMG1053SP17.qcow2. Choose the Linux option for OStype and CentOS 7.0 option for Version. Click on Forward.

  • Choose the Memory and CPUs settings. Click on Forward.

  • Enter the Name for VM and choose the Network selection (this could be NAT or Bridge depending on network environment). Click on Finish.

  • Shut down the VM and click on Show virtual machine details. Choose the VNC server type for Display Spice. Once set, click on Apply and power on the VM (additional NICs can be added if necessary).

     

     

  • Edit the /etc/hosts file.  

    • Add an entry before the existing 127.0.0.1 entry with the specific IP address, hostname, and alias for the Linux server.
      Example:
      135.119.36.142  <hostname>   localhost
      127.0.0.1           localhost.localdomain   localhost

    • Edit the /etc/sysconfig/network file and enter the same hostname (HOSTNAME=<value>) that was added in the /etc/hosts file.

      • Run command:

service network restart

Deploy/Import the Virtual Machine (Dialogic VM)

The procedures below describe how to create a Virtual Machine (VM) profile using the VMware vSphere client software. Once the VM is built on the server, the image that was created to run the GCEMS can then be imported and installed. Follow the procedures below to create the VM.

The procedures below describes creating a VM using VMware vSphere virtualization software. This is the virtualization software used during testing and development. However, other brands of virtualization software available can be used. It is up to the system administrator to know the procedures and processes required to create, run, and maintain the virtualization software.

Important Note: The procedure below describes deploying the VM using VMware. When deploying the VM using VirtualBox virtualization software, a problem in performance occurs because the serial port is by default, not enabled when first creating the VM. To alleviate the performance issues, click Enable Serial Port in the Serial Port tab.

  • Open the VMware vSphere Client software and select Deploy OVF Template from the File menu.

  • In the Deploy OVF Template screen, browse to and select the file labeled VEGCEMS_IMG_1053SP16.ovf. This file is the VM software that will run on Red Hat Enterprise Linux. Click on Next.

  • Read any warnings on any pop up screens that may appear and accept as required.

  • In the next screen that appears, verify the OVF Template Details are correct. Click on Next.

  • In the Name field of the Name and Location screen, either accept the default which is VEGCEMS_IMG_1053SP16 or enter a distinct name that identifies the VM being created. In this procedure, the default name was accepted. Click on Next.

  • In the Datastore screen that appears, click on and highlight the required datastore selection. Click on Next.

  • In the Ready to Complete screen, verify the Deployment Settings are correct. Click on Finish when satisfied that the settings are correct. The VM VEGCEMS_IMG_1053SP16 will now get created. This will take approximately 5 minutes to complete.

  • Once completed, select the VM image labeled VEGCEMS_IMG_1053SP16 just created. This image can be selected from within the tree in the vSphere Client screen. Select the Getting Started tab.

  • Within the Getting Started tab, click on Power on Virtual Machine to power up the VM just created.

  • Click on the Console tab, the VM that just got created can now be viewed powering up.

    • Red Hat Enterprise Linux Server will start. At the localhost login: screen, enter the following:

Dialogic User Login

User: excelsw
Password: excelsw

Edit the Created Virtual Machine (VM)

Procedure for Red Hat Enterprise Linux 6.7

When importing the supplied files and creating a VM, information such as the IP addresses and subnet masks are generic addresses and need to be changed to accommodate the network that the VM will be operating in. The procedure below describes how to configure the IP addresses to communicate with the VM just created. After the VM has been created and logged on, there are a few modifications needed. The scripts that create the VM configures two Ethernet adapters for the VM. Eth0 should be configured with a static IP address of 192.168.0.100 and eth1 should be configured to get its IP address through DHCP. The Ethernet adapters installed on the server that are running the VM already have a MAC address assigned to each adapter. However, the scripts that install the VM are trying to assign a different MAC address. The mismatch in MAC addresses cause Ethernet adapter eth0 to not get the static address being assigned through the VM installation scripts. To correct this mismatch of MAC addresses, follow the instructions below.

Start up the VM and log in. Defaults: username = excelsw, password = excelsw.

The first boot process may take longer than normal due to MAC address changing on NIC card and DHCP requests.

  • Open the Network Connections screen by right clicking on the icon in the top of the screen and clicking on Edit Connections.

  • Select device Auto eth2 and click on Edit button. Note the Auto eth2 hardware address then configure the same hardware address for System eth0 and remove Auto eth2. The root password = excel2. Otherwise, you will need to acquire the root password for the server.

     

  • Repeat the steps above if a second Ethernet interface is required. Note the Auto eth3 hardware address then configure the same hardware address for System eth1 and remove Auto eth3.

  • Remove /etc/udev/rules.d/70-persistent-net.rules and reboot system. After reboot, the two NICs are present in Network Manager.

  • Edit the /etc/hosts file.

    • Remove the existing entry (mapped to 192.168.0.100) if you want to add a new entry with the specific IP and hostname. Add an entry before the existing 127.0.0.1 entry with the specific IP address, hostname, and alias for the Linux server.
      Example:
      135.119.36.142  <hostname>   localhost
      127.0.0.1           localhost.localdomain   localhost

    • Edit the /etc/sysconfig/network file and enter the same hostname that was added in the /etc/hosts file.

      • Run command:

service network restart

Procedure for Red Hat Enterprise Linux 5.9

After the VM has been created and logged on, there are a few modifications needed. The scripts that create the VM configures two ethernet adapters for the VM. The eth0 should be configured with a static IP address of 192.168.1.100 and eth1 should be configured to get its IP address through DHCP. The ethernet adapters installed on the server that are running the VM already have a MAC address assigned to each adapter. However, the scripts that install the VM are trying to assign a different MAC address. The mismatch in MAC addresses cause ethernet adapter eth0 to not get the static address being assigned through the VM installation scripts. To correct this mismatch of MAC addresses, follow the instructions below.

Start up the VM and log in. Defaults: username = excelsw, password = excelsw.

The first boot process may take longer than normal due to MAC address changing on NIC card and DHCP requests.

  • On the EMS server, open Network from System menu as shown in screen capture below.

  • Before the Network Configuration screen, it will ask for the root user password. If the server was purchased from Dialogic -or- Red Hat and installation instructions were followed, then the root password = excel2. Otherwise, you will need to acquire the root password for the server.

  • Select device eth0 and click on Edit.

  • Edit the properties as necessary to connect to the same subnet as IMG CTRL 0 Port. The screen capture below is used as a reference.

  • Select the Hardware Device tab from the Ethernet device box and change MAC address by clicking on Probe.

  • Close the Network Configuration screen and click on Yes to apply the changes.

  • Repeat the steps above if a second Ethernet interface is required.

  • Edit the /etc/hosts file.

    • There is an existing entry for localhost mapped to 127.0.0.1. Add an entry before the existing 127.0.0.1 entry with the specific IP address, hostname, and alias for the Linux server.
      Example:
      135.119.36.142  <hostname>   localhost
      127.0.0.1           localhost.localdomain   localhost

    • Edit the /etc/sysconfig/network file and enter the same hostname that was added in the /etc/hosts file.

      • Run command:

service network restart

Return to Documentation Home I Return to Sangoma Support