Complete the following high-level tasks to install, configure and start Z APM Connect DG.
Create the installation directory if it does not exist.
Move the archive file,
6.1.1-TIV-ZAPM-FP00001-standalone.tar.gz, to the installation directory and navigate to that directory.
Extract the archive file to begin installation. The expected directory structure is:
├── images │ ├── zapm-kafka+3.1.2.tar │ ├── redis+6.2.7.tar │ ├── zapm-instana-exporter+6.1.1-1.tar │ ├── zapm-transaction-processor+6.1.1-1.tar │ └── zapm-zookeeper+3.8.0.tar └── zapmctl
Note: In the unlikely event that not all of the expected files are present, it is possible that the archive file was corrupted while being downloaded. If this happens, re-download the file and try again.
Install, configure, and start the Z APM Connect Distributed Gateway.
Example commands to complete these steps are provided below. The directory /opt/ibm is used in the examples.
# Step 1: Create the installation diectory if it does not exist (/opt/ibm/ is used in the examples). **`mkdir -p /opt/ibm`** # Step 2: Move the archive to the installation directory and navigate to that directory **`mv ./zapm-connect-dg-standalone.tar.gz /opt/ibm/ cd /opt/ibm`** # Step 3: Extract the archive file. The files are listed as they are extracted. **`tar -xvzf zapm-connect-dg-standalone.tar.gz`** # Step 4: Install the required Docker images and initialize the configuration files. **`sudo ./zapmctl install`** # (Conditional) Step 5: Upgrade the installation. **`sudo ./zapmctl install --update`**
Note: The above commands will add all of the latest Z APM Connect images to the local image repository and will ask about restarting the Z APM Connect DG if it is already running. Upgrade process will not remove any previous configuration, certificates, or saved logs.
For more information on the subcommands of the
zapmctl executable and their options, see the following sections:
A complete example of installing and configuring Z APM Connect DG in interactive mode is provided for your reference.