Page History

To upgrade your Control Panel server:

1. Run the following command from the CP server to stop the OnApp service:

   Code Block
   service onapp stop

2. Download and install the latest OnApp YUM repository file:

   Code Block
   bash#> rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-4.1.noarch.rpm

3. Upgrade OnApp Control Panel installer package:

   Code Block
   bash#> yum update onapp-cp-install

   
   

4. Update your server OS components (if required):

   Code Block
   bash# /onapp/onapp-cp-install/onapp-cp-install.sh -y

5. Anchor
   config config

   (Optional) If you need some custom Control Panel configuration, set the values before the installer script runs.

   Expand
   title Edit the /onapp/onapp-cp.conf file to set Control Panel custom values
   # Template server URL Code Block TEMPLATE_SERVER_URL='http://templates-manager.onapp.com/' # IPs (separated with coma) list for the snmp to trap Code Block SNMP_TRAP_IPS= # OnApp Control Panel custom version Code Block ONAPP_VERSION= # OnApp MySQL/MariaDB connection data (database.yml) Code Block 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' # MySQL/MariaDB server configuration data (in case of local server) Code Block MYSQL_WAIT_TIMEOUT=604800 MYSQL_MAX_CONNECTIONS=500 MYSQL_PORT=3306 # Use MariaDB instead of MySQL as OnApp database server Code Block WITH_MARIADB=0 # Configure the database server relative amount of available RAM Code Block TUNE_DB_SERVER=0 # The number of C data structures that can be allocated before triggering the garbage collector. It defaults to 8 million Code Block RUBY_GC_MALLOC_LIMIT=16000000 # sysctl.conf net.core.somaxconn value Code Block NET_CORE_SOMAXCONN=2048 # The root of OnApp database dump directory (on the Control Panel box) Code Block ONAPP_DB_DUMP_ROOT= # Remote server's (to store database dumps) IP, user, path, openssh connection options ans number of dumps to keep Code Block 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 * * * *' # Enable monit - tool for managing and monitoring Unix systems Code Block ENABLE_MONIT=1 # If enabled (the 1 value is set) - install (if local box) and configures RabbitMQ Server (messaging system) for the vCloud support. Code Block ENABLE_RABBITMQ=1 # Rotate transactions' log files created more then TRANS_LOGS_ROTATE_TIME day(s) ago Code Block TRANS_LOGS_ROTATE_TIME=30 # Maximum allowed for uploading file size in bytes, from 0 (meaning unlimited) to 2147483647 (2GB). Default is 1GB Code Block MAX_UPLOAD_SIZE=1073741824 # Timeout before ping Redis Server to check if it is started. Default is 5 sec. Code Block REDIS_PING_TIMEOUT=5 # 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 Code Block 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` #   SSLCertificateFile, SSLCertificateKeyFile Apache directives' values #   ssl_certificate, ssl_certificate_key Nginx directives' values Code Block SSLCERTIFICATEFILE=/etc/pki/tls/certs/ca.crt SSLCERTIFICATECSRFILE=/etc/pki/tls/private/ca.csr SSLCERTIFICATEKEYFILE=/etc/pki/tls/private/ca.key # * PEM-encoded CA Certificate (if custom one exists) #   SSLCACertificateFile, SSLCertificateChainFile Apache directives' values #   ssl_client_certificate Nginx directives' values Code Block SSLCACERTIFICATEFILE= SSLCERTIFICATECHAINFILE= #   SSLCipherSuite, SSLProtocol Apache directives' values #   ssl_ciphers, ssl_protocols Nginx directives' values Code Block SSLCIPHERSUITE= SSLPROTOCOL=

   Code Block
   bash# vi /onapp/onapp-cp.conf

6. Anchor
   installer installer

   Run Control Panel installer:

   Code Block
   bash#> /onapp/onapp-cp-install/onapp-cp-install.sh

   See the installer options below for details.

   Expand
   title The full list of Control Panel installer options:
   Usage: Code Block /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]   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     -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

   You may wish to reboot your Control Panel server to take advantage of a new kernel if it is installed. It is not required immediately as a part of the upgrade process though.

    

7. In the OnApp UI navigate to Settings > Configuration and click Save to complete the process.