ars.ini
Jump to navigation
Jump to search
The ars.ini configuration file defines one or more IBM Content Manager OnDemand ("IBM CMOD") instances on a server. While most systems only contain a single IBM CMOD server, it is possible to combine multiple OnDemand instances onto a single server -- usually for combining development and test instances.
Default ars.ini configuration parameters
[@SRV@_ARCHIVE] HOST=cmod.example.com PROTOCOL=2 PORT=0 SRVR_INSTANCE=archive SRVR_INSTANCE_OWNER=archive SRVR_OD_CFG=/opt/ibm/ondemand/V9.5/config/ars.cfg SRVR_DB_CFG=/opt/ibm/ondemand/V9.5/config/ars.dbfs SRVR_SM_CFG=/opt/ibm/ondemand/V9.5/config/ars.cache
- [@SRV@_ARCHIVE]
- This is the header that defines a server. Any of the parameters below refer to this server - ARCHIVE.
- HOST=cmod.example.com
- The fully qualified domain name of the server.
- PROTOCOL=2
- The protocol to use between the server and client. Leave the default value for the version of CMOD you've installed.
- PORT=0
- The TCP/IP port number to use for CMOD. 0 uses the default, 1445.
- Each server must have it's own port number, servers cannot share a port.
- This port number must be entered in the client software when defining a server.
- SRVR_INSTANCE=archive
- Name of the instance.
- SRVR_INSTANCE_OWNER=archive
- The operating system User ID that owns / controls this instance. This parameter may be case sensitive depending on your Operating System.
- SRVR_OD_CFG=/opt/ibm/ondemand/V9.5/config/ars.cfg
- Defines the location of your configuration file for the server.
- SRVR_DB_CFG=/opt/ibm/ondemand/V9.5/config/ars.dbfs
- Defines the location of your configuration file for the database manager.
- SRVR_SM_CFG=/opt/ibm/ondemand/V9.5/config/ars.cache
- Defines the locatio nof your configuration file for defining cache filesystems.
SRVR_OD_STASH=/opt/IBM/ondemand/V9.5/config/ars.stash
- SRVR_OD_STASH=/opt/IBM/ondemand/V9.5/config/ars.stash
- This parameter defines the location of the default stash file to use for database connections, arsload, and LDAP authentication.
SSL_PORT=1446 SSL_KEYRING_FILE=/opt/IBM/ondemand/V9.5/config/ondemand.kdb SSL_KEYRING_STASH=/opt/IBM/ondemand/V9.5/config/ondemand.sth SSL_KEYRING_LABEL=IBM CMOD SSL Certificate SSL_CLNT_USE_SSL=1
- SSL_PORT=1446
- Defines the port number for encrypted connections to CMOD.
- There is no default port number, common choices are 1443 and 1446, but may be any number between 1024 and 65535 not already in use on your server by other services like TSM (1500, 1501) or DB2 (50000-50006, 60000-60006).
- SSL_KEYRING_FILE=/opt/IBM/ondemand/V9.5/config/ondemand.kdb
- Defines the location of the key database that contains all the requisite certificates and keys.
- SSL_KEYRING_STASH=/opt/IBM/ondemand/V9.5/config/ondemand.sth
- Defines the location of the stash file that contains passwords to the keys and certificates in the key database.
- This file should have very restrictive permissions.
- SSL_KEYRING_LABEL=IBM CMOD SSL Certificate
- Defines the label of the SSL Certificate to be used to identify the IBM CMOD server.
- SSL_CLNT_USE_SSL=1
- Determines if utility clients like arsload should use SSL to connect to IBM CMOD.
- This is not necessary if you're not performing remote loads (via arsload), or queries or retrievals (via arsdoc).
ARS_LDAP_SERVER= ldap.example.com ARS_LDAP_PORT= ARS_LDAP_USE_SSL=FALSE ARS_LDAP_BASE_DN=ou=examplegroup,o=example.com ARS_LDAP_BIND_ATTRIBUTE=userid ARS_LDAP_MAPPED_ATTRIBUTE=userid ARS_LDAP_ALLOW_ANONYMOUS=TRUE ARS_LDAP_BIND_MESSAGES_FILE=/var/log/LDAPmessages.log ARS_LDAP_IGN_USERIDS=ADMIN,ARSLOAD,ARSMAINT ARS_LDAP_BIND_MESSAGES_FILE=/opt/IBM/ondemand/V9.5/config/arsldap.ini