How to configure aerospike for use with IPv6 or mixed IPv4/IPv6


#1

How to configure aerospike for use with IPv6 or mixed IPv4/IPv6

Context

While configuring aerospike, you may want to set an XDR source to connect to the destination using either IPv4, IPv6, OR a mix. This article details how to configure aerospike on both the destination and source side for XDR. The same configuration will work for client connections as well.

Method

  1. Within the network->service stanza, configure the ‘address’ part either as ‘any’ or to bind to either IPv4, or IPv6. You may use multiple address lines to bind to multiple addresses.
        service {
                address any
                port 3000

Alternatively:

        service {
                address 10.0.3.20
                address fc00::2020:6dfe:fcbe:89d5
                port 3000
  1. Configure the access-address and alternate-access-address as appropriate for each node to announce either the IPv6 or IPv4 address of that node to the client/XDR source. Configure access-address for clients and alternate-access-address for XDR.

Note, when using alternate-access-address, the XDR source will need the ‘dc-use-alternate-services true’ in order to use the announced alternate access address.

The below examples bind to either all addresses or to the specified 2 IPv4 and IPv6 addresses, respectively. Both examples announce the IPv4 address to clients and the IPv6 address to XDR. Each node can be configured differently and use either IPv6 or IPv4 for the service port.

Example:

        service {
                address any
                access-address 10.0.3.20
                alternate-access-address fc00::2020:6dfe:fcbe:89d5
                port 3000

Alternate example:

        service {
                address 10.0.3.20
                address fe80::2019:6cff:fecb:7d65
                access-address 10.0.3.20
                alternate-access-address fc00::2020:6dfe:fcbe:89d5
                port 3000

Summary

The configuration of service to allow a mix of IPv4 and IPv6 is simple, keeping in mind that the address parameter is used to tell asd which addresses it should bind to - i.e. listen on; while access-address and alternate-access-address are used to tell asd which address to announce to the client and XDR, respectively, to use for connections.

Again, remember that you must use the dc-use-alternate-services true configuration on the XDR source cluster to let it know that it should be using the announced alternate-access-address.

Keywords

IPv4 IPv6 XDR CLIENT

Timestamp

5/24/2018