Configuring the proxy

Basic proxy configuration is completed during proxy installation. To change the configuration of the proxy after installation, you must change the proxy configuration properties in the proxy product options file.

Location of proxy product options file

The proxy product options file is at proxy_folder/eclipse.ini, where proxy_folder is the folder to which the proxy was installed. The default proxy folder depends on the operating system and on the user who installed the proxy.
  • Default proxy folder on Microsoft Windows computers: C:\IBM\InfoSphere\Optim\proxy\
  • Default proxy folder on Linux or UNIX computers:
    • Proxy installed by superuser: /opt/IBM/InfoSphere/Optim/proxy/
    • Proxy installed by user other than superuser: /home/username/IBM/InfoSphere/Optim/proxy/, where username is the name of the user who installed the proxy

Configuring the proxy to use the server (InfoSphere Optim)

To use the proxy, you must first install and configure the server (IBM® InfoSphere® Optim™) on the same computer as the proxy. For more information about how to install and configure the server, see the installation and configuration information for the InfoSphere Optim component.

After the server is installed and configured on the proxy computer, the proxy must be configured to find and run the pr0cmnd program in the server. You must also install on the proxy computer the database client libraries for any relational database management systems that the services use. The proxy computer must be able to access the repository. Use the server to run at least one service by itself to verify that the server is configured properly and ready to run services.

When you run a service, the proxy uses the pr0cmnd program that is in the folder that you specify during installation. The default program folder depends on the platform on which you install the proxy:
  • Default program folder on Windows computers: C:\IBM\InfoSphere\Optim\RT\BIN\
  • Default program folder on Linux or UNIX computers: /opt/IBM/Optim/rt/bin/
If the pr0cmnd program is in a folder other than the folder that was specified during installation, change the following argument in the proxy_folder/eclipse.ini file.
-Dcom.ibm.nex.pr0cmnd.location=pr0cmnd_folder
  • pr0cmnd_folder is the program folder for the pr0cmnd program.
For example, the following line specifies /opt/IBM/Optim/dist/rt/bin as the name of the program folder for the pr0cmnd program.
-Dcom.ibm.nex.pr0cmnd.location=/opt/IBM/Optim/dist/rt/bin

Setting the proxy work directory

During installation, you set the directory that the proxy is to use to store work files. The default proxy work directory depends on the operating system and on the user who installed the proxy.
  • Default work directory on Windows computers: C:\IBM\InfoSphere\Optim\proxywork\
  • Default work directory on Linux or UNIX computers:
    • Proxy installed by superuser: /opt/IBM/InfoSphere/Optim/proxywork/
    • Proxy installed by user other than superuser: /home/username/IBM/InfoSphere/Optim/proxywork/, where username is the name of the user who installed the proxy
To change the work directory, open the proxy_folder/eclipse.ini file and look for the following line, where work_directory is the current work directory:
-Dcom.ibm.optim.proxy.workdir.root=work_directory
For example, the following line specifies D:\Optim\proxywork as the proxy work directory:
-Dcom.ibm.optim.proxy.workdir.root=D:\Optim\proxywork

Setting the registry and repository locations

By default, the proxy is set to use the registry and repository at http://repository:8088/server/registry and http://repository:8088/server/repository.

Open the proxy_folder/eclipse.ini file and look for the following lines, where registry_URL is the location of the registry and repository_URL is the location of the repository. If these lines exist, set the lines to the correct registry and repository locations. If these lines do not exist, add the lines to the file with the correct registry and repository locations.
-Dcom.ibm.optim.registry.url=registry_URL
-Dcom.ibm.optim.repository.url=repository_URL
For example, the following lines specify http://repository1:8080/server/registry as the registry location and http://repository1:8080/server/repository as the repository location.
-Dcom.ibm.optim.registry.url=http://repository1:8080/server/registry
-Dcom.ibm.optim.repository.url=http://repository1:8080/server/repository

Setting the host name and port for a proxy

If the proxy computer is assigned IP addresses dynamically, set the host name and port that are to be used by the proxy. To set the host name and port for the proxy, add the following arguments to the end of the proxy_folder/eclipse.ini file.
-Dcom.ibm.optim.host.name=host_name
-Dcom.ibm.optim.host.port=host_port
  • host_name is the host name or IP address of the proxy.
  • host_port is the port used by the proxy.
For example, the following lines specify proxy_computer as the host name of the proxy and 12000 as the port number used by the proxy.
-Dcom.ibm.optim.host.name=proxy_computer
-Dcom.ibm.optim.host.port=12000

Setting the shared library environment variable

When you install the proxy on Linux or UNIX, set the shared library environment variable to include the directory that contains the proxy libraries (proxy_folder/shared/bin). Set the shared environment variable for each account that is used to run the proxy. To set the shared library environment variable for an account, add the following lines to the account login profile.
  • AIX®:
    LIBPATH=$LIBPATH:proxy_folder/shared/bin
    export LIBPATH
  • Linux or Solaris:
    LD_LIBRARY_PATH=$LD_LIBRARY_PATH:proxy_folder/shared/bin
    export LD_LIBRARY_PATH

Configuring the proxy to use the exact driver version specified on all service requests

By default, the proxy uses the JDBC driver that is specified on the service request or any newer version of the same driver. The proxy uses the first such driver that it finds in the repository. You can configure the proxy so that the proxy uses only the version of the JDBC driver that is specified on the service request. If the repository does not contain the version that is specified on the service request, the proxy returns an error. To configure the proxy so that the proxy uses only the exact driver version that is specified, add the following line to the end of the proxy_folder/eclipse.ini file:
-Dcom.ibm.nex.capability.driver.compatility.level=enforceExactVersionMatch

Configuring the proxy to use UTF-8 encoding in logs

If you install the proxy on a computer that is set to a language that requires the use of double-byte characters, configure the proxy to use UTF-8 encoding in its log files. To configure the proxy to use UTF-8 encoding, add the following line to the end of the proxy_folder/eclipse.ini file.
-Dfile.encoding=UTF-8
On Windows computers, you must also add the following line, where encoding is the character encoding that is used by the Windows computer. For example, use MS932 for Shift JIS encoding.
-Dconsole.encoding=encoding

Setting file permissions

If you install the proxy on a Linux or UNIX computer as a user other than the superuser, file permissions on your home directory might restrict other users from starting or restarting the proxy. To correct this issue, complete either of the following tasks.
  • Ask the administrator to install the proxy to /opt/IBM/Optim/proxy.
  • Set the file permissions to the folder to which the proxy is installed so that users can run the proxy.