Modifying the route to the platform

Important: IBM Cloud Pak® for Data Version 4.6 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.

Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.6 reaches end of support. For more information, see Upgrading IBM Software Hub in the IBM Software Hub Version 5.1 documentation.

The default Cloud Pak for Data 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:

Red Hat® OpenShift® Container Platform cluster administrator
Red Hat OpenShift Container Platform project administrator on the project where Cloud Pak for Data is installed

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 Cloud Pak for Data platform.

If you installed multiple instances of Cloud Pak for Data 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:

Cloud Pak for Data CLI: cpd-cli
OpenShift CLI: oc

For details, see: Setting up a client workstation.

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

Run the cpd-cli manage login-to-ocp command to log in to the cluster as a user with sufficient permissions to complete this task. For example:
```
cpd-cli manage login-to-ocp \
--username=${OCP_USERNAME} \
--password=${OCP_PASSWORD} \
--server=${OCP_URL}
```
Tip: The login-to-ocp command takes the same input as the oc login command. Run oc login --help for details.
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_INSTANCE} \
--custom_hostname=<hostname>
```
Changing the type of the route
```
cpd-cli manage setup-route \
--cpd_instance_ns=${PROJECT_CPD_INSTANCE} \
--route_type=passthrough
```