Installing Standard Edition in an air-gapped environment

You can install Standard Edition in an air-gapped environment by using a bastion host that has access to the internet and to the host that is in your air-gapped environment.

Prerequisites for installing Standard Edition in an air-gapped environment

In an air-gapped environment, you must create an installation package on your bastion host, transfer it to the host that is in the air-gapped environment, and then use the package to install Standard Edition.

Important:

You must disable antivirus software on the host machine before you install and operate the platform. Antivirus scanning interferes with the following areas and causes failures during deployment:

Container layers that Docker creates and manages
Volume-mounted data directories
The frequent, high-volume disk I/O that services such as Cassandra and ClickHouse perform

These interference points cause performance degradation, resource contention, container instability, and service startup failures.

Adding Instana repository and installing stanctl tool in air-gapped environments

Complete one of the following methods to install Standard Edition:

To install Standard Edition from the Instana repository, see Adding Instana repository and installing stanctl tool, and then Creating the air-gapped installation package.
To mirror the Instana repository to your internal repository and install Standard Edition from the internal repository, see Mirroring the repositories.

Creating the air-gapped installation package

You must create an installation package on your bastion host.

On your bastion host, make sure that you installed stanctl as described in the Installing stanctl command-line tool section.
Create the air-gapped package. By default, the package is created in the current directory. To specify another location, use the --output-dir <full-path-to-directory> flag with the command. For the disk space requirement of the directory, see Storage requirements.
```
stanctl air-gapped package
 
```

Enter the download key and sales key at the prompt. For more information about the prompts, see Before you begin.

? Enter the download key or an official agent key: **********************
? Enter the sales key: **********************

If multiple Instana backend versions are available for installation, you see a prompt with the available versions as shown in the following example. Select the Instana backend version that you want to install.
```
? Select Instana version to install:
  [Use arrows to move, type to filter]
> 3.281.433-0
3.279.369-0
 
```

If the keys that you entered are valid, the installer starts downloading the artifacts and creates the air-gapped package. You might see the following message:

⠇ Packaging stanctl artifacts  [1s] ✓
⠇ Packaging BuildMeta artifacts  [1s] ✓
⠇ Packaging Cluster artifacts  [1s] ✓
⠦ Packaging Geodb artifacts  [0s] ✓
⠸ Packaging Helm artifacts  [12s] ✓
⠙ Packaging License artifacts  [0s] ✓
⠴ Packaging Registry artifacts  [2m00s]

Depending on network conditions, it might take several minutes for the air-gapped package to be created. When your air-gapped package is ready, the following message is displayed.

------------------------------------------
Air-gapped package successfully exported!
File: instana-airgapped.tar.gz
------------------------------------------

Transferring the air-gapped installation package to the air-gapped host

Transfer the air-gapped package from the bastion host to the Instana host that is in your air-gapped environment. In a multi-node cluster, transfer the air-gapped package to node0 (instana-0).

Installing stanctl on the air-gapped host

You must install the command-line tool stanctl on the Instana host that is in your air-gapped environment. In a multi-node cluster, you must install stanctl on node0 (instana-0). You can install the tool by using the binary file that is provided in the air-gapped package. Extract the air-gapped package and copy the stanctl file to the /usr/local/bin directory on your Instana host.

tar -xzf </path/to/instana-airgapped.tar.gz> -C /usr/local/bin --strip-components 1 airgapped/stanctl

Importing the air-gapped package

Use the stanctl tool to import the air-gapped package on your air-gapped host.

stanctl air-gapped import --file </path/to/instana-airgapped.tar.gz

Deploying Standard Edition in the air-gapped environment

To deploy Standard Edition in an air-gapped environment using the Instana repository, follow the installation steps based on your cluster configuration.

To install a single-node cluster, run the following command. At the prompt, enter the parameter values.
```
```bash
stanctl up --air-gapped
```
 
```
To install a multi-node cluster, run the following command on node0 (instana-0) as the user that you configured for SSH access. At the prompt, enter the parameter values.
```
```bash
stanctl up --air-gapped --multi-node-enable
```
 
```
For additional configuration options, see Installing Standard Edition in an online environment.