Setting up a remote physical location for IBM Software Hub

Important: You must purchase IBM® Software Hub Premium to use remote physical locations and data planes.

You can expand your IBM Software Hub deployment by installing IBM Software Hub agents on a remote cluster.

In a typical installation, IBM Software Hub runs in a set of projects (namespaces) on a single Red Hat® OpenShift® Container Platform cluster. You can use remote physical locations to expand your IBM Software Hub deployment to a remote cluster by installing IBM Software Hub agents on the remote cluster.

Who needs to complete this task?

Cluster administrator A cluster administrator must complete this task.

When do you need to complete this task?

Repeat as needed If you want to set up multiple physical locations, you can repeat this task for each physical location.

Before you begin

Before you set up a remote physical location, review the following topics:

This task assumes that the following prerequisites are met:

Prerequisite Where to find more information
You have an existing IBM Software Hub instance that you want to expand to remote clusters.

This instance is the hub.

If this task is not complete, see Installing IBM Software Hub.
You have your platform API key for the instance of IBM Software Hub that you want to expand to remote clusters.

The API key must be associated with a user who has the Manage physical locations permission on the instance.

If this task is not complete, see Generating API keys for authentication.
You have an existing remote Red Hat OpenShift Container Platform cluster where you plan to create the remote physical locations. If this task is not complete, see Installing Red Hat OpenShift Container Platform for IBM Software Hub.
Storage is configured on the remote Red Hat OpenShift Container Platform cluster where you plan to create the remote physical locations. If this task is not complete, see:
  1. Installing persistent storage for IBM Software Hub
  2. Configuring persistent storage for IBM Software Hub
The workstation from which you will run the remote physical location setup is a client workstation and has the following command-line interfaces:
  • IBM Software Hub CLI: cpd-cli
  • OpenShift CLI: oc
If this task is not complete, see Setting up a client workstation to install IBM Software Hub.
If your cluster is in a restricted network, you have the required CASE packages on the client workstation. If this task is not complete, see Downloading CASE packages before running IBM Software Hub installation commands in a restricted network.

Procedure

Complete the following tasks to set up a remote physical location: