Virtuozzo OnApp with VMware Cloud Director Installation Guide

If you wish to deploy only the VCD integration model, you only need to install the Control Panel server, configure Rabbit MQ, and import VMware Cloud Director:

• Install/Update Control Panel Server
• Configure RabbitMQ and Virtuozzo OnApp Control Panel Connection
• Import of VMware Cloud Director Resources into OnApp

Install/Update Control Panel Server

To install/update control panel server:

1. Update your server:

   1	# yum update

2. Download Virtuozzo OnApp YUM repository file:

   1	# rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-6.4.noarch.rpm

3. Install Virtuozzo OnApp Control Panel installer package:

   1	#> yum install onapp-cp-install

4. Edit the /onapp/onapp-cp.conf file to set Control Panel custom values. Custom values must be set before the installer script runs.

   1	# vi /onapp/onapp-cp.conf

5. Run the Control Panel installer:

   1	#> /onapp/onapp-cp-install/onapp-cp-install.sh -i SNMP_TRAP_IPS

   Ensure that the SNMP_TRAPS_IP should be the management IP of your CP server.
   

   VCD and Rabbit MQ options
   The installer will automatically install/upgrade RabbitMQ server on the CP’s box and configure it if no options are specified. Consider the options below for Rabbit MQ configuration if it is already installed on server separate from CP.

   1 --rbthost RBT_HOST	IP address/FQDN where RabbitMQ Server runs. The RabbitMQ will be installed and configured on the current box if localhost/127.0.0.1 or box's public IP address (enlisted in SNMP_TRAP_IPS) Default values is 127.0.0.1.
   VCD_*	These options are usefull if VMware Cloud Director/RabbitMQ is already installed and configured.
   --VCDlogin VCD_LOGIN	RabbitMQ/VMware Cloud Director user. Default value is 'rbtVCD'.
   --VCDpasswd VCD_PASSWD	RabbitMQ/VMware Cloud Director user password. The random password is generated if isn't specified.
   --VCDvhost VCD_VHOST	RabbitMQ/VMware Cloud Director vhost. Default value is '/'
   RBT_*	These options are used to configure RabbitMQ manager account. If local RabbitMQ server.
   --rbtlogin RBT_LOGIN	RabbitMQ manager login. The default value is 'rbtmgr'.
   --rbtpasswd RBT_PASSWD	RabbitMQ manager password. The random password is generated if isn't specified.

6. Install Virtuozzo OnApp license to activate the Control Panel:
   Enter a valid license key via the Web UI (you’ll be prompted to do so). Once you have entered a license it can take up to 15 minutes to activate.

7. Restart the Virtuozzo OnApp service:

   1	#> service onapp restart

8. Once the installation of the Control Panel is complete, your default Virtuozzo OnApp login will be admin/changeme. The password can be changed via the Control Panel’s Users menu. You can now proceed to RabbitMQ and Virtuozzo OnApp Control Panel connection.

If you are using the Virtuozzo OnApp High Availability CP and VMware Cloud Director integration:

You need to perform the following steps to be able to use OVA and ISO functionality in your cloud.

1. Change the path to upload templates and media for using the shared directory:

   1 2 3 4

   ... iso_path_on_cp: "/path_to_shared_directory" ova_path: "/path_to_shared_directory" ...

   You should specify the shared directory for ISO and OVA variables.

2. Unmanage onapp-frontend-httpd-group-cluster and onapp-engine-group-cluster resources and restart services to apply the new configuraion:

   1	# crm resource unmanage onapp-frontend-httpd-group-cluster && crm resource unmanage onapp-engine-group-cluster

3. Restart the Virtuozzo OnApp engine and httpd services on all nodes:

   1	# service onapp restart && service httpd restart

4. Ensure that the services have been restarted correctly.

5. Manage unmanaged resources from step 2:

   1	# crm resource manage onapp-frontend-httpd-group-cluster && crm resource manage onapp-engine-group-cluster

Configure RabbitMQ and Virtuozzo OnApp Control Panel Connection

Virtuozzo OnApp VCD integration requires the use of RabbitMQ to keep VCD and Virtuozzo OnApp synchronized. If you plan using the RabbitMQ server installed by Virtuozzo OnApp by default, there is no need for additional configuration in Virtuozzo OnApp Control Panel. Though, it is required that you edit the AMQP settings in VCD.

To specify RabbitMQ settings in VCD:

1. Go to your Virtuozzo OnApp Control Panel server.
2. Open the /onapp/interface/config/on_app.yml file.
3. Find the RabbitMQ parameters:
   • rabbitmq_login
   • rabbitmq_password
   • rabbitmq_vhost
   • rabbitmq_host - make sure it is reachable by VMware Cloud Director
4. Edit your AMQP settings in VCD with the RabbitMQ details found at step 3:
   1. Navigate to the Administration tab of your System Organization, expand System Settings, and select Extensibility.
   2. Click Enable Notifications.
   3. Add the details from OnApp.
   4. Specify your VMware Cloud Director AMQP Exchange name that you should later use in the corresponding AMQP Exchange Name box while creating compute resources in OnApp.

If you are running your own RabbitMQ server, it is required that you add the RabbitMQ details through the Virtuozzo OnApp Control Panel.

To specify RabbitMQ settings in Virtuozzo OnApp Control Panel:

If you want to use a separate RabbitMQ instance for VMware Cloud Director, specify the following VMware Cloud Director RabbitMQ parameters in the /onapp/configuration/rabbit_mq/vcloud/credentials.yml file:

