using jd edwards enterpriseone server manager to create · pdf filebeginning with jd edwards...

39
IBM Oracle International Competency Center Using JD Edwards EnterpriseOne Server Manager to create an HTML server vertical cluster on WebSphere ND and IBM i Mike Brown - Oracle Gerrie Fisk - IBM Jim Denton - IBM February 2010 Abstract This paper describes the results of a joint project conducted by Oracle and IBM to provide step by step instructions on how to implement JD Edwards EnterpriseOne HTML servers in a clustered WebSphere® Application Server environment running on IBM i in conjunction with the JD Edwards Server Manager introduced in JD Edwards EnterpriseOne Tools release 8.97. Clustering provides customers with greater functionality and flexibility for supporting larger numbers of users and for improving performance and availability. 1 © Copyright 2010, IBM Corporation

Upload: vuongkhanh

Post on 22-Mar-2018

234 views

Category:

Documents


2 download

TRANSCRIPT

Page 1: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

IBM Oracle International Competency Center

Using JD Edwards EnterpriseOne Server Manager to create anHTML server vertical cluster on WebSphere ND and IBM i

Mike Brown - Oracle Gerrie Fisk - IBM Jim Denton - IBM February 2010

Abstract

This paper describes the results of a joint project conducted by Oracle and IBM to

provide step by step instructions on how to implement JD Edwards EnterpriseOne HTML

servers in a clustered WebSphere® Application Server environment running on IBM i in

conjunction with the JD Edwards Server Manager introduced in JD Edwards

EnterpriseOne Tools release 8.97. Clustering provides customers with greater

functionality and flexibility for supporting larger numbers of users and for improving

performance and availability.

1© Copyright 2010, IBM Corporation

Page 2: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Table of contents

Introduction 2

Creating a vertical cluster of the JD Edwards EnterpriseOne HTML server in a WebSphere Application Server ND and IBM i

environment 4

Starting the Cluster and verifying the installation 34

Managing the JD Edwards EnterpriseOne cluster 36

Appendix A – Checklist for creating the cluster 37

Appendix B - References 38

2© Copyright 2010, IBM Corporation

Page 3: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

3© Copyright 2010, IBM Corporation

Introduction

Oracle and IBM continue to work together to ensure that customers have the application and platform solutions needed to

maximize their business results. The following paper describes the steps required to implement JD Edwards

EnterpriseOne HTML servers in a clustered WebSphere Application Server environment running on IBM i.

Beginning with JD Edwards EnterpriseOne tools release 8.97, Oracle introduced Server Manager for managing,

maintaining and upgrading JD Edwards EnterpriseOne servers including HTML servers. This document offers guidelines

to customers with 8.97 or higher who need to create more than one HTML server in a WebSphere Application Server

cluster. (Another document, “Configuring the JD Edwards EnterpriseOne HTML Web Server to a WebSphere Cluster on

i5/OS,” describes how to implement clustering of HTML servers in environments which are using earlier versions than JD

Edwards EnterpriseOne tools release 8.97. See Appendix B.)

Many customers run with a single, standalone JD Edwards EnterpriseOne HTML server instance which can serve up to

200 users. This document expands upon that scenario for customers who want to have more than one JD Edwards

EnterpriseOne HTML server. Some reasons might include:

• serving more than 150-200 users

• load balancing

• redundancy and high availability.

This document covers how to vertically cluster a JD Edwards EnterpriseOne HTML server using IBM WebSphere ND on

IBM i. Figure 1 shows a single standalone HTML server expanded into two or more vertically clustered JD Edwards

EnterpriseOne HTML servers. A single HTTP server is used for this cluster and WebSphere clustering handles the load

balancing between the two (or more) JD Edwards EnterpriseOne HTML servers. See Appendix A for a checklist that

summarizes the steps to follow.

Page 4: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 1. Single HTML server and multiple vertically clustered HTML server deployments

Clustering requires a few changes in managing the JD Edwards EnterpriseOne HTML server instances:

• WebSphere Deployment Manager administrative console must be used for starting and stopping the JD Edwards EnterpriseOne HTML server instances individually or at the cluster level.

