Appendix: BEA WebLogic 8.1 Managed Server Architecture

In the current release, the PIA configuration of BEA WebLogic Server has been expanded to take advantage of WebLogic’s managed server architecture. This appendix provides overviews of web applications in PIA, WebLogic domain types, WebLogic domain directory structure and files, and PIA install and reinstall options, and discusses:

• Administering a WebLogic server life cycle.

• Tuning performance and monitoring resources.

• Changing configuration settings.

• Applying an example single-server configuration.

• Applying an example multi-server configuration.

See Also

Working with BEA WebLogic

Web Applications in PIA

PIA is packaged as a J2EE Enterprise Archive and is comprised of five J2EE web applications, commonly referred to as webapps. The five webapps are as follows.

In addition to the PeopleSoft webapps, three more webapps are added when you install PIA on a WebLogic server machine. These three webapps are not added as part of the PeopleSoft Enterprise Archive, but instead are defined as individual webapps provided by BEA. These three webapps are as follows.

WebLogic Domain Types

This section provides an overview of Weblogic domain types and discusses:

• Single-server domain.

• Multi-server domain.

• Distributed managed server.

• Common default settings.

• Single-server and multi-server/distributed server analogy.

• Domain topology.

Understanding WebLogic Domain Types

During PIA setup, you can choose between two different WebLogic domain configurations: a single-server domain and a multi-server domain. In addition, a multi-server domain can be expanded across multiple machines using the distributed managed server option. Each of these domain configurations has a specific purpose but is fully customizable beyond that purpose.

Single-Server Domain

The single-server domain configuration consists of a single WebLogic server instance, with the WebLogic administration application and all of the web components of PeopleSoft Internet Architecture deployed to use it. This configuration is very similar in design to the WebLogic domain provided in previous PeopleTools releases.

This configuration is intended for single-user or very small scale, non-critical production environments. It can be used as a starting point for you to familiarize yourself with BEA WebLogic Server 8.1

In this configuration, the resources used to administer WebLogic Server and your PeopleSoft application are not isolated from one another, therefore leaving the applications vulnerable to possible resource starvation. The low resource requirements of this configuration make it ideal for small scale and non-production usage.

This configuration creates the following server:

Single-Server Webapp Deployment

Some of the webapps deployed in a single-server domain configuration must be accessed using a modified URL:

http://server:port/webapp_name/...

The single-server domain configuration deploys webapps as follows:

Single-Server Domain Specific Settings

To configure the single-server domain specific settings, launch the WebLogic Server Console.

In the console, navigate to Servers, PIA, Configuration, General to configure the PIA server. The default web application for the PIA server is PORTAL. The single-server domain specific default settings for the PIA server are as follows:

Note. To configure SSL, you must also define SSL certificates.

See Implementing WebLogic SSL Keys and Certificates.

Multi-Server Domain

The multi-server domain configuration consists of seven server definitions, a WebLogic cluster, and the web components of PIA split across multiple servers. This configuration takes advantage of WebLogic’s administration server and managed server architecture.

This configuration is intended for production environments.

A production application warrants process and resource pool isolation for greater stability and optionally tighter security controls, which this configuration provides. In this configuration, the resources used for WebLogic domain administration and monitoring are isolated from similar resources used to support the PIA application. A server process named WebLogicAdmin performs nothing but WebLogic administration, which includes domain administration and monitoring. Continuing that separation, the individual web applications of PIA might be, and usually are, isolated from each other. The PIA applications are targeted and deployed across a portion of the six remaining server definitions, all of which are classified as managed servers, which are delivered in the multi-server configuration.

This configuration creates the following servers:

The multi-server domain configuration deploys webapps as follows:

Multi-Server Webapp Deployment

Some of the webapps deployed in a multi-server domain configuration must be accessed using a modified URL:

http://server:port/webapp_name/...

The multi-server domain configuration deploys webapps as follows:

Multi-Server Domain Specific Default Settings

To configure the multi-server domain specific settings, launch the WebLogic Server Console.

In the console, navigate to Servers, WebLogicAdmin, Configuration, General to configure the WebLogicAdmin server. The WebLogicAdmin server has no default web application. The domain specific default settings for the WebLogicAdmin server are as follows:

In the console, navigate to Servers, PIA, Configuration, General to configure the PIA server. The default web application for the PIA server is PORTAL. The domain specific default settings for the PIA server are as follows:

In the console, navigate to Servers, PIA1, Configuration, General to configure the PIA1 server. The default web application for the PIA1 server is PORTAL. The domain specific default settings for the PIA1 server are as follows:

In the console, navigate to Servers, PIA2, Configuration, General to configure the PIA2 server. The default web application for the PIA2 server is PORTAL. The domain specific default settings for the PIA2 server are as follows:

In the console, navigate to Servers, PSOL, Configuration, General to configure the PSOL server. The default web application for the PSOL server is PSOL. The domain specific default settings for the PSOL server are as follows:

In the console, navigate to Servers, PSEMHUB, Configuration, General to configure the PSEMHUB server. The default web application for the PSEMHUB server is PSEMHUB. The domain specific default settings for the PSEMHUB server are as follows:

In the console, navigate to Servers, RPS, Configuration, General to configure the RPS server. The default web application for the RPS server is HttpProxyServlet. The domain specific default settings for the RPS server are as follows:

Note. To configure SSL, you must also define SSL certificates.

See Implementing WebLogic SSL Keys and Certificates.

Distributed Managed Server

