Creating the ARS.CACHE file for the instance

The ARS.CACHE file lists the file systems on the object server that can be used by Content Manager OnDemand for cache storage.

About this task

If there are multiple file systems in the ARS.CACHE file, Content Manager OnDemand uses the file system with the greatest amount of space free to store the objects.

The following example shows an ARS.CACHE file that defines five cache storage file systems: 
     /arscache/cache1
     /arscache/cache2
     /arscache/cache3
     /arscache/cache4
     /arscache/cache5
Note: For a distributed library / object server system, configure one copy of the ARS.CACHE file on each server that is part of the Content Manager OnDemand system.

Procedure

To create the ARS.CACHE file for the instance:

  1. Log in to the server as the root user.
  2. Change to the /opt/IBM/ondemand/V10.5/config directory.
  3. Create (or edit) the ARS.CACHE file using a standard text editor such as vi.
  4. Insert one line in the file for each file system on the server that Content Manager OnDemand can use for cache storage.
    Important: The first entry in the ARS.CACHE file identifies the base cache storage file system. Content Manager OnDemand stores control information in the base cache storage file system. After you define the base cache storage file system to Content Manager OnDemand, you cannot add or remove it from Content Manager OnDemand. It must remain as the first entry.
  5. Save the file and exit the editor.
  6. Cache file systems must be owned by the Content Manager OnDemand instance owner and the system group.
    Make sure that only the user file permissions are set, not the group or other file permissions.
    For example: 
    drwx------  3 root system  512 Sep 22 13:08 /arscache/cache1
  7. Use the CHOWN command to set the ownership permissions.
    The following example shows how to change the user and group ownership of all file systems in the /arscache tree: chown -R root:system /arscache*
  8. Use the CHMOD command to set the file permissions.
    For example, the following commands set the correct permissions for the /arscache/cache1 file system: 
         chmod 700 /arscache/cache1
     chmod g-s /arscache/cache1

Results

Content Manager OnDemand cache storage files and subdirectories should have the following permissions: 
 drwx------ for every subdirectory (700)
 -r-------- for every object that has been migrated to archive storage (400)
 -rw------- for every object that has not yet been migrated (600)
 -rwxrwxrwx for every symbolic link under the retr and migr directories (777)