ARS0111E

What was the error?

Message Number: 111

Message Severity: Error (Corrective action is required to continue)

Message Name: ARS0111E

Message Text: OnDemand is unable to determine the link for the file >/arscache/cache2/12345/ABC/DOC/123FAAA<. The error number is X Srvr->ondemand 10.0.0.1 non-SSL<-

Example

OnDemand is unable to determine the link for the file >/arscache/cache2/12345/ABC/DOC/123FAAA<. The error number is 2 Srvr->ondemand 10.0.0.1 non-SSL<-

Related Errors

Windows Client Message: The server failed while retrieving a document.

What were you doing?

Likely running IBM CMOD's arsmaint command with the "-v" option to validate the cache filesystems.

What happened?

IBM Content Manager OnDemand encountered a file for which there is no link. Without a link inside the cache filesystem, the item cannot be retrieved in the cache. In fact, IBM CM OnDemand will try to retrieve the file from secondary storage (CMOD Storage Set or Storage Node) if one exists, as without a valid link, IBM Content Manager OnDemand will not know where the file exists in the cache filesystem(s).

Troubleshooting

The troubleshooting is already done. The link needs to be created. You can create a new link using information from the error message, which should allow the file to be retrieved.

In the example above, the link could be re-created with the following command:

 ln -s /arscache/cache2/12345/ABC/DOC/123FAAA /arscache/cache1/retr/ABC/DOC/123FAAA

Inside this command, these are the components:

ln -s

The UNIX / Linux command to create a symbolic ('soft') link from a file to a new location.

/arscache/cache2/12345/ABC/DOC/123FAAA

The location of the object in the cache filesystem that doesn't have an associated link. (Which we're building.)

/arscache/cache2

Presumably, the second cache filesystem.

12345

This is a CMOD internal date (number of days since January 1st, 1970 (also known as the UNIX epoch).

Historically, this date was the date that the documents stored in this subdirectory would expire. In modern versions of IBM Content Manager OnDemand, this numbered directory has practically no meaning, as CMOD Document Objects are expired based on their cache retention period, and the capacity of the cache filesystem.

ABC

This is the 'Application Group ID Name' - a three letter code representing a specific Application Group. You can find this information inside the CMOD database table called arsag.

DOC

This directory name indicates that documents are stored inside. A directory called RES is used to store resources.

123FAAA

This is the CMOD Object Name -- at load time, individual documents are de-duplicated, compressed, then grouped into files called CMOD Objects.

/arscache/cache1/retr/ABC/DOC/123FAAA

This is the path where the link is to be created.

Note that links are ALWAYS located in the first CMOD cache filesystem.

While you can add and remove cache filesystems from ars.cache, you cannot move the FIRST cache filesystem.

The 'retr' subdirectory is used as a 'map', to tell CMOD where it can find location of the the documents that users are requesting, across ALL of the cache filesystems.

The structure is similar to the source, except it excludes the numbered 'expiration date' subdirectory.

If the creation of the link is successful, IBM Content Manager OnDemand should be able to retrieve the documents from the CMOD cache. Instead of trying to find the individual document in CMOD, run the arsmaint command again, and see if the message has disappeared.

Articles Related to this message

IBM Content Manager OnDemand User Group Forums