Adding an instance

About this task

The ars.ini file contains information about Content Manager OnDemand instances. When you install the Content Manager OnDemand software, the ars.ini file contains information about the default instance named ARCHIVE. The easiest way to add a new instance to the file is to copy the set of lines that comprise the default instance definition and make changes to the copy.

When you install the Content Manager OnDemand software on the server, the ars.ini file gets copied to the Content Manager OnDemand configuration file directory. To define a new instance, log on as the super user or as any user set up with appropriate permissions. Make a backup copy of the ars.ini file. Then edit the ars.ini file with a standard text editor.

The information in the ars.ini file is organized in sections with a header line that identifies each section. The header line is identified by the brackets that delimit the beginning and end of the line.

The first section in the file contains information about the default instance. The following shows the default instance: 
     [@SRV@_ARCHIVE]
     HOST=
     PROTOCOL=2
     PORT=0
     SRVR_INSTANCE=archive
     SRVR_INSTANCE_OWNER=ARSSERVR
     SRVR_OD_CFG=/usr/lpp/ars/V10R5M0/config/ars.cfg
     SRVR_SM_CFG=/usr/lpp/ars/V10R5M0/config/ars.cache
  • The header line contains a string that identifies the name of the instance. By default, the first or only instance is named ARCHIVE.
  • The HOST parameter identifies the host name alias, IP address, or fully qualified host name of the library server. For information about how Content Manager OnDemand uses the HOST parameter, see Working with instances.
  • The PROTOCOL parameter identifies the communications protocol used to communicate between clients and the server (the number 2 identifies TCP/IP).
  • The PORT parameter identifies the TCP/IP port number that Content Manager OnDemand monitors for client requests (the number 0 means that the server monitors port number 1445). If you use a port number other than 1445 on the library server, enter that number instead of 0.
  • The SRVR_INSTANCE parameter identifies the name of the database that is used by the instance. IBM® recommends that you use the same name for the database and the instance.
  • The SRVR_INSTANCE_OWNER parameter identifies the name of the instance owner. This value should always be set to the super user or any other user that has the appropriate permissions.
  • The SRVR_OD_CFG parameter identifies the configuration file that is used by the instance. Each instance must use a separate configuration file.
  • The SRVR_SM_CFG parameter identifies the file that specifies the cache storage file systems that are used by the instance. Each instance must use a separate file to specify its cache storage file systems.
When you add an instance to the ars.ini file, remember that each instance must use a unique name. For example, to add an instance for testing new applications, you might add an instance named TEST. When you work with more than one instance, you must identify the instance name when you run Content Manager OnDemand programs (such as ARSDB, ARSLOAD, and ARSSOCKD) and database commands (such as connecting to the database). The following shows an example of a second instance of Content Manager OnDemand in the ars.ini file: 
     [@SRV@_TEST]
     HOST=rhone
     PROTOCOL=2
     PORT=1444
     SRVR_INSTANCE=TEST
     SRVR_INSTANCE_OWNER=ARSSERVR
     SRVR_OD_CFG=/usr/lpp/ars/V10R5M0/config/ars.test.cfg
     SRVR_SM_CFG=/usr/lpp/ars/V10R5M0/config/ars.test.cache
The name of the instance is TEST. The HOST statement identifies the host name alias of the library server. (When you add another instance to the ARS.INI file, you must set the HOST statement of the default instance to the host name alias of the library server.) The instance uses TCP/IP to communicate over port number 1444. (Each instance that runs on the same system must use a different port number.) The name of the database that is used by the instance is TEST. The name of the server configuration file that is used by the instance is ars.test.cfg. The name of the cache storage configuration file that is used by the instance is ars.test.cache.
Important: For a distributed library/object server system, you must make sure that the ars.ini file is consistent and correct on all servers that are part of the Content Manager OnDemand instance.