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