Install Control Panel Server

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:
```
# yum update
```
CODE

Download OnApp YUM repository file:

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

CODE

Install OnApp Control Panel installer package:
```
#> yum install onapp-cp-install
```
CODE

(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

TEMPLATE_SERVER_URL='http://templates-manager.onapp.com/'

CODE

# IPs (separated with coma) list for the snmp to trap

SNMP_TRAP_IPS=

CODE

# OnApp Control Panel custom version

ONAPP_VERSION=

CODE

# OnApp MySQL/MariaDB connection data (database.yml)

ONAPP_CONN_WAIT_TIMEOUT=15
ONAPP_CONN_POOL=30
ONAPP_CONN_RECONNECT='true'
ONAPP_CONN_ENCODING='utf8'
ONAPP_CONN_SOCKET='/var/lib/mysql/mysql.sock'

CODE

# MySQL/MariaDB server configuration data (in case of local server)

MYSQL_WAIT_TIMEOUT=604800
MYSQL_MAX_CONNECTIONS=500
MYSQL_PORT=3306

CODE

# Use MariaDB instead of MySQL as OnApp database server

WITH_MARIADB=0

CODE

# Configure the database server relative amount of available RAM

TUNE_DB_SERVER=0

CODE

# The number of C data structures that can be allocated before triggering the garbage collector. It defaults to 8 million

RUBY_GC_MALLOC_LIMIT=16000000

CODE

# sysctl.conf net.core.somaxconn value

NET_CORE_SOMAXCONN=2048

CODE

# The root of OnApp database dump directory (on the Control Panel box)

ONAPP_DB_DUMP_ROOT=

CODE

# Remote server's (to store database dumps) IP, user, path, openssh connection options ans number of dumps to keep

DB_DUMP_SERVER=
DB_DUMP_USER=root
DB_DUMP_SERVER_ROOT=/onapp/backups
DB_DUMP_SERVER_SSH_OPT="-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o PasswordAuthentication=no"
KEEP_DUMPS=168
DB_DUMP_CRON='40 * * * *'

CODE

# Enable monit - tool for managing and monitoring Unix systems

ENABLE_MONIT=1

CODE

# If enabled (the 1 value is set) - install (if local box) and configures RabbitMQ Server (messaging system) for the vCloud support.

ENABLE_RABBITMQ=1

CODE

# Rotate transactions' log files created more then TRANS_LOGS_ROTATE_TIME day(s) ago

TRANS_LOGS_ROTATE_TIME=30

CODE

# Maximum allowed for uploading file size in bytes, from 0 (meaning unlimited) to 2147483647 (2GB). Default is 0.

MAX_UPLOAD_SIZE=1073741824

CODE

# Timeout before ping Redis Server to check if it is started. Default is 5 sec.

REDIS_PING_TIMEOUT=5

CODE

# 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

SSL_CERT_COUNTRY_NAME=UK
SSL_CERT_ORGANIZATION_NAME='OnApp Limited'
SSL_CERT_ORGANIZATION_ALUNITNAME='OnApp Cloud'
SSL_CERT_COMMON_NAME=`hostname --fqdn 2>/dev/null`

CODE

# SSLCertificateFile, SSLCertificateKeyFile Apache directives' values
# ssl_certificate, ssl_certificate_key Nginx directives' values

SSLCERTIFICATEFILE=/etc/pki/tls/certs/ca.crt
SSLCERTIFICATECSRFILE=/etc/pki/tls/private/ca.csr
SSLCERTIFICATEKEYFILE=/etc/pki/tls/private/ca.key

CODE

# * PEM-encoded CA Certificate (if custom one exists)
# SSLCACertificateFile, SSLCertificateChainFile Apache directives' values
# ssl_client_certificate Nginx directives' values

SSLCACERTIFICATEFILE=
SSLCERTIFICATECHAINFILE=

CODE

# SSLCipherSuite, SSLProtocol Apache directives' values
# ssl_ciphers, ssl_protocols Nginx directives' values

SSLCIPHERSUITE=
SSLPROTOCOL=

CODE

# vi /onapp/onapp-cp.conf

CODE

Run the Control Panel installer:

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

CODE

The full list of Control Panel installer options:

Usage: `/onapp/onapp-cp-install/onapp-cp-install.sh [-c CONFIG_FILE] [-m MYSQL_HOST] [-p MYSQL_PASSWD] [-d MYSQL_DB] [-u MYSQL_USER] [-U ADMIN_LOGIN] [-P ADMIN_PASSWD] [-F ADMIN_FIRSTNAME] [-L ADMIN_LASTNAME] [-E ADMIN_EMAIL] [-v ONAPP_VERSION] [-i SNMP_TRAP_IPS] [--redis-host=REDIS_HOST] [--redis-passwd[=REDIS_PASSWD] [--redis-port=REDIS_PORT] [--redis-sock=REDIS_PATH] [-a] [-y] [-D] [-h]` CODE
Where:
MYSQL_*	Options are useful if MySQL is already installed and configured.
`-m MYSQL_HOST`	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.
`--redis-host=REDIS_HOST`	`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-port=REDIS_PORT	`Redis Server listen port.` `Defaults are:` `0 - if local server` `6379 - if remote server`
--redis-passwd[=REDIS_PASSWD]	`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.`
--redis-sock=REDIS_PATH :	`Path to the Redis Server's socket. Used if local server only.` `Default is /tmp/redis.sock`

ADMIN_*	`Options are used to configure OnApp Control Panel administrator data.` `Please note, that these options are for NEW INSTALL only and not for upgrade`
`-P ADMIN_PASSWD`	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:

#> yum install onapp-store-install
#> /onapp/onapp-store-install/onapp-store-install.sh

CODE

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:
```
#> service onapp restart
```
CODE