6.2.2.16.3. interface-names

6.2.2.16.3.1. Introduction

The interface-names command of the set advanced-configuration subgroup enables:

  • Assigning the physical interfaces of the GCap:

    • The management interfaces ( gcp0 and gcp1)

    • The capture and detection interfaces mon0 to monx or virtual monvirt
      This assignment is done with the set advanced-configuration interface-names <PCI-ID> <nom des interfaces>... command

  • Resetting the current assignment and returning to an automatic assignment
    This assignment is done with the set advanced-configuration interface-names reset command

6.2.2.16.3.2. Prerequisites

  • User: setup

  • Dependencies: the detection engine must be switched off

6.2.2.16.3.3. Commands

set advanced-configuration interface-names {{<PCI-ID> <name>...}|reset}

6.2.2.16.3.4. Example for manually assigning GCap interfaces

  • To verify the need to assign interfaces

    • Enter the following command.

      (gcap-cli) show interfaces

    • Validate.
      The system displays the available capture interfaces.

      Waiting 10s for interfaces to be up

Name    State    Physical Address  Status Speed Type    Vendor ID Device ID PCI bus
gcp0    Enabled  00:50:56:01:29:01 UP     1Gb   RJ45    0x8086    0x10d3    0b:00.0        
gcp1    Disabled 00:50:56:01:29:02 UP     1Gb   RJ45    0x8086    0x10d3    13:00.0        
mon0    Enabled  00:50:56:01:29:03 UP     1Gb   RJ45    0x8086    0x10d3    1b:00.0        
mon1    Disabled 00:50:56:01:29:04 UP     1Gb   RJ45    0x8086    0x10d3    04:00.0        
mon2    Disabled 00:50:56:01:29:05 UP     1Gb   RJ45    0x8086    0x10d3    0c:00.0        
mon3    Disabled 00:50:56:01:29:06 UP     1Gb   RJ45    0x8086    0x10d3    14:00.0        
monvirt Enabled  N/A               UP     N/A   Virtual N/A       N/A       N/A

      In this case, the interface names are correct. The existing assignment was successfully made.
      Example of a fault case:

      Name     State     Physical Address   Status Speed  Type         Vendor ID Device ID PCI bus
eno12399 N/A       68:05:ca:dd:fe:fa  UP     1Gb    1000BASE-SX  0x8086    0x1572    31:00.0        
eno12409 N/A       68:05:ca:dd:fe:fb  UP     1Gb    1000BASE-SX  0x8086    0x1572    31:00.1        
eno12419 N/A       68:05:ca:dd:fe:fc  UP     1Gb    1000BASE-SX  0x8086    0x1572    31:00.2        
eno12429 N/A       68:05:ca:dd:fe:fd  UP     1Gb    1000BASE-SX  0x8086    0x1572    31:00.3        
eno8303  N/A       ec:2a:72:02:3a:1c  DOWN   N/A    RJ45         0x14e4    0x165f    04:00.0        
eno8403  N/A       ec:2a:72:02:3a:1d  DOWN   N/A    RJ45         0x14e4    0x165f    04:00.1        
monvirt  Disabled  N/A                UP     N/A    Virtual      N/A       N/A       N/A

    Note

    Since the interfaces are unassigned, access via SSH connection on the gcpx port does not work.
    So only:

    • Physical access or

    • Via web access on the management console (iDRAC) or

    • Via SSH connection on the iDRAC port

    In this case, the system was unable to associate each of the network interfaces with its name.

  • To correct this problem, perform the following procedure.

    Astuce

    To make the assignment, the ID PCI Bus must be used.

    For all interfaces, there are three parts:

    • A set of four interfaces corresponding to the capture interfaces mon0 to monx

    • A set of two interfaces corresponding to the management interfaces gcp0 to gcp1

    • The monvirt line which is not to be assigned

    Thus, the assignment to be made is as follows, sorted by:

    • Vendor ID

    • Device ID

    • Physical address (PCI bus)

    In this example, this gives:

    Detected name (Name)

    Vendor ID

    Device ID

    PCI bus

    NAME to be assigned

    eno12399

    0x8086

    0x1572

    31:00.0

    `mon0`

    eno12409

    0x8086

    0x1572

    31:00.1

    `mon1`

    eno12419

    0x8086

    0x1572

    31:00.2

    `mon2`

    eno12429

    0x8086

    0x1572

    31:00.3

    `mon3`

    eno8303

    0x8086

    0x165f

    04:00.0

    `gcp0`

    eno8403

    0x8086

    0x165f

    04:00.1

    `gcp1`

    monvirt

    N/A

    N/A

    N/A

    no assignment

    • Enter the following command.

      (gcap-cli) set advanced-configuration interface-names 31:00.0 mon0 31:00.1 mon1 31:00.2 mon2 31:00.3 mon3 04:00.0 gcp0 04:00.1 gcp1

    • Validate.

      Danger

      It is possible to invert gcp0 and gcp1, mon0 and mon1 with a bad configuration of this command.

      The command will be executed but there is loss of ssh connection and loss of pairing between GCap and GCenter.

6.2.2.16.3.5. Example to reset the current assignment and return to an automatic assignment

  • Enter the following command.

    (gcap-cli) set advanced-configuration interface-names reset

  • Validate.
    The system displays the following message:

    Network interfaces will be refreshed and corresponding configuration applied
Rebooting in 10 seconds...
You can still abort by pressing CTRL+C.