The distributed managed server configuration, although listed alongside the single-server and multi-server domain types, is not a true domain type. It's an optional extension for an existing multi-server configuration that's used to extend a WebLogic domain configuration across multiple machines in a heterogeneous network. For example, on one machine you perform a PIA install and create a multi-server domain. On a second machine you again perform a PIA install but select to create a distributed managed server. You stop, start, and administer the distributed managed server on the second machine just as if it was a managed server local to the primary server’s machine.

As with the multi-server domain type, this configuration takes advantage of WebLogic’s managed server architecture.

Note. Only one managed server can be run per distributed managed server domain directory. If you intend to run multiple distributed managed servers on a single machine, perform the PIA install and create unique distributed managed server domain directories, one for each distributed managed server that you intend to run on that machine.

This configuration is intended for production environments that encompass multiple machines.

A distributed managed server configuration provides the same benefits as a multi-server configuration with the added benefit of hardware isolation. This option requires a multi-server installation to be performed to some other location, which will contain the configuration for this distributed managed server.

Distributed Managed Server Specific Defaults

The server configuration settings for a distributed managed server are maintained via that domain’s administration server and are stored locally on that administration server. Configuration settings are replicated to a managed server during its startup, but are only maintained as a read-only backup copy for that individual managed server in the event that the administration server isn't available the next time this particular managed server needs to be started.

Common Default Settings

Single-server and multi-server domain configurations have many settings in common.

Domain Defaults

Many of these common settings can be configured in the WebLogic Server Console, but some are configured in other environments. Default values are listed when available.

Script and Environment Defaults

Modify these settings by editing a setEnv script or applying command line parameter overrides to WebLogic control scripts.

The following settings specify the names and structure of various directories on the web server machine.

Note. You configure Java VM options including JVM memory size using the JAVA_OPTIONS_OSplatform parameter, during PIA setup.

The following are miscellaneous settings.

The following are debugging output settings.

The following are HTTP forward proxy support settings.

Single-Server and Multi-Server/Distributed Server Analogy

In a production environment it is highly recommended to use a multi-server or distributed server configuration. The multi-server selection provides an initial WebLogic domain configuration that consists of multiple server definitions: one administration server and multiple managed servers, each with a specific purpose. The distributed server option augments a multi-server configuration by expanding the domain configuration across multiple machines.

An analogy that can describe the differences between the single-server configuration and a multi-server or distributed server configuration uses the example of two common beverage distribution models: a single lemonade stand, and a large chain of coffee shops.

Single-Server Model — The Lemonade Stand

With a lemonade stand you have yourself, one table, one collection of resources and ingredients, and a single recipe. If any of these are ruined, your lemonade stand is out of business. Similarly, in a single-server configuration you have one server process, one machine, one collection of resources and program files, and a single domain configuration file. If any of those is ruined, your web server is out of business. Throughput can also be an issue for both a lemonade stand and a single-server configuration. For example, if the weather is warm and you receive a rush of thirsty customers, your throughput will reach a maximum at either the rate you accept new orders, ring up cashier transactions, or prepare drinks. If you accept orders and ring up transactions in half the time that you prepare drinks, adding a second bartender would double your throughput, but in this configuration you can't do that because it's only you. Likewise, the single-server configuration is constrained to provide server configuration and all web server based portions of PIA on a single process. The multi-server model enables you to overcome these limitations.

Multi-Server Model — The Coffee Shop Chain

Within the same analogy, a large chain of coffee shops has multiple employees, multiple cashier stations, multiple coffee prep stations, and recipes archived and known to multiple employees. Similarly, in a multi-server configuration you can have multiple machines, multiple collections of resources and program files, multiple web server processes, and a replicated domain configuration file. In this model, if any of those resources is ruined, work simply shifts to the next instance of that resource. In addition, throughput can be maintained. For example, if the coffee house received a rush of parched customers, additional cashiers and beverage engineers could be added to maintain throughput. Likewise, in the multi-server configuration, an increase in PeopleSoft Portal usage can easily be accommodated by configuring an additional WebLogic server instance to also serve the PeopleSoft Portal application. In this way, the multi-server model supports extendibility and resource independence.

The fundamental benefits of a multi-server configuration are:

• Dedicated service providers.

  Web servers can be dedicated to providing PeopleSoft Portal and are insolated from other portions of PIA such as PeopleSoft Integration Gateway or PeopleBooks.

• Redundant service providers.

  Multiple web servers can be used to serve different aspects of PIA, providing load balancing and failover support.

• Distributed resources.

  Multiple web server machines can be used, each capable of serving different or redundant aspects of PIA.

• Centralized and replicated configuration.

  Master domain configuration is centralized and distributed server information is replicated locally.

Domain Topology

A WebLogic domain can be as small and simple as the Single-server configuration or as broad and complex as the Multi-server configuration with distributed managed servers. In no way exhausting the possibilities, following are three sample layouts depicting each domain configuration.

Single server — one machine

In a single-server configuration, the WebLogic domain’s administration console and the J2EE components of PIA are all provided on a single instance of WebLogic Server.

Multi-server — one machine

In a multi-server configuration, multiple instances of WebLogic server are used, each contributing a specific function. The WebLogic console is provided on the domain’s administration server, WebLogicAdmin, and the J2EE components of PIA are provided on individual or shared WebLogic managed servers.

Multi-server with distributed managed servers — multiple machines

In a Multi-server configuration with distributed managed servers, multiple instances of WebLogic server are used, each providing a specific function. The WebLogic console is provided on the domain’s administration server, WebLogicAdmin, and the J2EE components of PIA are provided on individual or shared WebLogic managed servers. The only differentiating factor from the initial Multi serve configuration is that in this configuration two or more actual machines are used.

