Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
 This section is the part of the OnApp installation procedure.
Install Control Panel Server  >  Install Compute Resources > Install Data Stores > Install Backup Server > Download and Configure Templates on Control Panel Server  > Configure Cloud

 

 



Info
  • Review the Preparation Guide to ensure that you have a suitable environment before starting the installation.
  • 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 
  • If you consider deploying High Availability Clusters, refer to OnApp Cloud Installation Guide for High Availability Clusters.If you're replacing an existing Control Panel with a new install, refer to Control Panel Migration Guide for instructions.

To install Control Panel server, perform the following procedure:

  1. Update your server:

    Code Block
    bash# yum update
  2. Download OnApp YUM repository file:

    Code Block
    # rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-4.1.noarch.rpm
  3. Install OnApp Control Panel installer package:

    Code Block
    bash#> yum install onapp-cp-install
  4. Anchor
    config
    config
     Set the custom Control Panel configuration. It is important to set the custom 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

     


    Anchor
    installer
    installer

  5. Run the Control Panel installer:

    Code Block
    bash#> /onapp/onapp-cp-install/onapp-cp-install.sh -i SNMP_TRAP_IPS
    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_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_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


     
      
    --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_PASSWDRabbitMQ/vCloud user password. The random password is generated if isn't specified.
    --vcdvhost  VCD_VHOSTRabbitMQ/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_PASSWDRabbitMQ manager password. The random password is generated if isn't specified.
      


    -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'.
    -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
  • Install Cloudboot dependencies:

    Note

    This step is optional: if you have Integrated Storage, take this step, otherwise skip it.

    Code Block
    bash#> yum install onapp-store-install
    bash#> /onapp/onapp-store-install/onapp-store-install.sh
  • 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's Users and Groups menu in the Control Panel.

     


    Note
    Once you have entered a license it can take up to 15 minutes to activate.
  • Restart the OnApp service:

    Code Block
    bash#> service onapp restart
  • After you have installed the Control Panel server, configure your Cloud Settings. See Configure Cloud for details. 



  •  

     

     This section is the part of the OnApp installation procedure.
    Install Control Panel Server  >  Install Compute Resources > Install Data Stores > Install Backup Server > Download and Configure Templates on Control Panel Server  > Configure Cloud