Problem

How can a new data catalogue and the files that are referenced in the catalogue be added to a Unix Relativity Data Server?

Resolution

The relativity data server is driven by the odbc.ini file that resides in the Relativity Data Server installation directory.

The normal installation directory for the Relativity Data Server that uses the RM file handler is:

/usr/RelRM12.08/RelRM12.08

For the Relativity Data Server that uses the Micro Focus (MF) file Handler it is:

/usr/RelMF12.08/RelMF12.08

The odbc.ini file is split into four main areas.

SimbaServer

This is headed [SimbaServer] and contains the Relativity configuration information. Once this is setup, it is unlikely that it will be changed.

Simba Trace

This is headed [Simba Trace] and is used to setup the tracing options that are required to diagnose faults. It is unlikely that this will need to be changed.

ODBC Data Sources

This is headed [ODBC Data Sources] and is where the link between the data source names and relativity is performed. This list is used to provide the names of the data sources that are available within the Relativity Data Server. When adding a new catalogue to the Relativity Data Server, a new entry is required here. The name that is entered here is then expended upon in the [Server Admin Section].

The format of a new entry is:

<name>= Relativity Server

For example:

Shirt3Demo=Relativity Server

Server Admin Section

This is headed [Server Admin Section] and this provides the configuration information for the catalogues that are managed by the Relativity Data Server. There are groups of the following information:

[<name>] – links the entry from the [ODBC Data Sources] to the configuration information for the catalogue

DBQ=<name> this is data source name and is normally the same as name that appears in the [ODBC Data Sources] section.

Catalog=<location of the catalogue> This can be a fully qualified path, or relative to the directory that the odbc.ini file resides in.

FileMgr=<File Manager abbreviation> The file manager used to access the files that are referenced in the catalogue. This is normally RM or MF.

So, using the above example, the entry in the [Server Admin Section] would be:

[Shirt3Demo]

DBQ= Shirt3Demo

Catalog=/usr/RelRM12.08/RelRM12.08/samples/rm/shirt-3/shirt3.rcg

FileMgr=RM

The above setup uses the RM file manager. An example for the MF file manger would be:

[Shirt3Demo]

DBQ= Shirt3Demo

Catalog=mf/shirt-3/shirt3.rcg

FileMgr=MF

Note:

The same information applies to Linux, AIX, Sun Solaris systems.

Incident #2683733