WebLogic Domain Directory Structure and Files

This section discusses:

• WebLogic domain directory structure.

• WebLogic domain file listing by type.

• J2EE application files.

WebLogic Domain Directory Structure

File and directory layout of PIA on WebLogic 8.1 does differ from that on prior versions of WebLogic. At a high level, the first difference is that the WebLogic domains are installed within your PS_HOME directory structure, rather than into WebLogic’s directory structure as with prior versions of WebLogic Server.

The default home directories for PIA on different versions of WebLogic are as follows:

This change was performed because managing the WebLogic configuration and PIA configuration similarly to the PeopleSoft application server and PeopleSoft Process Scheduler provided a clearer and more extendable architecture.

File and directory layout of PIA on WebLogic 8.1 differs from that of prior versions of PIA. The following illustration clarifies the directory structure layout of a PIA install on WebLogic Server 8.1.

WebLogic domain directory structure

WebLogic Domain File Listing by Type

Following are listings of all WebLogic domain files installed by the PIA setup, organized by file type. Where necessary, each table includes columns that indicate whether a given file is used in a single-server, multi-server, or distributed server configuration.

This listing does not include java classes or PIA configuration files. On UNIX an equivalent Bourne shell script is provided where a Windows script is listed.

The following table lists WebLogic server administration scripts.

The following table lists WebLogic server configuration files.

The following table lists PeopleSoft J2EE application scripts, which are all used with PeopleSoft Integration Broker, and can be used with every WebLogic server configuration.

The following table lists miscellaneous files, which can be used with every WebLogic server configuration.

See Also

Enterprise PeopleTools 8.46 PeopleBook: PeopleSoft Integration Broker

J2EE Application Files

In addition to WebLogic domain configuration files, application descriptors are installed with the PeopleSoft J2EE enterprise application. The following table lists these descriptor files. The path shown for each file is relative to PS_HOME\webserv\WebLogic_domain\applications\.

PIA Install and Reinstall Options

The PeopleSoft Internet Architecture (PIA) installer enables you to create a new WebLogic server domain or update a valid existing WebLogic domain. A valid domain is a domain built by the PIA installer in the PS_HOME directory that you specify.

Depending on which option you select, you're prompted for additional information relevant to that selection. When creating a new domain, you're prompted to select from three configuration types: Single-server, multi-server and distributed managed server. If you select to update an existing domain, you're prompted to indicate which domain you would like to update and what type of update you would like to perform, which are as follows:

• Install additional PeopleSoft site.

  This option is relevant only to the PeopleSoft PORTAL web application, and doesn't modify or revert any other configuration settings. Select this option to install only the necessary files for defining an additional PeopleSoft site onto an existing WebLogic configuration. The new site will be accessed using its name in the URL. A site named “CRM” would be accessed using a URL similar to http://mywebserver_machine/CRM. To reset or recreate an existing PeopleSoft site, simply enter that site’s name as the site to create. On your web server, a PeopleSoft site is comprised of the following directories within the PORTAL web application:

  weblogic_domain\applications\peoplesoft\PORTAL\site\*

  weblogic_domain\applications\peoplesoft\PORTAL\WEB-INF\psftdocs\site\*

  See Enterprise PeopleTools 8.46 PeopleBook: Internet Technology.

• Redeploy PeopleSoft Internet Architecture.

  This selection affects all of the PIA web applications installed to the local WebLogic domain. Select this option to redeploy all of the class files and jar files that comprise web components of PIA. WebLogic Server configuration files, scripts and any existing PeopleSoft (PORTAL) sites are not overwritten, unless you specify an existing PeopleSoft site during this setup.

• Re-create WebLogic domain and redeploy PeopleSoft Internet Architecture.

  This option affects WebLogic Server configuration and all of the PIA web applications installed to the local WebLogic domain. Select this option to completely remove an existing WebLogic domain and create the newly specified PeopleSoft site.

  Warning! The entire WebLogic and PIA configuration in the specified WebLogic domain is deleted when you select this option.

• Deploy additional PeopleSoft application extensions.

  This option is solely for use with PeopleSoft applications. PeopleSoft application extensions are provided with certain PeopleSoft applications, and this option enables you to deploy those extensions. Consult the installation documentation for your PeopleSoft application to see if this option is appropriate. PeopleTools does not use application extensions.

Administering a WebLogic Server Life Cycle

This section provides an overview of the WebLogic server life cycle and discusses how to:

• Start and stop single-server processes.

• Start and stop multi-server processes.

• Start and stop a distributed managed server.

See Also

Starting BEA WebLogic

Stopping BEA WebLogic

Understanding the WebLogic Server Life Cycle

You control a WebLogic server’s life cycle primarily using a collection of scripts provided in that server’s WebLogic domain directory. Each instance of a WebLogic server runs in an isolated Java Runtime Environment (JRE), regardless of whether you're testing with a single-server configuration or implementing a multi-server configuration for production. All scripts must be launched from the WebLogic domain directory; and provide usage syntax if run with –help.

Starting and Stopping Single-Server Processes

In a single-server configuration, there's only one server to administer: PIA. You can control the life cycle of the PIA server using scripts or in the WebLogic console.

Scripts

For all platforms:

For Windows only:

WebLogic Console

A WebLogic server can also be shut down from its administration console. To shut down a WebLogic server in the WebLogic Server Console, sign in to the console at http://webserver/console and perform either of the following.