• Upgrading the JD Edwards EnterpriseOne HTML server instances in a cluster is not available. The JD Edwards EnterpriseOne HTML server instances would need to be deleted and recreated.

All other maintenance, modifying the .ini files, logging, etc. is available via Server Manager.

Creating a vertical cluster of the JD Edwards EnterpriseOne HTML server in a WebSphere

Application Server ND and IBM i environment

Prerequisites • IBM WebSphere Application Server ND version 6.1.0.21 is installed and operational, i.e., the default profile,

created by WebSphere at install time on IBM i, is operational, serving as administrative console for server1.

o Note that the supported versions of WebSphere Application Server change over time. Please refer to the Oracle JD Edwards EnterpriseOne Minimum Technical Requirements for IBM i for the current versions supported. See Appendix B.

o These instructions were tested using version 6.1.0.21, but they are expected to work on later versions.

4© Copyright 2010, IBM Corporation

• JD Edwards EnterpriseOne Server Manager is installed and running on a Windows machine.

Page 5: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

5© Copyright 2010, IBM Corporation

• JD Edwards EnterpriseOne Server Manager Agent is installed and running on the system where the HTML server is to be deployed.

• JD Edwards EnterpriseOne Enterprise Server instance has been registered and is functional with Server Manager.

• Recommended: a Server Group within Server Manager is created and modified for use when deploying the JD Edwards EnterpriseOne HTML server instance. (Server Groups are used to standardize the configuration settings for grouping instances.)

Step 1: Creating IBM Deployment Manager profile as a WebSphere ND profile The first step is to create the WebSphere administrative console for the DeployMgr profile (dmgr). Clustering will need

this dmgr JVM process to be up and running because it communicates with the Node Agent for configuration and

operational management for that node.

• Open qshell Command Entry by entering the QSH command.

• Navigate to the following directory by entering the following: cd /QIBM/ProdData/WebSphere/AppServer/V61/ND/bin

• Enter the following as a single command to create the DeploymentManager profile: ./manageprofiles -create -profileName DeployMgr

-templatePath/QIBM/ProdData/WebSphere/AppServer/V61/ND/profileTemplates/dmgr-serverName dmgr

• Confirm that the INSTCONFSUCCESS message appears.

• Run the IVT (Install Verification Test) on the newly created profile/server to verify the application server starts correctly. Navigate to the directory by entering: cd /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/DeployMgr/bin

• and then entering the command ./ivt dmgr DeployMgr. The output will look like the example below. IVTL0015I: WebSphere Application Server DENI508A is running on port: 9061 for profile DeployMgr

Step 2: Configuring WebSphere and HTTP before JD Edwards EnterpriseOne HTML deployment

2a: Creating a managed profile as a WebSphere ND profile • Choose a profile name to be created. This example created the AppSrv01 profile. It will become the managed

profile after it is federated to the dmgr profile as a node.

• On IBM i, execute the command manageprofiles –create

o Open qshell with command QSH.

o Navigate by running: cd /qibm/proddata/websphere/appserver/v61/nd/bin

− Enter the following command on one line to create the AppSrv01 profile: ./manageprofiles -create -templatePath default -profileName AppSrv01 –serverName AppSrv01

INSTCONFSUCCESS: Success: Profile AppSrv01 now exists. Please consult /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/AppSrv01 /logs/AboutThisProfile.txt for more information about this profile.

o Using Server Manager console, view the new profile AppSrv01 and start its Application Server AppSrv01. See Figure 2.

Page 6: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 2. WebSphere Server Manager console

o Return to qshell on IBM i with QSH and run the command: ./dspwasinst -profileName AppSrv01

Additional ports: 2810 BOOTSTRAP_ADDRESS port 8881 SOAP_CONNECTOR_ADDRESS port

o Note the SOAP_CONNECTOR_ADDRESS port. (In the example above, it is port 8881.)

2b: Federating a profile (managed by dmgr) using IBM WebSphere Deployment Manager administrative console

