Configure proxy settings

IBM BPM, V8.0.1, All platforms > Administer the IT infrastructure > Manage IBM Process Servers > Modify runtime server configuration properties
Configure proxy settings

If you use a proxy server for internet connections, you can configure IBM BPM so that it uses the appropriate server and protocol for internet connections, such as when connecting to Blueworks Live.

Configuring proxy settings requires updating the 100Custom.xml. Before you begin, make sure this file exists in the directory PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config.
If not, create the file. See The 99Local.xml and 100Custom.xml configuration files.

The connection section of the 99Local.xml file contains the proxy settings for IBM BPM. To make changes to the configuration, you must copy content from the 99Local.xml file to the 100Custom.xml file. When you use this method to control configuration, all customized settings are maintained in a single file; this can result in faster component upgrades.

Procedure

Complete the following steps to edit the proxy settings:
Open the 99Local.xml file and the 100Custom.xml file with a text editor. These files are located in the root directory of the server profile.

PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\system\99Local.xml
PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\100Custom.xml
Copy the connection section of 99Local.xml and paste the connection section in the 100Custom.xml file.
<server merge="mergeChildren"> 

<connection merge="mergeChildren"> 

<proxy-settings>
	<host>localhost</host>
	<port>80</port>
	<user-name>admin</user-name>
	<password>password</password>
	<password-encrypted>false</password-encrypted>
	<excluded-hosts></excluded-hosts>
	</proxy-settings>



</connection>
</server> 
Close the 99Local.xml file.
In the 100Custom.xml file, uncomment the section or sections that you want to edit.
Edit the 100Custom.xml file for your environment. Consider the scope for the changes to the proxy settings before editing the file:

If you want proxy settings to be applied for all known protocols, use the <proxy-settings> section.
If you want to establish settings for specific protocols, use the <proxy-settings protocol="http"> and <proxy-settings protocol="https"> sections.

If you use the <proxy-settings> section, any protocol-specific settings established in other sections are ignored.

Proxy settings
Setting Required or Optional Description
host Required IP address or host name of the proxy server.
port Required Port number that is used by the proxy server for client connections.
user-name Optional User name used by the proxy server for client connections.
password Optional Password used by the proxy server for client connections.
password-encrypted Optional Encryption status for the password. The value is true if the password is encrypted; otherwise, the value is false.
For more information see "Using encrypted passwords in proxy settings" in the related links for this topic.
excluded-hosts Optional IP addresses or host names of any hosts for which proxy settings should not be applied. localhost , 127.0.0.1 , and 0:0:0:0:0:0:0:1 are excluded by default. Use a comma-separated string of IP addresses to exclude additional hosts.

Save and close the file.
Use encrypted passwords in proxy settings

If you want to use an encrypted password in the proxy settings, first generate the encrypted password, and then update the 100Custom.xml file to include the password and its encryption status.
Encoding credentials in URLs

You can control whether the credentials passed in an IBM BPM URL that implements redirect-login.jsp are encoded.
For example, you can encode credentials in a URL used to start a service directly from IBM Process Designer.
Extend the maximum number of characters in tracked performance data
By default, the maximum number of characters that is allowed in performance data (variable fields that are tracked to the Performance Data Warehouse for reporting purposes) is 64. You can extend this limit by making the following changes to the property file for your IBM BPM Performance Data Warehouse. The changes that you make to this property affect the column sizes in the tracking group tables.
Restricting access to debugging for services

You might need to limit access to debugging functionality for services in the Inspector in IBM Process Designer. Use the IBM BPM configuration file (99Local.xml) to control which users have the ability to debug services.

Modify runtime server configuration properties

Setting	Required or Optional	Description
host	Required	IP address or host name of the proxy server.
port	Required	Port number that is used by the proxy server for client connections.
user-name	Optional	User name used by the proxy server for client connections.
password	Optional	Password used by the proxy server for client connections.
password-encrypted	Optional	Encryption status for the password. The value is true if the password is encrypted; otherwise, the value is false. For more information see "Using encrypted passwords in proxy settings" in the related links for this topic.
excluded-hosts	Optional	IP addresses or host names of any hosts for which proxy settings should not be applied. localhost , 127.0.0.1 , and 0:0:0:0:0:0:0:1 are excluded by default. Use a comma-separated string of IP addresses to exclude additional hosts.