8.9. Management Console
The OpenShift Enterprise Management Console is a web application that is installed on the broker host, and exposes the REST API. The Management Console interacts with OpenShift Enterprise through the REST API in a similar fashion to the client tools.
8.9.1. Installing the Management Console
This section describes how to install the Management Console on a broker host.
Procedure 8.22. To Install the OpenShift Enterprise Management Console:
- Install the required software package:
#
yum install openshift-origin-console - Modify the corresponding sample httpd configuration file located in the
/var/www/openshift/console/httpd/conf.ddirectory to suit the requirements of your authentication model. For example, useopenshift-origin-auth-remote-user-ldap.conf.sampleto replaceopenshift-origin-auth-remote-user.conf, and modify it as necessary to suit your authentication configuration. This is similar to what was done for broker authentication in the/var/www/openshift/broker/httpd/conf.d/directory. - Make the service persistent on boot, and start the service using the following commands:
#
chkconfig openshift-console on#service openshift-console start
After the Management Console is installed, configure the
SESSION_SECRET setting in the /etc/openshift/console.conf file, which is used for signing the Rails sessions. Run the following command to create the random string:
# openssl rand -hex 64Note
The
SESSION_SECRET must be the same across all consoles in a cluster, but does not necessarily need to be the same as the SESSION_SECRET used in /etc/openshift/broker.conf.
Important
Ensure that the
CONSOLE_SECURITY setting in the /etc/openshift/console.conf file has the default setting of remote_user. This is a requirement of OpenShift Enterprise and ensures proper HTTP authentication.
CONSOLE_SECURITY=remote_user
Restart the Management Console to apply your changes. This is required each time the
SESSION_SECRET setting is modified. Note that all sessions are dropped.
# service openshift-console restart
Access the Management Console from
https://broker.example.com/console using a web browser. Use the correct domain name according to your installation.