• Federating the profile allows management of this profile by the Deployment Manager’s administrative console through the Node Agent of the federated profile (managed node).

• Node Agent is a JVM process that manages servers of the federated profile (managed node) and is created automatically during federation.

• There are two methods to federate a node:

o using the WebSphere administrative console

o using addNode command line.

• Administrative console method will be used here:

o Open WebSphere’s Deployment Manager administrative console.

o Example: http://deni508a:9061/ibm/console/login.do

o Select System Administration, then Nodes view from the left navigation box.

6© Copyright 2010, IBM Corporation

Page 7: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 3. WebSphere Deployment Manager console

o Click on Add Node button circled in Figure 3 above.

Figure 4. Add Node dialog box

o Take the default (Managed node) as in Figure 4, and click Next.

7© Copyright 2010, IBM Corporation

Page 8: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 5. Add Managed Node dialog box

o Enter the host name for this server as shown in Figure 5. With vertical clustering, the name should be the same system where WebSphere is running. (In the case of horizontal clustering, a different machine name might be selected.)

o Insert the SOAP port that was noted earlier for the profile created, AppSrv01 profile (8881 in this case).

o Leave all other settings as default.

o Click OK.

Figure 6. Successful federation response

o Verify successful federation, as in Figure 6.

o Select the link to Logout.

o Log back in and navigate to the System administration -> Nodes; see Figure 7.

8© Copyright 2010, IBM Corporation

Page 9: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 7. System administration Nodes display

o Make note of the new Node DENI508A_AppSrv01. It will always contain the name of the server and the name of the profile.

o The Server Manager Agent will need to be restarted on IBM i using the following instructions.

− Open qshell with the command QSH.

− cd <jde_home>\bin

− ./stopAgent

− ./startAgent &

o Log into Server Manager console to view the changes to the WebSphere environment as seen by the Server Manager agent and console.

o The AppSrv01 profile is now federated. (Note that the application server AppSrv01 in node DENI508A_AppSrv01 is stopped. This is working correctly. This is not a valid application server and will not be used.)

2c: Creating an HTTP server using the IBM HTTP administrative console • Open the administrative console for managing the HTTP Server

o Example: http://deni508a:2001/HTTPAdmin

o Select to Create HTTP Server from the left pane.

9© Copyright 2010, IBM Corporation

Page 10: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 8. Create HTTP Server in HTTP administrative console

o Enter the name of the server to create. This example is WEBSRV_ND, see Figure 8.

o Click Next and take defaults. (An exception might be the port selection screen. Make sure the port does not conflict with any other ports on the system. If it does, select and enter a new port.)

o Click Finish and verify success as in Figure 9.

Figure 9. Create HTTP Server verification

2d: Creating the internal web server (plug-in) using IBM WebSphere Deployment Manager administrative console The web server needs to be created such that it is global to the ND environment and the dmgr profile. It will be shared by

any node that is federated to the ND environment. The web server contains the WebSphere plugin-cfg.xml file and links it

to the HTTP server.

• Log into WebSphere’s Deployment Manager administrative console and select Servers -> Web servers.

10© Copyright 2010, IBM Corporation

Page 11: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 10. WebSphere Deployment Manager administrative console

• Create the web server by selecting New; see Figure 10.

Figure 11. Define new Web server name

• As shown in Figure 11, select the node created earlier, such as DENI508A_AppSrv01.

• The server name is the same as the HTTP server, such as WEBSRV_ND.

• Type will default to IBM HTTP server which is the correct value.

11© Copyright 2010, IBM Corporation

Page 12: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

F igure 12. Select IHS template

• Select the IHS template and click Next as in Figure 12.

Figure 13. Set port number

• Set port number to match the HTTP server created earlier. This example uses 82; see Figure 13.

• Enter sign in information for HTTP administrative console, such as qsecofr.

• Click Next.

12© Copyright 2010, IBM Corporation

Page 13: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 14. Confirm summary information

• Confirm the summary information as in Figure 14.

• Click Finish.

Figure 15. Save Web server definition

• Click Save; see Figure 15.

