5.5.9. Managing the network parameters of `Tunnel` and `Management` interfaces

5.5.9.1. Introduction

This procedure describes:

Viewing the network settings
Modifying these parameters.

To...	Use the command	described in the procedure
obtain an overview of the information on all network interfaces	show network-config configuration	Procedure A
display for each interface: MAC address, carrier presence, speed, and type of connection	show interfaces	Procedure B
display or change the domain name	show network-config domain or set network-config domain	Procedure C
display or change the system name	show network-config hostname or set network-config hostname	Procedure D
display or modify the interface used in SSH for administering the GCap and the GCap GCenter link	show interfaces or set interfaces assign-role	Procedure E
display or modify the MTU value of the interfaces	show interfaces or set advanced-configuration mtu	Procedure F
display or modify the TCP/IP settings of the Management / Tunnel interfaces	show network-config gcp0	Procedure G

5.5.9.2. Prerequisites

User: setup
Commands used in this procedure:

5.5.9.3. Preliminary operations

Connect to the GCap (see Procedure for connecting to the GCap via SSH).
Stop the detection engine (see monitoring-engine).

5.5.9.4. Procedure A: Display the network configuration

Enter the show network-config configuration command then validate.
The system displays the information of all network interfaces.
In this procedure, only the information on the management and tunnel network interfaces is detailed.
For information on the monx capture interfaces, refer to the Procedure for managing monx capture interface settings.
The system displays the following information:
- System name (hostname)
- Domain name (domain_name)
- Details of the TCP/IP settings for each network interface (management and tunnel)
- Whether or not the interface is enabled

(gcap-cli) show network-config configuration

