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 0x165f 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.

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.