Data Center RUM Documentation

Skip to end of metadata
Go to start of metadata

The AMD is a set of regular applications. This set of applications is installed or upgraded by a single script (upgrade.bin). Each supported hardware platform and operating system requires a dedicated upgrade.bin script to install the AMD software. The files can be found on Dynatrace installation media (DVD or CD kit).

The installation script needs to be transferred to the machine and acquire the execution bit to run. It can be run only by root user.

Important:

Icon
To run the AMD software installation script and successfully complete the installation or upgrade, you must first install Perl and yum.

Other software dependencies may need to be resolved before the AMD software installation completes. They can be resolved automatically, using upgrade.bin script, or manually. For more information, see AMD Software Dependencies and Conflicts .

File Naming Convention

The target operating system, hardware architecture, and release number can be read from the installation script file name. The convention is the following:

upgrade-[SSL decryption engine]-[operating system version]-[hardware architecture]-ndw-[release number]-b001.bin

where:

  • [SSL decryption engine] indicates whether support for SSL decryption hardware is built in this variant of AMD software. OpenSSL support is labeled with amd or amdclassic, whereas supported SSL hardware is labeled with its name - amd_ncipher_pkcs11, or  amdclassic_ncipher_pkcs11. The meaning of the amd string depends on the RHEL release.

    RHEL 6
    amd - OpenSSL support, classic AMD
    amd_ncipher_pkcs11 - nCipher support, classic AMD

    RHEL7
    High Speed AMD
    amd -  OpenSSL support.
    amd__ncipher_pkcs11 -  nCipher support. 

    Classic AMD
    amdclassic
     - OpenSSL support.
    amdclassic_ncipher_pkcs11
    - nCipher support.

  • [operating system version] indicates whether the file is suitable for installation on Red Hat Enterprise Linux 6 (amdos6) or Red Hat Enterprise Linux 7 (amdos7).

  • [hardware architecture] indicates whether the file is suitable on 32-bit (i386) or 64-bit (x86_64) architecture. Note that since the 12.4 release, the only available architecture is x86_64.

  • [release number] indicates the AMD version that will be installed. The number contains major, minor, and patch number versions.

For example, the file upgrade-amd-amdos6-x86_64-ndw-12-04-00-1245-b001.bin is used to install AMD version 12.4 with OpenSSL support on 64-bit Red Hat Enterprise Linux 6.

Options for licensing

When running the upgrade.binyou must choose the AMD licensing mode using the the following command line option:

--licenses-type <licenses-type>

The option has two values:

  • dlm
  • eservices 

Use dlm to install AMD using a classic, DLM based licensing scheme. Use eservices to install the AMD using eServices based licensing scheme. 

Icon

The --licenses-type values for releases before 12.4.11 use numbers instead of strings. 1 for DLM and 2 for eServices.

For example, to install High Speed AMD, using the DLM based licensing scheme, use the High Speed AMD upgrade.bin as in the example below :

To install Classic AMD using the eServices based licensing scheme, use the Classic AMD upgrade.bin as in the example below.

Installation software in the community downloads

 The installation file is available in several versions depending on the hardware architecture, operating system version, and SSL decryption engine. The Dynatrace Community Downloads page contains the installation files with OpenSSL support for Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 7.

The following are example names of installation files for Red Hat Enterprise Linux 6:

  • upgrade-amd-amdos6-x86_64-ndw-12-04-00-1245-b001.bin

The following is an example name of an installation file for Red Hat Enterprise Linux 7:

  • upgrade-amd-amdos7-x86_64-ndw-12-04-00-2184-b001.bin

Choose a file labeled i386 for 32-bit operating system versions and a file labeled x86_64 for 64-bit operating system versions. The version number, that is indicated by the digits following the string ndw in the file name, may be different from the number on your distribution disk.

Choose a file labeled amdos6 for installation on Red Hat Enterprise Linux 6 or a file labeled amdos7 for installation on Red Hat Enterprise Linux 7.