2e: Configuring the WebSphere plug-in to be associated with the HTTP server using the IBM HTTP administrative console

• There are two directives that need to be added to the http.conf configuration file:

13© Copyright 2010, IBM Corporation

o The WebSphere plugin-cfg.xml directive configures the communication between the HTTP configuration and the WebSphere configuration. With clustering, this file is loaded at the cell level, not the node level, so that it is available globally to the network deployment domain (DeployMgr). The node level (WEBSRV_ND) is not used because it has the potential to be overwritten if changes are made to the application server.

Page 14: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

o The LoadModule directive is used to load a service program with additional code over and above basic Apache support.

• The plugin-cfg.xml directory and file name is: /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/DeployMgr/config/cells/plugin-cfg.xml

o To review the plugin-cfg.xml file, if desired:

o Open WebSphere’s Deployment Manager administrative console.

o Select Environment, then Update global Web server plugin configuration from the left navigation box as in Figure 16 below.

Figure 16. WebSphere Deployment Manager administrative console

• To add the two directives to the HTTP configuration file, log into the HTTP administrative console.

• Select the WEBSRV_ND HTTP Server.

14© Copyright 2010, IBM Corporation

Page 15: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 17. HTTP administrative console

• Select the Edit Configuration File link in the left navigation pane; see Figure 17. This step edits the configuration file, for example: /www/WEBSRV_ND/conf/httpd.conf

• Add the two lines shown above to the beginning of the httpd.conf configuration file of the HTTP server. The two lines should look like this example: WebSpherePluginConfig /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/DeployMgr/config/cells/plugin-cfg.xml LoadModule was_ap20_module /QSYS.LIB/QHTTPSVR.LIB/QSVTAP20.SRVPGM

• Make sure that the plugin line has no spaces other than the first one and it has not word wrapped.

• Select Apply.

• Select OK.

• Start the HTTP server WEBSRV_ND.

Figure 18. HTTP server successfully started

15© Copyright 2010, IBM Corporation

Page 16: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

• Verify that the HTTP server is running and available, using a browser with system name:port number as in Figure 18.

o This example is http://deni508a:82

Step 3: Deploying an EnterpriseOne HTML Server instance using EnterpriseOne Server Manager

3a: Log into Server Manager and create a J2EE application server

Figure 19. EnterpriseOne Server Manager

• Select the WebSphere instance to create a J2EE application server. See Figure 19.

Figure 20. Select profile name

• Select the Profile Name created earlier, such as DeployMgr, where the J2EE application server will reside and be managed; see Figure 20.

Figure 21. Create J2EE application server

• Select the node from the Node Name dropdown list as in Figure 21. This example shows DENI508A_AppSrv01.

16© Copyright 2010, IBM Corporation

• Enter a unique name for the J2EE application server in the server name text box. This example uses AS_95_M1.

Page 17: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

• Suggestion: A name with 10 or fewer characters is easiest to identify on IBM i because job names are limited to 10 characters.

• Note: this will become the first member of the cluster.

• Select the Create Server button.

Figure 22. Application server name

• Note that this is the application server (see Figure 22) used when deploying the JD Edwards EnterpriseOne HTML server instance.

3b: Create new managed instance • Now that the J2EE container is created, this step will deploy the JD Edwards EnterpriseOne application code into

it to create the JD Edwards EnterpriseOne HTML server.

• Navigate to the Management Dashboard in Server Manager.

Figure 23. Server Manager Management Dashboard

• Select the agent link DENI508A managing WebSphere DENI508A_WAS61 as in Figure 23.

17© Copyright 2010, IBM Corporation

Page 18: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 24. Create new managed instance

• Select Create New Managed Instance button; see Figure 24.

Figure 25. Select instance type

• Select the EnterpriseOne HTML Server radio button, then select the continue button; see Figure 25.

Figure 26. Specify instance properties

18© Copyright 2010, IBM Corporation

Page 19: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

• Enter the Server Group from the dropdown (which was an optional prerequisite.) If this was not done, there is always a default server group available but it will need to be changed to work in the environment where deployment occurs.

