Remote physical locations

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

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

A remote physical location is processing infrastructure on a remote cluster. When you set up a remote physical location, you install IBM Software Hub agents on a remote cluster.

After you set up a remote physical location, you can register the physical location with the instance of IBM Software Hub that you want to expand. Then, you can add the physical location to a data plane. A data plane is a logical grouping of one or more physical locations. Users can deploy workloads to a data plane. The workload will be scheduled on one of the physical locations associated with the data plane.

Services that support remote physical locations

You can create service instances on remote physical locations for the following services:

  • Analytics Engine powered by Apache Spark
    Restriction: If you want to create Analytics Engine powered by Apache Spark instances on remote physical locations, you cannot use job interface in Analytics Engine powered by Apache Spark. You must set sparkAdvEnabled to false. For more information about this setting, see Specifying additional configurations for Analytics Engine powered by Apache Spark.
  • DataStage
  • Orchestration Pipelines

    Tech preview This feature is supported as a technical preview.

Supported project (namespace) configurations for remote physical locations

To use a cluster as a remote physical location, you must create the following projects:

Projects for shared cluster components
The shared cluster components are installed exactly once on the cluster and are shared by all remote physical locations on the cluster. Each component is installed in its own project, and no other software should be installed in the project.

The following table provides the default project name and the environment variable that is used to identify the project in commands throughout the documentation. You are not required to use the default project names. The default names are used only if you don't specify a project name when you install the components.

Component Default project name Environment variable
IBM Certificate manager ibm-cert-manager ${REMOTE_PROJECT_CERT_MANAGER}
License Service ibm-licensing ${REMOTE_PROJECT_LICENSE_SERVICE}
Scheduling service No default. ${REMOTE_PROJECT_SCHEDULING_SERVICE}

For more information about these components, see Shared components.

Projects for the remote physical location
A remote physical location is comprised of two Red Hat OpenShift Container Platform projects:
Management project
The project on the remote cluster where you want to install the required agents, operators, and custom resources.

After you create the remote physical location, any service instances that are created on the physical location are created in the management project.

In the remote physical location setup commands, the ${REMOTE_PROJECT_MANAGEMENT} environment variable refers to the management project.

Each remote physical location has its own management project.

Workload project
The project on the remote cluster where you want to run workloads.

In the remote physical location setup commands, the ${REMOTE_PROJECT_WORKLOAD} environment variable refers to the workload project.

Each remote physical location has its own workload project.

Architecture of remote physical locations

You can have multiple remote physical locations on a remote cluster.

The following diagram shows a remote cluster with the shared cluster components and four remote physical locations.
  • The software in the Certificate manager project (ibm-cert-manager) manages the certificates for the License Service.
  • The software in the License Service project (ibm-licensing) monitors the VPC use for each remote physical location.
  • The software in the scheduling service project (ibm-cpd-scheduler)
The architectural diagram is described in the preceding text.
The following diagram provides more details about the projects that are associated with a remote physical location.
  • Each remote physical location is comprised of two projects: a management project and a workload project.
  • The software in the management project for the remote physical location manages the workloads in the workload project for the instance.

    For example, the agents and operators in the physical-location-management-1 project manage the workloads in the physical-location-workload-1.

The architectural diagram is described in the preceding text.

Each remote physical location can communicate with exactly one instance of IBM Software Hub. However, an instance of IBM Software Hub can connect to multiple remote physical locations, as shown in the following diagram:

An architectural diagram that shows the primary instance of IBM Software Hub (also called the hub) connecting to three remote physical locations.

If you have multiple remote physical locations on a remote cluster, each remote physical location can communicate with different instances of IBM Software Hub.

Organizing remote physical locations with data planes

After you register a physical location with an instance of IBM Software Hub, you can add the remote physical location to a data plane.

A data plane is a logical grouping of one or more physical locations. Users can create services instances on a data plane, and the instance is created on one of the physical locations associated with the data plane.

Important: Users cannot schedule workloads directly on a remote physical location. The remote physical location must be added to a data plane and the remote physical location must be enabled so that the scheduling service can schedule workloads on the physical location.

The following diagram shows examples of how you can use data planes to organize remote physical locations into logical groups.

The architectural diagram is described in the following text.

In this example, the primary instance of IBM Software Hub (the hub) has three data planes.

Data plane 1
This data plane is for workloads that require GPUs.

The data plane contains four remote physical locations. Each remote physical location has between 2 and 4 GPUs. Each remote physical location is located in a different country.

Data plane 2
This data plane is for workloads that must be processed in the European Union.

The data plane contains two remote physical locations. Both physical locations are in countries that are part of the European Union.

Data plane 3
This data plane is for workloads that exceed the available vCPU and memory on the hub.

The data plane contains two remote physical locations. One of the remote physical locations has lower priority, so the scheduling service will schedule workloads on that remote physical location only if it cannot schedule the workload on the remote physical location with higher priority.