6.2.1.16. network-config

6.2.1.16.1. Introduction

The GCap includes:

  • capture and monitoring interfaces (mon0 to monx)

  • network interfaces (gcp0/gcp1) for managing the probe via SSH and for pairing with the GCenter

    Two cases are possible:

    • Single-interface configuration

      SSH connection for GCap management and VPN communication are managed through the gcp0 interface.

    • dual-interface configuration.

      The VPN communication is controlled by the gcp0 interface.
      The SSH connection for GCap management is handled by the gcp1 interface.

For more information on network interfaces, refer to the GCap input / output description section.
The network-config command of the show subgroup enables displaying:

  • The status of all GCap interfaces: show network-config configuration command

  • The status for only the network interfaces: show network-config status command

    • The status for each interface: command show network-config gcp0 or show network-config gcp1

    • The status for all network interfaces: show network-config status command

  • The domain name: show network-config domain command

  • The host name: show network-config hostname command

  • The interface used to manage the probe in SSH: show network-config ssh command

  • The speed of the VPN link between GCap and Gcenter: show network-config vpn-link speed command

6.2.1.16.2. Prerequisites

  • User: setup

  • Dependencies: the detection engine must be switched off

6.2.1.16.3. Commands

show network-config {configuration|domain|gcp0|gcp1|hostname|ssh|status|vpn-link}

6.2.1.16.4. Example of displaying the GCap configuration

  • Enter the following command.

    (gcap-cli) show network-config configuration

  • Validate.

    Depending on the single or dual interface configuration, the information is different.
    The two cases are listed below.

6.2.1.16.4.1. Single-interface configuration

In this case, the system displays the network configuration information including gcp1 (not used).

(gcap-cli) show network-config configuration
{
    "hostname": "GCap",
    "domain_name": "gatewatcher.com",
    "gcp0": {
        "description": "VPN / SSH",
        "ip_address": "X.X.X.X",
        "mask": "255.255.255.0",
        "default_gateway": "X.X.X.X",
        "enabled": true,
        "mtu": 1500
    },
    "gcp1": {
        "description": "SSH",
        "ip_address": "None",
        "mask": "255.255.255.0",
        "default_gateway": "",
        "enabled": false,
        "mtu": 1500
    },
    "mon0": {
        "description": "default",
        "enabled": true,
        "filtering_rules": {},
        "mtu": 1500
    },
    "mon1": {
        "description": "default",
        "enabled": false,
        "filtering_rules": {},
        "mtu": 1500
    },
    "mon2": {
        "description": "default",
        "enabled": false,
        "filtering_rules": {},
        "mtu": 1500
    },
    "mon3": {
        "description": "default",
        "enabled": false,
        "filtering_rules": {},
        "mtu": 1500
    }
}

6.2.1.16.4.2. Dual-interface configuration

In this case, the system displays the configuration information.

(gcap-cli) show network-config configuration
{
    "hostname": "GCap",
    "domain_name": "gatewatcher.com",
    "gcp0": {
        "description": "VPN",
        "ip_address": "X.X.X.X",
        "mask": "255.255.255.0",
        "default_gateway": "X.X.X.X",
        "enabled": true,
        "mtu": 1500
    },
    "gcp1": {
        "description": "SSH",
        "ip_address": ""X.X.X.X"",
        "mask": "255.255.255.0",
        "default_gateway": "255.255.255.0",
        "enabled": true,
        "mtu": 1500
    },
    "mon0": {
        "description": "default",
        "enabled": true,
        "filtering_rules": {},
        "mtu": 1500
    },
    "mon1": {
        "description": "default",
        "enabled": false,
        "filtering_rules": {},
        "mtu": 1500
    },
    "mon2": {
        "description": "default",
        "enabled": false,
        "filtering_rules": {},
        "mtu": 1500
    },
    "mon3": {
        "description": "default",
        "enabled": false,
        "filtering_rules": {},
        "mtu": 1500
    }
}

6.2.1.16.5. Example of displaying the GCap domain

  • Enter the following command.

    (gcap-cli) show network-config domain

  • Validate.
    The system displays the domain name.

    Current domain name: gatewatcher.com

6.2.1.16.6. Example of displaying the gcp0 interface configuration

  • Enter the following command.

    (gcap-cli) show network-config gcp0

  • Validate.
    The system displaying the gcp0 interface configuration.
    Depending on the single or dual interface configuration, the information is different.
    The two cases are listed below.

6.2.1.16.6.1. Single-interface configuration: gcp0 interface

SSH and VPN connections are handled by the gcp0 interface.
In this case, the system displays:

Interface ```gcp0``` configuration (VPN / SSH):
        - IP Address: X.X.X.X
        - Mask: 255.255.255.0
        - Gateway: X.X.X.X

6.2.1.16.6.2. Dual-interface configuration: gcp0 interface

The VPN communication is controlled by the gcp0 interface.
The SSH connection for GCap management is handled by the gcp1 interface.
In this case, the system displays:

Interface gcp0 configuration (VPN):
        - IP Address: X.X.X.X
        - Mask: 255.255.255.0
        - Gateway: X.X.X.X

6.2.1.16.7. Example of displaying the gcp1 interface configuration

  • Enter the following command.

    (gcap-cli) show network-config gcp1

  • Validate.
    The system displaying the gcp1 interface configuration.
    Depending on the single or dual interface configuration, the information is different.
    The two cases are listed below.

6.2.1.16.7.1. Single-interface configuration: gcp1 interface

In this case, the system displays the information of the gcp1 not used:

Interface gcp1 configuration (SSH):
        - IP Address: None
        - Mask: 255.255.255.0

6.2.1.16.7.2. Dual-interface configuration: gcp1 interface

In this case, the system displays the information of the gcp1 used:

Interface gcp1 configuration (SSH):
        - IP Address: X.X.X.X
        - Mask: 255.255.255.0
        - Gateway: X.X.X.X

6.2.1.16.8. Example of displaying the host name of the GCap

  • Enter the following command.

    (gcap-cli) show network-config hostname

  • Validate.
    The system displays the interface the host name of the GCap.

    Current hostname: GCap-name

6.2.1.16.9. Example of displaying the interface used to manage the probe in SSH

  • Enter the following command.

    (gcap-cli) show network-config ssh

  • Validate.
    The system displays the SSH interface used to manage the GCap.
    In the case of the single-interface configuration, the system displays:

    SSH is using interface gcp0

    In the case of dual-interface configuration, the system displays:

    SSH is using interface gcp1

6.2.1.16.10. Example of displaying the status of the GCap's gcp0 and gcp1 network interfaces

  • Enter the following command.

    (gcap-cli) show network-config status

  • Validate.
    The system displays the status of the GCap network interfaces.

     Name         Address        Carrier      Speed          Type
 gcp0     xx:xx:xx:xx:xx:xx        UP   1000Mb/s          RJ45
 gcp1     xx:xx:xx:xx:xx:xx        UP   1000Mb/s          RJ45

    For each interface, the following information is displayed:

    • Address : interface MAC address

    • Carrier :

    • valeur UP: the physical interface is connected

    • valeur DOWN: the physical interface is not connected

    • Speed : interface speed in Mb/s

    • Type : the type of cable/sfp connected to the physical port