• Enter a unique name for the Instance Name such as EA_JS_95. Select a name that is useful for the configuration of the cluster. This instance is deployed in AS_95_M1 so it will be part of the first member of the cluster.

• Enter the J2EE Server from the dropdown. This is the AS_95_M1 application server that was created above.

• Enter the HTTP Port value. This example uses port 95. As before, be sure that this port does not cause a conflict with any existing ports.

• Enter Software Component from the dropdown list.

o Select the appropriate version of the software to be deployed.

o This component has been distributed to the agent’s components directory.

• Select the Continue button when all entries are acceptable values; see Figure 26.

Figure 27. Confirm managed instance properties

• Note the HTTP Server (web server definition) that was created earlier.

o If this was not created, there will be an error shown.

o If there are multiple web servers, select the correct HTTP Server from the dropdown.

o This example uses WEBSRV_ND.

• Verify other settings or change them as necessary, as in Figure 27. These and all other configuration (INI) settings can be changed post deployment.

Figure 28. Create instance

19© Copyright 2010, IBM Corporation

Page 20: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

• Take note of the warning; see Figure 28. The readme.txt file will be used later to configure the HTTP Server (web server definition) so review the Example location.

• Select the Create Instance button.

Figure 29. Synchronize configuration

• After processing is complete, the home page for the created instance will be displayed.

• Select the Synchronize Configuration button, as in Figure 29.

o This step synchronizes the configuration files: jdbj.ini, jas.ini, tokengen.ini, tnsnames.ora and jdelog.properties files to the deployed structure of the JD Edwards EnterpriseOne HTML server instance.

o Every change to a configuration file initiates a prompt for Synchronize Configuration which needs to be executed each time.

• This instance is the location where all members of the cluster report runtime information and managing configuration.

NOTE: In the past, the virtual host had to be created manually, but now Server Manager creates the virtual host for you.

Verify, if desired, that the virtual host exists with the correct HTTP port number listed by going to WebSphere DeployMgr

administrative console and clicking on environment, then virtual hosts. Open the virtual host, such as vh_EA_JS_95, click

on Host Aliases, and find the port number entered for the HTML application server.

• (At this point, with the addition of installing the JDBC driver in Server Manager, this JD Edwards EnterpriseOne HTML instance COULD be run as a standalone as depicted in the left hand diagram in Figure 1.)

Step 4: Creating and configuring the WebSphere cluster after JD Edwards EnterpriseOne HTML deployment

4a: Configuring the HTTP Server and Web Server definition using IBM HTTP administrative console

• View the readme.txt that was displayed as a warning statement in the Finish step when the JD Edwards EnterpriseOne HTML server instance was created.

o <jde_home>\targets\EA_95_M1\readme.txt

o This readme.txt file was created with machine specific information during deployment; see Figure 30.

20© Copyright 2010, IBM Corporation

Page 21: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 30. HTML server instance readme text

• Copy the directives from this file to the appropriate httpd.conf file. Example: /www/WEBSRV_ND/conf/httpd.conf

o Log into the HTTP administrative console.

o Select the WEBSRV_ND HTTP Server.

o Select the Edit Configuration File from the left navigation pane.

o Note: When copying the directives, be sure to copy first to Notepad and then from Notepad into the httpd.conf to make sure no errant control characters are introduced. Additionally, make sure that there is a blank line at the end of the file or the HTTP Server will not start. This additional line ensures that a carriage return is included at the end of the file so it can be parsed correctly.

21© Copyright 2010, IBM Corporation

Page 22: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 31. HTTP Administrative console

o Select Apply button when finished editing.

o Select OK button.

o Note that the screenshot from the HTTP Administrative console (Figure 31) shows the section that has been added to the file.

22© Copyright 2010, IBM Corporation

Page 23: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 32. Listen 0.0.0.0:95 directive

• Note: The portion of the directive Listen 0.0.0.0:95 is required for IPv6; see Figure 32. It shows as a warning with IPv4 but will not cause a runtime problem within the httpd.conf file. To remove the warning with IPv4 change it to: Listen *:95.

