Red Hat Enterprise Linux is the supported operating system to serve as the AMD platform. We recommend that you use the kickstart installation method and the installation script provided on installation media to install the operating system. For supported operating systems by your Dynatrace release, visit OS and SQL supported versions in DC RUM topic.

The following procedures are a general guide to Red Hat Enterprise Linux installation. Some of the examples presented in procedures may differ depending on the release you are installing. The differences occur in filenames of the kickstart and upgrade files, for example:

Red Hat Enterprise Linux 6Red Hat Enterprise Linux 7
amdrhel6.cfg
amdrhel7.cfg
upgrade-amd-amdos6-x86_64-ndw-12-04-00-1234-b001.bin
upgrade-amd-amdos7-x86_64-ndw-12-04-00-1234-b001.bin

Note that if the target machine already has a Red Hat Enterprise Linux version supported by Dynatrace installed, you do not need to repeat the installation of the operating system. In this case, you are advised to run a system test to verify system readiness for AMD software installation.

Before You Begin

  • Download the official distribution ISO file from the Red Hat Enterprise Linux website.
  • Set the BIOS to boot from either DVD/CD-ROM or USB.

    DVD/CD-ROM installationsUSB installations
    Burn the downloaded ISO image onto a DVD/CD-ROM media.

    Follow the official instructions on how to create a bootable USB drive with Red Hat Enterprise Linux installation (Red Hat Enterprise Linux USB).

    Add the Dynatrace provided kickstart file to the root of the Red Hat Enterprise Linux installation USB drive or stick.

  • Optionally: Although not required to install the Red Hat Enterprise Linux, access to the internet is necessary to register the Red Hat Enterprise Linux and update or install additional repositories.

