Documente Academic
Documente Profesional
Documente Cultură
x Install Options
Oracle
Page 2
Introduction
Intended Audience
This document is intended for anyone who is installing a WebLogic 10.3.x domain in their PeopleSoft
environment and is looking for additional details (outside of information provided in PeopleTools 8.5x
Installation guide) on different types of WebLogic install options
Oracle
Page 3
Oracle
Page 4
Domain Types
Single-Server WebLogic Domain
For a single-server domain, the WebLogic domain uses just one java process, and the entire PeopleSoft
application is deployed to it. The domain listens on just one http port (as well as an https port) and all the
requests (PIA requests and WebLogicAdmin requests) go to this single java process. This is the easiest and
most basic type of domain to install.
In the past, weve not recommended single-server domains in production environments, since a single java
process was being shared for both PIA and WebLogicAdmin processing. However, with the introduction of 64bit WebLogic (starting with PeopleTools 8.51), the java process no longer has the restrictions on heap size. So
that makes the Single-Server domain a more viable solution, even in production environments. (More about this
in the advantages/disadvantages section)
EXAMPLE 1: Below is a diagram of a single-server WebLogic domain (uses one java process).
Web Server Machine
Single Server Domain peoplesoft
PIA
Listening on:
http port# 80 and https port# 443
EXAMPLE 2: Note that you also have the option of installing multiple single-server domains on one machine
(or multiple single-server domains on multiple machines) But you need to make certain each domain is listening
on a different http and https port# (if multiple domains on one machine). If you have more than one PIA, then a
load balancer or reverse proxy server is needed in order to distribute the requests to the PIAs. Below is a
diagram showing two Single Server Weblogic domains on one machine (using a total of two java processes)
Web Server Machine
Single Server Domain peoplesoft1
PIA
Load Balancer (or RPS)
Listening on port
80
Listening on:
http port# 80 and https port# 443
PIA
Listening on:
http port# 81 and https port# 444
Oracle
Page 5
WebLogicAdmin
Listening on http port# 9999
PIA
Listening on:
http port# 81 and https port# 444
EXAMPLE 2: Note that you can set up additional server definitions, outside of the seven pre-configured
definitions. For example, if you want two independent PIAs, you could clone the PIA and call it PIA-TWO as
in this example below (Independent PIAs and Clustered PIAs are discussed further in Section Clustered vs
Independent PIAs). This set-up would require a load balancer or proxy server in order to distribute the
incoming http requests to PIA and PIA-TWO
Oracle
Page 6
WebLogicAdmin
Listening on http port# 9999
Listening
on port 80
PIA
Listening on:
http port# 81 and https port# 443
Oracle
PIA-TWO
Listening on:
http port# 82 and https port# 444
Page 7
WebLogicAdmin
Listening on http port# 9999
Listening
on port 80
Clustered PIA
PIA1
Listening on:
http port# 80 and https port# 443
PIA2
Listening on:
http port# 81 and https port# 444
EXAMPLE 2: You can also set up a DMS with independent PIAs as per the example below (refer to the
Cluster vs Independent PIAs section for more information about using Independent PIAs or Clustered PIAs)
Web Server Machine 1
Load Balancer
(or RPS)
WebLogicAdmin
Listening on http port# 9999
Listening
on port 80
PIA
Listening on:
http port# 80 and https port# 443
Oracle
PIA-TWO
Listening on:
http port# 81 and https port# 444
Page 8
MULTI-SERVER DOMAIN:
Advantages:
Allows for scalability as you can easily add/remove PIAs as needed, to a multi-server domain
You can monitor/configure all the servers (PIAs, PSEMHUB, etc) from a single, centralized
WebLogic console
The multi-server domain option is required for some functionality such as PSEMHUB.
Disadvantages:
More machine resources (memory, CPU, file handles are needed) since the WebLogicAdmin and
each managed server (PIA, PSEMHUB, etc) have a separate java process.
Oracle
Page 9
Oracle
Page 10
Multi-Server Domains
To install a a multi-server domain, refer to the instructions in the PeopleTools 8.5x Installation guide. Below
are links to the Installation Documents
PeopleTools 8.50 Installation Guide
PeopleTools 8.51 Installation Guide
PeopleTools 8.52 Installation Guide
In the PeopleTools 8.5x Installation Guide (links above), you will need to refer to section Setting Up the
PeopleSoft Pure Internet Architecture option.
When installing the PIA, you will need to choose the Multi Server Domain option.
After you install the multi-server domain, the next step is to determine which of the servers you wish to use (eg
PIA, PIA1, PSEMHUB, etc). If you are using more than one PIA, refer to the next section in this document:
How to Install Independent PIAs or Clustered PIAs.
After you install the PIA, refer to section (in installation guide) titled Verifying the PeopleSoft Pure Internet
Architecture Installation. This section provides instructions on how to start the server(s) you wish to use. Most
of our customers choose to use just the WebLogicAdmin server and PIA. To start these two servers, run:
startWebLogicAdmin.sh (or startWebLogicAdmin.cmd for Windows)
startManagedWebLogic.sh PIA (or startManagedWebLogic.cmd PIA for Windows)
Distributed Managed Server (DMS)
The following document provides step-by-step instructions on installing and starting a DMS:
Doc# 951393.1: How to Install and Configure WebLogic Clusters, Distributed Managed Servers and Node
Managers
Oracle
Page 11
Your decision to use independent PIAs or clustered PIAs is solely dependent on ONE
factor and that is whether you are going to implement stateful failover. If you are not using
stateful failover, you should use independent PIAs. If you are using stateful failover (and not implementing
Oracle Coherence), then you should use clustered PIAs.
So to summarize, you would use a clustered PIA only if:
1. You wish to use stateful failover
-AND2. You are implementing stateful failover via a WebLogic cluster (as opposed to using Coherence*Web)
If you are not familiar with stateful failover, then refer to the following information which describes the types of
failover (stateful vs. stateless):
Stateless Failover
In Stateless Failover, the data is not replicated. So if the web server, that user is accessing, becomes
unavailable, then the user will lose any information that they are in the process of updating. However,
the user will remain logged into the PeopleSoft application (since the cookie information is still
available on user's browser)
Stateful Failover (also known as session replication and seamless user session transfer)
In Stateful Failover, the data is replicated. So if the web server, that user is accessing, becomes
unavailable, then there is a seamless transfer of user session to another Weblogic server. The user does
not lose any information that they are in the process of updating.
Stateful Failover functionality was recently added to PeopleTools, therefore there are not very many
PeopleSoft customers who have implemented stateful failover. Thus most of our customers choose to install
independent PIAs.
The following sections explain each independent vs. clustered PIAs, in detail.
Oracle
Page 12
PIA Types
Independent PIAs
With this set up, each PIA is running independently and there is no communication between the different PIAs.
Example 1: In this example, there are two independent PIAs, each installed on the same machine
Web Server Machine
Multi Server Domain peoplesoft
WebLogicAdmin
Listening on http port# 9999
Listening
on port 80
PIA
Listening on:
http port# 81 and https port# 443
PIA-TWO
Listening on:
http port# 82 and https port# 444
Example 2: In this example, there are three independent PIAs, one on Web Server Machine#1 and two more
on Web Server Machine#2
Web Server Machine 1
Load Balancer
(or RPS)
WebLogicAdmin
Listening on http port# 9999
Listening
on port 80
PIA
Listening on:
http port# 80 and https port# 443
Oracle
PIA-THREE
Listening on:
http port# 82 and https port# 445
PIA-TWO
Listening on:
http port# 81 and https port# 444
Page 13
Clustered PIAs
With this set up, the PIAs are configured to be in a cluster and multicasting/unicasting is used so that the
PIAs can communicate with one another. As mentioned earlier, the clustered PIA is needed only if you are
implementing stateful failover, as the cluster configuration allows the PIAs to replicate session data of other
PIAs. Thus, if one of the PIAs goes down, the users session can be seamlessly transferred to another PIA.
Note that even though the PIAs are clustered, each uses its own java process and it listens on its own http port.
The clustered PIA is much more complex because of the multicasting/unicasting going on between the PIAs.
Also, there is more memory overhead if you configure the PIAs to replicate each others session info.
Therefore we recommend using it only if you need stateful failover (and if you choose not to use
Coherence*Web for stateful failover implementation)
Example 1: Below is an example of a clustered PIA, with two PIA members, on a multi-server domain
Web Server Machine
Multi Server Domain peoplesoft
WebLogicAdmin
Listening on http port# 9999
Listening
on port 80
Clustered PIA
PIA2
PIA1
Listening on:
http port# 82 and https port# 444
Listening on:
http port# 81 and https port# 443
WebLogicAdmin
Listening on http port# 9999
Listening
on port 80
Clustered PIA
PIA1
Listening on:
http port# 80 and https port# 443
Oracle
PIA2
Listening on:
http port# 81 and https port# 444
Page 14
CLUSTERED PIA:
Advantages:
Allows for stateful failover (in the event that you are not using Oracle Coherence*Web for stateful
failover)
Disadvantages:
This is a rather complex setup since unicasting/multicasting is required for communication between
PIAs
More machine resources (memory and CPU) required for each PIA since the PIAs back up each
others session info and since unicasting/multicasting communications occur between each of the
PIAs
Oracle
Page 15
Oracle
Page 16
Oracle
Page 17
Other Resources
This document concentrated on a couple key configurations to consider when installing WebLogic PIA:
1) Domain type
2) Clustered vs. Independent PIA's
In addition to the above configurations, there are many other things to consider when installing/configuring
WebLogic such as setting heap size, configuring SSL, getting latest Weblogic patches, etc. Below are other
resources that may help you with any other WebLogic configurations that you need help with:
This knowledge document provides a variety of information on using WebLogic 10.3.x with PeopleSoft:
Doc ID 1390513.2: Information Center: WebLogic 10.3.x for PeopleSoft
The PeopleBooks "System and Server Administration" includes a section on working with WebLogic.
This can be accessed as follows:
1. Go to the Oracle Hosted PeopleBooks Site:
http://docs.oracle.com/cd/E17566_01/epm91pbr0/eng/psbooks/psft_homepage.htm
2. Go to 'PeopleTools' section and choose your PeopleTools Release
3. Go to the 'Administration Tools' section and click on 'PeopleTools 8.5x: System and Server
Administration'
4. Refer to chapter 'Working with Oracle WebLogic'
Oracle
Page 18