• Stop and start the HTTP Server to validate that the HTTP server is configured to serve the new port 95: http://deni508a:95; see Figure 33 for a successful validation example.

Figure 33. Verify HTTP server

23© Copyright 2010, IBM Corporation

Page 24: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

4b: Creating a cluster from the deployed HTML server using IBM WebSphere Deployment Manager administrative console

• Log into WebSphere’s Deployment Manager administrative console and select Servers, then Clusters link from the left navigation; see Figure 34.

Figure 34. WebSphere Deployment Manager administrative console

• Select New to create a new cluster, as in Figure 35.

Figure 35. Create new cluster

• Enter the cluster name, such as E1Cluster, as in the example in Figure 36.

• Click Next

24© Copyright 2010, IBM Corporation

Page 25: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 36. Name new cluster

Figure 37. Create first cluster member

• Select the radio button to Create the member by converting an existing application server as in Figure 37.

• Use the dropdown to select the appropriate Application Server. Note that the Member name text box will be populated based on the dropdown selection, such as AS_95_M1.

• The Weight value specifies the amount of work that is directed to this application server. It can range from 0 to 20. Leave it at the default of 2 so that the workload will be split evenly between the cluster members.

• Select Next to create the first member of the cluster.

25© Copyright 2010, IBM Corporation

Page 26: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 38. Add second cluster member

• Create an additional member giving it a unique name, like AS_95_M2, and select the node where the original member resides (DENI508A_AppSrv01). See Figure 38.

• Leave Weight and Generate unique HTTP ports at the defaults.

• Select Add Member button.

• (If additional cluster members are required, repeat the above steps).

• Select Next button to create the second member of the cluster.

26© Copyright 2010, IBM Corporation

Page 27: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 39. List of cluster members

• The resulting members to be created are shown in Figure 39 above. Select Next button.

27© Copyright 2010, IBM Corporation

Page 28: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 40. Cluster summary information

• Select Finish button, as in Figure 40.

28© Copyright 2010, IBM Corporation

Figure 41. Save cluster changes

Page 29: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

• After the cluster is created, select Save as in Figure 41.

4c: Installing the JDBC drivers for the cluster members using JD Edwards EnterpriseOne Server Manager

• Log into Server Manager and select the JD Edwards EnterpriseOne HTML server that was created.

• Configuring JDBC Drivers is required. In this case, installing a DB2 driver for use on IBM i is needed.

Figure 42. Using Server Manager to configuring JDBC drivers

• Select the JDBC Drivers link in the Quick Links left pane box as shown in Figure 42.

Figure 43. Install the JDBC driver for all cluster members

• Use the selection boxes to the left of the Application servers that are running the HTML server code. Select “Install Driver” button; see Figure 43. Repeat for all members of the cluster.

29© Copyright 2010, IBM Corporation

Page 30: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 44. Verify the JDBC driver is installed

• Confirm that the status changes to “Installed” as in Figure 44.

4d: Configuring the cluster members using IBM WebSphere Deployment Manager administrative console

• Configuration of the Generic JVM arguments of each cluster member is necessary for Server Manager to identify each member and for the JD Edwards EnterpriseOne HTML servers to separate the log file names.

• Log into WebSphere’s Deployment Manager administrative console.

• Select the Clusters from the left navigation.

• Select E1Cluster; see Figure 45.

Figure 45. WebSphere Deployment Manager administrative console

30© Copyright 2010, IBM Corporation

Page 31: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 46. Server clusters

• Select Cluster members; see Figure 46.

Figure 47. Cluster members

• Select the first member such as Member AS_95_M1 in Figure 47.

31© Copyright 2010, IBM Corporation

Page 32: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 48. Properties and settings

• Expand Java and Process Management.

• Select the Process Definition; see Figure 48.

32© Copyright 2010, IBM Corporation

Figure 49. More properties

Page 33: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

• Select Java Virtual Machine; see Figure 49.

Figure 50. Specifying generic JVM arguments

• Enter these two parameters separated by a space into the Generic JVM arguments. See Figure 50.

