Modifying the route to the platform

The default IBM® Software Hub is a reencrypt route named cpd.

You can modify the route by:

  • Changing the hostname of the default route
  • Changing the default route from a re-encrypt route to a passthrough route
What permissions do you need to complete this task?
To complete this task, you must have one of the following roles:
  • Cluster administrator
  • Instance administrator
When do you need to complete this task.
This task is optional, but recommended. You should complete this task before you give users access to the IBM Software Hub platform.

If you installed multiple instances of IBM Software Hub on your cluster, complete this task for each instance.

Before you begin

The workstation from which you will run the commands must be set up as a client workstation with the following command-line interfaces:
  • IBM Software Hub CLI: cpd-cli
  • OpenShift® CLI: oc

For details, see: Setting up a client workstation to install IBM Software Hub.

About this task

This task covers how to change the hostname of the route. If you want to change the route from a passthrough route to a re-encrypt route, see Using a custom TLS certificate for HTTPS connections to the platform.

Procedure

  1. Log the cpd-cli in to the Red Hat OpenShift Container Platform cluster:
    ${CPDM_OC_LOGIN}
    Remember: CPDM_OC_LOGIN is an alias for the cpd-cli manage login-to-ocp command.
  2. Run the cpd-cli manage setup-route command.

    The command that you run depends on whether you want to change the hostname of the default route or whether you want to change the route type


    Changing the hostname of the route

    You must replace the following variables before you can run the command:

    <hostname>
    The hostname to use in the route.
    cpd-cli manage setup-route \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --custom_hostname=<hostname>

    Changing the type of the route
    cpd-cli manage setup-route \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --route_type=passthrough