Setting Up VIPs for NFSv3
Explains how to set up VIPs for NFS version 3 using either the Control System or the CLI.
About this task
NOTE
The NFSv3 server (mapr-nfsserver
) nodes cannot failover to NFSv4
server (mapr-nfs4server
) nodes and vice versa. Ensure that
different sets of VIPs are assigned for NFSv3 and NFSv4 server nodes. When running
the maprcli virtualip add
command to set up VIPs, list the MACs of
the respective nodes so that the failover works properly (this is necessary when
both NFSv3 and NFSv4 are going to be set up on the same cluster). The MACs should be
mutually exclusive as both NFSv3 and NFSv4 servers cannot run on the same
node.Adding VIPs Using the Control System
About this task
You can use the Control System to specify a range of virtual IP addresses and assign them to the pool of servers that are running the NFS service. You can also restrict the assignment of virtual IP addresses to certain subnets.
Before following this procedure, make sure:
- You have installed NFS on at least three nodes (recommended).
- You have started the NFS gateway service on the servers to which you plan to assign VIPs.
Procedure
-
Log in to the Control System, click Services, and go
to the NFS
service information page where you can configure VIPs for NFSv3
nodes.
NOTEThe Services page is not available on the Kubernetes version of the Control System.
- Click Add Virtual IP to display the Add Virtual IP page.
-
Enter the start of the VIP range in the Starting Virtual IP field.
HPE Ezmeral Data Fabric distributes the VIPs in this range to the selected network interfaces. VIPs are automatically migrated between the network interfaces when failures occur.
-
Enter the end of the VIP range in the Ending Virtual IP field.
If you are assigning only one VIP, you can leave the field blank. HPE Ezmeral Data Fabric distributes the VIPs in this range to the selected network interfaces. VIPs are automatically migrated between the network interfaces when failures occur.
-
Enter the Netmask for the VIP range in the Netmask field.
For example:
255.255.255.0
. HPE Ezmeral Data Fabric assigns this netmask to the network interfaces along with the VIPs. - Specify whether (Yes) or not (No) to assign a particular VIP address to a specific server or MAC address. If Yes, enter the MAC address for the network interface to be assigned to the Starting Virtual IP address. The remaining VIP addresses from the same pool are assigned randomly.
-
Select one of the following:
- Use all network interfaces on all nodes that are running the
NFS Gateway service to set up VIPs that use all network
interfaces on all the nodes running the NFS Gateway service.
If additional NFS Gateway services are started, the network interfaces on their nodes will automatically become candidates for the VIPs in this range.
- Select network interfaces to restrict the
assignment of virtual IP addresses to certain subnets: A list of available and selected node names, physical IP addresses, and MAC addresses displays. Select from the:
- Available list and click to move selection to Selected VIPs.
- Selected list and click to remove from selected list of VIPs.
- Use all network interfaces on all nodes that are running the
NFS Gateway service to set up VIPs that use all network
interfaces on all the nodes running the NFS Gateway service.
-
Confirm the actual VIP assignment by clicking Save
Changes.
It might take up to 40 seconds to assign the VIPs. If necessary, refresh the page in your browser to view the list of VIPs.
Adding VIPs Using the CLI and REST API
About this task
The basic command to set up VIPs is:
maprcli virtualip add -netmask <netmask> -virtualip <virtualip> -service nfs3 -json
Send a request of type POST. For example:
curl -X POST 'https://<host>:8443/rest/virtualip/add?service=nfs3&netmask=<netmask>&virtualip=<vip>' --user <username>:<password>
For the complete list of required and optional parameters, see
virtualip add
.