Specifying a different OpenShift server hostname

This recipe talks about how you can configure a different OpenShift server hostname. By default, when you set up your OpenShift account using the rhc setup command, rhc is configured to work with the public OpenShift PaaS hosted at openshift.redhat.com. However, it is possible to use a different OpenShift installation, which can be either an OpenShift Enterprise or an OpenShift Origin installation.

Getting ready

To step through this recipe, you will need to have rhc installed on your machine. Refer to the Installing the OpenShift rhc command-line client recipe for instructions.

How to do it…

Open a command-line terminal and run the following command to use a different OpenShift server hostname:

$ rhc setup --server <My OpenShift Installation Hostname>

Replace <My OpenShift Installation Hostname> with the OpenShift server hostname.

How it works…

The rhc setup command takes an option, --server, which allows a user to specify the server hostname. When you run the rhc setup command with the new server location, the setup command will perform all the actions required to configure your OpenShift account to work with the new server. The setup command will overwrite the express.conf file in ~/.openshift with the new server hostname. The rhc client will get configured to work with the new OpenShift server.

There's more…

You can also configure the server by directly editing the express.conf file at ~/.openshift/express.conf. The libra_server property is as follows:

# The OpenShift server to connect to
libra_server=openshift.redhat.com

Change the preceding code to a new server hostname:

# The OpenShift server to connect to
libra_server=<Your OpenShift Installation>

See also

• The Setting up an OpenShift account using rhc recipe
• The Viewing the account details using rhc recipe