Enabling Unicode

To support multibyte character encoding, you must configure the Dispatcher JVM properties.

About this task

The Dispatcher process is a running instance of the IBM Security Directory Integrator server.

The IBM Security Directory Integrator is a Java™ application that is running its own JVM. You can supply standard JVM properties to the Dispatcher such as:

  • Encoding
  • Memory allocation initial size
  • Memory allocation maximum size

As an example, to set up the dispatcher encoding to UTF-8, perform the following steps:

Procedure

  • On Windows operating systems
    1. Stop the IBM Security Directory Integrator (Security Adapters) service.
    2. Navigate to the adapter timsol directory.
    3. Open the ibmdiservice.props file with a text editor.
    4. Set the value of the jvmcmdoptions property to the Java property value that you want to change to.
      For example, if you want the Dispatcher JVM to run with UTF-8 encoding, then set jvmcmdoptions=- Dfile.encoding=UTF-8.
      Note: When you set multiple properties, separate two properties with a space.
    5. Save and close the ibmdiservice.props file.
    6. Start the IBM Security Directory Integrator (Security Adapters) service.
  • On UNIX or Linux® operating systems
    1. Navigate to the ITDI_HOME installation directory.
    2. Run the following command: 
      vi ibmdisrv
    3. Modify the string value in the following format: 
      "$JRE_PATH/java" -cp "/opt/IBM/TDI/V7.1/jars/3rdparty/IBM/
db2jcc_license_c.jar" "-Dlog4j.configuration=file:etc/
log4j.properties" -jar "/opt/IBM/TDI/V7.1/IDILoader.jar"
com.ibm.di.server.RS "$@"
      For example, if you want the JVM to use UTF-8 encoding, then modify the command as: 
      "$JRE_PATH/java" -cp "/opt/IBM/TDI/V7.1/jars/3rdparty/IBM/
db2jcc_license_c.jar" "-Dfile.encoding=UTF-8" "
-Dlog4j.configuration=file:etc/log4j.properties" -jar
"/opt/IBM/TDI/V7.1/IDILoader.jar" com.ibm.di.server.RS "$@"
    4. Restart the dispatcher service. Run one of the following commands to restart the process:
      • On AIX® operating systems: 
        /opt/IBM/TDI/V7.1/timsol/ITIMAd restartsrc
      • On Linux, Solaris, and HP-UX operating systems: 
        /opt/IBM/TDI/V7.1/timsol/ITIMAd restart
  • Enabling UTF-8 encoding for the Dispatcher and adapter log file is suggested.
    Logging capabilities are provided by IBM Security Directory Integrator. Encoding settings can be enabled as follows:
    1. Open the file ITDI_HOME/solution/etc/log4j.properties in a text editor.
    2. After the line log4j.appender.Default.file=logs/ibmdi.log, add the following setting: 
      log4j.appender.Default.file.encoding=UTF-8
    3. The resulting entry looks like the following example: 
      log4j.appender.Default=org.apache.log4j.FileAppender
log4j.appender.Default.file=logs/ibmdi.log
log4j.appender.Default.file.encoding=UTF8
log4j.appender.Default.layout=org.apache.log4j.PatternLayout
log4j.appender.Default.layout.ConversionPattern=%d{ISO8601} %-5p [%c] - %m%n
log4j.appender.Default.append=false
    4. Restart the IBM Security Directory Integrator Adapter (Dispatcher) service.