Install connector in OpenStack/KVM

Install an Enterprise Application Access (EAA) connector in an OpenStack or KVM environment.

Installation Requirements

Compatible virtual environment:

  • OpenStack/KVM : OpenStack Newton, OpenStack Mitaka, OpenStack Liberty, OpenStack: Support for any flavor running KVM images in QCOW2 format
  • Kernel Virtual Machine (KVM) Version 3.x

Computing capability:

  • CPU. Four virtual core.

  • Memory. 8 GB RAM

  • Storage. 16 GB hard drive disk space (4 GB allocated to swap space and 12 GB of free space).

Network:

  • A private IP address inside the Local Area Network (LAN), either DHCP or static. The connector should run close to internal applications, possibly in the same subnet as the application, and be able to communicate with the application in test.

  • Dial-out access to the Internet on TCP port 443. A connector must reach the Enterprise Application Access service over the internet. This communication is carried out over an open TCP port 443, and only needs outbound connectivity.

  • Access to the applications. The port and protocol must be accessible in the LAN.

  • A firewall that allows the connector's private IP address to reach the application on configured port numbers. For example, a firewall rule to allow the connector to reach the application server internal IP address or hostname (if DNS is configured) on port numbers 80, 443, or any application specific port.

Download the connector

  1. Log in to Enterprise Center.

  2. In the Enterprise Center navigation menu, select Application Access > Clients & Connectors > Access and Identity Connectors.

  3. Click Add New Connector (+). Provide a name and an optional description.

  4. For Package select OpenStack/KVM.

  5. (Optional) If you need remote debugging, enable Debugging.

  6. Click Save. The connector status changes to Created. Click Download Template, to download the file.

Install the connector

Prerequisite

Admin rights to access OpenStack services such as Glances, Horizons, and others.

  1. Extract the image file you downloaded in previous steps to a known location.

  2. Transfer the downloaded connector image file to the OpenStack Glances server.

  3. Log in to an SSH session on the Glances server.

  4. Enter the command to convert the downloaded image file format to the Qcow2 image format:

qemu-img convert -f raw -O qcow2 image.img image.qcow2

Verify the connector is running

  1. Return to Enterprise Center.
  2. In the Enterprise Center navigation menu, select Application Access > Clients & Connectors > Access and Identity Connectors.
  3. On the connectors list page, select your OpenStack connector and click Approve.
  4. Verify that the connector shows the private and public IP addresses assigned to it. The connector reaches out to the EAA Cloud. The status changes to Ready and Connector is running.