Upgrade the Management Console

This topic describes how to upgrade the Management Console.

Prerequisites

To upgrade the Eucalyptus Management Console

  1. Stop the eucaconsole service, if running:
    systemctl stop eucaconsole.service
  2. Run the following command to install the new Eucalyptus Management Console repository:
    yum install http://downloads.eucalyptus.cloud/software/eucalyptus/4.4/rhel/7/x86_64/eucalyptus-release-4.4-2.8.as.el7.noarch.rpm
  3. Upgrade eucaconsole:
    yum upgrade eucaconsole
  4. Uncomment the 'listen' directive and uncomment/modify the SSL certificate paths in /etc/nginx/nginx.conf (search for "SSL configuration"). For example:
    # SSL configuration
    # SSL configuration
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    listen 443 ssl;
    ssl_certificate <path to euca console cert file>;
    #EXAMPLE: 
    #ssl_certificate /etc/eucaconsole/console.crt;
    ssl_certificate_key <path to euca console key file>;
    #EXAMPLE: 
    #ssl_certificate_key /etc/eucaconsole/console.key;
    
    # end of SSL configuration
    Note: Self-signing certificates are automatically generated by default. To change this to use your own certificates, see Run the Management Console on nginx.
  5. Edit the /etc/eucaconsole/console.ini file:
    1. Locate the session.secure = parameter and change its value from false to true, per this example:
      session.secure = true
      Note: If HTTPS is used, meaning Nginx is configured to use port 443, the session.secure setting must equal true.
    2. (Optional) Locate the [server:main] section. By default, the host is set securely to 127.0.0.1, which means the console only communicates with Nginx on the same host. If you change the host setting to 0.0.0.0, connections are accepted from anywhere.
      [server:main]
      use = egg:gunicorn#main
      host = 127.0.0.1
      port = 8888
  6. Start eucaconsole using the following command:
    systemctl start eucaconsole.service
    Note: This command starts Nginx automatically. There is no need to run Nginx manually.
    Your upgrade is now complete.
  7. You may now access your Management Console by pointing your web browser to the IP address for your console: https://yourconsole_ip_address
x