Chapter 2. Installing metering

Procedure

1. Create a namespace object YAML file for the Metering Operator with the oc create -f <file-name>.yaml command. You must use the CLI to create the namespace. For example, metering-namespace.yaml:

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-metering 1
     annotations:
       openshift.io/node-selector: "" 2
     labels:
       openshift.io/cluster-monitoring: "true"

   1

   It is strongly recommended to deploy metering in the openshift-metering namespace.

   2

   Include this annotation before configuring specific node selectors for the operand pods.

2. In the OpenShift Container Platform web console, click Operators OperatorHub. Filter for metering to find the Metering Operator.
3. Click the Metering card, review the package description, and then click Install.
4. Select an Update Channel, Installation Mode, and Approval Strategy.
5. Click Install.

6. Verify that the Metering Operator is installed by switching to the Operators Installed Operators page. The Metering Operator has a Status of Succeeded when the installation is complete.

   Note

   It might take several minutes for the Metering Operator to appear.

7. Click Metering on the Installed Operators page for Operator Details. From the Details page you can create different resources related to metering.

Procedure

1. Create a Namespace object YAML file for the Metering Operator. You must use the CLI to create the namespace. For example, metering-namespace.yaml:

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-metering 1
     annotations:
       openshift.io/node-selector: "" 2
     labels:
       openshift.io/cluster-monitoring: "true"

   1

   It is strongly recommended to deploy metering in the openshift-metering namespace.

   2

   Include this annotation before configuring specific node selectors for the operand pods.

2. Create the Namespace object:

   $ oc create -f <file-name>.yaml

   For example:

   $ oc create -f openshift-metering.yaml

3. Create the OperatorGroup object YAML file. For example, metering-og:

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: openshift-metering 1
     namespace: openshift-metering 2
   spec:
     targetNamespaces:
     - openshift-metering

   1

   The name is arbitrary.

   2

   Specify the openshift-metering namespace.

4. Create a Subscription object YAML file to subscribe a namespace to the Metering Operator. This object targets the most recently released version in the redhat-operators catalog source. For example, metering-sub.yaml:

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: metering-ocp 1
     namespace: openshift-metering 2
   spec:
     channel: "4.5" 3
     source: "redhat-operators" 4
     sourceNamespace: "openshift-marketplace"
     name: "metering-ocp"
     installPlanApproval: "Automatic" 5

   1

   The name is arbitrary.

   2

   You must specify the openshift-metering namespace.

   3

   Specify 4.5 as the channel.

   4

   Specify the redhat-operators catalog source, which contains the metering-ocp package manifests. If your OpenShift Container Platform is installed on a restricted network, also known as a disconnected cluster, specify the name of the CatalogSource object you created when you configured the Operator LifeCycle Manager (OLM).

   5

   Specify "Automatic" install plan approval.