• In the navigation tree on the left, expand your domain, then Servers, then right click the PIA server and select Start/Stop this server.

• In the console, navigate to Servers, PIA, Control.

On the Start/Stop page, you can elect to perform either of the following two shutdown procedures:

Starting and Stopping Multi-Server Processes

In a Multi-server configuration, as the title implies there are multiple servers to administer. Controlling the life cycle of these servers can be done via scripts, the WebLogic console and the WebLogic Node Manager.

Scripts

For all platforms:

For Windows only:

Following are some important managed server considerations for scripts:

• For all platforms:

  When starting a WebLogic managed server it will attempt to connect to its administration server. A managed server’s administration server is specified either as a command line parameter when starting the managed server, or using the three administration server environment variables in setEnv, specifically ADMINSERVER_PROTOCOL, ADMINSERVER_PORT, and ADMINSERVER_HOSTNAME. The first time a managed server starts, it must connect to its administration server. If on subsequent startups the administration server is not available, the managed server starts up in Managed Server Independence (MSI) mode by using its locally replicated msi-config.xml. A managed server running in MSI mode can't be administered from a console, so this situation should only be encountered when it is imperative that the managed server be started even though the administration server is not running. Once the administration server is back online, running managed servers that were not previously known by the administration server to be running may be rediscovered using WebLogic’s command line utility java weblogic.Admin DISCOVERMANAGEDSERVER, or you can just restart the managed server.

  To use WebLogic’s java command line utility classes run setEnv to set up your environment, then run java weblogic.Admin for usage.

• For Windows only:

  When running a WebLogic managed server as a Windows service, the managed server’s administration server must be running. When installing a managed server as a Windows service, the managed server service can be configured to be dependent on its local administration server. To configure a managed server service to be dependent on its local admin server service use the –depends option of installNTservice.cmd when defining the Windows service for the managed server. In addition, when the administration server is also a Windows service, you must define it using the following command:

  installNTservice.cmd –delay interval

  Where intervalis a period in milliseconds, for example 6000. This allows the administration server sufficient time to start before the managed server starts.

WebLogic Server Console

