Enabling NFS Volume Services

This topic describes how Pivotal Cloud Foundry (PCF) operators can deploy NFS volume services.

Overview

A volume service gives apps access to a persistent filesystem, such as NFS. By performing the procedures in this topic, operators can add a volume service to the Marketplace that provides an NFSv3 filesystem.

Developers can then use the Cloud Foundry Command Line Interface (cf CLI) to create service instances of the volume service and bind them to their apps. For more information, see the Using an External File System (Volume Services) topic.

Note: You must have an NFS server running to enable NFS volume services. If you want to use NFS and do not currently have a server available, you can deploy the test NFS server bundled with the NFS Volume release.

Enable Volume Services

To enable NFS volume services in PCF, perform the following steps:

  1. Navigate to the Ops Manager Installation Dashboard.
  2. Click the Elastic Runtime tile.
  3. Click Application Containers.
  4. Under Enabling NFSv3 volume services, select Enable.

    Note: In a clean install, NFSv3 volume services are enabled by default. In an upgrade, NFSv3 volume services match the setting of the previous deployment.

    Er config app vol svc
  5. (Optional) To configure LDAP for NFSv3 volume services, perform the following steps:
    • For LDAP Service Account User, enter the username of the service account in LDAP that will manage volume services.
    • For LDAP Service Account Password, enter the password for the service account.
    • For LDAP Server Host, enter the hostname or IP address of the LDAP server.
    • For LDAP Server Port, enter the LDAP server port number. If you do not specify a port number, Ops Manager uses 389.
    • For LDAP Server Protocol, enter the server protocol. If you do not specify a protocol, Ops Manager uses TCP.
    • For LDAP User Fully-Qualified Domain Name, enter the fully qualified path to the LDAP service account. For example, if you have a service account called volume-services that belongs to organizational units (OU) called service-accounts and my-company, and your domain is called domain, the fully qualified path looks like the following:
      CN=volume-services,OU=service-accounts,OU=my-company,DC=domain,DC=com
  6. Click Save.
  7. Return to the Ops Manager Installation Dashboard and click Apply Changes to redeploy.
  8. Using the cf CLI, enable access to the service:
    $ cf enable-service-access nfs
    To limit access to a specific org, use the -o flag, followed by the name of the org where you want to enable access. For more information, see the Access Control topic.

After completing these steps, developers can use the cf CLI to create service instances of the nfs service and bind them to their apps.

Create a pull request or raise an issue on the source for this page in GitHub