• :host: - RabbitMQ server IP address
• :port: - RabbitMQ port
• :vhost: - the name of the “virtual host” (or vhost) that specifies the namespace for entities (exchanges and queues) referred to by the protocol. Note that this is not virtual hosting in the HTTP sense.
• :user: - RabbitMQ login
• :password: - RabbitMQ password

If you want to use the same Rabbit MQ instance both for VMware Cloud Director and Virtuozzo OnApp engine:

1. Go to your Control Panel’s Settings menu, and click the Configuration icon.
2. Click the System tab to change the following application settings:
   RabbitMQ
   • Host - RabbitMQ server IP address
   • Virtual Host - the name of the “virtual host” (or vhost) that specifies the namespace for entities (exchanges and queues) referred to by the protocol. Note that this is not virtual hosting in the HTTP sense.
   • Login - RabbitMQ login
   • Password - RabbitMQ password

Import of VMware Cloud Director Resources into OnApp

Before you start

• Your VCD should be v10.1 or later.

• VCD public addresses should be configured properly.

• All VCD users should have a valid and unique email and First and Last name assigned inside of vCloud Director. Otherwise, they won’t be imported.

• Currently fast-provisioned virtual datacenters are not supported for vApp provisioning.

• VCD users should be assigned one of the default or custom VMware Cloud Director roles.

• vApps that have “system” owner will be imported under “System Owner” in OnApp.

• Any system user will not be imported. Virtuozzo OnApp will only import organization users.

• VSs currently cannot be connected to network during provisioning.

• VS passwords are not imported into OnApp.

• VMware Cloud Director system admins are not imported into Virtuozzo OnApp and all management tasks are performed via the VMware Cloud Director web interface.

• VMware Cloud Director compute resource passwords are encrypted by default.

Import

To import your VMware Cloud Director resources into Virtuozzo OnApp:

1. Log in to Virtuozzo OnApp CP as an administrator.

2. Set Rabbit MQ credentials for the Virtuozzo OnApp CP and your VMware Cloud Director.

3. Create a compute zone in which the VMware Cloud Director compute resource will reside.

   To create a compute zone:

   1. Go to your Control Panel’s Settings menu and click the Compute Zones icon.
   2. Press "+" or click the Add New Compute Zone button.
   3. On the screen that follows:

      1. Label - give your compute zone a name

      2. Server type - select a type for your zone. For VMware Cloud Director compute zones select the Virtual Private Cloud type.

      3. Location group - select the location group to which this Compute zone will be assigned

      4. Failover timeout - set the time period for which the iterations will run during the failover if the compute resource does not respond

   4. Click the Save button.

4. Create a compute resource of a vcloud type and specify VMware Cloud Director global system admin credentials and API URL of your VMware Cloud Director.

   When importing VCD resources you can choose whether you wish your users to be associated with one or several VMware Cloud Director instances. If you wish your users to have access to multiple VMware Cloud Director instances, you can set up several organizations from different VCD instances to be associated in Virtuozzo OnApp with a single user group and have access to resources across multiple VCD instances.

   • single vCloud Director mode - all resources are imported from the VCD instance. Each organization is imported as a separate user group which can be associated with one VCD instance.
   • multiple vCloud Director mode - only system level entities are imported (provider VDCs, external networks, etc.). Organizations are imported but are empty, i.e. do not contain resources and users. After the initial import you can select which organization you wish to import and associate with a certain user group. Users imported in this mode can be configured to have access to multiple VCD instances.

   To create a compute resource:

   1. Go to your Control Panel Settings menu.
   2. Click the Compute Resources icon.
   3. Press + button or click the Add New Compute Resource button underneath the list of compute resources on the screen.
   4. On the screen that appears:

      • Label - enter a compute resource name.

      • Compute resource type - choose a compute resource type. Select vcloud.

      • Compute zone - select the compute zone you added on Step 3.

      • Operation mode - select whether you wish to import the zone in the single or multiple VMware Cloud Director mode. If you select the multiple VMware Cloud Director, you need to later import the resources of an organization and its users.

      • Login - specify the VMware Cloud Director system admin login

      • Password - specify the VMware Cloud Director system admin password

      • API URL - set the VMware Cloud Director API URL - e.g. https://example.com

      • AMQP Exchange Name - specify your VMware Cloud Director AMQP exchange name (this can be taken in your VMware Cloud Director instance Extensibility > Settings > Exchange )

   5. Click the Save button. The compute resource will be added to the system and the import will start automatically.

5. The import will start automatically. After the transaction is successfully completed, all your VMware Cloud Director resources will be shown in OnApp. You can view log output of transaction Import vCloud to Control Panel for more import details.

6. Import the users and resources of the required organization. This step is only applicable if you have selected the multiple VMware Cloud Director mode for your compute resource in step 4.

   1. Go to Control Panel > Settings > Compute Resources > Label.
   2. The page that loads shows the details of your VCD compute resource. Click Tools and select Import Organization from vCloud.
   3. Move the Import slider to the right next to the organization(s) you wish to import.
   4. Select a user group to which you wish to assign the organization in the Assign to User Group field. If you do not select a user group but enable the Import slider, a new user group will be created for this organization. If you select a user group that is already associated with one or several organizations, the users from the new organization will be created in the already present organizations and the users from the already present organizations will be created in the new user group.
   5. Click Submit to import the organizations.