🚧

This feature is only available in BindPlane OP Enterprise. Learn more here.

Enable Offline Agent Package Hosting and Upgrades

This feature allows BindPlane OP Enterprise edition to host the agent packages. This is used in environments where the either BindPlane or the Agent system do not have external network access to github.

BPOP offline agent configuration

In order to use offline agent upgrades, the feature must first be enabled.

To enable offline agent upgrades, the offline option must be enabled. The folder where agent upgrade artifacts will be stored when uploaded may also be configured. By default, agent upgrade artifacts are stored in /var/lib/bindplane/agent-versions.

Here is an example config enabling offline mode.

# Listen on port 3001, all interfaces.
host: 0.0.0.0
port: "3001"

# Basic auth should use a username other than
# admin along with a secure password.
username: admin
password: password

logFilePath: /var/log/bindplane/bindplane.log

# Endpoint for which clients and collectors will interfact
# with the server's http interface.
serverURL: http://bindplane.c.bindplane.internal:3001

server:
    # Endpoint for which collectors will interact with the
    # server's web socket interface. 
    remoteURL: ws://bindplane.c.bindplane.internal:3001

    storageFilePath: /var/lib/bindplane/storage/bindplane.db
    /
    # Enables "offline" mode, which disables syncing agent versions with GitHub, and enables
    # uploading upgrade packages for bindplane to host agent upgrade and install artifacts.
    offline: true
    
    # The path where agent upgrades are stored when uploading agent upgrade packages in offline mode.
    #
    agentUpgradesFolder: /var/lib/bindplane/agent-upgrades

    # A random uuid which is used as a shared secret between bindplane and
    # deployed agents.
    secretKey: your-secret-key

    # A random uuid which is used for generating web ui session cookies.
    sessionsSecret: your-session-secret

Upload an Agent Upgrade Artifact Package

Agent artifact packages can be uploaded to BindPlane OP server to allow agents to upgrade to new versions, as well as allow agent to be installed through BindPlane OP while in offline mode. These packages can be found and downloaded from the releases page of the observIQ Distro for OpenTelemetry GitHub repository.

To upload an agent upgrade artifact package, use the bindplanectl upload agent-upgrade command. The artifact package should be downloaded onto the machine from which you are running bindplanectl, which may or may not be the BindPlane OP server. In this example, version 1.21.1 of the collector is being uploaded to BindPlane OP:

bindplanectl upload agent-upgrade ./observiq-otel-collector-v1.21.1-artifacts.tar.gz --username admin --password password

If the file has been renamed, you must specify the --version flag with the version you are uploading:

bindplanectl upload agent-upgrade ./artifacts.tar.gz --version v1.21.1 --username admin --password password

Delete Old Agent Artifact Packages

Agent versions and agent artifact packages can be removed using the bindplanectl delete agent-version command:

bindplanectl delete agent-version observiq-otel-collector-v1.21.1 --username admin --password password

This will delete the version from BindPlane OP and remove the unpacked artifact package from the disk of the BindPlane OP server.