Linux: Troubleshooting IPv6 support

You might need to enable IPv6 support in the kernel if you have installed StorageGRID nodes on Linux hosts and you notice that IPv6 addresses have not been assigned to the node containers as expected.

About this task

You can see the IPv6 address that has been assigned to a grid node in the following locations in the Grid Manager:
  • Select Nodes, and select the node. Then, click Show more next to IP Addresses on the Overview tab.

    screen shot of Nodes > Overview > IP Addresses
  • Select Support > Tools > Grid Topology. Then, select node > SSM > Resources. If an IPv6 address has been assigned, it is listed below the IPv4 address in the Network Addresses section.

If the IPv6 address is not shown and the node is installed on a Linux host, follow these steps to enable IPv6 support in the kernel.

Procedure

  1. Log in to the host as root or using an account with sudo permission.
  2. Run the following command: sysctl net.ipv6.conf.all.disable_ipv6
    root@SG:~ # sysctl net.ipv6.conf.all.disable_ipv6
    The result should be 0.
    net.ipv6.conf.all.disable_ipv6 = 0
    Note: If the result is not 0, see the documentation for your operating system for changing sysctl settings. Then, change the value to 0 before continuing.
  3. Enter the StorageGRID node container: storagegrid node enter node-name
  4. Run the following command: sysctl net.ipv6.conf.all.disable_ipv6
    root@DC1-S1:~ # sysctl net.ipv6.conf.all.disable_ipv6
    The result should be 1.
    net.ipv6.conf.all.disable_ipv6 = 1
    Note: If the result is not 1, this procedure does not apply. Contact technical support.
  5. Exit the container: exit
    root@DC1-S1:~ # exit
  6. As root, edit the following file: /var/lib/storagegrid/settings/sysctl.d/net.conf.
    sudo vi /var/lib/storagegrid/settings/sysctl.d/net.conf
  7. Locate the following two lines and remove the comment tags. Then, save and close the file.
    net.ipv6.conf.all.disable_ipv6 = 0
    net.ipv6.conf.default.disable_ipv6 = 0
  8. Run these commands to restart the StorageGRID container:
    storagegrid node stop node-name
    storagegrid node start node-name