File options for Installing

Specific parameter must be used with the upgrade.bin during an installation. You must indicate whether the installation script should automatically configure your system or attempt to upgrade the system as it is and, you must specify the license type for your installation.

Release differences

Icon

The upgrade.bin options may differ depending on the release you are installing. The options listed below reflect the latest available release. To see which options are available for your release, use the --help parameter when executing the upgrade.bin script.

Mandatory parameters for installation:

  • --automatic or --manual
    --automatic
    The script automatically installs missing dependencies and modifies required services configurations.
    --manual
    The script installs the software. If the system doesn't meet the requirements, the script stops and reports the changes or updates that need to be done. To learn more about the parameters on testing system or resolving software dependencies, see AMD software dependencies and conflicts .
  • --licenses-type <lic-type>
    Specifies the license type (New installations only); values: dlm, eservices
    Use dlm to install AMD using a classic, DLM based licensing scheme. Use eservices to install the AMD using eServices based licensing scheme.

    Icon

    The --licenses-type values for releases before 12.4.11 use numbers instead of strings. 1 for DLM and 2 for eServices.

    For example, to install High Speed AMD, using the DLM based licensing scheme, use the High Speed AMD upgrade.bin as in the example below :

    To install Classic AMD using the eServices based licensing scheme, use the Classic AMD upgrade.bin as in the example below.

Optional parameters for installation:

  • --tmpdir="<directory>"
    Sets a temporary directory with permissions to launch the upgrade.bin script. Some system security policies do not permit scrip execution from the /tmp directory. Use this parameter to specify different temporary directory that has the execution permissions.

  • --set-user <username[:groupname]>
    The installation file option --set-user can be used to specify an unprivileged AMD user. The --set-user option specifies or creates a user and the group to which this user belongs. A user created with this option has all the necessary permissions to configure and operate the AMD software, but is not permitted to perform system-level operations.

    The following syntax specifies the user and a group during the installation: --set-user user:group.

    For example, to specify the user peter belonging to group operators, execute a command in the following format:

    Since this option is available only in new installations, specifying the user and the group will automatically create, assign, and make use of the created users and groups during the installation process.

--help

Icon

Use the --help option for a list of parameters available during the installation mode:

File options for Upgrading

Specific parameter must be used with the upgrade.bin during an upgrade. During the upgrade, you must indicate whether the installation script should automatically configure your system or attempt to upgrade the system as it is.

Mandatory parameters for upgrade:

  • --automatic
    If you want the installation script to automatically install/upgrade missing dependencies, disable the nonessential service and modify the required services configurations, use the --automatic parameter.

  • --manual
    If you want the installation script to upgrade without any system changes, use the –manual parameter. The installation script will attempt to install/upgrade the monitoring software on the existing system, but it will stop and report changes and updates that need to be performed if the system does not meet the requirements. To learn more about the parameters on testing system or resolving software dependencies, see AMD software dependencies and conflicts .

Optional parameters for upgrade:

--tmpdir="<directory>"
Sets a temporary directory with permissions to launch the upgrade.bin script. Some system security policies do not permit scrip execution from the /tmp directory. Use this parameter to specify different temporary directory that has the execution permissions.

Uninstalling AMD

To remove the AMD software from your machine, use the the upgrade.bin with the –-erase option. For example:

To clear the system completely, after you uninstall the software, remove the AMD specific directories. Use the following commands:

Nonstandard Boot Loader

Default installations of standard distributions of Red Hat Enterprise Linux use the GRUB 2 boot loader. If the number of CPUs is eight or more, the AMD software installation or upgrade script updates kernel parameters in the boot loader configuration file. The installation script on nonstandard distributions, or installations using a boot loader other than GRUB, generate the following warning:

Though the installation or upgrade will complete successfully, you must modify the boot loader configuration file manually and set the kernel parameters. Edit the configuration file of your boot loader, set the following parameters, and reboot the system.

  • No labels