Accessing the boot node and Red Hat OpenShift cluster

By using Secure Shell (SSH) public key authentication, you can access the boot node and the Red Hat® OpenShift® cluster nodes.

About this task

The Maximo® Application Suite deployment configures the Azure Bastion service to provide the SSH access to the Red Hat OpenShift cluster nodes.

  1. Go to resource group where the Red Hat OpenShift Container Platform cluster virtual machines are deployed, for example, masocp-<uniqustr>-rg.

    If you use the New OpenShift cluster (IPI) deployment mode, the resource group name format is masocp-<uniqustr>-rg. For the New OpenShift cluster, existing network (UPI) deployment mode, the resource group is the same as the one where existing network infrastructure is available, of which the VNet was provided at the time of deployment.

  2. Select the virtual machine to which you want to connect and choose to connect option on azure portal.
  3. Choose bastion option from the connect menu and it takes you to the page where you need to fill the details like username and SSH private key.
  4. Use the “core” username. You can either upload your private key from local machine or you can paste the content of private key on azure portal textbox.
  5. Press connect button. You are redirected to a new browser window where you can access the VM command line.

In the Azure cloud, when you start the Maximo Application Suite installation, a boot node is created. By using the required tools and the installation parameters, the boot node completes the installation.

In the Red Hat OpenShift cluster that is created during the installation. The boot node has the public IP address so it can be accessed directly from outside using SSH client. However, the Red Hat OpenShift cluster nodes are not assigned with the public IP address.

The boot node, and private cluster nodes are all Azure virtual machines. If you need to perform maintenance or troubleshooting tasks in a virtual machine, you can connect to it by using Azure Bastion service.

Before you installed Maximo Application Suite, you generated a key pair, which consists of a public key and a private key. You stored the private key locally. When you specified the installation parameters, you selected the public key in the sshKey parameter.

During the installation, a copy of the public key is stored in the boot node, and the private cluster nodes. Because you have the corresponding private key, you can access these instances by using SSH over Bastion service.

Procedure

Accessing the boot node and private cluster nodes

To use SSH access to connect to the boot node and the private cluster nodes, complete the following steps:

  1. In your Azure account, go to the Virtual machines service.
  2. Click the virtual machine that belongs to the Red Hat OpenShift cluster you have provisioned.
    • You can find the virtual machine based on the resource group name where the virtual machine is available. The resource group name will start with masocp-<unique-identifier>.
    • All the virtual machines are in the same resource group. In case of the IPI deployment mode, the resource group name format is masocp-<uniqustr>-rg. In case of UPI deployment mode, the resource group is the same as the one where existing network infrastructure is available, of which the VNet was provided at the time of deployment.
  3. Retrieve the node details.

    For bootnode

    1. To retrieve the boot node details, get the public IP address from Public IP address field displayed on the virtual machine’s Overview page.
    2. Perform the SSH from your workstation.
    ssh azureuser@<bootnode-public-ip-address>

    For Red Hat OpenShift cluster nodes

    1. Choose Bastion option from the Connect menu and it will take you to the page where you need to fill the details like Username and SSH private key.
    2. Use username as “core” and you can either upload your private key from local machine or you can paste the content of private key on azure portal text-box.
    3. Click the connect button and you will get redirected to a new browser window with a command shell to the Red Hat OpenShift cluster