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.3. Preliminary operations

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 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 (gcp0 and gcp1)

    • 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 interface

    • Carrier: status of the current transmission:

      • value UP: physical interface is connected

      • value DOWN: physical interface is not connected

    • Speed: the interface speed in Mb/s

    • Type: 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 interface

    • Enter 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