To install Red Hat Enterprise Linux as a standalone dedicated system:

  1. Insert the Red Hat Enterprise Linux disk or the USB stick.  

  2. Reboot the machine and allow the boot menu to appear.

    If your system uses the UEFI firmware:
    1. Select the Install Red Hat Enterprise Linux 7.x option.
    2. Press [e] or [TAB] to edit the selected option.
    3. Append the location of the kickstart file to the linuxefi command.
      For kickstarts located on a DVD/CD-ROM use:

      ks=cdrom:/amdrhel7.cfg

      For kickstarts located on a USB:

      inst.ks=hd:LABEL=LIVE:/amdrhel7.cfg

      For example:

    4. Press [Ctrl-x] or [ENTER] to start installing Red Hat Enterprise Linux with the modified option.

    5. Skip to step 4 of the installation procedure.


  3. Press [Esc] to exit boot menu and at the boot: prompt, type the command to use the kickstart script located on the Dynatrace DVD 2 in the AMD folder or the root of the USB stick.

    Installation Paths

     DVD/CD-ROM installation paths assume that the system hardware contains a phisycal DVD/CD-ROM drive. External DVD/CD-ROM devices utilizing the USB port may require the use of the USB installation paths even if a CD-ROM media is used.

    DVD/CD-ROM installationsUSB installations
    1. At the boot command type: linux ks=cdrom:/amdrhel7.cfg

      boot:linux ks=cdrom:/amdrhel7.cfg

      If you intend to install AMD with support for SSL acceleration cards, you can use the CD kit with appropriate installation files (for example, “Agentless Monitoring Device 12.04.00 with nCipher Support” CD kit) to submit the kickstart installation script to the installer. In this case you must indicate that the kickstart file is in the root of the CD:

      At the boot command type: linux ks=cdrom:/amdrhel7.cfg

      You can always use the script located on the DVD 2 as the CD kit contains the amdrhel7.cfg file to limit the number of discs used during installation.

    2. Replace the Red Hat Enterprise Linux distribution media with the CD kit containing the kickstart installation script.

    3. Replace the Red Hat Enterprise Linux distribution media with the CD kit containing the kickstart installation script and p ress [Enter].

    4. Allow the kickstart script to load, re-insert the Red Hat Enterprise Linux installation media and press [Enter].

    This example assumes that you have used a LiveUSB Creator which labels the USB as LIVE. If you have used a different tool to create bootable USB, the label may differ.

    At the boot command type:  inst.ks=hd:LABEL=LIVE:/amdrhel7.cfg

    boot:linux inst.ks=hd:LABEL=LIVE:/amdrhel7.cfg
  4. Once the installation process finishes, press [Enter] to reboot the system.

  5. Confirm the installed version of Red Hat Enterprise Linux.

    1. Log in as a root user with a default password greenmouse.

    2. Check the version numbers by using the uname -snrv command.

      Figure 3. Sample Output of the uname Command :

      [root@amdprobe /]# uname -snrv 
      Linux amdprobe 3.10.0-229.el7.x86_64 #1 SMP Thu Jan 29 18:37:38 EST 2015
  6. Inspect the installation logs to find out if everything is installed correctly.
    Check /root/install.log to verify that all software packages were installed successfully. Errors logged here may indicate that the AMD software will not work properly due to failed dependencies. Errors recorded in /root/install.log may be caused by faulty installation medium; if this occurs, either reinstall the failed packages manually or install the entire system again using another medium.

  7. Proceed to the manual installation of the packages that are not available on the installation media.
    AMD software depends on the packages that might not be included with any of the installation disks. To display the list of packages that are required by the AMD software but not installed in the system, run the installation script with --list-missing-deps parameter.

    [root@amdprobe /]# ./upgrade-amd-amdos7-x86_64-ndw-12-04-00-1234-b001.bin --list-missing-deps
    

    The packages required for AMD software installation and not included in the base workstation or server repository include:

    • Java (This package is included in Red Hat Enterprise Linux 7 )

    • perl-XML-Simple

    • perl-Switch

      Review the Java builds and DC RUM Releases topic to find out what Java version is required for your release. You need to be logged on to use this link

    The packages must be installed manually or from the Red Hat Network using an Internet connection. You can use the AMD software installation script as an aid for installing the missing packages.

     Online Installations

    Register your system with Red Hat Network.

    If your machine is connected to the Internet, we recommend using Red Hat Network to install the AMD dependencies and apply security updates to your Linux. To register the system and enable subscriptions, use the subscription-manager command.

    1. Register your Linux in Red Hat Network.
      Execute subscription-manager register at the command prompt and enter the subscription username and password.

      [root@amdprobe /]# subscription-manager register 
      Username:
      Password:
    2. Attach the subscription to the registered system.
      Execute subscription-manager attach --auto at the command prompt to .

      [root@amdprobe /]# subscription-manager attach --auto 
    3. Enable optional Red Hat repositories.
      This is necessary to get access to all the AMD system dependencies you will install in the next step.

      Make sure that you use the appropriate repository for your type of system:

      Red Hat Enterprise Linux workstation

      subscription-manager repos --enable=rhel-7-workstation-optional-rpms

      Red Hat Enterprise Linux server

      subscription-manager repos --enable=rhel-7-server-optional-rpms

    Acquire and install the missing software dependencies.

    1. Change the working directory to the location where the upgrade.bin is placed.

    2. Run the script with the --install-deps-from-net parameter.
      For example:

      [root@amdprobe /]# ./upgrade-amd-amdos6-x86_64-ndw-
      12-04-00-1234-b001.bin --install-deps-from-net

      When the missing dependencies are pulled from the installation repository, the script also silently adds the packages necessary for AMD maintenance. If you want to omit the installation of these packages, use the --skip-recommended parameter together with --install-deps-from-net.

    3. The AMD software dependencies and other auxiliary packages will be installed from the Red Hat Network repository or a repository currently defined in the yum configuration.

     Offline Installations

    Perform a manual installation of the missing packages from a locally created repository.

    To run this procedure successfully, you must install createrepo using the Red Hat Enterprise Linux installation disc.
    For example:

    [root@amdprobe /]# yum install createrepo
    1. Collect all of the indicated packages and prepare them for copying.
      Use the installation media or official Red Hat repositories as the source for the packages.

      If your AMD's Linux was installed without using the kickstart script and you do not have access to the network, you must create a local repository that contains the packages from all of the Linux distribution DVDs. The missing packages that are listed using the --list-missing-deps parameter have additional dependencies located throughout the Linux distribution set.

    2. Use an SFTP client (for example, WinSCP) to log in to the AMD.

    3. Copy the necessary packages to the directory of your choice on the AMD.
      For example:

      [root@amdprobe /]# /tmp/amdrepo
    4. Log in to the system as root.

    5. Navigate to the directory where the packages are located and run the createrepo command.
      For example:

      [root@amdprobe /]# createrepo /tmp/amdrepo 

      Navigate to the location where upgrade.bin is placed and run the script with the --install-deps-from-url parameter.
      For example:

      [root@amdprobe /]# ./upgrade-amd-amdos6-x86_64-ndw-12-04-00-
      1234-b001.bin --install-deps-from-url file:///tmp/amdrepo 

      As a result, the AMD software dependencies and other auxiliary packages are installed from the custom repository.

    6. Copy any installation files for missing packages to this custom repository.

  8. The kickstart script cannot configure some settings automatically. For this reason, make these changes after the operating system installation. If you are running a custom installation of Red Hat Enterprise Linux, you may not need to adjust most of the settings.
    • Change the password for the root user.

      Log in as the root user with password greenmouse and then issue the passwd operating system command to modify the root user password to a password of your choice.

      The rest of this procedure should be performed as the root user.

    • Set the time zone.

      1. To display supported time zones, type timedatectl list-timezones at the command prompt.

        Once the list is displayed, write down the time zone that you wish to set.

        [root@amdprobe /]# timedatectl list-timezones 
        Africa/Abidjan
        ...
        Pacific/Wallis

        You can use grep command to display only specific time zones. For example:

        [root@amdprobe /]# timedatectl list-timezones | grep America/N 
        America/Nassau
        America/New_York
        America/Nipigon
        America/Nome
        America/Noronha
        America/North_Dakota/Beulah
        America/North_Dakota/Center
        America/North_Dakota/New_Salem
                          
      2. To change the currently used time zone, type timedatectl set-timezone time_zone at the command prompt.
        In the command listed above, replace the time_zone variable with any of the values displayed in the supported time zones list.

        [root@amdprobe /]# timedatectl set-timezone Europe/Warsaw 
                          
    • Set the time and date.

      Set the current time and date using the command:

      [root@amdprobe /]# timedatectl set-time 'YYYY-MM-DD HH:MM:SS' 

      Replace YYYY with a four-digit year, MM with a two-digit month, DD with a two-digit day of the month for the date, and for the time, HH with an hour, MM with a minute, and SS with a second, in two-digit form.

      Note that the quotes as shown in the example above are required in this command to hide the special characters from the shell.

      Execute the timedatectl command to view the current settings.

      [root@amdprobe /]# timedatectl 
            Local time: Thu 2015-05-21 10:51:11 CEST
        Universal time: Thu 2015-05-21 08:51:11 UTC
              RTC time: Thu 2015-05-21 08:51:11
              Timezone: Europe/Warsaw (CEST, +0200)
           NTP enabled: no
      NTP synchronized: no
       RTC in local TZ: no
            DST active: yes
       Last DST change: DST began at
                        Sun 2015-03-29 01:59:59 CET
                        Sun 2015-03-29 03:00:00 CEST
       Next Dst change: DST ends (the clock jumps one hour backwards) at
                        Sun 2015-10-25 02:59:59 CEST
                        Sun 2015-10-25 02:00:00 CET
                    
    • Register your system with Red Hat Network.

      You must be able to apply security updates or bug fixes for software running on Linux. To register the system and enable subscriptions use the subscription-manager command.

      1. Execute subscription-manager register at the command prompt and enter the subscription username and password to register your Red Hat Enterprise Linux.

        [root@amdprobe /]# subscription-manager register 
        Username:
        Password:
      2. Execute subscription-manager attach --auto at the command prompt to attach a specified subscription to the registered system.

        [root@amdprobe /]# subscription-manager attach --auto 
                         
      3. Execute subscription-manager repos --enable=rhel-7-workstation-optional-rpms at the command prompt to enable this system to use specific repositories.

        Make sure that you use the appropriate repository for your type of system:

        Red Hat Enterprise Linux workstation

        subscription-manager repos --enable=rhel-7-workstation-optional-rpms

        Red Hat Enterprise Linux server

        subscription-manager repos --enable=rhel-7-server-optional-rpms


    • Optional: Change the keyboard layout.

      You can override the default keyboard map, which is “us” (“QWERTY”, LATIN-1). For the convenience of users logging in to the AMD locally, the changes can be made either persistent from session to session or valid for only the current session. Note that a persistent change will affect other users, perhaps including users for whom a different layout is needed. In such cases, a temporary (session-only) change may be preferable.

      • To change the keyboard layout temporarily, use the loadkeys command.

        This affects only the user who executes the command and remains in effect only until the end of the session or until the command is revoked.

        To use, for example, the “AZERTY” PC keyboard layout, issue the loadkeys azerty command.

        To return to the default settings, issue the loadkeys --default command.

      • To make a persistent change, edit the keyboard configuration file:

        1. To find the names of available keyboard layouts, execute the localectl list-keymaps . For example:

          [root@amdprobe /]# localectl list-keymaps 
          ANSI-dvorak
          ...
          windowkeys

          You can use grep command to display only specific keymaps. For example:

          [root@amdprobe /]# localectl list-keymaps | grep pl-dvorak 
          pl-dvorak
          pl-dvorak_altquotes
          pl-dvorak_quotes
                                
        2. To change the currently used keyboard layout, type localectl set-keymap layout at the command prompt.

          This change is global. The key map is loaded by startup scripts and requires that you restart your system for the changes to go into effect. When you enter your password, remember that the new key mapping will be active at the time of login.

          [root@amdprobe /]# localectl set-keymap pl-dvorak 
                                
  • No labels

3 Comments

  1. If installing from DVD, without network, obtaining the packages required for AMD software installation that are not included in the base workstation or server repository, can be a challenge.

    As for perl-Switch this package is on the rhel-7-server-optional-rpms (see above) repository.

    for instance on a server with internet and RH access:
    $ yum reinstall perl-Switch --downloadonly

    When installing without network, best to bring it along on your USB stick (with the kickstart config).

  2. Tip: the kickstart file can also be read from an NFS share.  Especially handy when installing with DVD-ROM, where it may be cumbersom to include the ks.cfg.
    ks=nfs:<server>:/<path>


    Tip #2: NFS server can be enabled on a Windows Server. On your CAS for example.