o Example: –DcloneId=AS_95_M1 –Dwas.home=true

o Make the DcloneId value the same name as the application server (AS_95_M1 in this case).

o NOTE: Make sure the characters are as expected. Copying and pasting from this document, for example, can cause problems. Dashes and equal signs can be different. Either copy into and out of Notepad or type the parameters in directly.

• Select Apply.

• Select OK.

33© Copyright 2010, IBM Corporation

Page 34: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 51. Save changes to JVM

• Select Save as in Figure 51.

• Execute these steps for each member of the cluster. Use a different DcloneId value for each application server. (Example: AS_95_M2)

Starting the Cluster and verifying the installation

Step 5: The cluster needs to be restarted to apply the generic JVM arguments of the previous step. Open WebSphere’s

Deployment Manager administrative console and go into Servers, then Application servers. Stop the first application

server, if it was still running from the previous steps. Each member of the cluster can be started or stopped individually

here, if desired.

The easiest way to start the cluster is to click on clusters, click on E1cluster, and then click on RippleStart. The cluster is

now created as in the right-hand diagram of Figure 1. After the members are started, log in to JD Edwards EnterpriseOne

to verify the installation.

Prerequisites for signing into JD Edwards EnterpriseOne using a cluster member:

• The HTTP server, such as WEBSRV_ND, must be running.

• Dmgr must be running. cd /QIBM/ProdData/WebSphere/AppServer/V61/ND/profiles/DeployMgr/bin ./startManager dmgr

• Node agent must be running so that dmgr can communicate with the node. cd /QIBM/ProdData/WebSphere/AppServer/V61/ND/profiles/AppSrv01/bin ./startNode

• One or more cluster members must be running. Note: If login fails with an authorization issue, enter qshell with QSH command and navigate with:

cd /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/AppSrv01

then run the chmod command to correct the authority levels:

chmod -R 755 installedApps

Then stop and start the cluster.

Two additional views of cluster operations are:

1. Sign onto a green screen session and type in WRKSBS. Find the QWAS61 subsystem and enter an 8. The JVMs running should look like the example in Figure 52 below.

or

34© Copyright 2010, IBM Corporation

Page 35: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

Figure 52. Verify running JVMs

2. Sign into Server Manager. Click on the WebSphere managed instance. Under the DeployMgr profile, click on the related managed instance such as EA_JS_95. As in the example in Figure 53, Server Manager displays the instance running, the online users using both cluster members, and each cluster member generating its own log files. Note: Load balancing is based on workload, not number of users, and in practice can vary over time as WebSphere manages some node affinities to route similar application work to the same node for optimal performance.

Figure 53. Server Manager WebSphere managed instance

35© Copyright 2010, IBM Corporation

Page 36: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

36© Copyright 2010, IBM Corporation

Managing the JD Edwards EnterpriseOne cluster

The following considerations apply to managing a JD Edwards EnterpriseOne cluster.

• Server Manager CAN be used to manage:

o Vertically clustered log files

o Ini file (Modification will still require sync)

o Viewing of runtime metrics for all cluster members

• Server Manager CANNOT be used to manage:

o Horizontally clustered log files

o Start and stop of the application servers that are clustered

o Starting and stopping the cluster

o Updating (Change Component) the HTML server code

• WebSphere administrative console must be used to manage (because of the CANNOTs above)

o Start and stop of the cluster members (Application servers and their applications within)

o Start and Stop of the cluster

• Management of horizontally clustered log files is a manual process

o Acquire the log files from the logs directory of the machine where the log files exist.

The individual cluster nodes should be tuned based on existing best practices. For further information, see the tuning

guidelines listed in Appendix B.

Page 37: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

37© Copyright 2010, IBM Corporation

Appendix A – Checklist for creating the cluster

Step Product Checklist for creating an HTML server vertical cluster on WebSphere ND and IBM i

Example names: Your names:

Prerequisites

1 QSH Create IBM Deployment Manager profile as a WebSphere ND profile

DeployMgr, dmgr

2 Configure WebSphere and HTTP before JD Edwards EnterpriseOne HTML deployment

