- Use corresponding option of the Control Panel installer in case MySQL is already installed and configured.
- Installer output is redirected to ./onapp-cp-install.log
- All installer critical errors are in /var/log/messages
- This instruction is applicable for installing OnApp 6.0 Patch 2
To install Control Panel server, perform the following procedure:
Update your server:
Download OnApp YUM repository file:
Install OnApp Control Panel installer package:
(Optional) You can optionally apply the Control Panel custom configuration. It is important to set the custom values before the installer script runs.Edit the /onapp/onapp-cp.conf file to set Control Panel custom values
# Template server URL
# IPs (separated with coma) list for the snmp to trap
# OnApp Control Panel custom version
# OnApp MySQL/MariaDB connection data (database.yml)
# MySQL/MariaDB server configuration data (in case of local server)
# Use MariaDB instead of MySQL as OnApp database server
# Configure the database server relative amount of available RAM
# The number of C data structures that can be allocated before triggering the garbage collector. It defaults to 8 million
# sysctl.conf net.core.somaxconn value
# The root of OnApp database dump directory (on the Control Panel box)
# Remote server's (to store database dumps) IP, user, path, openssh connection options ans number of dumps to keep
# Enable monit - tool for managing and monitoring Unix systems
# If enabled (the 1 value is set) - install (if local box) and configures RabbitMQ Server (messaging system) for the vCloud support.
# Rotate transactions' log files created more then TRANS_LOGS_ROTATE_TIME day(s) ago
# Maximum allowed for uploading file size in bytes, from 0 (meaning unlimited) to 2147483647 (2GB). Default is 0.
# Timeout before ping Redis Server to check if it is started. Default is 5 sec.
# OnApp Control Panel SSL certificates (please do not change if you aren't familar with SSL certificates)
# * The data below to generate self-signed PEM-encoded X.509 certificate
# SSLCertificateFile, SSLCertificateKeyFile Apache directives' values
# ssl_certificate, ssl_certificate_key Nginx directives' values
# * PEM-encoded CA Certificate (if custom one exists)
# SSLCACertificateFile, SSLCertificateChainFile Apache directives' values
# ssl_client_certificate Nginx directives' values
# SSLCipherSuite, SSLProtocol Apache directives' values
# ssl_ciphers, ssl_protocols Nginx directives' values
Run the Control Panel installer:The full list of Control Panel installer options:
MYSQL_* Options are useful if MySQL is already installed and configured.
MySQL host -p MYSQL_PASSWD MySQL password -d MYSQL_DB OnApp MySQL database name -u MYSQL_USER MySQL user REDIS_* Options are useful if Redis Server is already installed and configured.
IP address/FQDN where Redis Server runs.
The Redis Server will be installed and configured on the current box if localhost/127.0.0.1 or box's public IP address (listed in SNMP_TRAP_IPS) is specified.
If local Redis, it will serve as well on the unix socket '/tmp/redis.sock'.
Default value is 127.0.0.1.
Redis Server listen port.
0 - if local server
6379 - if remote server
Redis Server password to authentificate.
Random password is generated if the option's argument isn't specified.
By default no password is used for local Redis.
Path to the Redis Server's socket. Used if local server only.
Default is /tmp/redis.sock
Options are used to configure OnApp Control Panel administrator data.
Please note, that these options are for NEW INSTALL only and not for upgrade
CP administrator password -F ADMIN_FIRSTNAME CP administrator first name -L ADMIN_LASTNAME CP administrator last name -E ADMIN_EMAIL CP administrator e-mail --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 are 127.0.0.1. VCD_* Options are usefull if vCloud/RabbitMQ are already installed and configured. --vcdlogin VCD_LOGIN RabbitMQ/vCloud user. Default value is 'rbtvcd'. --vcdpasswd VCD_PASSWD RabbitMQ/vCloud user password. The random password is generated if isn't specified. --vcdvhost VCD_VHOST RabbitMQ/vCloud vhost. Default value is '/' RBT_* 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. -v ONAPP_VERSION Install custom OnApp CP version -i SNMP_TRAP_IPS IP addresses separated with coma for snmp to trap -c CONFIG_FILE Custom installer configuration file. Otherwise, preinstalled one is used. -y update OS packages (except of OnApp provided) on the box with 'yum update'. -a do not be interactive. Process with automatic installation. -D do not make database dump, and make sure it is disabled in the cron and not running at the moment -h print this info
(Optional) Install CloudBoot dependencies:
Install OnApp license to activate the Control Panel. Enter a valid license key via the Web UI (you'll be prompted to do so). Your default OnApp login is admin/changeme. The password can be changed via the Control Panel > Cloud > Groups menu in the Control Panel.Once you have entered a license it can take up to 15 minutes to activate.
Restart the OnApp service: