Installing the RMF for z/OS Grafana plugin in a Docker environment

You can install the RMF for z/OS Grafana plugin along with Grafana within a Docker container. Use this method if you are running Grafana in a containerized environment.

Before you begin

Before installing the RMF for z/OS Grafana plugin, ensure that all required software is available. See Prerequisites.

Procedure

  1. Run the following command to create a volume for storing the Grafana state: 
    docker volume create rmf-grafana-data
  2. Run the following command to create and run a container: 
    docker run --name <container_name> \
--hostname <hostname> \
--detach \
--restart <restart_policy> \
--volume <volume_name>:<container_data_path> \
--publish <host_port>:<container_port> \
--env "GF_INSTALL_PLUGINS=<plugin_id>" \
<image_name>
    Variables Description
    <container_name>

    Name for the container (user-defined).
    <hostname>

    Hostname assigned to the container.
    <restart_policy>

    Restart behavior (for example, no, on-failure, always, unless-stopped).
    <volume_name>

    Name of the Docker volume for persistent storage.
    <container_data_path>

    Path inside the container where data is stored (for example, /var/lib/grafana).
    <host_port>, <container_port>

    Port mapping between the host and the container.
    <plugin_id>

    Identifier of the RMF for z/OS Grafana plugin to install (for example, ibm-rmf-app).

    You can optionally append a version number to install a specific version (for example, ibm-rmf-app 2.0.1). If no version is specified, the latest version from the Grafana plugin catalog is installed.
    <image_name>

    Version of the Grafana image to be used.
    For example,
    docker run --name rmf-grafana \
--hostname rmf-grafana \
--detach --restart unless-stopped \
--volume rmf-grafana-data:/var/lib/grafana \
--publish 3000:3000 \
--env "GF_INSTALL_PLUGINS=ibm-rmf-app" \
11.0.1
    Note: zCX/zLinux images are available at Container Images for IBM Z and LinuxONE. Similarly, images of other required platforms are available at Docker Hub.
  3. Verify that the IBM RMF option is listed under the Apps section.

Results

You have installed the RMF for z/OS Grafana plugin.

What to do next