Editing the endpoint mapping and namespace mapping for an operator collection

Procedure

1. Log in to the z/OS Cloud Broker instance that contains the operator collection you need to edit the z/OS endpoint mapping and namespace mapping for. (See Logging in to z/OS Cloud Broker.)

2. In the z/OS Cloud Broker navigation pane, select Manage operator collections.

   

3. In the Configure collections section of the "Configure operator collections" page, select the operator you wish to edit the endpoint mapping and namespace mapping for.

   

4. Select Edit on the "Suboperator configuration" page.

   

5. On the Upload SSH key tab, select one or more z/OS endpoints that you want to modify for this operator collection.

   
   Note: If you need to add a new endpoint, see Define a z/OS® endpoint. If you need to update an existing endpoint you are already mapped to, see Updating z/OS endpoints in z/OS Cloud Broker.

6. If needed, update your credentials for the z/OS endpoints, do one of the following:

   Important: The credential type cannot be changed. To modify it, it is recommended to delete the current mapping configuration and create a new one.

   • If Shared credentials are used, the same credentials are used across all suboperators. You can update the SSH key by completing the following steps:

     1. Click Add key and select a new SSH private key for connecting to the z/OS endpoints you are mapping your operator collection to. If you do not already have an SSH key for z/OS, see Creating SSH keys for IBM z/OS Cloud Broker.
        
        

     2. In the SSH key username field, enter the z/OS username this key has been authorized to be used with.
        
        

     3. If you entered a passphrase during SSH key generation, select Yes under the Provide a SSH key passphrase (optional) field and enter the passphrase.
        
        

     4. Select Test SSH key.
        
        

        If the SSH test is successful, a success message is displayed.

     5. If needed, select one or more z/OS endpoints and click Remove credentials to remove the uploaded credentials.

   • If Personal credentials are used, each user who creates an instance of the suboperator will provide their personal credentials. No action is needed.

   Note: If Shared credentials are used, auditing can be performed in Openshift to track which user created each instance. If Personal credentials are used, auditing can be performed on the z/OS LPAR. Access can be managed by z/OS sysadmins, instead of using RBAC in Openshift, by granting or denying permissions to various resources via each user's personal ID. If a user attempts to install ZPM without the necessary permissions on z/OS, the instance creation will fail.

7. Select Next.

8. On the Select operator base image version tab, from the Version drop-down list, select the operator base image version for executing this operator collection.

   

9. Select Next.

10. On the Select namespace(s) tab, modify the namespace mapping for the credential verified z/OS endpoints by completing the following steps:
    
    

    1. Select the z/OS endpoints you want to modify.

    2. Click Remove namespace(s) to remove the namespaces for the selected z/OS endpoints.

    3. Select one or more namespaces.
       
       

    4. Click Add namespace(s) and the selected namespaces are displayed. You can expand the table for a detailed view of the selected namespaces.
       
       

    Note: At least one namespace should be added to each z/OS endpoint. To prevent mapping failures, avoid mapping the operator collection to a target namespace if it has already been mapped to by an operator from another namespace.

11. Click Next.

12. Review the mapping details on the Review and confirm tab and then select Submit.

    

    If the configuration is successful, a success message is displayed.

    

Procedure results

The operator collection is mapped to the newly selected z/OS endpoints across the newly specified namespaces and is listed in the Configure collections section on the "Configure operator collections" page.

You can verify your changes by selecting the operator you have updated.