Configuring NFS AIS mounts for FTS Server on Linux

About this task

You may want to access an NFS AIS mount for FTS Server when your WorldServer instance is running on Linux. Installed NFS environments are often highly customized, so you may want to use the following steps as guidelines for your installation. For example, you can use the server names in this example or use names of your own.

When deploying WorldServer and FTS in a mixed Linux/Windows environment and using NFS, you must configure Windows Active Directory with Identity Management for Linux. By doing so, you can map Windows usernames to Linux usernames.

Procedure

  1. Configure the NFS Server (linux-nfs-server1).
    1. Create a folder to share: mkdir /export/nfsmnt
      This example uses a subfolder under nfsmnt called NFSTesting for WorldServer/FTS resource files. That subfolder also has an AISmount folder that contains the filesystem AIS assets.
    2. Change the ownership of the folder to that of the user ID with which the NFS client will run:
      • chown wasadmin:wasadmin /export/nfsmnt
      • chmod 755 /export/nfsmnt
    3. Check the NFS Server installation: yum list nfs-utils
    4. Install NFS Server, if necessary: yum install nfs-utils portmap
    5. Edit the /etc/exports file. Add the line: /export/nfsmnt *(rw,sync,no_root_squash)
    6. Start NFS Server process: /etc/init.d/nfs start
    7. Check the NFS Server process status: /etc/init.d/nfs status ## or service nfs status
    8. Configure NFS Server Services to start at boot-time:
      • chkconfig nfs on
      • chkconfig portmap on
  2. Install and configure Windows Tools for supporting NFS. In this case, use Windows Services for UNIX on the FTS Server machine (windows-fts-server2).
    1. Install Windows Services for UNIX on your server.
    2. Configure user name mapping according to your environment.
    3. Validate that the FTS Server machine can now see the folders in Windows Explorer by navigating to \\linux-nfs-server1.global.sdl.corp\export\nfsmnt.
      The FTS Server machine can now see the folders using a UNC-style syntax.
    4. With Windows Explorer opened to \\linux-nfs-server1.global.sdl.corp\export\nfsmnt, validate that you can create files and folders on the NFS share from the Windows OS and that the correct file permissions are applied.
    5. Install the SDL File Type Support Server using \\linux-nfs-server1.global.sdl.corp\export\nfsmnt\ftsShared as the FTS Shared folder.
    6. Configure the FTS Server service to depend on Windows Services for Unix service:
      1. Open a command prompt.
      2. Run the appropriate service for your Windows Services for UNIX installation, such as: sc config ftsserver depend= zzInterix
  3. Configure NFS mount on WorldServer machine (linux-worldserver-server3)
    1. Create a folder on the WorldServer machine that is the FQDN of the NFS Server: mkdir /mnt/linux-nfs-server1.global.sdl.corp
    2. Configure a temporary NFS mount: mount -t nfs linux-nfs-server1: /export/nfsmnt /mnt/linux-nfs-server1.global.sdl.corp -o sync
    3. Configure the NFS mount to be established at machine boot:
      1. Edit /etc/fstab.
      2. Add the following line: linux-nfs-server1:linux-nfs-server1:/export/nfsmnt /mnt/linux-nfs-server1.global.sdl.corp nfs defaults 0 0.
      3. Save and exit /etc/fstab.
    4. Configure a symbolic link from the NFS Server's shared folder that you mounted. You have to mirror the local folder structure that you're going to create to mimic a UNC-style path.
      1. mkdir /linux-nfs-server1.global.sdl.corp
      2. mkdir /linux-nfs-server1.global.sdl.corp/export
      3. mkdir /linux-nfs-server1.global.sdl.corp/export/nfsmnt
      4. cd /linux-nfs-server1.global.sdl.corp/export/nfsmnt
      5. ln -s /linux-nfs-server1.global.sdl.corp/NFStesting
    5. Validate that your WorldServer machine can see the folders using a UNC-style: ls /linux-nfs-server1.global.sdl.corp
      The WorldServer machine can now see the folders using a UNC-style syntax.
  4. Install and configure WorldServer (linux-worldserver-server3)
    1. Deploy the wa.war, ws-legacy.war and ws-api.war files.
    2. Modify the standard variables in the general.properties file (database_username, database_password, etc).
    3. In the general.properties file, also configure:
      • temp_file_path=//linux-nfs-server1.global.sdl.corp/export/nfsmnt/NFStesting/wstemp
      • rcs_root=//linux-nfs-server1.global.sdl.corp/export/nfsmnt/NFStesting/wsrcsroot
      • ftsserver_shared_directory=//linux-nfs-server1.global.sdl.corp/export/nfsmnt/NFStesting/ftsshared
      • log4j.appender.logfile.File=//linux-nfs-server1.global.sdl.corp/export/nfsmnt/NFStesting/ws.log
    4. Restart WorldServer to use the variables updated in the general.properties file.
  5. Configure your file system AIS mount in WorldServer.
    1. Log in to WorldServer as admin .
    2. Go to Management > Asset Interface System > AIS Mounts > Add.
    3. Add the mount using the *Directory path: *//linux-nfs-server1.global.sdl.corp/export/nfsmnt/NFStesting/AISMount
    4. Save the mount.