Installing Instana backend and data stores

Before you begin the installation, make sure you have the following information ready. You need it later when you run the stanctl up command.

Table 1. Installation parameters

Parameter	Prompt at which you specify the parameter	Example parameter	stanctl up flag	More information
Installation type	? Choose installation type:	The default value for a single-node cluster is demo. . The default value for a multi-node cluster is production.	--install-type	Single-node cluster hardware requirements Multi-node cluster hardware requirements
Base domain name	? Enter the domain under which Instana will be reachable:	instana.example.com	--core-base-domain	Single-node cluster DNS settings Multi-node cluster DNS settings
Download key	? Enter the download key or an official agent key:	UYB_02_pltyNHJ9lg_56er	--download-key	Purchasing a license
Sales key	? Enter the sales key:	qemiOPI_808dklkOIIJWEF	--sales-key	Purchasing a license
Tenant name	? Enter your tenant name:	marketing	--unit-tenant-name	Tenant and unit names
Unit name	? Enter your unit name:	test	--unit-unit-name	Tenant and unit names
Instana admin password	? Enter Instana admin password: ? Confirm Instana admin password:	any value	--unit-initial-admin-password	Decide on a password for the Instana admin user. This password is used only in a fresh installation. After you install Standard Edition, you can change this password by using the auth reset-password command.
TLS certificate file	? Enter TLS certificate file (hit ENTER to auto-generate):	NA	--core-tls-crt	Do not enter any value at the prompt to use an automatically generated self-signed certificate. To use a custom certificate, specify the full path and name of your custom Transport Layer Security (TLS) certificate. For example, /opt/instana/key-and-certificate/tls.crt. For more information, see TLS certificate and key.
TLS key file	? Enter TLS key file (hit ENTER to auto-generate):	NA	--core-tls-key	If you specify a custom TLS certificate, you must also specify a custom TLS key. For example, /opt/instana/key-and-certificate/tls.key. For more information, see TLS certificate and key.
Autogenerate TLS certificate and key	NA	No	--core-tls-generate-cert	During installation, you must provide a TLS certificate and key by using one of the following methods: Method 1: Specify the TLS certificate and key Use the --core-tls-crt and --core-tls-key flags to specify the TLS certificate and key. Method 2: Automatically generate the TLS certificate and key Use the --core-tls-generate-cert flag to automatically generate the TLS certificate and key during installation. If you do not follow either method, you see the following results: - If you are using the --quiet flag, the installation fails. - If you are not using the --quiet flag, the installation prompts for the certificate and key.

If you are installing on a multi-node cluster by running the stanctl up --multi-node-enable, you need the following parameters in addition to the items in the previous table.

Table 2. Multi-node cluster installation parameters

Parameter	Prompt at which you specify the parameter	Example parameter	stanctl up --multi-node-enable flag	More information
IP addresses	? Enter the IPs for all three nodes, separated by commas:	10.8.1.10,10.8.1.11,10.8.1.12; Private IP addresses of the three nodes.	--multi-node-ips	See IP addresses. Enter the IP addresses in the correct sequence: first IP address is of node0 that you prepared for the backend, the second IP address is of node1 that you prepared for the data stores, and the third IP address is of node2 for other uses.

Use the following URL and access credentials to access the UI:

• The URL to access the UI has the following syntax:

  <unit-name>-<tenant-name>@<base-domain>

  For more information about these parameters, see Tenant and unit names and DNS settings.

  For example, if your unit name is test, tenant name is marketing, and the base domain is instana.example.com, your URL would be test-marketing@instana.example.com.

• The default username is admin@instana.local.

• The password for the default username is the one that you set during installation. After you install Standard Edition, you can set a new password for the admin user. For more information, see Changing the password of admin or any other user.

For more information about installing Standard Edition, see the following topics:

• Installing Standard Edition in an online environment
• Installing Standard Edition in an air-gapped environment
• Installing Standard Edition using mirrored repositories

When you install the Instana backend, some components are available by default. For more information, see Components.

To install agents and optional features, see Configuring Instana.

If required, you can enable autocompletion for your shell to get prompts for the stanctl commands. For more information, run the stanctl completion -h command.