Documentation Plugins Oracle data source Installation

Install and upgrade the Oracle data source plugin

This document covers how to install, upgrade, and verify the Oracle data source plugin across different Grafana deployment environments. Once the plugin is installed, refer to Configure the Oracle data source to set up a connection.

Before you begin

Verify the following requirements before installing:

Install the plugin

Choose the installation method that matches your Grafana deployment.

Grafana Cloud

The plugin is available to install from the plugin catalog on Pro and Advanced plans. Navigate to Administration > Plugins and data > Plugins, search for “Oracle”, and click Install.

Self-managed Grafana (CLI)

Bash Copy

grafana cli plugins install grafana-oracle-datasource

Restart Grafana after installation.

Docker

Set the GF_INSTALL_PLUGINS environment variable:

YAML Copy

environment:
  - GF_INSTALL_PLUGINS=grafana-oracle-datasource
  - GF_ENTERPRISE_LICENSE_TEXT=<YOUR_LICENSE>

Kubernetes (Helm chart)

Add the plugin to your Helm values:

YAML Copy

plugins:
  - grafana-oracle-datasource

envFromSecret: grafana-license-secret

Or use the GF_INSTALL_PLUGINS environment variable in your deployment spec:

YAML Copy

env:
  - name: GF_INSTALL_PLUGINS
    value: "grafana-oracle-datasource"
  - name: GF_ENTERPRISE_LICENSE_TEXT
    valueFrom:
      secretKeyRef:
        name: grafana-license
        key: license.jwt

Kubernetes (init container)

If you don’t control the Helm chart (for example, on a shared platform cluster), use an init container to download the plugin before Grafana starts:

YAML Copy

initContainers:
  - name: install-plugins
    image: curlimages/curl:latest
    command:
      - sh
      - -c
      - |
        curl -sL https://grafana.com/api/plugins/grafana-oracle-datasource/versions/latest/download \
          -o /plugins/grafana-oracle-datasource.zip && \
        unzip /plugins/grafana-oracle-datasource.zip -d /plugins/
    volumeMounts:
      - name: plugins
        mountPath: /plugins

Mount the same volume at /var/lib/grafana/plugins in the Grafana container.

Air-gapped (offline) installation

For environments without internet access:

1. Download the plugin ZIP from your Grafana account portal on a machine with internet access.

2. Transfer the ZIP to the Grafana server.

3. Extract to the plugins directory:

   Bash Copy

   unzip grafana-oracle-datasource-3.4.0.linux_amd64.zip -d /var/lib/grafana/plugins/

4. Set ownership:

   Bash Copy

   chown -R grafana:grafana /var/lib/grafana/plugins/grafana-oracle-datasource

5. Restart Grafana.

Verify the installation

After installing, confirm the plugin is loaded:

1. Navigate to Administration > Plugins and data > Plugins.
2. Search for “Oracle” and verify the plugin appears with a status of Installed.
3. If the plugin doesn’t appear, check the Grafana server logs for errors and refer to Troubleshooting: Licensing issues.

Upgrade the plugin

Always check the version compatibility table before upgrading to ensure your Grafana version supports the target plugin version.

Version compatibility

Upgrade steps

1. Back up data source settings before upgrading (export via API or note current configuration).

2. Install the new plugin version:

   Bash Copy

   grafana cli plugins update grafana-oracle-datasource

3. Restart Grafana.

4. Verify each data source connection with Save & test.

5. If using TNSNames, confirm the TNSName field retained its value after upgrade (a v3.3.2 regression cleared this field; fixed in v3.3.3).

Troubleshoot upgrade issues

Refer to Upgrade from v2.x to v3.x for breaking changes specific to the v3 migration.

Roll back to a previous version

If an upgrade causes issues, you can pin a specific plugin version:

Bash Copy

grafana cli plugins install grafana-oracle-datasource 3.3.3

Restart Grafana after the rollback. For Docker or Kubernetes, append the version to the plugin name:

YAML Copy

environment:
  - GF_INSTALL_PLUGINS=grafana-oracle-datasource 3.3.3

Uninstall the plugin

To remove the Oracle plugin from a self-managed Grafana instance:

Bash Copy

grafana cli plugins remove grafana-oracle-datasource

Restart Grafana after uninstalling. Existing data source configurations are preserved in the Grafana database but become non-functional until the plugin is reinstalled.

For Docker or Kubernetes, remove grafana-oracle-datasource from the GF_INSTALL_PLUGINS variable and redeploy.