Configuring the server-side NFS shares

Shared storage is required for the HCL Docs components to share configuration and document data and information. These specific procedures are required only if you are using one of the Linux servers as an NFS server.

Note:
  • Make sure nfs-utils, chkconfig, rpcbind packages are installed on the system.
  • It is recommended to utilize a dedicated storage filer system when possible. If you are using a dedicated storage filer system, the steps will be different but the shares will need to be exported and the same client access must be granted.
  • If you're installing with a non-root user, add the user to the server: adduser -u <userid>. You need the UID/GID of this user ID for configuring the NFS share on Windows.
  1. Run the following commands to configure the server-side share for Docs data:
    • mkdir -p /nfs/docs_data
    • chown -R root:root /nfs/docs_data
    • chmod -R 775 /nfs/docs_data
    • echo "/nfs/docs_data <serverFQIN1>(insecure,rw,async,no_root_squash)<serverFQIN2>(insecure,rw,async,no_root_squash)" >>/etc/exports
      Example:
      "/nfs/docs_data Docs01.renovations.com(insecure,rw,async,no_root_squash)  
      Docs02.renovations.com(insecure,rw,async,no_root_squash)" >>/etc/exports
      Note:
      • HCL Docs and Connections have their own share points respectively. Moreover, their nfs servers might be different.
      • If you need additional NFS clients to access the NFS server, add more items, such as <ClientHostName>(insecure,rw,async,no_root_squash) with a space separating each item.
  2. Run the following commands to configure the server-side share for Viewer data:
    • mkdir -p /nfs/viewer_data
    • chown -R root:root /nfs/viewer_data
    • chmod -R 775 /nfs/viewer_data
    • echo "/nfs/viewer_data <serverFQIN1>(insecure,rw,async,no_root_squash)<serverFQIN2>(insecure,rw,async,no_root_squash)" >>/etc/exports
      Example:
      "/nfs/viewer_data Docs01.renovations.com(insecure,rw,async,no_root_squash) 
      Docs02.renovations.com(insecure,rw,async,no_root_squash)" >>/etc/exports
  3. Export Connections share point to the given server where to deploy Docs Extension or Viewer Extension. If a different node with Connections is selected to run GUI installer and deploy Docs Extension or Viewer Extension, the Connections share point must be exported to the given node. For example, Conversion node DocsWin01:
    echo "/nfs/IBM/ConnectionsData DocsWin01.renovations.com(insecure,rw,async,no_root_squash)" >>/etc/exports
  4. Restart the NFS server:
    • /sbin/service rpcbind restart
    • /sbin/service nfs restart
    • /sbin/service nfslock restart
  5. Verify the exported mount points by:
    • /usr/sbin/showmount -e localhost
  6. Run the following commands to automatically start the NFS server on boot.
    • chkconfig rpcbind on
    • chkconfig nfs on
    • chkconfig nfslock on