1935421.1 914 E1 WebLogic12c Clustering-JAS Fixed
1935421.1 914 E1 WebLogic12c Clustering-JAS Fixed
1935421.1 914 E1 WebLogic12c Clustering-JAS Fixed
5
Clustering Best Practices with Oracle WebLogic
Server 12c for the HTML Server
O R AC L E W H I T E P AP E R | D E C E M B E R 2 0 1 4
Disclaimer
The following is intended to outline our general product direction. It is intended for information purposes
only, and may not be incorporated into any contract. It is not a commitment to deliver any material,
code, or functionality and should not be relied upon in making purchasing decisions. The development,
release, and timing of any features or functionality described for Oracle’s products remains at the sole
discretion of Oracle.
JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices with Oracle WebLogic Server 12c for the HTML Server
Table of Contents
Overview 1
WebLogic Definitions 2
About Clusters 2
Cluster and Domain: Differences 2
Benefits of Clustering 3
Vertical and Horizontal WebLogic Clusters 3
WebLogic Administration Server and WebLogic Administration Console 3
Machines and Node Manager 3
Overview of the Install 4
vmserver44 4
vmserver4444 4
JD Edwards Instance details 4
Overview of a Vertical Cluster Setup 4
Setting Up a Vertical Cluster 5
Create the E1_914 WebLogic Domain 5
Start the Administration Server 15
Create the Cluster 17
Overview of a Horizontal Cluster Setup 23
Setting Up a Horizontal Cluster 24
Load Balancing the Clustered Server 30
Install Oracle HTTP Server 30
Set Up HTTP Proxy for Load Balancing 47
I | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices with Oracle WebLogic Server 12c for the HTML Server
Testing Clustered HTML Server without SSL 48
Configuring SSL 48
Configuring Oracle HTTP Server as a Client that Trusts the WebLogic Server 51
II |
JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Overview
The purpose of this document is to provide all the necessary steps for JD Edwards EnterpriseOne
customers to setup Oracle WebLogic Server clusters. The clusters can then be used for deployment of
the JD Edwards EnterpriseOne HTML application.
1 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices with Oracle WebLogic Server 12c for the HTML Server
WebLogic Definitions
The first part of this paper discusses each part of a WebLogic Server used in the setup of the JD Edwards
EnterpriseOne clusters. For the complete WebLogic documentation, see
About Clusters
A WebLogic Server cluster consists of multiple WebLogic Server instances running simultaneously and working
together to provide increased scalability and reliability. To clients, the cluster shows as a single WebLogic Server
instance. The server instances that constitute a cluster can run on the same machine or be located on different
machines. You can increase a cluster’s capacity by adding additional server instances to the cluster on an existing
machine, or you can add machines to the cluster to host the incremental server instances. Each server instance in
a cluster must run the same version of WebLogic Server.
A domain is an interrelated set of WebLogic Server resources that are managed as a unit. A domain includes one
or more WebLogic Server instances, which can be clustered, non-clustered, or a combination of clustered and
nonclustered instances. A domain can include multiple clusters. A domain also contains the application
components deployed in the domain, and the resources and services required by those application components,
and the server instances in the domain.
In each domain, one WebLogic Server instance acts as the Administration Server—the server instance which
configures, manages, and monitors all other server instances and resources in the domain. Each Administration
Server manages one domain only. If a domain contains multiple clusters, each cluster in the domain has the same
Administration Server.
All server instances in a cluster must reside in the same domain; you cannot “split” a cluster over multiple domains.
Similarly, you cannot share a configured resource or subsystem between domains.
Clustered WebLogic Server instances behave similar to non-clustered instances, except that they provide failover
and load balancing. The process and tools used to configure clustered WebLogic Server instances are the same
as those used to configure non-clustered instances. However, to achieve the load balancing and failover benefits
that clustering enables, you must follow guidelines for cluster configuration.
You can follow the cluster configuration guidelines by two methods. One method is to use a hardware load
balancer to achieve load balancing and failover. The second method is to use the WebLogic Server functionality.
This paper discusses the steps required to:
» Achieve load balancing using only WebLogic tools, and not the load-balancing hardware.
» Install and configure Oracle HTTP Server.
For load balancing, you can use Oracle HTTP Server as a proxy server in front of WebLogic Clusters.
For details about WebLogic Server clustering, including the steps to implement clustering with load balancing
hardware, see the Oracle WebLogic Clustering Guide:
WebLogic 12.1.2: http://docs.oracle.com/middleware/1212/wls/INTRO/clustering.htm
WebLogic 12.1.3: http://docs.oracle.com/middleware/1213/wls/INTRO/clustering.htm
2 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Benefits of Clustering
A WebLogic Server cluster provides these benefits:
» Scalability: The capacity of an application deployed on a WebLogic Server cluster can be increased dynamically.
You can add server instances to a cluster without interruption of service—the application continues to run
without impacting clients and end users.
» High-Availability: In a WebLogic Server cluster, application processing can continue when a server instance fails.
You cluster application components by deploying them on multiple server instances in the cluster—so, if a
server instance on which a component is running fails, another server instance on which that component is
deployed can continue application processing.
A horizontal cluster exists when two or more WebLogic Managed Servers on different physical machines are
grouped together. Horizontal clusters can help optimize machine and network resources, and also provide failover
protection if other cluster members are unavailable.
Administration Console is a Web application hosted by Administration Server. You can use Administration Console
to manage and monitor an active domain, including:
» Configuring active domains
» Stopping and starting servers
» Monitoring server health and performance
» Monitoring application performance
» Viewing server logs
You use WebLogic Node Manager when you set up Managed Servers in a horizontal cluster configuration. Node
Manager is a WebLogic Server utility that enables you to start, shut down, and restart Administration Server and
Managed Server instances from a remote location. A Node Manager process is not associated with a specific
WebLogic domain but with a machine. You can use the same Node Manager process to control server instances
in any WebLogic Server domain as long as the server instances reside on the same machine as the Node
Manager process. Node Manager must run on each computer that hosts WebLogic Server instances
(Administration Server or Managed Server) that you want to control with Node Manager.
3 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
vmserver44
» Windows Server 2008 R2 64bit
» Server Manager Agent 9.1.4
» Oracle WebLogic Server 12.1.2
» Domain E1_914
» Administration Server
» Cluster C1
» Managed Server C1_VC1
» Managed Server C1_VC2
» Node Manager for machine vmserver44
» Oracle HTTP Server 12.1.2 (Used for proxy server in front of WebLogic Cluster. Installation and configuration
steps are listed below.)
» Server Manager Console 9.1.4
» Managed Instance for Oracle WebLogic
» Managed Instance for E1_C1_JAS (HTML Server deployment)
vmserver4444
Note: Oracle WebLogic Server is offered in several editions, each of which grants license to different levels of
functionality. For details about the various editions of Oracle WebLogic Server, see the Oracle Fusion
Middleware 12c Licensing Information Guide. The systems described in this document were configured using
Oracle WebLogic Server Enterprise Edition.
» Oracle JD Edwards Server Manager Console 9.1.4 is installed and running on vmserver44.
» Oracle JD Edwards Server Manager Agent 9.1.4 is installed and running on vmserver44.
» WebLogic Node Manager on vmserver44 is up and running.
» JD Edwards EnterpriseOne services are up and running to validate the HTML sign-on with JD Edwards Security
Server.
» The user implementing these steps has a thorough understanding of JD Edwards installation, including Server
Manager, and Oracle WebLogic Server 12c.
The Vertical Cluster setup consists of two Managed Servers running on the same machine. The following is an
overview of setting up a vertical cluster:
4 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
» Install Oracle WebLogic 12.1.2 64bit on machine vmserver44.
» Create a domain E1_914 in WebLogic
» Create a machine vmserver44 in the E191 domain.
» Create a cluster C1 with the Managed Servers C1_VC1. »
Deploy EnterpriseOne JAS HTML Server to the cluster.
» Create Managed Server C1_VC2 and add to cluster C1.
» Edit Startup values for the Managed Servers.
» Configure all the JAS settings for EnterpriseOne JAS HTML Server.
» Start the EnterpriseOne JAS Instance.
» Set up HTTP Proxy for load balancing by performing either of the following actions:
» Create Managed Server using WebLogic HTTPClusterServlet.
» Install Oracle HTTP Server and configure proxy.
For this paper, WebLogic was installed on a Windows platform; therefore, all commands and screenshots are from
Windows.
2. Select the Create a new domain option, enter the domain name E1_914 in the Domain Location field, and
then click Next.
5 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
3. Select the first option Basic WebLogic Server Domain in Available Templates, and then click Next.
6 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
4. Enter the name and password for the domain, and then click Next.
7 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
5. Select Production for Domain Mode, enter the Java Development Kit (JDK) path, and then click Next. Note
that only JDK 1.7 Update 25+ is supported.
8 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
6. Select Administration Server and Node Manager, and then click Next.
Note that you create the cluster, Managed Servers, and machine by using the Administration Console.
You can create the cluster by using the config.cmd program.
9 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
7. Change the listen port to an open port, and then click Next. In this example the port is 7501.
10 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
8. Select Per Domain as the Node Manager Type, enter the Node Manager user name and password, and then
click Next.
11 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
9. Verify the configuration summary, and then click Create to create the domain.
12 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
10. When the configuration progress shows as 100%, click Next.
13 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
11. On the confirmation screen, note the URL for the Administration Console, (in this example, it is
http://vmserver44.us.oracle.com:7501/console), and then, click Finish.
14 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
vmserver44
To stop any other NodeManager instances using stopNodeManager, change directories to the domain location
where NodeManager may be running. For example:
1. cd <WLS_HOME>/ wlserver/server/bin
2. stopNodeManager.cmd
3. Start the NodeManager that was just installed once any other NodeManager instances are stopped
4. cd <WLS_HOME>/user_projects/domains/EnterpriseOne_914/bin
5. startNodeManager.cmd
15 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Start the Administration Server
1. Change directories to the domain location:
cd <WLS_HOME>/user_projects/domains/E1_914
2. Start the server.
startWebLogic.cmd
3. Enter the user name and password when required.
16 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Create the Cluster
1. Use log-in credentials to log in to the Administration Console URL:
http://vmserver44.us.oracle.com:7501/console/login/LoginForm.jsp The system displays the
Administration Console home page:
vmserver44
2. Click Environment, Clusters, Lock & Edit, and then click New.
Change the name to C1. Retain Messaging Mode as Unicast.
Note: Clusters use messaging for sharing sessions, load balancing and failover, Java Message Service
(JMS), and for other information shared between cluster members. Clusters can use either Unicast or
Multicast messaging. Multicast is a simple broadcast technology that enables multiple applications to
subscribe to a given IP address and port number and listen for messages, but requires hardware
configuration and support. Unicast does not have these requirements and is recommended for new
clusters.
17 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
3. Keep all other options as the default and click OK. Then, click Activate Changes. The system displays a
summary of clusters.
18 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
c. Click C1_VC1 and change the machine to dndedasvm4. .
d. Click Save, and then click Activate Changes.
When you select a cluster, the system displays the server settings:
Note: You can access this screen by using different methods in the Administration Console.
One method is:
Click Environment, C1, the Servers tab, and then click the server name.
Another method is:
Click Environment, Servers, and then click the server name.
6. Deploy EnterpriseOne JAS HTML Server to the cluster.
a. Ensure that the Server Manager agent is started on vmserver44.
b. In Server Manager Console on machine vmserver44, register Oracle WebLogic Server 12c as a
managed instance on vmserver44. The screen below shows the instance name as WLS_1212,
the install location as C:\oracle\Middleware\Oracle_Home, and uses the same user name and
password as when the domain E1_914 was created.
19 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
c. When you click the new managed instance, the system displays the WebLogic domain details.
Note the E1_91 domain with the one Managed Server C1_VC1 in the cluster C1. The
Administration Server is also in the E1_91 domain and it is shown as running because the
startWebLogic.cmd command was issued after the domain was created.
d. In Server Manager Console, create a new managed instance on the managed home for
vmserver44, for the EnterpriseOne JAS HTML application.
i. Upload the latest 9.1.4 version of the JD Edwards EnterpriseOne HTML client and
distribute it to vmserver44.
ii. Create a new managed instance called E1_JAS_C1 under the managed home for
vmserver44, using the j2ee server for C1_VC1, port 7503 and the software
component loaded in the previous step. Click Continue.
iii. Enter appropriate information for the JD Edwards instance and click Continue. Then,
confirm the action by clicking Create Instance.
The EnterpriseOne HTML code is deployed to the C1_VC1 server.
A warning message is displayed, informing you that the web server configuration files
are out-of-date on the remote server and they need to be synchronized. The
configuration files (jas.ini, jdbj.ini, jdelog.properties, and so on) are copied from the
server manager agent folders to the classes folder, where the HTML application code
20 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
resides when the Synchronize Configuration button is clicked. These actual locations
are discussed in Step 9. The synchronization occurs at a later step, so you do not
need to click the button at this time.
After the HTML server is deployed, the system displays the following server
information:
vmserver44
21 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
a. In WebLogic Admin Console, click Environment, Servers, C1_VC1, and then click Lock &
Edit.
b. Click the Server Start tab, and add the following in the Arguments box:
-Xms768m –Xmx1280m -DcloneId=C1_VC1
Note: The –DcloneId is case-sensitive. If there are any errors or special characters in the
arguments, the server will not start. If the server does not start, it is recommended that you
delete the values for startup and retype them in the Arguments box. The argument already
consists of the value –Ddefault_path=<SM Agent Home>/targets/E1_JAS_C1/config, where
<SM Agent Home> is the SM Agent install location. Just append the above argument to the
existing ones.
c. Click Save, and then click Activate Changes.
d. Repeat the steps for C1_VC2, using:
–Ddefault_path=<SM Agent Home>/targets/E1_JAS_C1/config -Xms768m –Xmx1280m
DcloneId=C1_VC2
9. Configure the JAS settings for EnterpriseOne JAS HTML Server.
a. Using the Server Manager console, edit your Configuration items for the EnterpriseOne HTML
Server E1_JAS_C1 managed instance. Ensure all the correct information is entered for
Network Setting > JDBJ Database Configuration and so on, and then save the changes.
The current configuration is connecting to an Oracle Database, therefore, you must enter the
correct database connect strings in the tnsnames.ora section of the JDBJ Database
Configuration. Also, the fully qualified path to the tnsnames.ora file must be removed. This step
is necessary for the jdbj.ini file to find the proper location to the tnsnames.ora file after the
synchronization of the configuration files.
When the configurations are saved within Server Manager, the files are stored in:
<SM Agent Home>/targets/E1_JAS_C1/config
b. Click the Managed Instance Name E1_JAS_C1 in Server Manager, and then click the
Synchronize Configuration button. The synchronization process takes a few minutes to
complete. The configuration files are copied to a location within the Server Manager Agent
folders as well as a location within the WebLogic folders.
For Server Manager instance E1_JAS_C1, the configuration files are found in the classes
folder in:
<SMAgentHome>/targets/E1_JAS_C1/owl_deployment/webclient.ear/app/weblcient.war/WEBI
NF
For each Managed Server, there is another copy of the deployed code because the WebLogic
deployment method being used is the staged method: the code is copied to a staged area for
each server. After synchronization, the configuration files for the WebLogic deployment area
are found in the classes folder in:
<WLS_HOME>/user_projects/domains/E1_91/servers/C1_VC1/stage/E1_JAS_C1/app/webclie
n t.war/WEB-INF and
<WLS_HOME>/user_projects/domains/E1_91/servers/C1_VC2/stage/E1_JAS_C1/app/webclie
n t.war/WEB-INF
10. Start the EnterpriseOne JAS Instance.
a. The first time the E1_JAS_C1 managed Instance is started within Server Manager, the
WebLogic servers need to be started instead of the actual HTML Instance. Subsequent
Stop/Start requests can be handled directly by the E1_JAS_C1 Instance.
b. In Server Manager, navigate to your WebLogic managed instance WLS_1212, locate your two
Managed Server names, check the boxes to the left of the names, and then click Start.
22 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
After the servers start, then the E1_JAS_C1 is started and the JD Edwards HTML
Application Server can be accessed on these two URLs:
http://vmserver44:7503/jde/owhtml and http://vmserver44:7505/jde/owhtml
It is recommended that you test these URLs to ensure that the EnterpriseOne HTML Server is
accessible. However, the URLs should not be used by actual users. The HTTP Proxy
(discussed later) will be used to set up load balancing, for all users to be able to access the
HTML application.
The URL on the Server Manager managed instance page points only to the port where the
HTML application was initially deployed. The servers can be stopped and started successfully
using both the Server Manager and the WebLogic Console.
Assumptions
» Oracle WebLogic 12.1.2 64bit is installed on vmserverd4444. WebLogic must be installed in the same directory
structure on each machine. This is mandatory, and if there is any deviation in the install location between the
two machines then the clustered Managed Server will not work on vmserverd4444.
Note: Oracle WebLogic Server is offered in several editions, each of which grants license to different levels of
functionality. For details about various editions, see the Oracle Fusion Middleware 11g Licensing Information
Guide. The systems described in this document were configured using Oracle WebLogic Server Enterprise Edition.
» Oracle WebLogic 12.1.2 is installed and running on vmserver44. The Administration Console is running on port
7501. The two vertical Managed Servers discussed in the previous section are installed.
» Oracle JD Edwards Server Manager Console 9.1.4 is installed on vmserver44.
» Oracle JD Edwards Server Manager Agent 9.1.4 is installed on vmserver44.
» WebLogic Node Manager on vmserver44 is up and running.
» WebLogic Node Manager on vmserverd4444 is up and running.
» JD Edwards EnterpriseOne services are up and running in order to validate the HTML sign-on with JD Edwards
Security Server.
» E1_JAS_C1 managed instance is stopped in Server Manager.
23 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
» The user implementing these steps has a thorough understanding of JD Edwards installation, including Server
Manager, and WebLogic 12c.
Here is an overview of setting up a horizontal cluster:
» Install Oracle WebLogic 12.1.2 64bit on machine vmserverd4444. WebLogic must be installed in the same
directory structure as installed on vmserver44. This is mandatory, and if there is any deviation in the install
location between the two machines then the clustered Managed Server will not work on vmserverd4444.
Note: The Node Manager must be started on the horizontal cluster machine.
» Create machine vmserverd4444 in E1_914 domain using Administration Console.
» Create Managed Server C1_HC1 and add to the cluster C1.
» Edit Startup values for the Managed Server C1_HC1.
» Create the domain E1_914 on vmserverd4444.
» Start the EnterpriseOne JAS Instance.
» Setup HTTP Proxy for load balancing.
24 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
2. Create Managed Server C1_HC1 and add to the cluster C1.
a. In WebLogic Admin Console, click Environment, Servers, Lock & Edit, and then click New.
b. Change the name to C1_HC1, change the Server listen port to 7507, select Yes, make this
server a member of an existing cluster and select C1. Then, click Finish.
25 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
–Ddefault_path=<SM Agent Home>/targets/E1_JAS_C1/config -Xms768m –Xmx1280m
DcloneId=C1_HC1
The –DcloneId is case-sensitive. If there are any errors or special characters in the arguments,
the server will not start. If the server does not start, then it is recommended that you delete the
values for the startup and retype them in the Arguments box. <SM Agent Home> is the SM
Agent install location.
c. Click Save, and then click Activate Changes.
4. Create the domain E1_914 on vmserverd4444.
The steps to create the cluster are complete on vmserver44; now, distribute the domain to
vmserverd4444. Use the pack and unpack commands to complete the distribution.
a. On vmserver44, change directories to the <WLS_HOME>\wlserver\common\bin folder cd
C:\oracle\Middleware\Oracle_Home\wlserver\common\bin.
b. Pack the domain into a jar file. There are no line breaks in the following command. Create the
user_templates folder if it does not exist on vmserver44.
pack.cmd -managed=true
domain=C:\oracle\Middleware\Oracle_Home\user_projects\domains\E1_914 -template
C:\oracle\Middleware\Oracle_Home\user_templates\E1_914.jar -template_name="E1_914"
5. Start the EnterpriseOne JAS managed Instance using Server Manager Console.
a. You added another server to the C1 Cluster; therefore, you need to restart the WebLogic
servers instead of the actual HTML Instance. Subsequent Stop/Start requests can be handled
directly by the E1_JAS_C1 instance.
26 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
b. In Server Manager, navigate to your WebLogic managed instance WLS_1212, locate the three
Managed Server names, check the boxes to the left of the names, and then click Start.
When you start the E1_JAS_C1 managed instance, all the servers in the C1 start too, and
become available for service. The vertical cluster members are started and are accessible as
before using the direct URL. The new cluster member running on vmserverd4444 is accessible
through this URL:
http://vmserverd4444:7507/jde
The configuration files (jas.ini, jdbj.ini, jdlogs.properties, and so on) for the server C1_HC1 are
located on the vmserverd4444 machine in the following location:
<WLHOME>/user_projects/domains/E1_91/servers/C1_HC1/stage/E1_JAS_C1/app/webclient.
w ar/WEB-INF/classes
If a change is made to the configuration files using Server Manager Console, the Synchronize
Configuration warning is displayed again, and when this process is completed, all the
configuration files are copied over to the same classes folder on vmserverd4444.
The tnsnames.ora file does not get copied to the above folder, where the other configuration
files are located. The tnsnames.ora file must be manually copied to vmserverd4444, in the
same folder structure where it is located on vmserver44. This will be fixed in a later release of
Server Manager.
For resolving this, create the server manager agent target config folder on vmserverd4444 in
<Server Manager Home>/targets/E1_JAS_C1/config and copy the tnsnames.ora file from
vmserver44 to vmserverd4444 in the newly created folder. The target folder on vmserverd4444
is /u01/Oracle/Oracle_SMA/SCFHA/targets/E1_JAS_C1/config
When the release level of the HTML server is changed using Server Manager, and the HTML
managed instance is deployed to a cluster, after the deployment of the new HTML release, all
of the Managed Servers in the cluster are updated.
6. Notes about Server Manager and horizontal cluster members
Runtime Metrics
Server Manager Console receives instance information and runtime metrics from the Server Manager
agents running on each of the managed home machines. For the vertical cluster members, all metrics
are transferred successfully because of an agent running on vmserver44.
However, no Server Manager agent is installed on vmserverd4444 (the machine containing the horizontal
cluster member); therefore, no data is reported to the Server Manager Console.
27 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
To correct this, copy the agent.properties file from vmserver44 to vmserverd4444. The agent.properties
file is located in <Server Manager Home>/config on vmserver44. The file contains the name of the
Server Manager Console Machine and Management Server JMX port, which is the port that the Manager
Server listens to for incoming connections.
By copying this agent.properties file to the machine hosting the horizontal cluster member, we are
sending data to the Server Manager on the port listed; therefore, the information will be displayed in the
Server Manager Console.
The file must be in the same physical location on each of the two machines, and it must be owned by the
same user account that runs WebLogic.
Action
» Create the file structure on your horizontal machine and copy the properties file to that location.
After the horizontal server install, Server Manager displays this:
server102
Logs
One drawback for horizontal cluster members is that the logs from Managed Server running on the
horizontal cluster machines will not be brought into the Server Manager console for viewing. The
functionality of displaying logs is performed by the Server Manager Agent, and because no additional
agent is installed on the horizontal cluster machine, no logs will be available in the Server Manager
Console. To view these logs, log in to the machine as the user running WebLogic, change directories to
the log location (as specified by jdelog.properties file), and open in an editor. The functionality to view
horizontal cluster member logs will be included in a future release of Server Manager.
This screen shows that only the Vertical Member logs are displayed.
28 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
server102
JDBC Drivers
Proper Java Database Connectivity (JDBC) drivers must be installed on all physical machines that host
Managed Servers in the cluster. The recommended method of installing JDBC drivers is through the
Server Manager Console. Currently, this method requires a Server Manager Agent running on the target
machine for successful JDBC file copy.
Similar to logs, the JDBC drivers will not be copied to machines which host horizontal cluster members
because there is no Server Manager Agent running on that machine.
To correct this, manually copy the required JDBC file to the horizontal cluster machine. The file must be
identical to the file on the vertical cluster machine, owned by the user running WebLogic, and placed in
the same folder structure as exists on the vertical cluster machine.
Action
» Create the above folder on the horizontal cluster machine, and then copy the JDBC file to that folder.
One method involves using the WebLogic-supplied proxy plug-in HTTPClusterServlet and creating an additional
WebLogic Managed Server to proxy the connections. For the details about this method, see the: WebLogic
Cluster Guide: http://docs.oracle.com/middleware/1212/wls/CLUST/setup.htm#i685302
You can load balance the connections by using Oracle HTTP Server in front of the WebLogic server. There is a
specific module in Oracle HTTP Server called mod_wl_ohs which allows requests to be proxied from Oracle HTTP
Server to Oracle WebLogic Server. For details, see:
http://docs.oracle.com/middleware/1212/core/EMPRC/ohs_mod_weblogic_proc.htm
29 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
The Oracle HTTP server can be installed on the same server as WebLogic or a separate server altogether,
allowing more flexibility in your overall architecture.
1. Download the “Oracle Fusion Middleware 12c Oracle HTTP Server (12.1.2.0.0) ” package that
is appropriate for your platform from the edelivery web site (https://edelivery.oracle.com). For more
information, see the Edwards EnterpriseOne Certifications.
2. Extract the downloaded file to a temporary directory on the machine you are targeting for installation.
3. Run the .exe program to start the installation. The first screen you will see is the welcome screen. Click
Next to begin the installation.
30 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
a. Click View to view an existing directory into which one or more Oracle products have already
been installed.
To install the product in a new directory, type the full path of your new directory in the Oracle
Home field. The installer will create the specified directory for you.
b. Click Next.
5. Determine the type of installation you want to perform and consequently, which products and features
you want to install.
The options you see on this screen will differ depending on the product you are installing. For specific
details, see your product installation guide.
31 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Click Next.
6. Ensure that specific operating system prerequisites have been completed. Click Next.
32 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
7. If you want to register your installation, enter your e-mail address and your My Oracle Support password.
If you want to decline registration, clear the I wish to receive security updates via My Oracle Support
check box.
33 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Click Next.
username
8. The Installation Summary screen contains a list of the feature sets you selected for installation. Click
Install.
34 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
9. This screen now shows the progress of the installation. When the progress bar reaches 100%, the
installation is complete.
35 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Click Next.
10. The system then displays the Installation Complete screen, and provides a summary of the products and
features that are now installed.
36 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Click Finish.
37 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Enter the domain location, and then click Next.
12. Select the template Oracle HTTP Server (Standalone), and then click Next.
38 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
13. A JDK location is selected by default. You can also provide an external JDK location. Click Next.
39 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
14. Enter the system component name, select the component type as OHS, and then click Next.
40 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
15. If required, change the Admin Port, Listen Port, and Secure Socket Layer (SSL) Listen Port values on
this screen.
41 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Click Next.
16. Select Per Domain as the Node Manager Type, enter the node manager user name and password, and
then click Next.
42 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
17. The system displays the Configuration Summary page.
43 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Click Create.
44 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
When the progress bar reaches 100%, clickNext.
19. The Success page indicates that the domain creation is successful. Click Finish.
45 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Set Up HTTP Proxy for Load Balancing
You can now configure the Oracle HTTP Server installation to communicate with an existing EnterpriseOne HTML
server installed on a WebLogic cluster. The following shows how to configure the default HTTP port (7777) in OHS
and dispatch a request to the EnterpriseOne HTML client port running on WebLogic cluster.
1. Find the mod_wl_ohs.conf in the following directory:
<ORACLE_HOME>\user_projects\domains\base_domain\config\fmwconfig\components\OHS\instances\
o hs1
2. In mod_wls_ohs.conf, add the following lines to the end of the file.
» For vertical cluster (Assume that HTML Server instance is created on a cluster with two servers on a
vertical node running on port 7503 and 7505):
Listen 7777
<VirtualHost *:7777>
<Location /jde>
SetHandler weblogic-handler
WebLogicCluster vmserver44:7503,vmserver44:7505
</VirtualHost>
» For horizontal cluster install (Assume that HTML Server instance is created on a cluster with three server
on a horizontal node running on port 7503,7505 and 7507):
46 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Listen 7777
<VirtualHost *:7777>
<Location /jde>
SetHandler weblogic-handler
WebLogicCluster vmserver44:7503,vmserver44:7505,vmserverd4444:7507 </VirtualHost>
Note: The port used (7503, 7505 and 7507) in this configuration are the HTTP port of the respective WLS
Managed Servers on which HTML Server is installed.
Configuring SSL
SSL secures communication by providing message encryption, integrity, and authentication. The SSL standard
allows the involved components (such as browsers and HTTP servers) to negotiate the encryption, authentication,
and integrity.
» Encryption provides confidentiality by allowing only the intended recipient to read the message.
» Integrity ensures that a message sent by a client is received intact by the server, unaltered.
» Authentication enables the server and client to check that the other party is who it claims to be.
Oracle WebLogic Server supports two types of keystores for keys and certificates:
Other components use Oracle wallet as their storage mechanism. An Oracle wallet is a container that stores your
credentials, such as certificates, trusted certificates, certificate requests, and private keys. You can store Oracle
wallets on the file system or in LDAP directories, such as Oracle Internet Directory. Oracle wallets can be auto-
login or password-protected wallets.
There are various lines of communication that you may want to secure with SSL. One consideration is that the
computation required to encrypt and decrypt HTML pages will affect performance. The examples below walk
through configuring SSL for two different communication lines by building on the basic configuration discussed
above, and also demonstrate the use of both a JKS keystore and an Oracle wallet.
47 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
If you elect to secure the communication channel from the browser to the Oracle HTTP Server, you must also
secure the communications between the Oracle HTTP Server and the Oracle WebLogic Server applications. This
consists of two steps: Configuring SSL for your WebLogic Managed Server, and then configuring Oracle HTTP
Server as a client that trusts the WebLogic server.
vmserver4
4
Repeat this step (assigning SSL port) for all the servers in the cluster. Port 7506 and 7508 are
assigned to C1_VC1 and C1_HC1 respectively.
4. Enable WebLogic Plug-In.
WebLogic plug-in needs to be enabled to be able to receive request from a proxy plug-in.
a. In the WebLogic Admin Console, click Environment, Clusters, C1, and then click Lock & Edit.
b. Go to the Advanced section.
c. Set WebLogic Plug-In Enabled to yes.
48 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
d. Click Save, and then click Activate Changes.
The system displays a screen similar to this:
a. From the Keystores drop-down list, select Custom Identity and Java Standard Trust.
b. In the Identity section, in the Custom Identity Keystore field, enter the path and the file name of the
identity keystore that was created in Step 1. Enter JKS for the Custom Identity Keystore Type.
c. Fill in the keystore passphrase with the password that was used in Step 1.
d. Click Save at the bottom of the screen to apply your changes.
On this screen, notice the path and file name of Java Standard Trust Keystore at the top of the Trust
section. This is the file containing the recognized Certificate Authorities that WebLogic will
recognize. Use this file in the next step.
49 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
6. From the command line, run the keytool command to import the self-signed certificate that was created in
Step 2 above into the Java trust keystore (changeit is the default password for the Java trust keystore):
keytool -importcert -trustcacerts -alias enterpriseone -file C:\enterpriseone.cer –
keystore C:\Oracle\Middleware\Oracle_Home\oracle_common\jdk\jre\security\cacerts
-storepass changeit
7. In the WebLogic console, select the SSL sub-tab.
Fill in the Private Key Alias and Private Key Passphrase for the certificate that was created in Step 2
above. Click Save to apply your changes.
8. Select the Control tab for the server, and then click Restart SSL.
You should now be able to connect directly to the EnterpriseOne WebLogic server using SSL.
To test this, open a browser window and type in the following URLs:
https://vmserver44:7504/jde/E1Menu.maf https://vmserver44:7506/jde/E1Menu.maf
https://vmserver44:7508/jde/E1Menu.maf
This will again bring up an Untrusted Connection page that can be accepted for this example.
Configuring Oracle HTTP Server as a Client that Trusts the WebLogic Server
Now that you have set up the WebLogic Server to use SSL, you need to configure the Oracle HTTP Server to
recognize your WebLogic server as a valid Certificate Authority. The steps below can be followed to complete the
SSL communication loop:
1. Copy the file containing the public key certificate to the machine that is running your Oracle HTTP
Server. In this example, this is the enterpriseone.cer file that was created in Step 2 of the previous
section. This certificate must be imported into the Oracle wallet that the Oracle HTTP Server is using.
2. Import this certificate into the Oracle HTTP Server wallet. Use the orapki utility located in the bin
directory under your oracle_common directory. The example below assumes that the orapki utility is
already in your PATH, and you have changed the local directory to be the default wallet directory:
(<ORACLE_HOME>\user_projects\domains\<DOMAIN_NAME>\config\fmwconfig\components\OHS\inst
a nces\<OHS_INSTANCE_NAME\keystores)
orapki wallet add -wallet . -trusted_cert -cert C:\enterpriseone.cer –auto_login_only
50 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Next, configure the Oracle HTTP Server installation to communicate with an existing EnterpriseOne HTML server
installed on a WebLogic cluster. The following example shows how to configure the default HTTPS port (7778) in
OHS and dispatch a request to the EnterpriseOne HTML client HTTPS port running on the WebLogic cluster.
For Vertical Cluster Install (Assume that HTML Server instance is created on a cluster with two servers on a
vertical node running on https port 7504 and 7506):
Listen 7778
<VirtualHost *:7778>
<Location /jde>
SetHandler weblogic-handler
WebLogicCluster vmserver44:7503,vmserver44:7505</Location>
<IfModule ossl_module>
SSLEngine on
SSLVerifyClient None
SSLProtocol nzos_Version_1_0 nzos_Version_3_0
SSLCipherSuite
SSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA,SSL_RSA_WITH_3DES_EDE_CBC_SHA,S
S
L_RSA_WITH_DES_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_CBC_SHA
SSLCRLCheck Off
SSLWallet
"${ORACLE_INSTANCE}/config/fmwconfig/components/${COMPONENT_TYPE}/instances/${COMPONENT_NA
M
E}/keystores/default"
</IfModule>
</VirtualHost>
For Horizontal Cluster Install (Assume that HTML Server instance is created on a cluster with three servers on a
horizontal node running on https port 7504,7506 and 7508):
Listen 7778
<VirtualHost *:7778>
<Location /jde>
SetHandler weblogic-handler
WebLogicCluster vmserver44:7503,vmserver44:7505,vmserverd4444:7507
</Location>
<IfModule ossl_module>
SSLEngine on
SSLVerifyClient None
SSLProtocol nzos_Version_1_0 nzos_Version_3_0
SSLCipherSuite
SSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA,SSL_RSA_WITH_3DES_EDE_CBC_SHA,S
S
L_RSA_WITH_DES_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_CBC_SHA
SSLCRLCheck Off
SSLWallet
"${ORACLE_INSTANCE}/config/fmwconfig/components/${COMPONENT_TYPE}/instances/${COMPONENT_NA
M
E}/keystores/default"
</IfModule>
</VirtualHost>
51 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
NOTE: The ports used (7503, 7505 and 7507) in this configuration are the HTTP ports of the respective WLS
Managed Servers and not the HTTPS port on which the HTML server is installed.
https://vmserver44:7778/jde/E1Menu.maf
52 | JD Edwards EnterpriseOne 9.1.4/9.1.5 Clustering Best Practices With Oracle WebLogic Server 12c for the HTML Server
Copyright © 2014, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability
or fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations
are formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by
any means, electronic or mechanical, for any purpose, without our prior written permission.
CONNECTWITHUS Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective
owners.
blogs.oracle.com/oracle
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license
facebook.com/oracle and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron
logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
1214
twitter.com/oracle
JD Edwards EnterpriseOne 9.1.4 Clustering Best Practices with Oracle WebLogic Server 12.1.2
oracle.com December 2014