Offline Agent Package Installation and Upgrades
How to set up BindPlane OP to host agent packages locally
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
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.
Updated about 1 month ago