Installing ACD

Overview

1. Install the Merative ACD operator catalog: This will deploy the catalog from which the ACD operator can be installed.
2. Install the ACD operator: This will deploy the operator that can be used to install and manage your ACD instances.
3. Install one or more replicas of ACD by using the ACD operator.

Before you begin

• Plan for your installation, such as preparing for persistent storage, considering security options, and planning for performance and capacity.
• Purchase ACD to obtain your ACD registry credentials.
• Log in to verify ACD registry access.
• Set up your environment according to the prerequisites, including setting up your OpenShift Container Platform.
• Obtain the connection details for your OpenShift Container Platform cluster from your administrator.
• Set up your project and project dependencies if required for your environment.

Obtain ACD registry credentials

Verifying ACD registry access

docker login acdcontaineredition.azurecr.io --username <username>
Copy to clipboardCopied!

• where <username> is the user id provided to you for the ACD container registry.

docker pull acdcontaineredition.azurecr.io/acd-ce/merative-acd-operator-catalog:latest
Copy to clipboardCopied!

ACD registry pull secret

1. Added to the OpenShift global pull secrets for the entire cluster
2. Added to the ACD operand service account in the specific namespace where ACD runs

Option 1: OpenShift global pull secret installation

1. Use the RedHat OpenShift Container Platform web console and select Workloads -> Secrets in the openshift-config project.

2. Select the pull-secret object from the list of secrets.

3. Select Actions -> Edit Secret to bring up the secret editor for this secret.

4. Edit an existing credential for the ACD registry (acdcontainerregistry.azurecr.io) if it already exists or Select Add credentials at the bottom and fill in the new pull secret credentials using acdcontainerregistry.azurecr.io for the registry name.

   

1. Extract the current global image pull secret from the cluster into a file in the current directory named .dockerconfigjson

   oc extract secret/pull-secret --namespace openshift-config --to=.
   Copy to clipboardCopied!

2. Create a base64 encoded string with the ACD registry credentials, the user id (username) and password sent to you and verified above, as it aligns with your access method.

   printf "<username>:<password>" | base64
   Copy to clipboardCopied!

3. Edit the .dockerconfigjson file and ADD a new JSON object to the existing auths object with the credentials for the ACD registry. For example:

   "acdcontaineredition.azurecr.io": {
       "auth": "YjM3ODBhpaxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxmljVTk==",
       "email": "xxx@nomail.relay.merative.com"
   }
   Copy to clipboardCopied!

4. Update the global image pull secret with the updated credentials:

   oc set data secret/pull-secret --namespace openshift-config --from-file=.dockerconfigjson
   Copy to clipboardCopied!

5. Monitor the node status using the command:

   oc get nodes
   Copy to clipboardCopied!

6. When the nodes are finished restarting, your cluster is now ready to pull images from the ACD registry.

Option 2: Service account pull secret installation

1. Create a secret

   kubectl create secret docker-registry acd-registry-credentials \
       --docker-server=acdcontaineredition.azurecr.io \
       --docker-username=<username> \
       --docker-password=<password> \
       --docker-email=<email_address> \
       --namespace=${acd_namespace}
   Copy to clipboardCopied!

   • <username> is the user id for accessing the ACD container registry
   • <password> is the password for accessing the ACD container registry

2. After the ACD operand has been installed, the service account must be patched to point to the secret.

   NOTE: If using the current release of the ACD Container Edition, this acd-registry-credentials pull secret is already defined in the operand service account so the patch step is no longer necessary.

   kubectl patch serviceaccount merative-acd-operand \
       --namespace ${acd_namespace} \
       --patch '{"imagePullSecrets": [{"name": "acd-registry-credentials"}]}'
   Copy to clipboardCopied!

3. Then the ACD operand pods must be restarted

   kubectl delete pods \
       --namespace ${acd_namespace} \
       --all
   Copy to clipboardCopied!

Installing the Merative ACD operator catalog

1. Create a file for the ACD operator catalog source with the following content, and save as ACDCatalogSource.yaml:

   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
      name: merative-acd-operator-catalog
      namespace: openshift-marketplace
   spec:
      displayName: "ACD Operator Catalog"
      publisher: Merative
      sourceType: grpc
   Copy to clipboardCopied!

2. Log in to your Red Hat OpenShift Container Platform as a cluster administrator by using the oc CLI.

3. Create the source by using the following command:

   oc create -f ACDCatalogSource.yaml
   Copy to clipboardCopied!

Installing the ACD operator

Install the ACD operator using the web console

1. Log in to the OpenShift Container Platform web console using your login credentials.
2. Expand the Operators dropdown and select OperatorHub to open the OperatorHub dashboard.
3. Select the project you want to use as the target namespace for your ACD deployment.
4. In the All Items search box enter ACD to locate the operator title.
5. Click the Merative ACD tile to open the install side panel.
6. Click the Install button to open the Create Operator Subscription dashboard.
7. Select the chosen installation mode that suits your requirements. If the installation mode is A specific namespace on the cluster, select the target namespace you created previously.
8. Select the approval strategy that suits your requirements. If set to Automatic, the Subscription resource uses Operator Lifecycle Manager (OLM) to manage and upgrade the operator to ensure that the latest version is always running in the cluster. With Manual approval set, a project administrator must manually approve the install plan to enable the upgrade. See the upgrading section for more details.
9. Click Install to begin the installation.

Installing the ACD service

Install the ACD service by using the web console

1. Log in to the OpenShift Container Platform web console using your login credentials.
2. Expand the Operators dropdown and select Installed Operators to open the Installed Operators page.
3. Expand the Project dropdown and select the project the operator is installed in. Select the Annotator for Clinical Data operator link in the Name column. If the operator is not shown, it is either not installed or not available for the selected namespace.
4. In the Operator Details dashboard, click the Annotator for Clinical Data tab.
5. Click the Create Acd button to open the Create Acd panel. You can use this panel to define an Acd custom resource.
   • From here, you can install by using the Form view. For more advanced configurations or to install an instance using default configuration, see installing by using the YAML view.