IBM Content Manager, Version 8.5.0.3      Supports:  IBM Content Navigator     

Installing the properties file on the library server

If the library server is on a different machine than the system administration client, the library server requires the cmbcmenv.properties file for user authentication from the LDAP server.

If the library server is on a different machine than the system administration client, you must copy the generated cmbcmenv.properties file to the library server machine. You must copy the file into the directory that is pointed to by the IBMCMROOT/CMGMT environment variable. If there are multiple library server databases installed, you might want to copy it into a directory under IBMCMROOT/CMGMT with the same name as the database name. The library server LDAP user exit attempts to find this properties file under a directory with the database name that exists under the directory pointed to by the IBMCMROOT/CMGMT environment variable.

For example, on a Linux, AIX® or Solaris system, if the library server database is ICMNLSDB, then the library server attempts to find the cmbcmenv.properties file under the IBMCMROOT/CMGMT/ICMNLSDB directory. Similarly on a Windows system, the library server looks under the IBMCMROOT\CMGMT\ICMNLSDB directory.

If the properties file is not found in the directory with the database name under IBMCMROOT/CMGMT, the library server then looks for the file under the directory pointed to by IBMCMROOT/CMGMT.

To copy the properties file:

  1. Back up the original properties file on the library server machine.
  2. Copy the new properties file from the system administration client machine to the library server machine, into the directory with the matching name of the library server database. If there are multiple library server databases installed on the same system, the directory that matches the library server database is the recommended place for the properties file.
    Important: Transferring the file in the correct file format is critical, especially from a Windows system to a Linux, AIX or Solaris system. When you use an FTP tool to transfer the file, make sure that you transfer it with the ASCII format.
  3. In the backup copy of the properties file for the library server, find and copy the line of code with the following parameter: CMCFGDIR. In most cases, this line is the first line of code in the file.
  4. In the new properties file on the library server, replace the CMCFGDIR line of code with the copied line of code from the original file. The CMCFGDIR parameter is used by IBM® Content Manager, not by LDAP, and the value on the library server must be the value from the original file.
  5. For the Solaris platform with an Oracle library server database, you must complete the following additional steps in the new properties file:
    1. Open the cmbcmenv.properties file.
    2. Find the line that begins with LDAP_PROVIDER_URL.
    3. Delete ldap://. For example, change LDAP_PROVIDER_URL=ldap://cmi135.svl.ibm.com to LDAP_PROVIDER_URL=cmi135.svl.ibm.com.
    4. Save the change.


Last updated: June 2015
mua10210.htm

© Copyright IBM Corporation 2015.