QSH, SM 2a: Create a managed profile as a WebSphere ND profile

AppSrv01

WAS 2b: Federate a profile (managed by dmgr) Deni508a_AppSrv01

HTTP 2c: Create an HTTP server WEBSRV_ND

WAS 2d: Create the internal web server (plug-in) WEBSRV_ND

HTTP 2e: Configure the WebSphere plug-in to be associated with the HTTP server

3 Deploy an EnterpriseOne HTML Server instance

SM 3a: Log into Server Manager and create a J2EE application server

AS_95_M1

SM 3b: Create new managed instance EA_JS_95

4 Create and configure the WebSphere cluster after JD Edwards EnterpriseOne HTML deployment

HTTP 4a: Configure the HTTP Server and Web Server definition

WAS 4b: Create a cluster from the deployed HTML server

E1Cluster, AS_95_M1, AS_95_M2

SM 4c: Install the JDBC drivers for the cluster members

WAS 4d: Configure the cluster members

5 Restart the E1Cluster

Product list with the example's port numbers:

WAS= IBM WebSphere Deployment Manager administrative console (9061)

SM=JD Edwards EnterpriseOne Server Manager (8999)

HTTP=IBM HTTP administrative console (2001)

QSH=IBM i command line QSHELL

Page 38: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

38© Copyright 2010, IBM Corporation

Appendix B - References

General system tuning • Configuring the JD Edwards EnterpriseOne HTML Web Server to a WebSphere Cluster on i5/OS

http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101216

• IBM eServer iSeries Performance Management Tools (03 October 2005) http://www.redbooks.ibm.com/abstracts/redp4026.html?Open

• IBM Power Systems Performance Capabilities Reference IBM i operating system Version 6.1 http://www-03.ibm.com/systems/resources/pcrm2804.pdf

• Performance Management for IBM System i Home Page http://www-03.ibm.com/servers/eserver/iseries/perfmgmt/

• IBM System i and IBM i Information Center http://publib.boulder.ibm.com/infocenter/iseries/v6r1m0/index.jsp

• IBM / Oracle Informational APARs http://www-03.ibm.com/systems/i/advantages/oracle/

• IBM Preventative System Planning for System i – PSP http://www-912.ibm.com/s_dir/sline003.NSF/GroupPTFs?OpenView&Start=1&Count=30&Collapse=1#1

Oracle Minimum Technical Requirements • Oracle Minimum Technical Requirements (MTRs) (userid and password required)

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=745831.1

Page 39: Using JD Edwards EnterpriseOne Server Manager to create · PDF fileBeginning with JD Edwards EnterpriseOne tools release 8.97, ... Oracle JD Edwards EnterpriseOne Minimum Technical

39

Copyright © 2010 Oracle Corporation Oracle Corporation 500 Oracle Parkway Redwood Shores, CA 94065 Oracle is a registered trademark of Oracle Corporation and/or its affiliates.

© Copyright IBM Corporation 2010 IBM Corporation 1 New Orchard Road Armonk, NY 10504 U.S.A. Produced in the United States of America 02-10 All Rights Reserved IBM, the IBM logo, ibm.com, Power, and WebSphere are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. These and other IBM trademarked terms are marked on their first occurrence in this information with the appropriate symbol (® or TM), indicating U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at ibm.com/legal/copytrade.shtml. Other company, product, or service names may be trademarks or service marks of others. The information provided in this document is distributed “AS IS” without any warranty, either express or implied. The information in this document may include technical inaccuracies or typographical errors. References in this document to IBM products or services do not imply that IBM intends to make them available in every country. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. Information concerning non-IBM products was obtained from a supplier of these products, published announcement material, or other publicly available sources and does not constitute an endorsement of such products by IBM. Sources for non-IBM list prices and performance numbers are taken from publicly available information, including vendor announcements and vendor worldwide homepages. IBM has not tested these products and cannot confirm the accuracy of performance, capability, or any other claims related to non-IBM products. Questions on the capability of non-IBM products should be addressed to the supplier of those products.