Jump To Close Expand all Collapse all Table of contents Deployment Guide 1. Introduction to OpenShift Enterprise Expand section "1. Introduction to OpenShift Enterprise" Collapse section "1. Introduction to OpenShift Enterprise" 1.1. Product Features 1.2. What's New in Current Release 2. Prerequisites Expand section "2. Prerequisites" Collapse section "2. Prerequisites" 2.1. Supported Operating Systems 2.2. Hardware Requirements 2.3. Red Hat Subscription Requirements 3. Architecture Expand section "3. Architecture" Collapse section "3. Architecture" 3.1. Communication Mechanisms 3.2. State Management 3.3. Redundancy 3.4. Security 4. Upgrading from Previous Versions Expand section "4. Upgrading from Previous Versions" Collapse section "4. Upgrading from Previous Versions" 4.1. Upgrade Tool 4.2. Preparing for an Upgrade 4.3. Upgrading from OpenShift Enterprise 1.2 to OpenShift Enterprise 2.0 4.4. Upgrading from OpenShift Enterprise 2.0 to OpenShift Enterprise 2.1 4.5. Upgrading from OpenShift Enterprise 2.1 to OpenShift Enterprise 2.2 5. Host Preparation Expand section "5. Host Preparation" Collapse section "5. Host Preparation" 5.1. Default umask Setting 5.2. Network Access Expand section "5.2. Network Access" Collapse section "5.2. Network Access" 5.2.1. Custom and External Firewalls 5.2.2. Manually Configuring an iptables Firewall 5.2.3. IPv6 Tolerance 5.3. Configuring Time Synchronization 5.4. Enabling Remote Administration 6. Deployment Methods Expand section "6. Deployment Methods" Collapse section "6. Deployment Methods" 6.1. Using the Installation Utility 6.2. Using the Installation Scripts Expand section "6.2. Using the Installation Scripts" Collapse section "6.2. Using the Installation Scripts" 6.2.1. Selecting Components to Install 6.2.2. Selecting a Package Source 6.2.3. Selecting Password Options 6.2.4. Setting Broker and Supporting Service Parameters 6.2.5. Setting Node Parameters 6.2.6. Deploying Sample Broker and Node Hosts Using openshift.sh 6.2.7. Performing Required Post-Deployment Tasks 6.3. Using the Sample Deployment Steps Expand section "6.3. Using the Sample Deployment Steps" Collapse section "6.3. Using the Sample Deployment Steps" 6.3.1. Service Parameters 6.3.2. DNS Information 7. Manually Installing and Configuring a Broker Host Expand section "7. Manually Installing and Configuring a Broker Host" Collapse section "7. Manually Installing and Configuring a Broker Host" 7.1. Configuring Broker Host Entitlements Expand section "7.1. Configuring Broker Host Entitlements" Collapse section "7.1. Configuring Broker Host Entitlements" 7.1.1. Using Red Hat Subscription Management on Broker Hosts 7.1.2. Using Red Hat Network Classic on Broker Hosts 7.2. Configuring Yum on Broker Hosts 7.3. Installing and Configuring BIND and DNS Expand section "7.3. Installing and Configuring BIND and DNS" Collapse section "7.3. Installing and Configuring BIND and DNS" 7.3.1. Installing BIND and DNS Packages 7.3.2. Configuring BIND and DNS 7.3.3. Verifying the BIND Configuration 7.4. Configuring DHCP and Host Name Resolution Expand section "7.4. Configuring DHCP and Host Name Resolution" Collapse section "7.4. Configuring DHCP and Host Name Resolution" 7.4.1. Configuring the DHCP Client on the Broker Host 7.4.2. Verifying the DHCP Configuration 7.5. Installing and Configuring MongoDB Expand section "7.5. Installing and Configuring MongoDB" Collapse section "7.5. Installing and Configuring MongoDB" 7.5.1. Installing MongoDB 7.5.2. Configuring MongoDB 7.5.3. Configuring MongoDB User Accounts 7.6. Installing and Configuring ActiveMQ Expand section "7.6. Installing and Configuring ActiveMQ" Collapse section "7.6. Installing and Configuring ActiveMQ" 7.6.1. Installing ActiveMQ 7.6.2. Configuring ActiveMQ 7.6.3. Verifying the ActiveMQ Configuration 7.7. Installing and Configuring MCollective Client Expand section "7.7. Installing and Configuring MCollective Client" Collapse section "7.7. Installing and Configuring MCollective Client" 7.7.1. Installing MCollective Client 7.7.2. Configuring MCollective Client 7.8. Installing and Configuring the Broker Application Expand section "7.8. Installing and Configuring the Broker Application" Collapse section "7.8. Installing and Configuring the Broker Application" 7.8.1. Installing the Broker Application 7.8.2. Setting Ownership and Permissions for MCollective Client Configuration File 7.8.3. Modifying Broker Proxy Configuration 7.8.4. Configuring the Required Services 7.8.5. Configuring the Standard SELinux Boolean Variables 7.8.6. Configuring the Broker Domain 7.8.7. Configuring the Broker Datastore 7.8.8. Configuring the Broker Plug-ins 7.8.9. Configuring OpenShift Enterprise Authentication 7.8.10. Configuring Bundler 7.8.11. Verifying the Broker Configuration 8. Continuing Broker Host Installation for Enterprise Expand section "8. Continuing Broker Host Installation for Enterprise" Collapse section "8. Continuing Broker Host Installation for Enterprise" 8.1. Installing and Configuring DNS Plug-ins Expand section "8.1. Installing and Configuring DNS Plug-ins" Collapse section "8.1. Installing and Configuring DNS Plug-ins" 8.1.1. Installing and Configuring the Fog DNS Plug-in 8.1.2. Installing and Configuring the DYN® DNS Plug-in 8.1.3. Configuring the nsupdate DNS Plug-in for Compatible DNS Services 8.2. Configuring User Authentication for the Broker Expand section "8.2. Configuring User Authentication for the Broker" Collapse section "8.2. Configuring User Authentication for the Broker" 8.2.1. Authenticating Using htpasswd 8.2.2. Authenticating Using LDAP 8.2.3. Authenticating Using Kerberos 8.2.4. Authenticating Using Mutual SSL 8.2.5. Integrating Active Directory Authentication with Identity Management 8.3. Separating Broker Components by Host Expand section "8.3. Separating Broker Components by Host" Collapse section "8.3. Separating Broker Components by Host" 8.3.1. BIND and DNS 8.3.2. MongoDB 8.4. Configuring Redundancy Expand section "8.4. Configuring Redundancy" Collapse section "8.4. Configuring Redundancy" 8.4.1. BIND and DNS 8.4.2. Authentication 8.4.3. MongoDB 8.4.4. ActiveMQ 8.4.5. Broker Web Application 8.5. Installing and Configuring the Gear Placement Plug-in Expand section "8.5. Installing and Configuring the Gear Placement Plug-in" Collapse section "8.5. Installing and Configuring the Gear Placement Plug-in" 8.5.1. Developing and Implementing a Custom Gear Placement Algorithm 8.5.2. Example Gear Placement Algorithms 8.6. Using an External Routing Layer for High-Availability Applications Expand section "8.6. Using an External Routing Layer for High-Availability Applications" Collapse section "8.6. Using an External Routing Layer for High-Availability Applications" 8.6.1. Selecting an External Routing Solution 8.6.2. Configuring the Sample Routing Plug-In 8.6.3. Configuring a Routing Daemon or Listener 8.6.4. Enabling Support for High-Availability Applications 8.7. Integrating with External Single Sign-on (SSO) Providers 8.8. Backing Up Broker Host Files 8.9. Management Console Expand section "8.9. Management Console" Collapse section "8.9. Management Console" 8.9.1. Installing the Management Console 8.9.2. Creating an SSL Certificate 8.10. Administration Console Expand section "8.10. Administration Console" Collapse section "8.10. Administration Console" 8.10.1. Installing the Administration Console 8.10.2. Accessing the Administration Console 8.10.3. Configuring Authentication for the Administration Console 8.11. Clearing Broker and Management Console Application Cache 9. Manually Installing and Configuring Node Hosts Expand section "9. Manually Installing and Configuring Node Hosts" Collapse section "9. Manually Installing and Configuring Node Hosts" 9.1. Configuring Node Host Entitlements Expand section "9.1. Configuring Node Host Entitlements" Collapse section "9.1. Configuring Node Host Entitlements" 9.1.1. Using Red Hat Subscription Management on Node Hosts 9.1.2. Using Red Hat Network Classic on Node Hosts 9.2. Configuring Yum on Node Hosts 9.3. Creating a Node DNS Record 9.4. Configuring Node Host Name Resolution 9.5. Configuring the Node Host DHCP and Host Name 9.6. Installing the Core Node Host Packages 9.7. Installing and Configuring MCollective on Node Hosts Expand section "9.7. Installing and Configuring MCollective on Node Hosts" Collapse section "9.7. Installing and Configuring MCollective on Node Hosts" 9.7.1. Facter 9.8. Installing Cartridges Expand section "9.8. Installing Cartridges" Collapse section "9.8. Installing Cartridges" 9.8.1. Installing Web Cartridges 9.8.2. Installing Add-on Cartridges 9.8.3. Installing Cartridge Dependency Metapackages 9.9. Configuring SSH Keys on the Node Host 9.10. Configuring Required Services on Node Hosts Expand section "9.10. Configuring Required Services on Node Hosts" Collapse section "9.10. Configuring Required Services on Node Hosts" 9.10.1. Configuring PAM 9.10.2. Configuring Cgroups 9.10.3. Configuring Disk Quotas 9.10.4. Configuring SELinux 9.10.5. Configuring System Control Settings 9.10.6. Configuring Secure Shell Access 9.10.7. Configuring the Port Proxy 9.10.8. Configuring Node Settings 9.10.9. Updating the Facter Database 9.11. Enabling Network Isolation for Gears 9.12. Configuring Node Hosts for xPaaS Cartridges 9.13. Configuring Gear Profiles (Sizes) Expand section "9.13. Configuring Gear Profiles (Sizes)" Collapse section "9.13. Configuring Gear Profiles (Sizes)" 9.13.1. Adding or Modifying Gear Profiles 9.14. Configuring Districts Expand section "9.14. Configuring Districts" Collapse section "9.14. Configuring Districts" 9.14.1. Creating a District 9.14.2. Viewing a District 9.15. Importing Cartridges 10. Continuing Node Host Installation for Enterprise Expand section "10. Continuing Node Host Installation for Enterprise" Collapse section "10. Continuing Node Host Installation for Enterprise" 10.1. Front-End Server Proxies Expand section "10.1. Front-End Server Proxies" Collapse section "10.1. Front-End Server Proxies" 10.1.1. Configuring Front-end Server Plug-ins 10.1.2. Installing and Configuring the HTTP Proxy Plug-in 10.1.3. Installing and Configuring the SNI Proxy Plug-in 10.1.4. Installing and Configuring the Websocket Proxy Plug-in 10.1.5. Installing and Configuring the iptables Proxy Plug-in 10.2. Enabling Seamless Gear Migration with Node Host SSH Keys Expand section "10.2. Enabling Seamless Gear Migration with Node Host SSH Keys" Collapse section "10.2. Enabling Seamless Gear Migration with Node Host SSH Keys" 10.2.1. rsync Keys 10.2.2. SSH Host Keys 10.3. SSL Certificates Expand section "10.3. SSL Certificates" Collapse section "10.3. SSL Certificates" 10.3.1. Creating a Matching Certificate 10.3.2. Creating a Properly Signed Certificate 10.3.3. Reusing the Certificate 10.4. Idling and Overcommitment Expand section "10.4. Idling and Overcommitment" Collapse section "10.4. Idling and Overcommitment" 10.4.1. Manually Idling a Gear 10.4.2. Automated Gear Idling 10.4.3. Automatically Restoring Idled Gears 10.5. Backing Up Node Host Files 11. Testing an OpenShift Enterprise Deployment Expand section "11. Testing an OpenShift Enterprise Deployment" Collapse section "11. Testing an OpenShift Enterprise Deployment" 11.1. Testing the MCollective Configuration 11.2. Testing Clock Skew 11.3. Testing the BIND and DNS Configuration 11.4. Testing the MongoDB Configuration 12. Configuring a Developer Workstation Expand section "12. Configuring a Developer Workstation" Collapse section "12. Configuring a Developer Workstation" 12.1. Configuring Workstation Entitlements 12.2. Creating a User Account 12.3. Installing and Configuring the Client Tools 12.4. Configuring DNS on the Workstation 12.5. Configuring the Client Tools on a Workstation 12.6. Using Multiple OpenShift Configuration Files 12.7. Switching Between Multiple OpenShift Environments 12.8. Creating a Domain and Application 13. OpenShift Enterprise by Red Hat Offline Developer Virtual Machine Image Expand section "13. OpenShift Enterprise by Red Hat Offline Developer Virtual Machine Image" Collapse section "13. OpenShift Enterprise by Red Hat Offline Developer Virtual Machine Image" 13.1. Downloading the Image 13.2. Using the Image 14. Customizing OpenShift Enterprise Expand section "14. Customizing OpenShift Enterprise" Collapse section "14. Customizing OpenShift Enterprise" 14.1. Creating Custom Application Templates 14.2. Customizing the Management Console 14.3. Configuring the Logout Destination 15. Asynchronous Errata Updates Expand section "15. Asynchronous Errata Updates" Collapse section "15. Asynchronous Errata Updates" 15.1. Applying Asynchronous Errata Updates A. Revision History Legal Notice Settings Close Language: English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Language and Page Formatting Options Language: English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF 7.4.2. Verifying the DHCP Configuration Run the following command to verify the host name of the broker host: # hostname Previous Next