Operations for Self-Hosted Classic Edition (Docker)

You can do the following operations for Classic Edition:

Upgrading your Instana console

Use your appropriate package manager command to update to a desired package version of Instana console.

See the following example for Ubuntu:

  • To get the latest version, run the command as follows:

    sudo apt-get install instana-console

  • To grab a specific version, run the command as follows:

    sudo apt-get install instana-console=221-2

Upgrading your Instana backend

The following command updates your container configuration based on the current settings.hcl file, and is pinned to the version of instana-console that is deployed.

You need to upgrade the Instana console before you upgrade the Instana backend.

instana update

You can also use this command to reconfigure your current installation.

Cleaning old Docker images

Clean up unused Docker containers and images from the local cache by running the following commands. Be aware that the backend is running.

docker container prune
docker image prune -a

Initializing or resetting installation

Initialize your installation and delete all existing data by running the following command:

instana init

Configuring default admin user

Create or reset your admin user by running the following command:

instana configure admin

Resetting authentication provider

Reset your authentication provider by running the following commands:

instana configure reset IDP

instana configure reset LDAP

Stopping all components

Stop all of the components of the Instana backend setup by running the following command:

instana stop

Note: If you use the automation script, use the -y parameter as follows to proceed without verification:

instana stop -y

Starting all components

Start all the components of the Instana backend setup by running the following command:

instana start

Note: If you use the automation script, use the -y parameter as follows to proceed without verification:

instana start -y

Creating a template for the settings.hcl file

Create the settings.hcl file with default (empty.md) values by running the following command:

instana settings template

The file is created in the directory where you run this command.

Validating the settings.hcl file

Validate the existing settings.hcl file by running the following command:

instana settings validate

Help

Get the help information by running the following command:

instana help

Version of Instana

Get the current running version of Instana backend by running the following command:

instana version