Configuring proxy server support

Configuring Enterprise Portal to work with a proxy server requires:

  1. Modifying global.properties.xml

  2. Registering proxy user names and passwords with Portal Interface

  3. Registering proxy user names and passwords with Portal Studio

  4. Configuring a Web browser

StepsModifying global.properties.xml

  1. Using any standard ASCII text editor, open global.properties.xml, whose location depends on your application server:

  2. Enable proxy server support by setting the value of the proxy property to on:

    Property name=”proxy” value=”on”
    
  3. Specify the host name or IP address of the proxy server; for example:

    Property name=”proxy.host” value=”10.22.85.198”
    
  4. Set the value of proxy.port to the port number on which the proxy server listens for HTTP requests:

    Property name=”proxy.port” value=”5400”
    

    This value must match the port value that you configure in the Web proxy server; for Sun ONE, the field name is “Server Port”; for ISA 2000, the field name is “TCP Port.”

  5. Specify a list of host names or IP addresses that can bypass the proxy server. Separate each host using a vertical bar. Typically, all machines inside the firewall should be on the list, including the EP server host. For example, if the local machine name is demo.sybase.com, the value of proxy.bypass_list should minimally include the following:

    Property name=”proxy.bypass_list” value=”demo.sybase.com|localhost|...”
    

    NoteAdd the Enterprise Portal server host and localhost to the bypass list; otherwise, internal HTTP requests are routed to the proxy server then relayed back to EP, which diminishes performance.

    If the EP server host and localhost are not on the bypass list, internal HTTP requests are routed to the proxy server then relayed back to EP, which diminishes performance.

StepsRegistering proxy user names and passwords with Portal Interface

Every user must obtain a proxy user name and password from the proxy server administrator, and register them with Portal Interface.

  1. To register a proxy username and password with Portal Interface, use a Web browser to access:

    http://host.domain:port/onepage/index.jsp
    

    Where host and domain identify the machine hosting the Enterprise Portal application, and port identifies the EAServer HTTP port.

  2. If you are using Portal Interface for the first time, click Join Now.

    On the Join Now tab, enter:

    Field name

    Description

    First Name

    First name

    Last Name

    Last name

    E-mail Address

    E-mail address

    Phone Number

    Telephone number

    Member Name

    Login name

    Password

    Login password

    Confirm Password

    Login password

    Proxy Username

    Proxy user name

    Proxy Password

    Proxy password

    Confirm Proxy Password

    Proxy password

    Roles

    Select one or more roles to grant to the user

    If you already have a Portal Interface account:

    1. Enter your user name and password to log in to Portal Interface.

    2. Click My Info, then select the Proxy tab and enter:

      • Password – login password.

      • Proxy User Name – proxy user name.

      • Proxy Password – proxy password.

      • Confirm Proxy Password – proxy password.

  3. Click Done.

StepsRegistering proxy user names and passwords with Portal Studio

Portal Studio users must register their proxy user names and passwords in Portal Studio.

  1. Using a Web browser, access this URL:

    http://host.domain.com/onepage/index.html
    

    Where host and domain identify the machine hosting the Enterprise Portal application.

  2. Log in, then select Account Info. In the Account Info dialog box, select Proxy Configuration.

  3. In the Change Proxy Configuration dialog box, enter:

    Click OK.