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 file with a text editor. For information about the 99Local.xml files and their locations, as well as information about the individual 100Custom.xml files that need to be updated and their locations, see the topic "The 99Local.xml and 100Custom.xml configuration files."
2. 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>
   
   <!--
   	<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 file, uncomment the section or sections that you want to edit.
5. 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.
   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 "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.

6. Save and close the file.