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.
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.