Installing Helm charts in the OpenShift console

Use the OpenShift® console to configure the Helm chart repository for your cluster and install the operators that your deployment scenario requires.

Before you begin

Before you begin, determine which operators you need for your deployment scenario. For an overview of the available operators, installation order, and installation methods, see Installing operators using Helm charts.

Tip: If you have an existing traditional Content Platform Engine deployment, you can add the Content Cortex AI Services operator without redeploying your environment.

About this task

Use the OpenShift console to add the Helm chart repository and install the operators that your deployment requires.

  • For a new IBM® Content Cortex container deployment, complete all operator installation steps in the order that is mentioned in the procedure.
  • For an existing traditional Content Platform Engine deployment, add the Helm chart repository and then install the Content Cortex AI Services operator and the required supporting operators.

Procedure

  1. From the command line on a system that can access your cluster, create a YAML file for the HelmChartRepository resource.

    You need cluster administrator privileges to create and apply the HelmChartRepository resource on the cluster.

    Use content similar to the following example for your environment:

    apiVersion: helm.openshift.io/v1beta1
    kind: HelmChartRepository
    metadata:
      name: ibm-content-cortex
    spec:
      connectionConfig:
        url: 'https://ibm-ecm.github.io/ibm-content-cortex-containers'
      name: IBM Content Cortex
  2. Review the repository information in the YAML file and update it only if your environment requires a different value.
  3. Apply the HelmChartRepository resource to the cluster.
    oc apply -f helmchartrepo-content-cortex.yaml
  4. Verify that the Helm chart repository is added to the cluster.
    oc get helmchartrepository content-cortex
    The Helm chart repository is available for the cluster.
  5. From the OpenShift console, access the Helm charts.
    Click Helm > Releases > Create Helm Release.
    The Helm chart catalog opens.
  6. Install the Content Cortex operator.
    Install the Content Cortex operator only for a new container deployment. If you have an existing traditional Content Platform Engine deployment, skip this step. Select IBM Content Cortex, click Install Helm Chart, configure the chart values in the form or YAML editor, and click Install.
  7. Install the Content Cortex AI Services operator.
    Select IBM Content Cortex AI Services, click Install Helm Chart, configure the chart values in the form or YAML editor, and click Install.
  8. Install the licensing operator.
    If your deployment already includes the required licensing components, skip this step. Otherwise, select ibm-licensing-cluster-scoped, click Install Helm Chart, configure the chart values in the form or YAML editor, and click Install. Install the operator in the ibm-licensing namespace.
  9. Install the usage metering operator.
    If your deployment already includes the required usage metering components, skip this step. Otherwise, select ibm-usage-metering, click Install Helm Chart, configure the chart values in the form or YAML editor, and click Install.
  10. Install the cluster-scoped usage metering operator.
    If your deployment already includes the required cluster-scoped usage metering components, skip this step. Otherwise, select ibm-usage-metering-cluster-scoped, click Install Helm Chart, configure the chart values in the form or YAML editor, and click Install.
    The operators that are required for your deployment are installed.

What to do next

After the operators are installed, create a custom resource and run the prerequisite scripts. For more information, see Generating simple custom resource and deployment files.