Configuring and enabling SMB and NFS protocol services

If you have not previously enabled and started the Cluster Export Services (CES) protocol services, enable and start them now.

Prerequisites

When you enable SMB protocol services, the following prerequisites must be met:

The number of CES nodes must be 16 or lower.
All CES nodes must be running the same system architecture. For example, mixing nodes based on Intel and Power® is not supported.

When you add new CES nodes to a running system where the SMB protocol is enabled, the following prerequisite must be met:

All CES nodes must be in SMB HEALTHY state. You can verify the health status of the SMB service by using the mmces state show smb command.

When you remove a CES node from a running system where the SMB protocol is enabled, the following prerequisite must be met:

All CES nodes (except for the node that is being removed) must be in SMB HEALTHY state.

For more information about the SMB states, see mmces command.

Enabling protocol services

Issue the following commands to enable SMB and NFS services on all CES nodes:

```
mmces service enable SMB 
```
```
mmces service enable NFS 
```

GUI navigation

To enable SMB services in the GUI, log on to the IBM Spectrum Scale™ GUI and select Services > SMB.
To enable NFS services in the GUI, log on to the IBM Spectrum Scale GUI and select Services > NFS.

The protocol services that are used need to be started on all CES nodes:

mmces service start SMB -a

mmces service start NFS -a

After you start the protocol services, verify that they are running by issuing the mmces state show command.

Note: The start and stop are maintenance commands. Stopping a service on a particular protocol node without first suspending the node ensures that the public IP addresses on that node stay with that node. In this case, protocol clients that try to connect to the service with these IP addresses fail. Start of change

The NFS service might restart automatically after downtime if the process had shutdown unexpectedly. End of change

The following example demonstrates how to manage NFS service, exports, and authentication options:

Issue the following command to enable the service:
```
mmces service enable NFS
```
Note: This command also starts NFS on all CES nodes.
Set up the authentication method. The following command specifies the file data access method and the userdefined authentication type:
```
mmuserauth service create --data-access-method file --type userdefined
```
Issue the following command to add an export:
```
mmnfs export add gpfs/fs0/fset0
```
where fs0 is a GPFS™ file system and fset0 is an independent fileset.
Issue the following commands to verify that the service is configured and running:
```
mmces service list -a
mmuserauth service list
mmnfs export list
```
Issue the following commands to stop NFS and disable the NFS protocol on the CES nodes:
```
mmces service stop nfs -a
mmuserauth service remove --data-access-method file
```
Note: The sequence for removing the file data access method is different for NFS and SMB:
- For NFS, you must remove the file data access method before you disable NFS.
- For SMB, you cannot remove the file data access method while SMB is enabled and running.
Issue the following command to disable the NFS service on the CES nodes:
```
mmces service disable NFS
```
Important: When you disable NFS, the NFS configuration is lost. To save the NFS configuration, back up the contents of the /var/mmfs/ces/nfs-config/ directory on any protocol node.