metering-installing-metering.adoc

Installing metering

modules/deprecated-feature.adoc

Review the following sections before installing metering into your cluster.

To get started installing metering, first install the Metering Operator from OperatorHub. Next, configure your instance of metering by creating a MeteringConfig custom resource (CR). Installing the Metering Operator creates a default MeteringConfig resource that you can modify using the examples in the documentation. After creating your MeteringConfig resource, install the metering stack. Last, verify your installation.

modules/metering-install-prerequisites.adoc

modules/metering-install-operator.adoc

Installing the metering stack

After adding the Metering Operator to your cluster you can install the components of metering by installing the metering stack.

Prerequisites

• Review the configuration options

• Create a MeteringConfig resource. You can begin the following process to generate a default MeteringConfig resource, then use the examples in the documentation to modify this default file for your specific installation. Review the following topics to create your MeteringConfig resource:

  • For configuration options, review About configuring metering.

  • At a minimum, you need to configure persistent storage and configure the Hive metastore.

Important

There can only be one MeteringConfig resource in the openshift-metering namespace. Any other configuration is not supported.

Procedure

1. From the web console, ensure you are on the Operator Details page for the Metering Operator in the openshift-metering project. You can navigate to this page by clicking Operators → Installed Operators, then selecting the Metering Operator.

2. Under Provided APIs, click Create Instance on the Metering Configuration card. This opens a YAML editor with the default MeteringConfig resource file where you can define your configuration.

   Note	For example configuration files and all supported configuration options, review the configuring metering documentation.

3. Enter your MeteringConfig resource into the YAML editor and click Create.

The MeteringConfig resource begins to create the necessary resources for your metering stack. You can now move on to verifying your installation.

modules/metering-install-verify.adoc

Additional resources

• For more information on configuration steps and available storage platforms, see Configuring persistent storage.

• For the steps to configure Hive, see Configuring the Hive metastore.