Appendix A. Using an NFS Share for Content Storage

Procedure

1. Create the NFS share. This example uses a share at nfs.example.com:/Satellite/pulp. Ensure this share provides the appropriate permissions to Satellite Server and its apache user.

2. Stop Satellite services on your Satellite Server:

   # satellite-maintain service stop

   Copy to Clipboard Toggle word wrap

3. Ensure Satellite Server has the nfs-utils package installed:

   # satellite-maintain packages install nfs-utils

   Copy to Clipboard Toggle word wrap

4. You need to copy the existing contents of /var/lib/pulp to the NFS share. First, mount the NFS share to a temporary location:

   # mkdir /mnt/temp
   # mount -o rw nfs.example.com:/Satellite/pulp /mnt/temp

   Copy to Clipboard Toggle word wrap

   Copy the existing contents of /var/lib/pulp to the temporary location:

   # cp -r /var/lib/pulp/* /mnt/temp/.

   Copy to Clipboard Toggle word wrap
5. Set the permissions for all files on the share to use the pulp user.

6. Unmount the temporary storage location:

   # umount /mnt/temp

   Copy to Clipboard Toggle word wrap

7. Remove the existing contents of /var/lib/pulp:

   # rm -rf /var/lib/pulp/*

   Copy to Clipboard Toggle word wrap

8. Edit the /etc/fstab file and add the following line:

   nfs.example.com:/Satellite/pulp    /var/lib/pulp   nfs    rw,hard,intr,context="system_u:object_r:pulpcore_var_lib_t:s0"

   Copy to Clipboard Toggle word wrap

   This makes the mount persistent across system reboots. Ensure to include the SELinux context.

9. Enable the mount:

   # mount -a

   Copy to Clipboard Toggle word wrap

10. Confirm the NFS share mounts to var/lib/pulp:

    # df
    Filesystem                         1K-blocks     Used Available Use% Mounted on
    ...
    nfs.example.com:/Satellite/pulp 309506048 58632800 235128224  20% /var/lib/pulp
    ...

    Copy to Clipboard Toggle word wrap

    Also confirm that the existing content exists at the mount on var/lib/pulp:

    # ls /var/lib/pulp

    Copy to Clipboard Toggle word wrap

11. Start Satellite services on your Satellite Server:

    # satellite-maintain service start

    Copy to Clipboard Toggle word wrap