Skip to main content

Linux: Add trunk or access interfaces to a node

Contributors
PDFs

You can add extra trunk or access interfaces to a Linux node after it has been installed. The interfaces you add are displayed on the VLAN interfaces page and the HA groups page.

Before you begin
Caution Don't attempt to add interfaces to a node while a software upgrade, recovery procedure, or expansion procedure is active.
About this task

Use these steps to add one or more extra interfaces to a Linux node after the node has been installed. For example, you might want to add a trunk interface to an Admin or Gateway Node, so you can use VLAN interfaces to segregate the traffic belonging to different applications or tenants. Or, you might want to add an access interface to use in a high availability (HA) group.

If you add a trunk interface, you must configure a VLAN interface in StorageGRID. If you add an access interface, you can add the interface directly to an HA group; you don't need to configure a VLAN interface.

The node is unavailable for a brief time when you add interfaces. You should perform this procedure on one node at a time.

Steps

  1. Log in to the Linux server hosting the node.

  2. Using a text editor such as vim or pico, edit the node configuration file:

    /etc/storagegrid/nodes/node-name.conf

  3. Add an entry to the file to specify the name and, optionally, the description of each extra interface you want to add to the node. Use this format.

    INTERFACE_TARGET_nnnn=value

    For nnnn, specify a unique number for each INTERFACE_TARGET entry you are adding.

    For value, specify the name of the physical interface on the bare-metal host. Then, optionally, add a comma and provide a description of the interface, which is displayed on the VLAN interfaces page and the HA groups page.

    For example:

    INTERFACE_TARGET_0001=ens256, Trunk

    Note Don't specify any other network parameters, or a validation error will result.

  4. Run the following command to validate your changes to the node configuration file:

    sudo storagegrid node validate node-name

    Address any errors or warnings before proceeding to the next step.

  5. Run the following command to update the node's configuration:

    sudo storagegrid node reload node-name

After you finish