Sun Java System Portal Server 7.1 Deployment Planning Guide

Configuring an HTTP Proxy

If the Portal Server software is installed on a host that cannot directly access certain portions of the Internet or your intranet, you can receive errors. For example, when using the SampleSimpleWebService provider, you might see the following error when the proxy has not been configured:


HTTP transport error: java.net.ConnectException: Connection refused

ProcedureTo Configure Usage of an HTTP Proxy for a Portal Server Instance

The following procedure describes how to configure an HTTP Proxy for a Portal Server instance on Sun Java System Web Server.

  1. Change directories to the web container data directory containing the configuration for the instance.

    cd webcontainer-install-root/SUNWwbsvr7/https-instance-name/config

    For example: /var/opt/SUNWwbsvr7/https-siroe.com/config

  2. Edit the server.xml file within this directory and add the following lines:


    <jvm-options>-Dhttp.proxyHost=proxy-host</jvm-options>

    <jvm-options>-Dhttp.proxyPort=proxy-port</jvm-options>

    <jvm-options>-Dhttp.nonProxyHosts=portal-host</jvm-options>

    Where proxy-host is the fully-qualified domain name of the proxy host, proxy-port is the port on which the proxy is run, and portal-host is the fully qualified domain name of the portal host.

  3. Restart the webcontainer for the changes to take affect.