Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Excerpt

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
    titleEdit 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
    titleThe 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_PASSWDMySQL password
    -d MYSQL_DBOnApp MySQL database name
    -u MYSQL_USERMySQL 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_PORTRedis 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_FIRSTNAMECP administrator first name
    -L ADMIN_LASTNAMECP administrator last name
    -E ADMIN_EMAILCP administrator e-mail
      
    -v ONAPP_VERSIONInstall custom OnApp CP version
    -i SNMP_TRAP_IPSIP addresses separated with coma for snmp to trap
    -c CONFIG_FILECustom installer configuration file. Otherwise, preinstalled one is used.
    -yupdate OS packages (except of OnApp provided) on the box with 'yum update'.
    -ado not be interactive. Process with automatic installation.
    -Ddo not make database dump, and make sure it is disabled in the cron and not running at the moment
    -hprint 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.