5.5.9. Managing the network parameters of the gcp0
and gcp1
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 network-config status |
Procedure B |
display or change the domain name |
show network-config domain set network-config domain |
Procedure C |
display or change the system name |
show network-config hostname set network-config hostname |
Procedure D |
display or modify the interface used in SSH for administering the GCap and the GCap GCenter link |
show network-config ssh and set network-config ssh |
Procedure E |
display or modify the MTU value of the interfaces |
show advanced-configuration mtu set advanced-configuration mtu |
Procedure F |
display or modify the TCP/IP settings of the GCPx interfaces |
show network-config gcpx |
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 gcpx network interfaces is detailed.
For information on the
monx
capture interfaces, refer to the Procedure for managingmonx
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 (
gcp0
andgcp1
)Whether or not the interface is enabled
(gcap-cli) show network-config configuration
{
"hostname": "GCap",
"domain_name": "domain.local",
"gcp0": {
"description": "VPN / SSH",
"ip_address": "192.168.1.1",
"mask": "255.255.255.0",
"default_gateway": "192.168.1.254",
"enabled": true,
"mtu": 1500
},
"gcp1": {
"description": "SSH",
"ip_address": "None",
"mask": "255.255.255.0",
"default_gateway": "",
"enabled": false,
"mtu": 1500
},
Note
The configuration in the above example is single interface, i.e. gcp0
used and gcp1
not used.
For gcp0
:
the description field indicates that VPN and SSH connections are on this interface
the TCP/IP parameters are listed
since the interface is enabled, the enabled parameter is true.
For gcp1
:
the description field indicates that the SSH connection is on this interface
the TCP/IP parameters are set to None
since the interface is disabled, the enabled parameter is false.
5.5.9.5. Procedure B: display the status of the GCap network interfaces gcp0
and gcp1
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
: the MAC address of the interfaceCarrier
: status of the current transmission:value
UP
: physical interface is connectedvalue
DOWN
: physical interface is not connected
Speed
: the interface speed in Mb/sType
: the type of cable/sfp connected to the physical port
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... 00% Generating interfaces configuration [OK] 09% Generating network configuration [OK] 18% Generating sshd configuration [OK] 27% Reconfiguring network [OK] 36% Reconfiguring firewall [OK] 45% Notifying new network addresses [OK] 54% Restarting sshd service [OK] 63% Restarting rsyslog service [OK] 72% Restarting gcenter-xfer-daemon service [OK] 81% Restarting netdata service [OK] 90% Restarting rsyslog service [OK] 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... 00% Generating interfaces configuration [OK] 09% Generating network configuration [OK] 18% Generating sshd configuration [OK] 27% Reconfiguring network [OK] 36% Reconfiguring firewall [OK] 45% Notifying new network addresses [OK] 54% Restarting sshd service [OK] 63% Restarting rsyslog service [OK] 72% Restarting gcenter-xfer-daemon service [OK] 81% Restarting netdata service [OK] 90% Restarting rsyslog service [OK] 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 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
To configure the
gcp1
interface in SSH:Enter the following command.
(gcap-cli) set network-config ssh gcp1
Validate.
Enter the following command.
(gcap-cli) set network-config gcp0 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 gcp1 ip-address Y.Y.Y.Y gateway Y.Y.Y.Y mask Y.Y.Y.Y confirmListe des procédures
Validate.
To configure the
gcp0
interface in SSH:Note
The
gcp1
interface is not used.Enter the following command.
(gcap-cli) set network-config ssh gcp0
Validate.
Enter the following command.
(gcap-cli) set network-config gcp0 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 advanced-configuration mtu
Validate.
The system displays the result.
Current Network MTU configuration: - mon1: 1500 - mon2: 1500 - mon3: 1500 - cluster0: 1500 - gcp0: 1500
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
gcp0
interfaceEnter the following command.
(gcap-cli) set advanced-configuration mtu gcp0 2000
Validate.
The system displays the result.
Updating Network MTU configuration to: - gcp0: 2000
5.5.9.10. Procedure G: display or modify the TCP/IP settings of a gcpx
interface
To display 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.
Single-interface configuration
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
Dual-interface configuration
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
To change the configuration of the
gcp0
interface address:Enter the following command.
(gcap-cli) set network-config gcp0 ip-address x.x.x.x gateway y.y.y.y mask z.z.z.z
Validate.
The system displaying the
gcp0
interface configuration.Setting interface gcp0 (VPN / SSH) to configuration : - IP Address: 10.2.19.129 - Mask: 255.255.255.0 - Gateway: 10.2.19.254 Do you want to apply this new configuration? (y/N)
Press y and then confirm.
Applying configuration... 00% Generating interfaces configuration [OK] 09% Generating network configuration [OK] 18% Generating sshd configuration [OK] 27% Reconfiguring network [OK] 36% Reconfiguring firewall [OK] 45% Notifying new network addresses [OK] 54% Restarting sshd service [OK] 63% Restarting rsyslog service [OK] 72% Restarting gcenter-xfer-daemon service [OK] 81% Restarting netdata service [OK] 90% Restarting rsyslog service [OK] Procedure completed with success