{
    "hostname": "GCap",
    "domain_name": "domain.local",
    "tunnel": {
        "ip_address": "192.168.1.1",
        "mask": "255.255.255.0",
        "default_gateway": "192.168.1.254",
    },
    "management": {
        "ip_address": "192.168.2.1",
        "mask": "255.255.255.0",
        "default_gateway": "192.168.2.254",
    },

Note

The configuration in the above example is dual interface.

5.5.9.5. Procedure B: display the status of the GCap network interfaces

Enter the following command.
```
(gcap-cli) show interfaces
```
Validate.
The system displays the status of the GCap network interfaces.

For each interface, the following information is displayed:

Label: The label name of the interface
Name: The system name of the interface
Role: The role assigned to the interface
Capture capability: If the interface can capture traffic
MTU: The MTU of the interface
Physical Address: the MAC address of the interface
Speed: the interface speed
Type: the type of cable/sfp connected to the physical port
Vendor ID: The Vendor ID of the network card
Device ID: The Device ID of the network card
PCI bus: PCI bus number used by the network card

5.5.9.6. Procedure C : display/change the GCap domain name

To display the current name:
- Enter the following command.
```
(gcap-cli) show network-config domain
```
- Validate.
  The system displays the domain name.
```
Current domain name: gatewatcher.com
```

To change the current name:

Enter the following command.

(gcap-cli) set network-config domain-name gatewatcher.com

Validate.

 Setting hostname/domain name to:
    - Hostname: gcap-int-129-dag
    - Domain name: gatewatcher.com
 Do you want to apply this new configuration? (y/N)

Press y and then confirm.

Applying configuration...
Procedure completed with success

To check the value modification:
- Enter the following command.
```
(gcap-cli) show network-config domain
```
- Validate.
  The system displays the domain name.
```
Current domain name: gatewatcher.com
```

5.5.9.7. Procedure D: display or change the GCap name

To display the current name:
- 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
```

To change the current name:

Enter the following command.

(gcap-cli) set network-config hostname gcap-name 

Validate.

Setting hostname/domain name to:
 - Hostname: gcap-name 
 - Domain name: gatewatcher.com
Do you want to apply this new configuration? (y/N)

Press y and then confirm

Applying configuration...
Procedure completed with success

To check the value modification:
- Enter the following command.
```
(gcap-cli) show network-config hostname
```
- Validate.
  The system displays the host name of the GCap.
```
Current hostname: GCap-name
```

5.5.9.8. Procedure E: display or modify the interface used to manage the GCap in SSH

To display the current configuration:
- Enter the following command.
```
(gcap-cli) show interfaces
```
- Validate.
  The system displays the role of the different interface of GCap (for SSH connection management, for IPSec tunnel: tunnel, for both: management-tunnel ).
  - In the case of the single-interface configuration, the system displays:
  - In the case of dual-interface configuration, the system displays:

To configure the enpXXXX interface for SSH and the enpYYYY interface for IPSec:

Enter the following command.

(gcap-cli) set interfaces assign-role enpXXXX management

Validate.

Enter the following command.

(gcap-cli) set interfaces assign-role enpYYYY tunnel

Validate.

Enter the following command.

(gcap-cli) set network-config management ip-address X.X.X.X gateway X.X.X.X mask X.X.X.X

Validate.

Enter the following command.

(gcap-cli) set network-config tunnel ip-address Y.Y.Y.Y gateway Y.Y.Y.Y mask Y.Y.Y.Y confirm

Validate.

To configure the enpXXXX interface for SSH and IPSec:

Note

No other interface is not used.

Enter the following command.

(gcap-cli) set interfaces assign-role enpXXXX management-tunnel

Validate.

Enter the following command.

(gcap-cli) set network-config management ip-address X.X.X.X gateway X.X.X.X mask X.X.X.X confirm

Validate.

5.5.9.9. Procedure F: display or change the MTU value

To display the current configuration of enabled interfaces:
- Enter the following command.
```
(gcap-cli) show interfaces
```
- Validate.
  The system displays the result.
  
  The values are displayed for all enabled network interfaces.
To change the current configuration of enabled interfaces: e.g. to change the MTU value of the management interface:
- Enter the following command.
```
(gcap-cli) set advanced-configuration mtu enp19s0 2000
```
- Validate.
  The system displays the result.
```
Updating Network MTU configuration to:
   - enp19s0: 2000
```

5.5.9.10. Procedure G: display or modify the TCP/IP settings of a `management` and/or `tunnel` interface

To display the management and tunnel interface configuration:
- Enter the following command.
```
(gcap-cli) show network-config management
```
- Validate.

(gcap-cli) show network-config configuration

{
    "hostname": "GCap",
    "domain_name": "domain.local",
    "tunnel": {
        "ip_address": "192.168.1.1",
        "mask": "255.255.255.0",
        "default_gateway": "192.168.1.254",
    },
    "management": {
        "ip_address": "192.168.2.1",
        "mask": "255.255.255.0",
        "default_gateway": "192.168.2.254",
    },

To change the configuration of the management interface address:

Enter the following command.

(gcap-cli) set network-config management ip-address x.x.x.x gateway y.y.y.y mask z.z.z.z

Validate.
The system displaying the management interface configuration.

Setting interface management to configuration :
   - IP Address: X.X.X.X
   - Mask: Y.Y.Y.Y
   - Gateway: Z.Z.Z.Z
Do you want to apply this new configuration? (y/N)

Press y and then confirm.

5.5.9. Managing the network parameters of Tunnel and Management interfaces

5.5.9.1. Introduction

5.5.9.2. Prerequisites

5.5.9.3. Preliminary operations

5.5.9.4. Procedure A: Display the network configuration

5.5.9.5. Procedure B: display the status of the GCap network interfaces

5.5.9.6. Procedure C : display/change the GCap domain name

5.5.9.7. Procedure D: display or change the GCap name

5.5.9.8. Procedure E: display or modify the interface used to manage the GCap in SSH

5.5.9.9. Procedure F: display or change the MTU value

5.5.9.10. Procedure G: display or modify the TCP/IP settings of a management and/or tunnel interface

5.5.9. Managing the network parameters of `Tunnel` and `Management` interfaces

5.5.9.10. Procedure G: display or modify the TCP/IP settings of a `management` and/or `tunnel` interface