Installing and Deploying WebFOCUS Open Portal Services Gateway

How to:

This section describes how to install and deploy the WebFOCUS Open Portal Services Gateway on an application server where the portal server is installed.

Note: The use of a gateway is required when the WebFOCUS client and the portal server are residing on two separate machines. If the WebFOCUS client and the portal server are installed on the same system, installing a gateway is not required and you can skip the following procedure.


Top of page

x
Procedure: How to Install and Deploy the WebFOCUS Open Portal Services Gateway

To install and deploy the WebFOCUS Open Portal Services Gateway:

  1. Locate the opsgw.war file in the following directory:
    \ibi\WebFOCUS77\worp\components\ops\gateway
  2. Extract this archive to a temporary directory, for example:
    c:\gw_temp
  3. Locate the web.xml file in the following directory:
    c:\gw_temp\WEB-INF
  4. Open the web.xml file using a text editor and locate the following section:
    <context-param>
       <param-name>target_server_url</param-name>
       <param-value>{protocol}://{servername}{:port}</param-value>
    </context-param>

    where:

    protocol

    Is the communication protocol being used, for example, http or https.

    servername

    Is the name of the application server where WebFOCUS is installed.

    port

    Is the port number on which the server listens.

  5. Provide the appropriate values that correspond to your WebFOCUS client configuration, for example:
    <context-param>
       <param-name>target_server_url</param-name>
       <param-value>http://win2k3ent.ibi.com:8080</param-value>
    </context-param>

    Perform the following steps only if you configured the optional RESTRICT_WOAS_TO_IP portal parameter:

    1. Locate the following section in the web.xml file:
      <context-param>
         <param-name>gateway_server_ip</param-name>
         <param-value></param-value>
      </context-param>
    2. Provide the IP address of the machine that is hosting WebFOCUS, for example:
      <context-param>
         <param-name>gateway_server_ip</param-name>
         <param-value>172.30.165.157</param-value>
      </context-param>

      For more information on configuring the optional RESTRICT_WOAS_TO_IP portal parameter, see Using WebFOCUS Portal Components.

  6. Save the web.xml file with your changes and rewar the archive using the following naming convention:
    contextpath.war

    where:

    contextpath

    Is the context path of the WebFOCUS installation, for example, ibi_apps.war.

  7. Make a copy of the repackaged .war file and rename it to ibi_html.war.

    Note: Ensure to use the context path naming convention in this instance.

  8. Deploy the two .war files (ibi_apps.war and ibi_html.war) on the same application server where the portal is deployed.

WebFOCUS