Configuring proxy settings

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

Complete the following steps to edit the proxy settings:

1. Open the 99Local.xml file and the 100Custom.xml files with a text editor.
2. Copy the connection section of the 99Local.xml file and paste the connection section into the 100Custom.xml files.

   <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>
   
   <!--
   	<proxy-settings protocol="http">
   		<host></host>
   		<port></port>
   		<user-name></user-name>
   		<password></password>
   		<password-encrypted></password-encrypted>
   		<excluded-hosts></excluded-hosts>
   		</proxy-settings>
   		<proxy-settings protocol="https">
   		<host></host>
   		<port></port>
   		<user-name></user-name>
   		<password></password>
   		<password-encrypted></password-encrypted>
   		<excluded-hosts></excluded-hosts>
   	</proxy-settings>
   	-->
   
   </connection>
   </server> 

3. Close the 99Local.xml file.
4. In the 100Custom.xml files, uncomment the section or sections that you want to edit.
5. Edit the 100Custom.xml files 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.
   Important: If you use the <proxy-settings> section, any protocol-specific settings established in other sections are ignored. If you want to use any protocol-specific settings that are defined in other sections, remove the <proxy-settings> section.

   Table 1. 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 the topic "Enabling encrypted passwords in proxy settings."
   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.

6. Save and close the file.