A WebLogic server can also be shut down from its administration console. To shut down a WebLogic server in the WebLogic Server Console, sign in to the console of the WebLogicAdmin server (http://webserver:port/console) and perform either of the following:

• In the navigation applet on the left, expand your domain, then Servers, then right click the PIA server and select Start/Stop this server.

• In the console, navigate to Servers, PIA, Control.

On the Start/Stop page, you can elect to perform either of the following two shutdown procedures:

WebLogic Node Manager

The WebLogic Node Manager provides the ability to start a WebLogic managed server from the WebLogic Server Console. In addition, the console provides a way to automatically restart a failed server. As with all WebLogic servers, the WebLogic Node Manager runs isolated in its own JRE, and on Windows it can also run as a Windows service. The WebLogic Node Manager binds to a unique IP address and port at startup and accepts lifecycle commands from a WebLogic administration server.

Multiple WebLogic domains running on a singe machine can have its managed servers administered by a shared WebLogic Node Manager, as long as each WebLogic domain uses the same version of WebLogic.

The following table lists the WebLogic Node Manager files that are provided with WebLogic server, not the PIA install. These files are located in BEA_HOME\weblogic81\server\bin\, not your PeopleSoft created WebLogic domain directory.

Note. BEA_HOME\weblogic81\common\nodemanager\NodeManagerLogs\ is the default logs directory for WebLogic Node Manager.

To start a local WebLogic Managed server from the WebLogic Node Manager:

1. Start the WebLogic domain’s WebLogic administration server.

2. Start the Node Manager of that domain’s local BEA_HOME.

   If you're attempting to start a distributed managed server, you must start the Node manager on that distributed machine, otherwise the administration server, Node Manager and managed server are all on one machine.

3. Sign on to the WebLogic Server Console by entering the following URL in a browser:

   http://webserver:9999/console

   Where webserver is the domain of the WebLogic server.

4. Traverse the following in the navigation tree on the left:

   1. Expand your WebLogic domain (for example, peoplesoft).

   2. Expand Servers.

   3. Right click the server you would like to start and click ‘Start/Stop this server...’.

5. On the console home page, within “Domain Configuration” \ “Network Configuration” select Servers, click the server you want to start, then select the Control tab.

6. Click the “Start this server...” link to start that server.

   If that text is not a hyperlink, either the WebLogic Node Manager is not running or the administration server was not able to communicate to the Node Manager.

A WebLogic Managed server started from the WebLogic Node Manager doesn't use Java options defined in setEnv, such as Java heap size. If you opt to use the WebLogic Node Manager, you should confirm or adjust the Java options in the WebLogic console of the administration server.

To adjust the Java options:

1. Expand your WebLogic domain (for example, peoplesoft).

2. Expand Servers.

3. Select the managed server that you would like to modify.

4. Select the first level Configuration tab

5. Select the second level Remote Start tab.

6. Update the Arguments field.

7. Click the Apply button.

Starting and Stopping a Distributed Managed Server

In a multi-server configuration, a distributed managed server is simply a managed server that isn't started from the same physical location as its domain’s administration server. You can control the life cycle of these servers using scripts, the WebLogic Server Console and the WebLogic Node Manager.

See Starting and Stopping Multi-Server Processes.

In addition to the multi-server considerations, edit the following file:

BEA_HOME\weblogic81\common\nodemanager\nodemanager.hosts

Edit this file to include a list of IP addresses or host names of WebLogic administration servers from which the connection to the node manager will be accepted. In a typical configuration, there's only one such server

Tuning Performance and Monitoring Resources

Monitoring the performance of a WebLogic instance is primarily performed at the WebLogic console. This section discusses how to:

• Manage JVM heap size and execute thread usage.

• Monitor HTTP session count for PeopleSoft portal.

See Also

Using WebLogic Server 8.1 Console to Monitor PeopleSoft Sessions

Managing JVM Heap Size and Execute Thread Usage

Two of the main resource to monitor and tune with regards to WebLogic Server are the JVM memory heap size and the Execute thread count pool size. Monitoring and tuning both of these resources and more are describe below.

Monitoring JVM Heap and Execute Thread Usage

The JVM heap size is the amount of memory that a particular JRE (Java Runtime Environment) gives to the JVM (Java Virtual Machine) that it creates. The java.exe command on Windows, java on UNIX and beasvc.exe when running WebLogic as a Windows service is the JRE and the JVM exists within the JRE’s memory space. The two primary sources for monitoring the amount of memory that is in use within a JVM are the WebLogic console and the WebLogic logs.

To monitor the amount of the JVM heap size available and in use:

1. Sign on to the WebLogic Server Console by entering the following URL in a browser:

   http://webserver:9999/console

   Where webserver is the domain of the WebLogic server.

2. Traverse the following in the navigation tree on the left:

   1. Expand your WebLogic domain (for example, peoplesoft).

   2. Expand Servers.

3. Select the server you intend to monitor (for example, PIA).

4. Select the first level Monitoring tab.

5. Select the second level Performance tab.

Idle Threads	Displays the number of execute threads available for work. Having an excessive number of idle threads, such as 200, will waste a small amount of JVM resources. Note. This value is static, so you must refresh the page to update it. Use the refresh icon at the top of the page.
Oldest Pending Request	Displays the date and time stamp of the oldest request in the queue. Note. This value is static, so you must refresh the page to update it. Use the refresh icon at the top of the page.
Throughput	Displays the number of requests over the displayed time frame that have been processed by an execute thread for the sampling time period. The top number on the left is the highest throughput, the bottom number on the left is the lowest throughput and the number on the right is the throughput for the current sample period.
Queue Length	Displays the number of requests over the displayed time frame that are queued up and waiting to be processed for the sampling time period. The top number on the left is the highest backlog, the bottom number on the left is the lowest backlog and the number on the right is the backlog for the current sample period.
Memory Usage	Displays the amount of JVM memory used in bytes over the displayed time frame. The top number on the left is the maximum memory available to the JVM (set using Java’s –Xmx setting) and the number on the right is the memory in use for the current sample period.

Changing the JVM Heap Size

If you need to adjust any of the Java options, most commonly the JVM heap size, you must manually edit that WebLogic domain’s local setEnv script. The two parameters, -Xms and -Xmx, control the JVM memory minimum and maximum heap size respectively.

Following are examples of the JVM heap size as specified in setEnv using the JAVA_OPTIONS_OSplatform environment variable. You only need to set the variables that correspond to the OS where the WebLogic server is running.

• JAVA_OPTIONS_WIN32="-server -Xms32m -Xmx200m -XX:MaxPermSize=128m"

• JAVA_OPTIONS_AIX="-Xms32m -Xmx200m"

• JAVA_OPTIONS_HPUX="-server -Xms32m -Xmx200m -XX:MaxPermSize=128m"

• JAVA_OPTIONS_LINUX="-Xms128m -Xmx256m"

• JAVA_OPTIONS_TRU64="-Xms32m -Xmx200m"

• JAVA_OPTIONS_SOLARIS="-server -Xms32m -Xmx200m -XX:MaxPermSize=128m"

Note. If you do adjust any of the Java options, most commonly the JVM heap size, you must restart WebLogic for these changes to take effect.

If you're running WebLogic Server as a Windows service you must rerun the installNTservice script to propagate this change into the Windows registry.

The WebLogic Node Manager does not use the Java options set in setEnv, but instead uses Java options set from the WebLogic console.

To modify the Java options for a WebLogic instance started via the WebLogic Node Manager:

1. Sign on to the WebLogic Server Console by entering the following URL in a browser:

   http://webserver:9999/console

   Where webserver is the domain of the WebLogic server.

2. Traverse the following in the navigation tree on the left:

   1. Expand your WebLogic domain (for example, peoplesoft).

   2. Expand Servers.

3. Select the server you intend to modify (for example, PIA).

4. Select the first level Configuration tab.

5. Select the second level Remote Start tab.

6. Update the Arguments field.

7. Click Apply.

Changing the Execute Thread Pool Size

To change the size of the Execute thread pool used by PeopleSoft applications for a particular WebLogic instance:

1. Sign on to the WebLogic Server Console by entering the following URL in a browser:

   http://webserver:9999/console

   Where webserver is the domain of the WebLogic server.

2. Traverse the following in the navigation tree on the left:

   1. Expand your WebLogic domain (for example, peoplesoft).

   2. Expand Servers.

3. Right-click the server you intend to modify (for example, PIA).

4. Select View Execute Queues.

5. Click the queue that your server is using, most likely weblogic.kernel.Default.

6. Adjust the queue size settings to fit your needs.

7. Click Apply.

See Also

Adjusting the JVM Heap Size

Monitoring HTTP Session Count for PeopleSoft Portal

In addition to memory and thread usage, it's also possible to monitor the number of established HTTP sessions used in conjunction with the PeopleSoft PORTAL application. This number, although not necessarily directly related to current performance, is an indicator of the following performance factors:

• JVM memory used to store HTTP session data.

• Current number of logged on clients.

• Peak number of logged on clients.

• Idle time of logged on clients.

To monitor HTTP sessions:

1. Sign on to the WebLogic Server Console.

2. Traverse the following in the navigation tree on the left:

   1. Expand peoplesoft.

   2. Expand Deployments.

   3. Expand Applications.

   4. Expand peoplesoft.

3. Select PORTAL.

4. Select the Monitoring tab.

5. Select the Sessions tab.

6. Ensure that the Session Monitoring Enabled check box is selected, which enables it for the current WebLogic instance.

   If the check box was previously cleared, restart WebLogic Server to apply the new setting.

7. Click the Refresh button at the top of the console page.

With HTTP session monitoring enabled, the information displayed will be users’ PeopleSoft ID, their workstation name or IP address, the PeopleSoft site they are logged onto and the time of their last request.

Note. Established HTTP sessions remain on the web server until users sign out of PeopleSoft or until the sessions time out. Simply closing the browser does not sign a PeopleSoft user out. You can control HTTP session time out settings from a site's web profile in the PeopleSoft database.

See Also

Configuring Web Profiles

Changing Configuration Settings

This section provides an overview of the WebLogic server configuration files, and discusses how to:

• Change the WebLogicAdmin server’s listen ports.

• Change application and server deployment targets.

Understanding the WebLogic Server Configuration Files

WebLogic server configuration settings are stored in a collection of files, primarily the setEnv script, config.xml, and the web.xml and weblogic.xml for each webapp.

• SetEnv contains statically and dynamically defined environment variables. It's called from all of the WebLogic administration scripts to assist in building the Java command line. You modify this file using a text editor.

• Config.xml contains server runtime settings, such as the HTTP port. You modify this file using the WebLogic Server Console.

• Web.xml and weblogic.xml, which are located in the WEB-INF directory of each webapp, are web application descriptors and contain settings relevant to their application.

Changing the WebLogicAdmin Server’s Listen Ports

In the multi-server configuration, several parameters are set based on the environment detected and on delivered defaults. One such parameter is the HTTP port of the WebLogicAdmin server. By default the WebLogicAdmin server’s HTTP listen port is 9999.

To change this value:

1. Start the WebLogicAdmin server via the startWebLogicAdmin script

2. Sign on to the WebLogic Server Console by entering the following URL in a browser:

   http://webserver:9999/console

   Where webserver is the domain of the WebLogic server.

3. Navigate to Servers, WebLogicAdmin, Configuration, General.

4. Modify the value of the Listen Port field.

5. Click Apply.

6. Restart the WebLogic server.

Note. If you can't initially start the server due to a port conflict, you can manually edit the value of the ListenPort parameter in that domain’s config.xml file. Creating a backup of config.xml is recommended before manually changing this file.

After changing the ListenPort value in your domain’s config.xml, either directly or using the console, you must also update your setEnv script. Update the ADMINSERVER_PORT environment variable to reflect the new HTTP port. This setting is used by the stopWebLogic and startManagedWebLogic scripts as the default administration server HTTP port.

Changing Application and Server Deployment Targets

With WebLogic, J2EE applications are targeted to any combination of WebLogic servers and WebLogic clusters. A WebLogic cluster is a logical grouping of servers, generally all providing the same application, though that's not a requirement. To change the servers or clusters that an application is targeted and deployed to, sign on to the WebLogic Server Console and update the application's target assignments. You can view and modify application and server target assignments on the Deployments, Applications tabs, and on the Deployments tab for each server.

Following is an example of how to change the target assignments of the PeopleSoft Integration Gateway (PSIGW) web application so it’s the only application targeted to the PIA server, and is the sole application on that instance.

To change the target assignments of the PeopleSoft Integration Gateway web application:

1. Sign on to the WebLogic Server Console.

2. Traverse the following in the navigation tree on the left:

   1. Expand peoplesoft.

   2. Expand Deployments.

   3. Expand Applications.

   4. Expand peoplesoft.

3. Select PSIGW.

4. Select the Targets tab.

5. In the Clusters section, clear the peoplesoftCluster check box.

6. Click Apply.

7. In the navigation tree, select PORTAL.

8. Select the Targets tab.

9. In the Independent Servers grid, clear the check box for targeting the PORTAL webapp to this server.

10. Click Apply.

11. Repeat steps 7 to 10 for the PSEMHUB, PSINTERLINKS and PSOL web applications.

To deploy an application to a cluster, target the server to the cluster and target the application to the cluster.

Applying an Example Single-Server Configuration

This section provides overviews of the basic machine configuration, PIA setup prompts, configuration file settings, and unprompted configuration file settings, and discusses how to start the weblogic server.

Basic Machine Configuration

This example single-server setup is performed on a machine with the following configuration:

• Operating system: Windows

• Hostname: DBROWN040403

• PeopleSoft home directory: C:\PT845

• BEA WebLogic Server home directory: C:\BEA

PIA Setup Prompts

Following are the PIA setup prompts and corresponding values appropriate to building the example single-server domain.

Note. The Prompt # column doesn't reflect actual step numbers during setup. The prompt numbers simply provide a reference for subsequent discussion of the configuration file settings.

Configuration File Settings

As a result of the specified setup response values, several configuration files are updated. Following are the corresponding configuration file updates by prompt number.

<ServerStart Arguments="-Xms64m -Xmx128m -Dps_home=C:/PT845" ClassPath="c:/bea/weblogic81\server\lib\weblogic_sp.jar;C:/PT845\webserv\peoplesoft\lib\ps_patch.jar;c:/bea/weblogic81\server\lib\weblogic.jar"
JavaHome="c:\bea\jdk142" RootDirectory="C:\PT845\webserv\peoplesoft"...

<ServerStart BeaHome="c:\bea" ClassPath="c:/bea/weblogic81\server\lib\weblogic_sp.jar;C:/PT845\webserv\peoplesoft\lib\ps_patch.jar;c:/bea/weblogic81\server\lib\weblogic.jar"...

<session-param>
   <param-name>CookieDomain</param-name>
   <param-value>.peoplesoft.com</param-value>
</session-param>

Note. The prompts numbered 7, 8, 9, 13, 14, 15, and 16 don't directly affect the WebLogic configuration.

Unprompted Configuration File Settings

In addition to the configuration file changes based on the setup response values, additional automatic configuration changes are performed based on the domain type you selected.

Starting the Weblogic Server

To start the WebLogic server created in this example, use the scripts created in the generated WebLogic domain directory of PS_HOME\webserv\peoplesoft\. To start this WebLogic server as a foreground process, run startPIA.cmd. A successful startup produces the following messages, which indicate that the server has started, that it has bound to all local IP addresses, and that it's listening on ports 80 and 443 for HTTP and HTTPS traffic respectively.

<Feb 27, 2004 11:23:41 AM PST> <Notice> <WebLogicServer> <BEA-000355> <Thread "ListenThread.Default" listening on port 80,
ip address *.*>
<Feb 27, 2004 11:23:41 AM PST> <Notice> <WebLogicServer> <BEA-000355> <Thread "SSLListenThread.Default" listening on port
443, ip address *.*>
<Feb 27, 2004 11:23:41 AM PST> <Notice> <WebLogicServer> <BEA-000330> <Started WebLogic Admin Server "PIA" for domain "peoplesoft"
running in Production Mode>
<Feb 27, 2004 11:23:41 AM PST> <Notice> <WebLogicServer> <BEA-000360> <Server started in RUNNING mode>

Applying an Example Multi-Server Configuration

This section provides overviews of the basic machine configurations, PIA setup prompts for multi-server configuration, configuration file settings for multi-server configuration, unprompted multi-server configuration file settings, PIA setup prompts for distributed managed server configuration, configuration file settings for distributed managed server configuration, and unprompted distributed server configuration file settings, and discusses how to start the weblogic servers.

Basic Machine Configurations

An extended Multi-server configuration requires performing two PIA installs, once to create the Multi-Server configuration and a second time to create the Distributed Managed Server.

This Multi-Server installation was performed on a machine with the following configuration.

• Operating system: Windows

• Hostname: DBROWN040403

• PeopleSoft home directory: C:\PT845

• BEA WebLogic Server home directory: C:\BEA

This Distributed-Server installation was performed on a machine with the following configuration.

• Operating system: RedHat Linux

• Hostname: PT-LINUX01

• PeopleSoft home directory: /apps/pt845

• BEA WebLogic Server home directory: /apps/bea

PIA Setup Prompts for Multi-Server Configuration

Following are the PIA setup prompts and corresponding values appropriate to building the example extended multi-server domain.

Note. The Prompt # column doesn't reflect actual step numbers during setup. The prompt numbers simply provide a reference for subsequent discussion of the configuration file settings.

Configuration File Settings for Multi-Server Configuration

As a result of the specified setup response values, several configuration files are updated. Following are the corresponding configuration file updates by prompt number.

<ServerStart Arguments="-Xms64m -Xmx128 -Dps_home=c:/pt845" ClassPath="c:/bea/weblogic81/server/lib/weblogic_sp.jar;c:/pt845/webserv/peoplesoft/lib/ps_patch.jar;c:/bea/weblogic81/server/lib/weblogic.jar"
JavaHome="c:/bea/jdk142" RootDirectory="c:/PT845/webserv/peoplesoft"...

<ServerStart BeaHome="c:/bea" ClassPath="c:/bea/weblogic81/server/lib/weblogic_sp.jar;c:/pt845/webserv/peoplesoft/lib/ps_patch.jar;c:/bea/weblogic81/server/lib/weblogic.jar"...

<Domain Name="peoplesoft"...

<Server Name="PIA" ListenPort="80"...
<Server Name="PIA1" ListenPort="80"...
<Server Name="PIA2" ListenPort="80"...

<Server Name="PIA" SSLListenPort="443"...
<Server Name="PIA1" SSLListenPort="443"...
<Server Name="PIA2" SSLListenPort="443"...

<session-param>
   <param-name>CookieDomain</param-name>
   <param-value>.peoplesoft.com</param-value>
</session-param>

Note. The prompts numbered 7, 8, 9, 13, 14, 15, and 16 don't directly affect the WebLogic configuration.

Unprompted Multi-Server Configuration File Settings

In addition to the configuration file changes based on the setup response values, additional automatic configuration changes are performed based on the domain type you selected.

PIA Setup Prompts for Distributed Managed Server Configuration

Following are the PIA setup prompts and corresponding values appropriate to building the example extended multi-server domain.

Note. The Prompt # column doesn't reflect actual step numbers during setup. The prompt numbers simply provide a reference for subsequent discussion of the configuration file settings.

Configuration File Settings for Distributed Server Configuration

As a result of the specified setup response values, several configuration files are updated. Following are the corresponding configuration file updates by prompt number.

<session-param>
   <param-name>CookieDomain</param-name>
   <param-value>.peoplesoft.com</param-value>
</session-param>

Note. The prompts numbered 7, 8, 9, 13, 14, 15, and 16 don't directly affect the WebLogic configuration.

Unprompted Distributed Server Configuration File Settings

In addition to the configuration file changes based on the setup response values, additional automatic configuration changes are performed based on the domain type you selected.

Starting the WebLogic Servers

To start the WebLogic Servers created in this example, use the scripts created in the generated WebLogic domain directory of PS_HOME\webserv\peoplesoft.

Starting the Domain Administration Server

To start the domain administration server, WebLogicAdmin, run the following command:

c:\pt845\webserv\peoplesoft\startWebLogicAdmin.cmd

A successful startup of this server produces the following messages, which indicate that the server has started, that it has bound to all local IP addresses, and that it's listening on port 9999 for HTTP traffic.

<Feb 27, 2004 11:23:41 AM PST> <Notice> <WebLogicServer> <BEA-000355> <Thread "ListenThread.Default" listening on port 9999,
ip address *.*>
<Feb 27, 2004 11:23:41 AM PST> <Notice> <WebLogicServer> <BEA-000330> <Started WebLogic Admin Server "WebLogicAdmin" for domain
"peoplesoft" running in Production Mode>
<Feb 27, 2004 11:23:41 AM PST> <Notice> <WebLogicServer> <BEA-000360> <Server started in RUNNING mode>

Starting the Local Managed Server

To start the local managed server (PIA) on DBROWN040403, the same machine where the WebLogicAdmin server is running, run the following command:

c:\pt845\webserv\peoplesoft\startManagedWebLogic.cmd PIA

A successful startup of this server produces the following messages, which indicate that the server has started, that it has bound to all local IP addresses, and that it's listening on ports 80 and 443 for HTTP and HTTPS traffic respectively.

<Feb 27, 2004 2:17:04 PM PST> <Notice> <WebLogicServer> <BEA-000355> <Thread "ListenThread.Default" listening on port 80,
ip address *.*>
<Feb 27, 2004 2:17:04 PM PST> <Notice> <WebLogicServer> <BEA-000355> <Thread "SSLListenThread.Default" listening on port 443,
ip address *.*>
<Feb 27, 2004 2:17:04 PM PST> <Notice> <WebLogicServer> <BEA-000330> <Started WebLogic Managed Server "PIA" for domain "peoplesoft"
running in Production Mode>
<Feb 27, 2004 2:17:04 PM PST> <Notice> <WebLogicServer> <BEA-000360> <Server started in RUNNING mode>

Starting a Remote Distributed Managed Server

Prior to starting a remote distributed managed server, which in this example is a WebLogic Reverse Proxy Server (RPS), you must modify the HttpProxyServlet web application’s web.xml file to specify the address of the back-end WebLogic instance from which content is proxied. The HttpProxyServlet webapp is the default webapp for the RPS server, and is used when proxing content from a single back-end WebLogic server.

To modify HttpProxyServlet’s web.xml you can use BEA’s graphical WebLogic Builder, or simply edit the HttpProxyServlet’s web.xml. To use WebLogic Builder, launch the startWebLogicBuilder script from within your WebLogic domain directory, and either specify applications/HttpProxyServlet as a command line parameter, or once in WebLogic Builder select File/Open and open the HttpProxyServlet application. To edit the web.xml file manually, the location of the file is weblogic_domain\applications\HttpProxyServlet\WEB-INF\web.xml.

The parameter values to adjust are the WebLogicHost and WebLogicPort init-params for the HttpProxyServlet servlet. Following the relevant part of a properly configured web.xml.

<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
 <web-app>
    <display-name>HttpProxyServlet</display-name>
    <description>HttpProxyServlet</description> 
 <servlet>
    <servlet-name>HttpProxyServlet</servlet-name>
    <display-name>HttpProxyServlet</display-name>
 <servlet-class>weblogic.servlet.proxy.HttpProxyServlet</servlet-class>
    <init-param>
       <param-name>WebLogicHost</param-name>
       <param-value>DBROWN040403</param-value>
       <description>Hostname of WebLogic PIA/PORTAL server.</description>
    </init-param>
    <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 start the remote managed server (RPS) on PT-LINUX01, the machine where the distributed managed server setup was performed, run the following command:

/apps/pt845/webserv/peoplesoft/startManagedWebLogic.cmd RPS http://dbrown040403:9999

A successful startup of this server produces the following messages, which indicate that the managed server started and was able to connect to the administration server, that it has bound to all local IP addresses, and that it's listening on ports 80 and 443 for HTTP and HTTPS traffic, respectively.

<Feb 27, 2004 2:17:04 PM PST> <Notice> <WebLogicServer> <BEA-000355> <Thread "ListenThread.Default" listening on port 8080,
ip address *.*>
<Feb 27, 2004 2:17:04 PM PST> <Notice> <WebLogicServer> <BEA-000355> <Thread "SSLListenThread.Default" listening on port 8443,
ip address *.*>
<Feb 27, 2004 2:17:04 PM PST> <Notice> <WebLogicServer> <BEA-000330> <Started WebLogic Managed Server "RPS" for domain "peoplesoft"
running in Production Mode>
<Feb 27, 2004 2:17:04 PM PST> <Notice> <WebLogicServer> <BEA-000360> <Server started in RUNNING mode>

Note. During the PIA setup of the distributed managed server, nothing was specified to indicate which server would be run on PT-LINUX01. The managed server that's run as a distributed managed server is the server name specified as a command line parameter to running startWeblogic along with the URL of its administration server.