Installing the NAM Probe software

This procedure describes how to make a fresh installation of the NAM Probe software on a server configured according to requirements. If you are upgrading an existing installation, go to Upgrading the NAM Probe software instead.

To create a complete NAM Probe installation, you need to:

  1. Set up a suitable server (physical or virtual).
  2. Install a supported version of Linux
  3. Configure the NAM Probe communication interface
  4. Install the NAM Probe software
    You Are Here

Installing NAM Probe software

Log on to the NAM Probe machine as the root user.

Get the latest NAM Probe installer.
Download an installation program from Downloads for Dynatrace Dynatrace NAM. The file will have a name such as:upgrade-amd-amdos7-x86_64- ... .bin. Select file applicable to your architecture and place it in a convenient directory on your machine. For more information, see Installation and upgrade options - File name.

Test the target machine for system readiness.
Go to the directory with the upgrade program and run it with the --test-system parameter. Review Installation and upgrade options - File options for testing for other upgrade.bin testing parameters.
For example:

[root@AMD ~]# ./upgrade-amd-17-00-00-1971-b001.bin --test-system
  • If no system readiness issues are found, you will see a summary message that finishes with a line such as
    "No missing dependencies, it is OK to install NAM Probe software."

  • If system readiness issues are found, follow the instructions on the screen. You may be prompted to install missing software or disable services that affect NAM Probe performance. For more information, see Installing Linux without kickstart or NAM Probe software dependencies and conflicts.

Important

An updated Linux kernel may be installed as an effect of a software compatibility check. If this happens, a system restart is necessary so that the proper kernel version is in use. For more information, see Resolving Linux kernel-related compatibility issues.

Run the selected upgrade file in the installation directory.
At the command line prompt, type: ./file_name   with the Mandatory parameters for installation where file_name is the name of the upgrade file.
For example:

[root@AMD ~]# ./upgrade-amd-17-00-00-1971-b001.bin --automatic --licenses-type eservices
  • NAM Probe installation and upgrade does not recognize symbolic links. The install script will leave a custom folder installation, ignore the symbolic links, and install a new version in the following folders:

  • /usr/adlex
    /var/spool/adlex
    /var/log/adlex
    To use a custom installation location, you need to use mounting points on separate partitions.

  • If the installation script warns after setup that the available disk space is below the minimum space required, you must make a suitable amount of free disk space available before continuing.

Optional: Select the correct SSL engine (applies to nCipher support only).
The installation procedure performed by the upgrade file may not be able to detect the exact type of the nCipher accelerator card (nShield or nFast), in which case it configures the NAM Probe for nShield. If the card installed is not nShield, you must manually modify the appropriate NAM Probe configuration property after the upgrade file is executed. To do this, open the /usr/adlex/config/rtm.config configuration file and find the ssl.engine property, which defaults to

 ssl.engine=nshield

If the installed card is nFast, change the setting from nShield to nfast .

Reboot the NAM Probe to complete the installation.

Now you are ready to configure your NAM Probe software and network interfaces. For more information, see: After you install the NAM Probe software.