Configuring proxy settings

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

Before you begin

Configuring proxy settings requires updating the 100Custom.xml files. For information about the 100Custom.xml files, see the topic The 100Custom.xml file and configuration.

About this task

The connection section of the 99Local.xml file contains the proxy settings for Business Automation Workflow. To make changes to the configuration, you must copy content from the 99Local.xml file to each 100Custom.xml file in your topology. To determine the location of the 99Local.xml file and the 100Custom.xml files in your specific topology, see the topic Location of configuration files.

Procedure

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.