The driver and interface configuration is performed through the Interface identification and network setup on the main rtminst menu. You will choose one or more communication ports and identify other interfaces as the capture interfaces.

The AMD machine is equipped with at least two network interfaces. Designate at least one NIC as a communication port that is used to log in remotely via SSH, send data to the report server, and communicate with the RUM Console software. Configure another NIC to collect traffic data (enter promiscuous mode).

  1. Select Interface identification and network setup from the main rtminst menu.

    The program checks the available drivers and interfaces and displays the current configuration information, as shown in the example below.

    Note:

    Errors or missing configuration items are displayed as exclamation marks (!) and in the reference error messages displayed further down on the screen. The items changed since the last output refresh are marked with (*).

    Figure 1. Selecting the Interface Identification and Network Setup

    Dynatrace AMD Installation Toolkit ver. 12.4.11.xxx
    AMD type: RTM classic
    Options:
            1 - Interface identification and network setup
            2 - AMD setup
            X - Exit
    Select an option and press `Enter`: Invalid selection
    Dynatrace AMD Installation Toolkit ver. 12.4.11.129
    AMD type: RTM classic
    Options:
            1 - Interface identification and network setup
            2 - AMD setup
            X - Exit
    Select an option and press `Enter`: 1
    Checking for missing drivers... done
    Bringing all interfaces up... done
    Network setup:
            Default gateway:  !
            Hostname:         none
            AMD type:         RTM classic
            Driver type:      customized
      |          |        |Aval.      |Link     |      |       |Link  |IP/
     #|Name      |HW type |driver     |param.   |Mode  |Traffic|det.  |Label
    --|----------|--------|-----------|---------|------|-------|------|--------------
     1|eth0      |e1000   |Nat.+Cust. |default  |Comm. |In     |Y     |DHCP
     2|eth1      |e1000   |Nat.+Cust. |default  |Capt. |In     |Y     |
     3|eth2      |e1000   |Nat.+Cust. |default  |Capt. |In     |Y     |
     4|eth3      |e1000   |Nat.+Cust. |default  |Capt. |In     |Y     |
     5|eth4      |e1000   |Nat.+Cust. |default  |Capt. |In     |Y     |
      (*) - changed since last refresh
    	! - Problems:
    	No default gateway, use N to setup network
    In commands below substitute # with an interface number from table.
    Type: 'M #' to setup port mode
          'P #' to setup link parameters
          'I #' to show details about interface and blink if possible
          'T' to change driver mode
          'N' to change network setup
          'A' to set all connected unused ports to capture mode
          'S' to save configuration and apply changes
          'X' to exit
          press ENTER to refresh
    Select an option and press `Enter` :
     Selecting the Interface Identification and Network Setup in Earlier Releases
     AMD Installation Toolkit ver. ndw.12.4.XXX
    
    Options:
            1 - Interface identification (legacy)
            2 - Interface identification and network setup
            3 - AMD setup
            X - Exit
    Select an option and press `Enter` :2
    Checking for missing drivers... done
    Bringing all interfaces up... done
    
    
    Network setup:
            Default gateway:   !
            Hostname:          localhost.localdomain
    
    
            Driver type:      customized
    
      |         |        |Aval.     |Link     |      |       |Link |IP/
     #|Name     |HW type |driver    |param.   |Mode  |Traffic|det. |Label
    --|---------|--------|----------|---------|------|-------|-----|---------
     1|eth0     |e1000e  |Nat.+Cust.|default  |Unused|In     |Y    |
     2|eth1     |8139cp  |Native    |default  |Unused|In+Out |Y    |
      (*) - changed since last refresh
    
     ! - Problems:
       No default gateway, use N to set up network.
       Communication port not defined, use M command.
       Capture port not define, use M command.
    
    
    In commands below substitute # with an interface number from table.
    Type: 'M #' to setup port mode
          'P #' to setup link parameters
          'I #' to show details about interface and blink if possible
          'T' to change driver mode
          'N' to change network setup
          'A' to set all connected unused ports to capture mode
          'S' to save configuration and apply changes
          'X' to exit
          press ENTER to refresh
    
    Select an option and press `Enter` :


  2. In the current configuration information, review the configuration changes.

    Configuring drivers and interfaces is an iterative process of displaying the current configuration, making a change to it or making a change to the physical configuration by connecting or disconnecting a network cable, and then re-displaying the new configuration information. Therefore, after each configuration change you make, compare the expected result with the actual result shown in the updated screen information.

    This process helps you associate the physical interfaces with particular entries in the rtminst table. The association is achieved by connecting a network cable to the interface and observing the interface being recognized by rtminst. The interface appears as Y in the Link det. column, and, if there is traffic on the interface, the traffic information appears in the Traffic column as In, Out or In+Out.

    It is not necessary to disconnect all of the network cables before you can identify a particular interface. When you connect each successive cable to the interfaces, their entries are added to the table, allowing you to match the physical interfaces to the entries in the table. To refresh the table, press [Enter] after each physical change: after you plug in a cable, wait a few seconds then press [Enter]. It should take only a few seconds for the system to recognize a physical change made to one of the interfaces.

    We recommend that traffic is present on each network cable used for the interface identification, as it can make it possible to identify the interfaces faster and more easily.

    Note:

    Depending on traffic volume on a given interface, the table information might not always be updated to reflect the new state when you press [Enter]. If you have problems with a link or traffic not being detected, use the I # command to force rtminst to take extra time to perform additional tests on the interface and display the updated information.
  3. Configure the default gateway and hostname.

    If either of these are currently undefined, specify the correct settings. If a particular setting is correct, leave it unchanged. The default gateway is the fallback for all communication ports, though you can also specify an additional gateway for each communication port when you are defining specific communication port parameters.

    1. Select [N] to change network setup

    2. Specify a new setting for the default gateway and press [Enter]. Press [Enter] without specifying a new value to retain the current setting.

    3. Specify a new setting for the host name and press [Enter]. Press [Enter] without specifying a new value, to retain the current setting.

    Figure 2. Configuring Default Gateway and Hostname

    Select an option and press `Enter` :N
    IP address of default gateway (enter n to leave undefined): [] 172.18.128.1
    Hostname: [] vantageamd
    
    
    Network setup:
            Default gateway:  172.18.128.1
            Hostname:         vantageamd
            AMD type:         RTM classic
            Driver type:      customized
     Configuring Default Gateway and Hostname in Earlier Releases
     Select an option and press `Enter` :N
    IP address of default gateway (enter n to leave undefined): [] 172.18.128.1
    Hostname: [] vantageamd
    
    
    Network setup:
            Default gateway:  172.18.128.1
            Hostname:         vantageamd


  4. Specify the type of network driver to use.

    In general, you should choose the Dynatrace custom network drivers.

    The current driver type is displayed on the rtminst output. To change the driver type, enter [T] and then select [C] for custom or [N] for native, as on the example below.

    Figure 3. Specifying the Type of Network Driver to Use

     In commands below substitute # with an interface number from table.
    Type: 'M #' to setup port mode
          'P #' to setup link parameters
          'I #' to show details about interface and blink if possible
          'T' to change driver mode
          'N' to change network setup
          'A' to set all connected unused ports to capture mode
          'S' to save configuration and apply changes
          'X' to exit
          press ENTER to refresh
    
    Select an option and press `Enter` :T
    
    
    Current driver type: customized
    
    Select:  N - use native drivers
             C - use custom drivers
             X - return to previous screen
    C
    
    Network setup:
            Default gateway:  172.18.128.1
            Hostname:         vantageamd
    
            Driver type:      customized
  5. Configure the communication port or ports.

    Choose the port (or ports) to use for communication and configure them. Leave at least one port available to configure as a capture port.

    Note:

    Although it is possible to designate all of the NICs as communication ports, this configuration is not functional because no sniffing ports would be available on the device.
    1. Identify the physical port.

      Identify the physical port by observing the changes in the table entries, as explained above in Step 2. Also, you can display the details about the interface and blink the interface LED (if equipped) using the I # option, where # is the number of the entry in the table of interfaces.

    2. Select the port to be a communication port.

      Enter M # where # is the number of the entry in the table of interfaces, and then select C to configure the port to be a communication port, as shown in the example below.

    3. Specify the IP address for this communications port.

    4. Specify the network mask for this communications port.

    5. Optional: Specify an additional gateway IP address to be used for this communications port, if any.

      Enter n for no additional gateway.

    Figure 4. Configuring Communication Port or Ports

     Select an option and press `Enter` :M2
    
    Port: eth1
    Current port mode: Communication
    IP: 172.18.131.241 Mask: 255.255.252.0
    Type:  C - to setup port in communication mode
           S - to setup port in capture mode
           U - to setup port as unused one
           X - return to previous screen
    Select an option and press `Enter` :C
    IP address: [] 172.18.131.241
    Network mask: [] 255.255.252.0
    IP address of additional gateway (enter n to leave undefined): [] n
  6. Configure the capture ports.

    Identify the port or ports to be the capture ports and configure each of them as outlined below.

    Note:

    It is possible that some of the interfaces will not be used. Generally, unused interfaces do not cause problems. However, to produce a cleaner installation and avoid false error messages, we recommend that you disable them.
    • You can identify and configure specific capture ports individually.

    • Alternatively you can issue a single command to set all connected unused ports to capture mode.

    To identify and configure specific capture ports individually:

    1. Identify the physical port.

      You should be able to identify the physical port by observing changes in the table entries, as explained above in Step 2. As an additional help, you can display details about the interface and blink the interface LED (if equipped) using the I # option, where # is the number of the entry in the table of interfaces.

    2. Select the port to be a capture port.

      Enter M # where # is the number of the entry in the table, and then select S to configure the port to be a capture port and press [Enter].

      Figure 5. Selecting a Capture Port

       In commands below substitute # with an interface number from table.
      Type: 'M #' to setup port mode
            'P #' to setup link parameters
            'I #' to show details about interface and blink if possible
            'T' to change driver mode
            'N' to change network setup
            'A' to set all connected unused ports to capture mode
            'S' to save configuration and apply changes
            'X' to exit
            press ENTER to refresh
      
      Select an option and press `Enter` :M1
      
      Port: eth0
      Label:
      Type:  C - to setup port in communication mode
             S - to setup port in capture mode
             U - to setup port as unused one
             X - return to previous screen
      Select an option and press `Enter` :S
    3. Optional: Specify the capture port label.

      Enter a label name of the port. Use a name to help you identify the interface at a later time. Press [Enter] to return to previous menu.

    4. Optional: Configure the link layer parameters for the interface.

      Select full duplex speed or auto-negotiation.

      Note:

      When an AMD with 1 GB copper wire network cards is connected to a 100 Mbps tap or a switch mirror port and auto-negotiation fails, you can force the traffic sniffing devices to full duplex at 100 Mbps to avoid performance degradation.

      Enter P# where # is the number of the entry in the table and then select the appropriate option.

      Figure 6. Configure Link Layer Parameters for a Capture Port

       In commands below substitute # with an interface number from table.
      Type: 'M #' to setup port mode
            'P #' to setup link parameters
            'I #' to show details about interface and blink if possible
            'T' to change driver mode
            'N' to change network setup
            'A' to set all connected unused ports to capture mode
            'S' to save configuration and apply changes
            'X' to exit
            press ENTER to refresh
      
      Select an option and press `Enter` :P1
      
      Chose new link parameters:
             0 - autonegotiation
             1 - Full duplex 1000Mb/s
             2 - Full duplex 10000Mb/s
             X - return to previous screen
      Select an option and press `Enter` :1

    To set all connected unused ports to capture mode:

    1. Ensure that the link is detected for all of the relevant ports.

      Connect a network cable to the interface and observe the interface being recognized by rtminst. The interface will appear as Y in the Link det. column.

    2. Select [A] to set all connected unused ports to capture mode.

      You are prompted to confirm your choice, after confirming, the ports listed as capture ports appear in the table.

       Select an option and press `Enter` :A
      All unused ports with links detected and suitable drivers available will be set to capture mode.
      Do you want to continue? (y or n) y
  7. Review the settings.

    Before exiting the setup, review all of the settings. All of the configuration settings are displayed on the screen and can be checked.

    Figure 7. Reviewing Configuration Settings

    Dynatrace AMD Installation Toolkit ver. 12.4.11.xxx
    AMD type: RTM classic
    Options:
            1 - Interface identification and network setup
            2 - AMD setup
            X - Exit
    Select an option and press `Enter`: 1
    Checking for missing drivers... done
    Bringing all interfaces up... done
    Network setup:
    		Default gateway:  172.18.128.1
            Hostname:         vantageamd
            AMD type:         RTM classic
            Driver type:      customized
      |          |        |Aval.      |Link     |      |       |Link  |IP/
     #|Name      |HW type |driver     |param.   |Mode  |Traffic|det.  |Label
    --|----------|--------|-----------|---------|------|-------|------|--------------
     1|eth0      |e1000   |Nat.+Cust. |default  |Comm. |In     |Y     |DHCP
     2|eth1      |e1000   |Nat.+Cust. |default  |Capt. |In     |Y     |
     3|eth2      |e1000   |Nat.+Cust. |default  |Capt. |In     |Y     |
     4|eth3      |e1000   |Nat.+Cust. |default  |Capt. |In     |Y     |
     5|eth4      |e1000   |Nat.+Cust. |default  |Capt. |In     |Y     |
      (*) - changed since last refresh
    
    In commands below substitute # with an interface number from table.
    Type: 'M #' to setup port mode
          'P #' to setup link parameters
          'I #' to show details about interface and blink if possible
          'T' to change driver mode
          'N' to change network setup
          'A' to set all connected unused ports to capture mode
          'S' to save configuration and apply changes
          'X' to exit
          press ENTER to refresh
    Select an option and press `Enter` :
     Reviewing Configuration Settings in Earlier Releases
     AMD Installation Toolkit ver. ndw.12.4.XXX
    
    Options:
            1 - Interface identification (legacy)
            2 - Interface identification and network setup
            3 - AMD setup
            X - Exit
    Select an option and press `Enter` :2
    Checking for missing drivers... done
    Bringing all interfaces up... done
    
    
    Network setup:
            Default gateway:  172.18.128.1
            Hostname:         vantageamd
    
    
            Driver type:      customized
    
      |         |        |Aval.     |Link     |      |       |Link |IP/
     #|Name     |HW type |driver    |param.   |Mode  |Traffic|det. |Label
    --|---------|--------|----------|---------|------|-------|-----|---------------
     1|eth0     |e1000e  |Nat.+Cust.|default  |Capt. |In     |Y    |
     2|eth1     |8139cp  |Native    |default  |Comm. |In+Out |Y    |172.18.131.241
      (*) - changed since last refresh
    
    
    In commands below substitute # with an interface number from table.
    Type: 'M #' to setup port mode
          'P #' to setup link parameters
          'I #' to show details about interface and blink if possible
          'T' to change driver mode
          'N' to change network setup
          'A' to set all connected unused ports to capture mode
          'S' to save configuration and apply changes
          'X' to exit
          press ENTER to refresh
    
    Select an option and press `Enter` :
  • No labels