If you wish to deploy only the vCD integration model, you only need to install the Control Panel server, configure Rabbit MQ, and import vCloud Director.


On this page:

  • As initial import of vCloud Director into OnApp might take a considerable amount of time, you may consider increasing the Idle session timeout parameter in the vCloud Director at Administration > General, to avoid the possible import failure.
  • It is recommended to have vCloud Director and OnApp Control Panel in one network.
  • Currently OnApp supports only default vCD roles. These roles are mapped using the label, therefore, please do not change the labels of the default user roles in vCloud Director. Users with custom roles are not imported into OnApp.


See also:

Full Cloud Installation 


If you already have RabbitMQ installed on another box or you already have vCD login and password, please run the installer with additional Rabbit MQ and vCD options.

Install/Update Control Panel Server


To install/update control panel server:

  1. Update your server:

    bash# yum update

  2. Download OnApp YUM repository file:

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

  3. Install OnApp Control Panel installer package:

    bash#> 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.

    bash# vi /onapp/onapp-cp.conf


  5. Run the Control Panel installer:

    bash#> /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. 

    --rbthost RBT_HOST

    IP address/FQDN where RabbitMQ Server runs. 
    The RabbitMQ will be installed and configured on the current box if localhost/ or box's public IP address (enlisted in SNMP_TRAP_IPS)
    Default values is


    These options are usefull if vCloud Director/RabbitMQ is already installed and configured.

    --vcdlogin      VCD_LOGIN

    RabbitMQ/vCloud Director user. Default value is 'rbtvcd'.

    --vcdpasswd VCD_PASSWD

    RabbitMQ/vCloud Director user password. The random password is generated if isn't specified.

    --vcdvhost     VCD_VHOST

    RabbitMQ/vCloud Director vhost. Default value is '/'


    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 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 OnApp service:

    bash#> service onapp restart

  8. Once the installation of the Control Panel is complete, your default OnApp login will be admin/changeme. The password can be changed via the Control Panel's Users menu.

  9.  Proceed to RabbitMQ And OnApp Control Panel Connection.

  • Installer output is redirected to ./onapp-cp-install.log
  • All installer critical errors are in /var/log/messages



Configure RabbitMQ And OnApp Control Panel Connection



 Remember that rabbitmq_host must be reachable by vCloud Director.

Import of vCloud Director resources into OnApp


  • At the moment, vCloud system admins are not imported into OnApp and all management tasks are performed via the vCloud Director web interface.
  • VS passwords are not imported into OnApp.
  • vCloud compute resource passwords are encrypted by default.