Example: Configuring a WebLogic RPS for a REN Server on Another Host Machine

This example presents one possible configuration for a REN server running on one host machine and installing an RPS to run on a second host machine, using Oracle WebLogic. The RPS redirects clients to both a REN server and to the PeopleSoft Pure Internet Architecture web server.

To configure an RPS for a REN server on another host machine:

1. Install a new web server domain on the second machine.

   Name the domain rps.

   Configure the following values:

   • AppServer Name: <application_server_machine_name>

   • JSL Port: 9999

     The RPS will not make Jolt connections.

   • HTTP Port: 8080

   • HTTPS Port: 8443

2. Start the new web server.

   Navigate to PS_CFG_HOME\webserv\rps\bin, and run startPIA.cmd.

3. Access the Admin Console using either the desktop or hosted version of the WebLogic Remote Console.

   See System and Server Administration: Using WebLogic Remote Console.

4. Under Providers, select Add Admin Server Connection Provider, and supply the required connection information for the rps server.

   See the Oracle GitHub documentation, https://oracle.github.io/weblogic-remote-console/administration-server/domain-configuration.

5. Click the Edit Tree tile, and then select Deployment, and then App Deployment, and then rps.

6. Select the Targets tab, and use the arrows to move PIA from Chosen to Available.

7. Click Save.

8. Click the Edit Tree tile, and then select Deployment, and then App Deployment, and then HttpProxyServlet.

9. Select the Targets tab, and use the arrows to move PIA from Available to Chosen.

10. Click Save.

11. For better web server performance, in the Edit Tree section, select Servers, and then PIA.

12. Select the Protocols tab, select the HTTP tab, and set both Duration and HTTPS Duration to 120 secs.

13. Stop the rps web server.

    Navigate to PS_CFG_HOME\webserv\rps\bin and run stopPIA.cmd.

14. Configure RPS parameters for the rps server.

    Locate the file web.xml at PS_CFG_HOME/webserv/rps/applications/HttpProxyServlet/WEB-INF.

    Edit web.xml in a text editor, changing the WebLogic port and WebLogic host from 8080 to 80 (the value 8080 is a default value that is derived during installation of the domain rps). For example:

    <init-param>
    	<param-name>WebLogicPort</param-name>
    	<param-value>80</param-value>
    	<description>HTTP listen port of WebLogic PIA/PORTAL server.</description>
    </init-param>

    To specify the associated REN server, (which is on another machine), edit web.xml, changing the REN server host machine, port, and root URL from their default RPS values. For example:

    <init-param>
    	<param-name>WebLogicHost</param-name>
    	<param-value>MACHINE_2</param-value>
    	<description>Hostname of REN server.</description>
    </init-param>
    <init-param>
    	<param-name>WebLogicPort</param-name>
    	<param-value>7180</param-value>
    	<description>Listen port of REN server.</description>
    </init-param>

    Another example is:

    <servlet-mapping>
    	<servlet-name>RENHttpProxyServlet</servlet-name>
    	<url-pattern>/psren/*</url-pattern>
    </servlet-mapping>

15. Reboot the RPS web server.

    Navigate to PS_CFG_HOME\webserv\rps\bin, and run startPIA.cmd.

16. (Optional) Configure and enable SSL on the RPS machine.

Note:

When using an Apache RPS, you must configure the kn_response_flush_override and the flush_rps_buffer_size_for_knjs parameters in the psrenconfig.txt file. Set both parameters according to the instructions within that file. Apache needs both parameters present with the same buffer size. The kn_response_flush_override parameter flushes a message, while the flush_rps_buffer_size_for_knjs parameter flushes the stay-alive.

Note:

Using WebLogic as a reverse proxy server is not recommended for a production system.