7.2. Configuring Yum on Broker Hosts

Procedure 7.3. To Configure Yum on Broker Hosts:

1. Install the latest openshift-enterprise-release package:

   # yum install openshift-enterprise-release

   Copy to Clipboard Toggle word wrap
2. Run the oo-admin-yum-validator command with the -o option for version 2.2 and the -r option for the broker role. This reports the first detected set of problems, provides a set of proposed changes, and halts.

   Example 7.3. Detecting Problems

   # oo-admin-yum-validator -o 2.2 -r broker
   				
   Please note: --role=broker implicitly enables --role=client to ensure /usr/bin/rhc is available for testing and troubleshooting.
   Detected OpenShift Enterprise repository subscription managed by Red Hat Subscription Manager.
   
   The required OpenShift Enterprise repositories are disabled:
       rhel-server-rhscl-6-rpms
       rhel-6-server-ose-2.2-rhc-rpms
       rhel-6-server-rpms
   Enable these repositories by running these commands:
   # subscription-manager repos --enable=rhel-server-rhscl-6-rpms
   # subscription-manager repos --enable=rhel-6-server-ose-2.2-rhc-rpms
   # subscription-manager repos --enable=rhel-6-server-rpms
   Please re-run this tool after making any recommended repairs to this system

   Copy to Clipboard Toggle word wrap
   Alternatively, use the --report-all option to report all detected problems.

   # oo-admin-yum-validator -o 2.2 -r broker --report-all

   Copy to Clipboard Toggle word wrap
3. After reviewing the reported problems and their proposed changes, either fix them manually or let the tool attempt to fix the first set of problems using the same command with the --fix option. This may require several repeats of steps 2 and 3.

   Example 7.4. Fixing Problems

   # oo-admin-yum-validator -o 2.2 -r broker --fix
   
   Please note: --role=broker implicitly enables --role=client to ensure /usr/bin/rhc is available for testing and troubleshooting.
   Detected OpenShift Enterprise repository subscription managed by Red Hat Subscription Manager.
   
   Enabled repository rhel-server-rhscl-6-rpms
   Enabled repository rhel-6-server-ose-2.2-rhc-rpms
   Enabled repository rhel-6-server-rpms

   Copy to Clipboard Toggle word wrap
   Alternatively, use the --fix-all option to allow the tool to attempt to fix all of the problems that are found.

   # oo-admin-yum-validator -o 2.2 -r broker --fix-all

   Copy to Clipboard Toggle word wrap

   Note

   If the host is using Red Hat Network (RHN) Classic, the --fix and --fix-all options do not automatically enable any missing OpenShift Enterprise channels as they do when the host is using Red Hat Subscription Management. Enable the recommended channels with the rhn-channel command. Replace repo-id in the following command with the repository ID reported in the oo-admin-yum-validator command output.

   # rhn-channel -a -c repo-id

   Copy to Clipboard Toggle word wrap

   Important

   For either subscription method, the --fix and --fix-all options do not automatically install any packages. The tool reports if any manual steps are required.
4. Repeat steps 2 and 3 until the oo-admin-yum-validator command displays the following message.

   No problems could be detected!

   Copy to Clipboard Toggle word wrap