JDE927 Server Manager Guide
JDE927 Server Manager Guide
JDE927 Server Manager Guide
EnterpriseOne
Tools
9.2
JD Edwards EnterpriseOne Tools
Server Manager Guide
9.2
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected
by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate,
broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering,
disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report
them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then
the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software, any programs embedded, installed or
activated on delivered hardware, and modifications of such programs) and Oracle computer documentation or other Oracle data delivered to or
accessed by U.S. Government end users are "commercial computer software" or "commercial computer software documentation" pursuant to the
applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, reproduction, duplication, release, display,
disclosure, modification, preparation of derivative works, and/or adaptation of i) Oracle programs (including any operating system, integrated
software, any programs embedded, installed or activated on delivered hardware, and modifications of such programs), ii) Oracle computer
documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in the license contained in the applicable contract. The
terms governing the U.S. Government's use of Oracle cloud services are defined by the applicable contract for such services. No other rights are
granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for
use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware
in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe
use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks
or registered trademarks of SPARC International, Inc. AMD, Epyc, and the AMD logo are trademarks or registered trademarks of Advanced Micro
Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle
Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and
services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible
for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable
agreement between you and Oracle.
JD Edwards EnterpriseOne Tools
Server Manager Guide
Contents
Preface .................................................................................................................................. i
1 Getting Started 1
Installing the Server Manager Management Console and Agent ........................................................................................ 1
Accessing the Certifications (Minimum Technical Requirements) ....................................................................................... 1
Configuring Server Manager Console to Work with Java 8 Update 201 (and later) (Release 9.2.3.4) ........................... 2
Configuring Server Manager Console to Work with Java 8 Update 201 (and later) (Tools Release 9.2.4.3 and later)
............................................................................................................................................................................................................ 32
3 Functional Overview 41
Standardized Remote Deployment ........................................................................................................................................... 41
Configuration Management ....................................................................................................................................................... 41
Audit History ................................................................................................................................................................................. 42
Remote Troubleshooting ............................................................................................................................................................ 42
Operational Control for Managed Servers ............................................................................................................................. 42
Flexible Monitoring ...................................................................................................................................................................... 42
Simplification and Automation of System Administration Tasks by Using Orchestrations (Release 9.2.6) .............. 43
Configuring an IBM i Enterprise Server to an Existing DB2 Database (Release 9.2.2.4) ............................................. 207
Change Component for the Enterprise Server (Tools Release 9.2 Update 3) ............................................................... 208
Enabling TLS on the Enterprise Server (Release 9.2.7.3) .................................................................................................... 214
Enabling TLS on the Deployment Server (Release 9.2.7.3) ................................................................................................ 215
Preface
Welcome to the JD Edwards EnterpriseOne documentation.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://
www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc .
Related Information
For additional information about JD Edwards EnterpriseOne applications, features, content, and training, visit the JD
Edwards EnterpriseOne pages on the JD Edwards Resource Library located at:
http://learnjde.com
Conventions
The following text conventions are used in this document:
Convention Meaning
Bold Boldface type indicates graphical user interface elements associated with an action or terms defined in
text or the glossary.
Italics Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular
values.
Monospace Monospace type indicates commands within a paragraph, URLs, code examples, text that appears on a
screen, or text that you enter.
> Oracle by Example Indicates a link to an Oracle by Example (OBE). OBEs provide hands-on, step- by-step instructions,
including screen captures that guide you through a process using your own environment. Access to
OBEs requires a valid Oracle account.
i
JD Edwards EnterpriseOne Tools Preface
Server Manager Guide
ii
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
1 Getting Started
As of March 2016, the following chapters have been removed from this guide and added to the JD Edwards
EnterpriseOne Installation and Upgrade Guides:
The installation and upgrade guides are located in the JD Edwards EnterpriseOne Installation and Upgrade
Documentation Library at:
http://docs.oracle.com/cd/E61420_01/index.htm
Upgrading from 9.1 to 9.2 Server Manager Consoles can be done using the Server Manager Console Update (self-update)
functionality for WAS and WLS based Server Manager Consoles. For an OC4J based Server Manager Console, please
follow the documentation below.
http://www.oracle.com/corporate/contracts/index.html
You can locate the JD Edwards EnterpriseOne Tools Release 9.2 Certifications from My Oracle Support.
1
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
E1: SVM: Console Not Communicating With Agent And/Or Runtime Metrics Not Displaying After AS400 / iSeries / IBM
Java Update Disables 3DES_EDE_CBC Algorithm (Doc ID 2256869.1).
If you performed the configuration changes specified in the above support document, begin by reverting those
modifications.
1. Stop the Server Manager Console and the Admin server in the domain on which the Server Manager Console is
installed.
2. Stop the Server Manager Agents.
3. Stop the Managed Instance.
4. Undo the changes to the $jdk/jre/lib/security/java.security file or restore the file from a backup. This process
of managing the $jdk/jre/lib/security/java.security file applies to the Java Installation used by the Server
Manager Console, Server Manager Agents, and other Managed Instances on the respective machines.
Secure JMX and Using SSL Settings for the Server Manager
Console
The subsequent sections are applicable if you have the following settings in the SCFMC/config/agent.properties and
$SCHFA/config/agent.properties files.
management.server.usesecurejmx=true
management.server.usingssl=true|false
These settings are required only if Secure JMX is enabled. By default, the Secure JMX setting is enabled.
2
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
-Djdk.tls.client.protocols=TLSv1.2 -Djavax.net.ssl.keyStore=C:\certs\keystore.jks -
Djavax.net.ssl.keyStorePassword=<key_store_password> -Djavax.net.ssl.keyStoreType=JKS -
Djavax.net.ssl.keyPassword=<key_password> -Djavax.net.ssl.trustStore=C:\Java64\jdk1.8.0_201\jre\lib\security
\cacerts -Djavax.net.ssl.trustStorePassword=<trust_store_password>-Djavax.net.ssl.trustStoreType=JKS -
Dweblogic.http.headers.enableHSTS=true
In the argument, replace the values that look like <password> with the actual password.
3
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
at $jdk/jre/lib/security/
cacerts.
Note: Starting with Tools Release 9.2.5, TLSv1.3 support is available on WebLogic Server (WLS) if you are using Server
Manager with Java 1.8 Update 261 and later. But, if you are using any Non-Oracle Java (i.e IBM, HP) in your setup for
any web component, Enterprise Server or Server Manager Console or if you are using the Server Manager Console
installed on WebSphere Server (WAS), you must continue to use the default version or use TLSv1.2. Also, starting with
Tools Release 9.2.5, Java 1.7 is no longer supported with JDEdwards for any web and non-web components.
Note: If you plan to implement HTTP Strict Transport Security, refer to this Oracle document: Command Reference for
Oracle WebLogic Server 14c in the section entitled: HTTP Strict Transport Security.
Additional JVM Arguments that are required to support Java 8 Update 201 and later and TLS 1.2 and later are as follows
(where this command is a single contiguous command line with no line breaks or carriage returns:
<server Instance name>.javax.net.ssl.trustStoreType=JKS
<server Instance name>.javax.net.ssl.keyStore=/u01/Middleware12214/oracacert/ keystore.jks
<server Instance name>.jdk.tls.client.protocols=TLSv1.2
<server Instance name>.javax.net.ssl.keyPassword=<key_password>
<server Instance name>.javax.net.ssl.trustStore=/u01/jde_agent /SCFHA/jdk/jre/lib/security/cacerts
<server Instance name>.javax.net.ssl.trustStorePassword=<trust_store_password>
<server Instance name>.javax.net.ssl.keyStorePassword=<key_store_password>
<server Instance name>.javax.net.ssl.keyStoreType=JKS
<server Instance name>.javax.net.ssl.enableHSTS=true
In the argument, replace the values that look like <password> with the actual password and <server Instance name >
with the BSSV or RTE instance name. These JVM Arguments update the agent.properties file of the embedded agent
($SCFHA/config/agent.properties) and these are required for Healthcheck to work.
The functions of the additional JVM Arguments are as explained in the table at the beginning of this section.
4
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
◦ Windows Platform
Run the following command to confirm that the import process was successful:
◦ UNIX Platform
Run the following command to confirm that the import process was successful:
◦ AS/400 Platform
5
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
Run the following command to confirm that the import process was successful:
Note: If there are multiple Certificates in the Certificate Chain of the Server Manager Console, all the Certificates in
the Certificate Chain must be imported into the Truststore. Import of multiple files is commonly required for a CA
Signed Certificate where a Root Certificate and an Intermediate Certificate exist in addition to the actual Certificate
used by the Server Manager Console.
Navigate to Home -> Summary of Servers -> <SM_J2EE_Server>, append the arguments as shown.
6
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
Navigate to Application servers -> <SM_J2EE_Server> -> Process definition - Java Virtual Machine, append the
arguments as shown.
Setting the HttpOnly and secure attributes for the SMCONSOLE_SSID cookie (Tools
release 9.2.4.3)
After you update the Server Manager Console to 9.2.4.3, perform the steps in the following sections to set the HttpOnly
and secure attributes for the SMCONSOLE_SSID cookie.
Note: These steps are applicable only if you are using the Server Manager Console installed on WebLogic and is
accessed over HTTPS or /SSL.
<wls:cookie-secure>true</wls:cookie-secure><wls:cookie-http-only>true</wls:cookie-http-only>
3. Start the Server Manager Console.
7
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
4. After the Server Manager Console starts up, log in to the Server Manager Console over HTTPS or SSL to
complete the configuration.
5. To confirm that the HttpOnly and secure attributes are set for the SMCONSOLE_SSID cookie, use the Browser
Debugging tool and ensure that the attributes of this cookie are the same as the attributes shown in the
following screenshot:
Note: These steps are applicable only if you are using the Server Manager Console installed on WebSphere and is
accessed over HTTPS or /SSL.
1. Log in to the WebSphere Admin Console profile in which the Server Manager Console is installed.
8
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
2. Navigate to the J2EE container in which the Server Manager Console is running.
9
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
10
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
11
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
5. Verify that the settings are configured as illustrated in the following screenshot:
12
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
6. Navigate back to the J2EE container in which the Server Manager Console is running and expand the Ports
option and note down the port number for the WC_defaulthost_secure name.
13
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
7. Navigate to Virtual Hosts, select default_host, add the port number that you noted in Step 6 for
WC_defaulthost_secure, and click Save.
8. Restart the Server Manager Console and access the console over the WC_defaulthost_secure port.
9. To confirm that the HttpOnly and secure attributes are set for the SMCONSOLE_SSID cookie, use the Browser
Debugging tool and ensure that the attributes of this cookie are as same as the attributes shown in the
following screenshot:
For the AIS server, navigate to Home -> Summary of Servers -> <AIS_J2EE_Server>, append the arguments as shown in
the screenshot.
14
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
For the HTML server, navigate to Home -> Summary of Servers -> <JAS_J2EE_Server>, append the arguments as
shown.
15
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
For the AIS server, navigate to Application servers - AIS_92 - Process definition - Java Virtual Machine, append the
arguments as shown.
16
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
17
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
For the HTML server, navigate to Application servers - AS_JS_82 - Process definition - Java Virtual Machine, append the
arguments as shown.
18
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
19
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
Enterprise Server
The following screenshot shows how the JVM Arguments are configured for the Enterprise server.
Configure the JVM Arguments in the DefaultOptions entry in the [JDE JVM] section of the Enterprise server JDE.INI file.
Note: Before starting with the TLS configuration, ensure that all the agents associated with the Server Manager
Console are in a running state. If any Server Manager Agent is stopped or not required, remove the corresponding
entry from the management dashboard. Additionally, update the Server Manager Agents to the same release as the
Server Manager Console.
20
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
Perform the following steps to apply the TLS configuration settings to the Server Manager Console and the Server
Manager Agents:
1. Click the Choose File field to select the certificate file or the keystore file you want to upload and distribute. You
can select only one file at a time to be uploaded and distributed.
21
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
2. Click the Upload and Distribute button. To upload multiple files, repeat the above processes again.
If all the agents associated with the Server Manager Console are not in a running state during the configuration,
the following error message is displayed:
Before performing validation, ensure that all the agents connected to the Server Manager Console are running.
If any of the agents associated with the Server Manager Console are not updated during the configuration, the
following error message is displayed.
Ensure all the Agents connected to Server Manager Console are updated to the same release as Server Manager
Console, prior to performing validation and applying the TLS automation.
3. Select a TLS version from the TLS Version drop-down list.
Note: For the WebLogic Server, you can select either TLSv1.2 or TLSv1.3.
22
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
6. To select a different TLS version, click the Reset button. The system will reset the TLS version and passwords
entered.
7. After successful validation, click the Apply and Restart button.
8. On the confirmation dialog box, click OK to apply the TLS configuration settings to the setup.
The restarting of the Server Manager Console brings up a short-lived terminal window on the Windows
machine on which the Server Manager Console is installed. You will see this window only if you are connected
to that machine. No operation is to be performed on this window and it will automatically close after the restart
of Server Manager Console is complete.
9. Click Management Dashboard and restart all the managed instances for which the message Instance Restart
Required is displayed. After you restart the managed instances, you can see the associated runtime metrics.
23
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
Note:
• When the certificate used for TLS configuration is due to expire in 7 days or when it has already expired, a
warning is displayed in the Managed Homes and Managed Instances page. You will need to take corrective
action for the certificate before it expires (upon seeing the warning message). If the certificate expires, the
secure communication over TLS will stop and you will need to manually reconfigure the TLS setting.
• If the Server Manager Console is on the WebLogic Server, after applying the TLS configuration, you will need to
restart the admin server of the domain in which the Server Manager Console is installed.
• For any web component in a horizontal cluster setup, you must copy the $SCFHA/config/agent.properties
file from the primary member to the horizontal cluster member after the automation has been applied.
Additionally, you must copy the keystore file, certificate file, and trust store file and place them in the same
location as the primary member.
• All the TLSv1.2/1.3 configuration information is saved in the $SCFMC/config/agent.properties file and $SCFHA/
config/agent.properties file.
• The trust store file is automatically configured in the $SCFHA/jdk/jre/lib/security/cacerts file on the agent
machines and to the $jdk/jre/lib/security/cacerts file of the Java installation used by the WebLogic Server
and the WebSphere Application Server on the Server Manager Console machine.
• When you create a new instance in a setup where TLSv1.2/1.3 automation has been applied, for the new
instance, TLSv1.2/1.3 is automatically configured.
• If the system property setting is management.server.usesecurejmx=false in the $SCFMC/config/agent.properties
file and the $SCFHA/config/agent.properties file, the system property setting will be automatically be changed
to management.server.usesecurejmx=true after applying the TLS configuration setting.
• You must import all the certificates from the $WAS_profile_dir\etc file for all the profiles into the agent’s
keystore and trust store files for the agent to connect to the WebSphere profiles.
24
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
2. After installation, copy the certificate file, keystore file, and trust store file[SC1] from an existing agent and place
these components on the new machine in a location similar to where they were stored in the existing agent.
3. Copy the $SCFHA/config/agent.properties file and make changes to the paths of the certificate file, keystore file,
and trust store file if required.
4. Restart the agent.
A sample start params entry is provided below. The changes are shown in bold in this entry sample, make the
same set of changes in the do32 and do64 sections.
25
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
26
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
A sample start parameters entry is provided below. The changes are shown in bold in the sample entry.
4. For AS/400, the Administrator must update the $SCFHA/config/agent.properties file to include these values:
os.os400.as400.user=JDE
os.os400.as400.password=<plain text as400 user JDE password>
After these values are set, the Administrator should restart the AS/400 Server Manager agent.
UNIX
echo $!>$JDEHOME/agent.pid
exit 0
27
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
28
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
AS/400 Platform
If you are managing the WebSphere Managed Instance on the AS/400 platform, configure the $SCFHA/bin/runAgent
script to use the 64-bit Java installation. Typically, the Java Installation used by the WebSphere Installation is:
/QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit/jre
If you are managing the Enterprise Server Managed Instance on the AS/400 platform, configure the $SCFHA/bin/
runAgent script to use the 32-bit or 64-bit Java installation depending on whether it is a 32-bit or 64-bit Enterprise Server
Managed Instance installation.
The install location of the Java 8, 32-bit and 64-bit, respectively, on the AS/400 machine is:
/QOpenSys/QIBM/ProdData/JavaVM/jdk80/32bit/jre
/QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit/jre
In order to enable the Server Manager agent to read the PTF.LOG file, you must use the DDM/DRDA AS/400 user and
password using this procedure:
1. The Administrator must update the $SCFHA/config/agent.properties file to include these values:
os.os400.as400.user=JDE
os.os400.as400.password=<plain text as400 user JDE password>
2. After these values are set, the Administrator should restart the AS/400 Server Manager agent.
29
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
30
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
os.os400.as400.user=JDE
os.os400.as400.password=<plain text as400 user JDE password>
Java.security File
If you have modified the $jdk/jre/lib/security/java.security file, and removed the anon and NULL entries from this file,
add the entries again or restore the file to its original condition. The following screenshot highlights these entries:
startWeblogic.sh/cmd
You must edit the startWeblogic.sh/cmd file in $<Server_Manager_Console_Weblogic_Domain>\bin\startWeblogic.sh/
cmd. In startWeblogic.sh/cmd, edit the command and add the content as shown in bold in the sample below. Also,
31
JD Edwards EnterpriseOne Tools Chapter 1
Server Manager Guide Getting Started
you must edit the same command to restart the Admin Server of the WebLogic Domain on which the Server Manager
Console is installed.
Note: If you plan to implement HTTP Strict Transport Security, refer to this Oracle document: Command Reference for
Oracle WebLogic Server 14c in the section entitled: HTTP Strict Transport Security.
Note: Restart the Server Manager Console after making the changes to the command.
If you are using Server Manager version 9.2.4.3 or later, these arguments will be taken from the agent.properties file that
is present in the $SCFMC\config and $SCHA\config folders.
32
JD Edwards EnterpriseOne Tools Chapter 2
Server Manager Guide Concepts and Terminology
Introduction
Server Manager for JD Edwards EnterpriseOne is a web based application used to manage the complete life cycle of the
JD Edwards EnterpriseOne server products. It is delivered with the JD Edwards EnterpriseOne Tools Release 8.97 and
later releases and supports the same JD Edwards EnterpriseOne associated application releases that are supported by
the tools releases.
Features at a Glance
Server Manager provides:
You can securely access and manage your JD Edwards EnterpriseOne installation from anywhere using a
standard web browser.
• Remote Deployment and Upgrades
You can install, uninstall, and update your JD Edwards EnterpriseOne servers regardless of their physical
location or platform.
• Remote Operational Control
You can start and stop any of your JD Edwards EnterpriseOne servers, Oracle J2EE application servers, or
supported third party J2EE application servers directly from the Management Console .
• Secure Administrative Tasks
Server Manager permits you to specify which existing JD Edwards EnterpriseOne users have access to the
Management Console control, which JD Edwards EnterpriseOne servers the user may view, and specify which
administrative tasks the user may perform on those servers.
• Configuration Management
Server Manager provides a web-based interface for managing the configuration of all managed servers. The
application presents each configuration item along with integrated help describing the configuration setting.
Note: Beginning with the availability of Server Manager , it is strongly advised that all changes to
configuration files (such as jde.ini, jas.ini, jdbj.ini, jdelog.properties, etc.) for any JD Edwards EnterpriseOne
server managed by Server Manager be accomplished using only the Management Console interface of
Server Manager . In addition to providing usability improvements, using Server Manager reduces the risk of
introducing configuration errors by providing dropdowns that contain only valid values where applicable.
Further, the tool provides a useful Audit History for any modifications made to configurations using Server
Manager .
• Configuration Comparison
33
JD Edwards EnterpriseOne Tools Chapter 2
Server Manager Guide Concepts and Terminology
Use Server Manager to compare the configuration of two or more servers to identify configuration differences.
You can compare configurations through the Management Console application regardless of the platform
or location of the actual JD Edwards EnterpriseOne server. You can also compare individual servers with the
default configuration of the corresponding server groups to which the servers belong.
• Audit History
Server Manager maintains a history of changes made to the managed servers. This includes a history of
each configuration change, each server start and stop, and each tools release update, including the user that
performed the change or operation. The Management Console application provides mechanisms to query and
view the audit history that is maintained.
• Integrated EnterpriseOne Software Management
Use Server Manager to centrally maintain all your JD Edwards EnterpriseOne server tools releases, including
the ability to copy the software to the remote server machines.
• Logical Server Grouping
Server Manager allows you to group servers with a similar purpose. These groups can include any of the
server types such as Enterprise Server, HTML Web Server , and so on. A default, or template, configuration is
maintained for each server group.
• Application Release Independence
Server Manager is delivered with JD Edwards EnterpriseOne Tools Release 8.97 (and later) and is compatible
with any supported JD Edwards EnterpriseOne application release beginning with Application Release 8.9
through the currently supported release. No electronic software updates (ESUs) are required to support Server
Manager .
• Self-Contained Installation
The installation of Server Manager delivers all components that are required by the Management Console
application. There are no third party requirements regardless of your existing or intended middleware topology
(for example, Oracle WebLogic Server, WebSphere Application Server, or no application server).
• Tools Release Independence
Newer versions of the Server Manager application will continue to support the management of earlier tools
releases back to JD Edwards EnterpriseOne its initial release in Tools Release 8.97.
• Offline Monitoring and Scheduling of System Administrative Orchestrations (Release 9.2.6)
Use Server Manager to monitor and schedule system administrative orchestrations in the offline mode. The
Server Manager system administrator can run administrative orchestrations even when the HTML, Database,
and Enterprise servers are down. Administrative orchestrations are orchestrations that contain only these types
of components: Open API-type connectors connecting to a Server Manager Console Open API endpoint, rules,
or child orchestrations with a similar structure as the parent orchestration.
Architecture
The key benefits of the Server Manager architecture include:
• An integrated, web-based Management Console application.
• Management Agents that are installed on the JD Edwards EnterpriseOne servers.
34
JD Edwards EnterpriseOne Tools Chapter 2
Server Manager Guide Concepts and Terminology
• Use of Java Management Extensions (JMX) technology by the Management Agents running on the servers to
run as background processes that interact with the Management Console web application.
• Secure and encrypted network communication between the Management Console and Management Agents .
The design goal of Server Manager is to reduce the total cost of ownership of JD Edwards EnterpriseOne server
products from installation and configuration, to ongoing maintenance and troubleshooting. Server Manager manages
these JD Edwards EnterpriseOne servers:
• Enterprise Servers
• HTML Web Servers
• Transaction Servers
• Collaborative Portal Servers
• Business Services Servers
A high level view of the architecture is illustrated by this diagram:
35
JD Edwards EnterpriseOne Tools Chapter 2
Server Manager Guide Concepts and Terminology
36
JD Edwards EnterpriseOne Tools Chapter 2
Server Manager Guide Concepts and Terminology
Components
This section discusses:
• Management Console
• Management Agent
• Managed Home
• Managed Instance
• Instance Properties
• Software Component
• Server Configuration and Runtime Metrics
Management Console
The central element of the Server Manager architecture is the Management Console , a web-based application. The
Management Console is responsible for:
Typically the most suitable machine within the JD Edwards EnterpriseOne architecture is the Deployment Server,
although the Management Console can be installed on any server that meets the JD Edwards EnterpriseOne
Certifications (MTRs) of the Deployment Server (for details refer to Accessing the Certifications (Minimum Technical
Requirements) in this guide). The Management Console uses a J2EE application container to host the application.
Optionally, the Management Console can be configured to use the secure protocols of HTTPS/SSL.
See Also
• For an illustration of the role of the Management Console within Server Manager , refer to Architecture.
Management Agent
Server Manager uses Management Agents that are installed on the physical machines that run JD Edwards
EnterpriseOne server products. These Management Agents communicate directly with the Management Console and
are instructed to perform operations as a result of user actions in the Management Console web application.
37
JD Edwards EnterpriseOne Tools Chapter 2
Server Manager Guide Concepts and Terminology
The Management Agent is based on the JMX Java management specifications. Management Agents interact only
with the Management Console web application; however, much of the work, such as starting and stopping servers, is
actually performed by the Management Agent .
The JD Edwards EnterpriseOne server products contain an embedded variant of the Management Agent . This
Management Agent is responsible for providing the runtime information about an active server instance to the
Management Console web application.
The Managed Home Agent is a standalone Management Agent which functions as an installed daemon process.
Managed Home
The location in which the managed home agent is installed is a Managed Home . Similar to the concept of an
ORACLE_HOME, the Managed Home is the deployment location of the standalone Management Agent and a
structured file system containing the constituent parts of managed JD Edwards EnterpriseOne servers.
The Managed Home is created by the installation of the standalone Management Agent . The structured nature of the
Managed Home simplifies the installation and maintenance of JD Edwards EnterpriseOne software.
You must install at least one Managed Home on each physical machine before installing or managing any JD Edwards
EnterpriseOne servers. It is possible for a machine to host more than one Managed Home that might not use the same
Management Console . Each unique Managed Home is associated with exactly one Management Console .
See Also
• For an illustration of the role of the Managed Home within Server Manager , refer to Architecture.
Managed Instance
Each EnterpriseOne server, Oracle Application Server, or WebSphere Application Server is referred to as a Managed
Instance . A Managed Instance is a particular instantiation of a software component on a physical machine. Each
Managed Instance is identified by an instance name that name is unique to the machine on which the Managed
Instance resides. The instance name is supplied by the user who either created or registered the server with the
Management Console .
Each Managed Instance is associated with a Managed Home on the same physical machine.
38
JD Edwards EnterpriseOne Tools Chapter 2
Server Manager Guide Concepts and Terminology
Instance Properties
Instance Properties are the unique characteristics needed to identify an individual managed instance. For example, only
a single instance property might have been defined for an Enterprise Server:
• Installation path
As another example, an HTML Web Server software component might define two instance properties:
Software Component
The JD Edwards EnterpriseOne Tools Releases are downloaded as a portable archive (.PAR) and are referred to as
Software Component s in Server Manager . The JDBC driver implementations (JAR files) are also Software Component
s in Server Manager .
• Server Components
• JDBC Driver Components
See Also
• For an illustration of the role of the Software Component within Server Manager , refer to Architecture.
Server Components
These Server Components are a subset of the Software Component s that can be deployed and managed by Server
Manager :
• J2EE containers that run the JD Edwards EnterpriseOne web-based server products.
These drivers are required components on the JD Edwards EnterpriseOne HTML Web Server and any other
JD Edwards EnterpriseOne server component that requires JDBC database connectivity that is not natively
provided by the underlying application server.
39
JD Edwards EnterpriseOne Tools Chapter 2
Server Manager Guide Concepts and Terminology
• RMI java application that runs on the JD Edwards EnterpriseOne Data Access Server.
The JDBC driver for this server is required to provide native database connectivity for the application (such as
Oracle BI Publisher) or program that is accessing the Data Access Server.
Note: Do not use Server Manager to install or uninstall an Oracle jdbc driver for any JD Edwards EnterpriseOne Web
Server that it WebLogic Server-based. If you need to update a JDBC driver for WebLogic Server for any reason, you
should use the native WebLogic Server tools, which are available at the below links:
https://docs.oracle.com/middleware/1212/wls/JDBCA/third_party_drivers.htm#JDBCA234
https://docs.oracle.com/cd/E24329_01/web.1211/e24367/third_party_drivers.htm#JDBCA232
Runtime metrics provide insight into the current state of a running Managed Instance . For example, the active user
sessions are a runtime metric provided by the JD Edwards EnterpriseOne HTML Web Server .
For details, refer to these chapters and sections within this guide:
• Configuration
For details refer to the chapter in this guide entitled: Configure EnterpriseOne Server Instances.
• Runtime Metrics
For details refer to the chapter in this guide entitled: View Runtime Metrics for a Managed Instance.
40
JD Edwards EnterpriseOne Tools Chapter 3
Server Manager Guide Functional Overview
3 Functional Overview
Using Server Manager through the web-based Management Console , the JD Edwards EnterpriseOne administrator
can create a new JD Edwards EnterpriseOne server on a remote machine. The JD Edwards EnterpriseOne software
used for installation is stored on the Management Console machine after being downloaded from the Customer
Connection website or using Change Assistant.
The software may be distributed, or copied, to the remote machine from the Management Console . This server
software ( JD Edwards EnterpriseOne Tools Release) can now be used to create the new JD Edwards EnterpriseOne
server. The Management Home Agent performs the installation of the specific server type and automatically performs
the requisite default configuration. After it is successfully installed, the server can be maintained entirely through the
Management Console . This deployment process is similar for all JD Edwards EnterpriseOne server types.
Configuration Management
Server Manager provides a complete configuration management system for all server types. Each configuration entry
from the .INI and .properties files has been defined in metadata contained within the Management Console . It is no
longer necessary to directly edit any of these configuration files, or even to know where they exist.
The configuration items are grouped into logical configuration topics. These topics are presented on the management
page for each JD Edwards EnterpriseOne Managed Instance . Selecting a configuration topic displays all the individual
configuration items contained within. These items are further grouped and displayed for viewing or editing. Each
configuration item is displayed with a plain text description. Configuration items with a list of allowed values are
displayed using drop down boxes.
A link to display context sensitive help is displayed next to each configuration item. Clicking this link displays the name
of the .INI file that is being viewed, the section and entry name in the file to which the .INI pertains, the default value
of the setting, and a full description of the configuration item. For items with an associated list of allowed values, each
value is displayed in the help text.
The contents of the contextual help for each setting are also available in reference form in the Management Console
documentation.
Through the Server Manager Management Console , a JD Edwards EnterpriseOne administrator can compare
configurations for each remote Managed Instance , even if they reside on separate physical machines. This capability
significantly reduces the effort required to ensure consistency among configurations, especially for those installations
containing numerous JD Edwards EnterpriseOne servers.
41
JD Edwards EnterpriseOne Tools Chapter 3
Server Manager Guide Functional Overview
Audit History
Before the introduction of Server Manager , many of steps in the software life cycle were not logged by any JD Edwards
EnterpriseOne mechanism. With Server Manager , the Management Console records and makes available an audit trail
of actions, such as:
• Installing or changing tools releases on a JD Edwards EnterpriseOne Enterprise Server.
• Installing or changing runtime code on a JD Edwards EnterpriseOne HTML Web Server .
• Changing to configuration items of Server Metrics.
• Recording implemented notifications (for example, for a critical failure).
Remote Troubleshooting
An administrator can use the Management Console to troubleshoot any of the Managed Instances within the
management domain. Troubleshooting includes:
• Retrieving and modifying configuration entries of managed servers.
• Retrieving log files.
• Comparing configurations of a particular instance with any other.
Before Server Manager , some of this functionality was available through the Server Administration Workbench (SAW)
web interface. However, Server Manager greatly enhances the capability of the administrator by extending this ability
to managing all JD Edwards EnterpriseOne server-based products (for a list of supported servers, refer to Server
Components). Additionally, unlike the previous SAW implementation, which was directly embedded in the product, the
Server Manager configuration management and troubleshooting tools are available even if the target instance is not
running or fails to start.
Flexible Monitoring
Due to its inherent knowledge of the registered topology, Server Manager can accurately determine and subsequently
monitor all entities constituting an EnterpriseOne installation. As such, Server Manager provides enterprise-wide views
rather than machine specific views, which eliminates the potential for inaccurate monitoring of general information. For
example, Server Manager contains real-time data for user sessions, Java memory usage, JDBj connection cache, and
prepared statement configurations. Without Server Manager , such information is not available.
42
JD Edwards EnterpriseOne Tools Chapter 3
Server Manager Guide Functional Overview
See Also
The Server Manager system administrator can use the Management Console to upload system administrative
orchestrations, which are designed to perform system administration tasks, and then use the Orchestrator Studio to
run the administrative orchestrations. This capability of Server Manager enables system administration tasks to be
completed even when the EnterpriseOne servers are down, ensuring business continuity.
43
JD Edwards EnterpriseOne Tools Chapter 3
Server Manager Guide Functional Overview
44
JD Edwards EnterpriseOne Tools Chapter 4
Server Manager Guide Configuring Server Manager Console to Start Automatically
E1: SVM: How to Configure Server Manager Console to Start Automatically With the Operating System When
Installed on WLS or WAS (Doc ID 2066799.1):
https://support.oracle.com/epmos/faces/DocumentDisplay?id=2066799.1
45
JD Edwards EnterpriseOne Tools Chapter 4
Server Manager Guide Configuring Server Manager Console to Start Automatically
46
JD Edwards EnterpriseOne Tools Chapter 5
Server Manager Guide Start, Stop, and Restart a Management Agent
• Microsoft Windows
• UNIX
• OS400 ()
Microsoft Windows
You can use these methods to start the Management Agent :
Note: The path installation_directory\JDE_HOME refers to the install location of the Management Agent .
For example:
47
JD Edwards EnterpriseOne Tools Chapter 5
Server Manager Guide Start, Stop, and Restart a Management Agent
installation_directory\JDE_HOME\SCFHA\bin\startAgent.bat
Note: The path installation_directory\JDE_HOME refers to the install location of the Management Agent .
UNIX
You can use this script to start the Management Agent :
installation_directory\JDE_HOME\SCFHA\bin\startAgent.bat
Note: The path installation_directory/JDE_HOME refers to the install location of the Management Agent .
OS400 ()
In order for the Management Agent to function, it is required that JDK 1.5 be installed on the IBM i machine.
48
JD Edwards EnterpriseOne Tools Chapter 5
Server Manager Guide Start, Stop, and Restart a Management Agent
As shown below, you must use the "&" switch as a suffix for the command script in order to start the Management
Agent as a background job. Launching the job in this manner means that when you leave the qshell the job will not die.
The user who installs, starts or restarts the agent must have the minimum permissions of *ALLOBJ, *SAVSYS and
*JOBCTL and *SECADM. After the Management Agent installation is complete, it will start. It is important to note that
when starting the Management Agent the user that is signed onto the IBM i machine is the user that executes the
functionality when the Management Agent is performing Server Manager work. That user must not be a user that has
a JD Edwards EnterpriseOne Enterprise Server library in its library list (for example: E900SYS).
Agent Commands
For the Management Agent running on the IBM i platform, you can run these commands from the default /JDEdwards/
JDE_HOME/SCFHA/bin folder:
restartAgent
runAgent
startAgent
stopAgent
1. To stop, start, or restart the Management Agent , log in to OS400 with a user profile which has sufficient
privileges to operate these services.
You should ensure that the job queue that the user belongs to is one that is not interrupted during processing.
Because it is interruptible, a job queue such as QINTER might not be the best choice for the job queue in which
to run the Management Agent . You should consider this warning when selecting the user with the correct
permissions and configuration to run the Management Agent processing tasks.
2. To submit the Management Agent action (stop, start, or restart) to batch so it runs in a subsystem other than
QINTER:
where in this example, the job queue is QTXTSRCH, which is a job queue that is delivered by IBM. This job queue
has no thread limitation and runs in the QBATCH subsystem.
49
JD Edwards EnterpriseOne Tools Chapter 5
Server Manager Guide Start, Stop, and Restart a Management Agent
3. You can use the work with active jobs command to view the processes running under the QBATCH subsystem. For
example:
4. If you want to kill the initial startAgent job, you can issue this command:
50
JD Edwards EnterpriseOne Tools Chapter 5
Server Manager Guide Start, Stop, and Restart a Management Agent
5. To verify the job is killed, you can use this work with active jobs command to view the processes running under
the QBATCH subsystem:
Note: If a user does not have sufficient privileges to stop a Management Agent , the Stop Agent button on the
Management Console is disabled (grayed out).
51
JD Edwards EnterpriseOne Tools Chapter 5
Server Manager Guide Start, Stop, and Restart a Management Agent
• Microsoft Windows
• UNIX
• OS400 ()
Microsoft Windows
You can use this .bat file to stop the Management Agent :
installation_directory\JDE_HOME\SCFHA\bin\stopAgent.bat
Note: The path installation_directory\JDE_HOME refers to the install location of the Management Agent .
UNIX
You can use this script to stop the Management Agent :
installation_directory\JDE_HOME\SCFHA\bin\stopAgent
Note: The path installation_directory\JDE_HOME refers to the install location of the Management Agent .
52
JD Edwards EnterpriseOne Tools Chapter 5
Server Manager Guide Start, Stop, and Restart a Management Agent
OS400 ()
Use this command within qshell to stop the Management Agent :
JDE_HOME/SCFHA/bin/stopAgent
Note: The path installation_directory\JDE_HOME refers to the install location of the Management Agent .
• Microsoft Windows
• UNIX
• OS400 ()
Microsoft Windows
You can use this .bat file to restart the Management Agent :
installation_directory\JDE_HOME\SCFHA\bin\restartAgent.bat
Note: The path installation_directory\JDE_HOME refers to the install location of the Management Agent .
UNIX
You can use this script to restart the Management Agent :
installation_directory\JDE_HOME\SCFHA\bin\restartAgent
Note: The path installation_directory\JDE_HOME refers to the install location of the Management Agent .
53
JD Edwards EnterpriseOne Tools Chapter 5
Server Manager Guide Start, Stop, and Restart a Management Agent
OS400 ()
User Installing, Starting, or Restarting the Management Agent. The user who installs, starts or restarts the agent
must have the minimum permissions of *ALLOBJ, *SAVSYS, *JOBCTL, and *SECADM. After the Management Agent
installation is complete, it will start. It is important to note that when starting the Management Agent the user that is
signed onto the IBM i machine is the user that executes the functionality when the Management Agent is performing
Server Manager work. That user must not be a user that has a JD Edwards EnterpriseOne Enterprise Server library in its
library list (for example: E900SYS).
JDE_HOME/SCFHA/bin/restartAgent
Note: The path installation_directory\JDE_HOME refers to the install location of the Management Agent .
54
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
The Select Instance dropdown is available on every Management Console page. It is always located at the top-most
portion of the left-hand pane, just above the What do you want to do? list.
55
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
When you click the Select Instance... dropdown, the Management Console displays a list of currently available instances
registered with this Management Console . The list is organized by these groups:
• Independent Instances
Where name is the name of the server group. For example, default.
Each instance is listed by its name, which is a link to the instance, and a description of the instance. If you click the link
for the instance, the Management Console displays the management page of the instance.
56
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
The Management Console displays a section in the left-hand pane of each web page called What do you want to do?
that provides easy navigation to the Management Console functions for INSTALL, CONFIGURE, and TRACK:
INSTALL
• Management Agents
Refer to Installing the Server Manager Management Console and Agent of this guide
• Managed Software
57
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
CONFIGURE
Refer to Configure the Default Server Group Configuration Settings and Administer Server Groups of this guide
TRACK
• User Activity
• Management Dashboard
• EnterpriseOne Servers By Type
• EnterpriseOne Servers By Group
• Search for User Resources
Management Dashboard
The Management Dashboard is the entry point into the management application. The web page displays the status
of all the Management Agents and Managed Instances . This view shows each of the known Managed Homes and
the Managed Instances that they contain. Managed Homes and Managed Instances can be accessed by clicking their
links.
58
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
59
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
To choose the Management Dashboard view of the Management Console , on the Home page, use the Select View
dropdown to choose Management Dashboard.
Note: This is the default view whenever you start the Management Console .
1. On the Home page, use the Select View dropdown to choose EnterpriseOne Servers By Type.
60
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
2. The grids in this view show the operational status of each installed server and their associated Managed
Instances . For any installed servers, you can click on the associated link to Instance Name to work with the
instance. The grids lists these items:
◦ Instance Name
Identifies the name assigned to the Managed Instance at the time it was created or registered.
◦ Managed Home Details
Displays the details of the Managed Home and the Managed Home host name of the target server.
◦ Server Group
Specifies the name of the server group of which the Managed Instance is a member.
◦ State
Lists the operational state of the managed instance, where valid values are:
- Running
- Stopped
- Starting
- Stopping
- Failed
- Undetermined
◦ User Activity
For an Enterprise Server, the display includes the number of active CallObject (kernel business function)
user and the number of active security server kernel users.
For an HTML Web Server , the display includes the number of active user sessions.
This screen shot displays an example of the grid for an installed Enterprise Server.
This screen shot displays an example of the grid for an installed HTML Web Server :
61
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
3. The view also lists server types that are available, but not installed.
This screen shot displays an example of the Management Console if the Enterprise Server is not installed:
At a minimum, the EnterpriseOne Servers By Group view of the Management Console includes a default server group
that you can use to initially manage servers. You can move any server from the default server group to a newly created
server group. A server cannot belong to more than one server group, including the default server group.
62
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
2. The EnterpriseOne servers are organized by server groups, where every installation will have at least one server
group called default. For example:
63
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
3. The grids in this view show the operational status of each installed server and their associated Managed
Instances . You can click on the link in the Instance Name column to access the instance. The grids lists these
items:
◦ Instance Name
Identifies the name assigned to the Managed Instance at the time is was created or registered.
◦ Managed Home Details
Displays the details about the Managed Home and the Managed Home host name of the target server.
◦ Managed Instance Type
Lists the operational state of the managed instance, where values are:
- Running
- Stopped
- Starting
- Stopping
- Failed
- Undetermined
◦ User Activity
For an Enterprise Server, the display includes the number of active CallObject (kernel business function)
user and the number of active security server kernel users.
For an HTML Web Server , the display includes the number of active user sessions.
4. Start and Stop buttons are available to start and stop individual or multiple servers in a group.
64
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
To select the Search for User Resources view of the Management Console :
1. On the Home page, use the Select View dropdown to select Search for User Resources.
Enter one or more JD Edwards EnterpriseOne user names to filter the returned results. You should
separate multiple names with spaces. Leave this field blank to search for all users.
◦ Search Package Name(s)
Enter one or more JD Edwards EnterpriseOne user names to filter the returned results. If you enter
multiple names, separate each name with a space. Leave this field blank to search for all the packages.
◦ Search Environment(s)
Enter one or more environment names to filter the returned results. Server Manager will only display
user resources that are associated with an environment for the environment that you specify. Leave this
field blank to search for all environments.
◦ Detail Level of Results
Select a radio button for your desired level of results, where the choices are Low, Medium, or High.
3. Click the Search button.
65
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
• Select All
• Select None
If you click the heading title again, the sort toggles to descending, as indicated by an upward point arrow to the right of
the heading text. For example:
66
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
Note: The system keeps track of the sort using a browser cookie.
• Running
• Stopped
• Running
• Stopped
• Undetermined
67
JD Edwards EnterpriseOne Tools Chapter 6
Server Manager Guide User Interface for the Management Console
68
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
When you create a new server instance, the Management Console applies the default configuration settings for that
type of server to the newly created server. For example, in a server group, you can define the default configuration
settings for a JD Edwards EnterpriseOne HTML Web Server. Each HTML Web Server that you create in that server group
uses the server groups default configuration settings for HTML Web Servers.
You can modify the configuration settings for an individual server as needed. The changes are reflected only in the
configuration settings of that particular server and do not affect the default configuration settings for that type of
server in the server group. Conversely, modifying the default configuration settings for a server group does not affect
the configuration of any servers that have already been created.
Note: When you create a server group, the Management Console copies default configuration settings from the
default server group to the new server group. In the new server group, you can modify the default configuration
settings as appropriate.
See Also
69
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
1. In the What do you want to do now? section of the Management Console, click the Server Groups link.
70
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
71
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
2. In the Select [Server Group] pane of the Server Groups page, click the Server Group Name hyperlink in the
Server Group Name row.
In the Server Group Default Configuration pane, the Management Console lists each type of JD Edwards
EnterpriseOne server that could belong to the group and the configuration categories for each.
3. Under the appropriate server type, click a configuration category link.
If a set of valid values exists, the Management Console displays these values in a dropdown menu.
Note: There might be some configuration items that are installation-specific and therefore not displayed in
the default configuration template. These settings are automatically configured for a new server when it is
created.
For example:
72
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
2. Select the << Set defaults Based on this Instance button to set the server group defaults based on an existing
instance.
3. Select the Apply defaults to this Instance >> button to apply the current server group default values to an
instance group.
You can use Centralized Configuration under Configure section in Management Console to create a centralized
configuration file, e1central.properties, that will help Management Console and HTML server instance to connect with
the database.
The configuration file will be distributed to all the applicable instances in the Server Manager Console, enabling
Centralized Configuration. Management Console will use the values defined in the centralized configuration file to
connect with the database. Each HTML server, that has Centralized Configuration enabled, will read the configuration
files (such as jde.ini, jas.ini, jdbj.ini, jdelog.properties, etc.) from the database and create the .ini file before starting the
instance.
After you enable the Centralized Configuration, the group level default configuration settings will be applicable to the
server group as well as all the HTML server instances in that server group. Any changes made on the configuration of
server groups will be applicable to HTML server instances as well. However, if you change the configuration settings at
73
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
instance level, the system overrides the group level configuration settings and uses the instance level configuration. You
have the option to restore the default group level configuration settings for such instances. See Understanding How to
Restore Group Default Settings for HTML Server Instances for details.
When you add a new server to a server group, Management Console automatically applies the default configuration
settings for that type of server to the newly added server. See Configuring Default Configuration Settings for details.
Moving an existing server from a group to a different server group will use the settings of the server group it is moved
to, if you have the Centralized Configuration enabled for a server instance. Server Manager automatically applies the
default configuration settings of that server group to the newly added HTML server instance.
Any changes to configuration settings on group or instance level requires you to synchronize the settings and restart
the HTML server instance for to use the new settings. For such instances, the system displays a Warning message along
with a Synchronize Configuration button. Click the Synchronize Configuration button to sync the changes and restart
the instance.
For all cluster setup, you must manually copy the e1central.properties file, that has the database details, along with the
e1Central_config folder, if available, to the node’s config folder.
Note: If you have more than one Sever Manager Console, you need to have different data sources for respective
consoles. For each Server Manager Console, you must create different F98CCONF (E1 Centralized Configuration Table)
table in different data sources. The table F98CCONF (E1 Centralized Configuration Table) in system data source will be
created as part of latest Tools Rollup ESU.
In case there is a change in the data source, you need to manually migrate all the records from F98CCONF (E1
Centralized Configuration Table) table to the new data source.
Note: HTML servers that are on and above Tools Release 9.2.7, must be restarted after synchronization is complete
with the new settings. When Centralized Configuration is enabled, any update that is made manually will not take
effect after the server is restarted. The changes are lost as the changes will be downloaded from the database.
Centralized Configuration is also enabled for HTML servers that are on Tools Release 9.2.7 while you create a new
instance. Alternatively, with Tools Release 9.2.7, you can perform a Change Component operation on the existing server
74
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
instances which enables Centralized Configuration. Change component will make all the current configuration entries in
database as instance level configuration.
Note: Make sure you have required drivers and certificates installed to allow the JAS instances and the
Server Manager Console to connect with the database.
Enter the password to use for centralized configuration when connecting to the configured database.
◦ Database Type
Use the dropdown to select a database where the centralized configuration table is stored. Tnsname.ora
field is populated when you select Oracle Database and the Use TLS field is populated when you select
either IBM UDB, AS/400 or SQL.
◦ Owner
Enter the database object owner where the centralized configuration table is stored.
◦ Server
Enter the server name where the centralized configuration table is stored.
◦ Database Name
Enter the database name where the centralized configuration table is stored.
◦ Physical Database
Enter the physical database name where the centralized configuration table is stored.
◦ Server Port
Enter the database server port where the centralized configuration table is stored.
◦ Data Source Name
Enter the database server port where the centralized configuration table is stored.
◦ Use TLS
The Use TLS option appears for selection after you select either IBM UDB, AS/400, or SQL. Select the
checkbox if you want a secure TLS connection to either of the databases.
◦ Tnsname.ora
The Tnsname.ora field appears for modification after you select Oracle Database in Database Type. Enter
the Tnsname.ora connection details.
4. Click Save.
The system will continue to apply the settings and it will take between 5 to 15 minutes to complete the action depending
on the number of server instances in the group. Do not refresh your web browser until the system prompts that the
operation is successful.
75
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
If the database details are incorrect, the system displays an error message. You must rectify the incorrect details to
enable Centralized Configuration.
Note: The data migration is a one-time event. If the database already has the records, the migration will not initiate
after you click Save. The system only performs the database connection validation.
Note: The Revert to Group Defaults button is only activate if the instance level configuration settings are
different from the group level configuration settings. If the Revert to Group Defaults button is not available
under the configuration items of an instance, any configuration setting that you update at the server group
level is applicable to the instance as well.
Note: If you disable the Centralized Configuration, you can restore the previously saved configuration else
the existing ini will continue to work.
76
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
Note: If you have enabled Centralized Configuration for HTML servers in the previous Tools Release (9.2.7), the
Centralized Configuration will be automatically enabled for AIS servers in Release 9.2.7.3. Alternatively, with Tools
Release 9.2.7.3, you can perform a Change Component operation on the existing server instances which enables
Centralized Configuration. Change component will make all the current configuration entries in database as instance
level configuration. See Using Centralized Configuration for EnterpriseOne HTML Servers (Release 9.2.7) for details.
After you enable the Centralized Configuration, the group level default configuration settings will be applicable to the
server group as well as all the AIS server instances in that server group. Any changes made on the configuration of
server groups will be applicable to AIS server instances as well. However, if you change the configuration settings at
instance level, the system overrides the group level configuration settings and uses the instance level configuration. You
have the option to restore the default group level configuration settings for such instances. See Understanding How to
Restore Group Default Settings for AIS Server Instances for details.
The steps to enable Centralized Configuration for AIS servers are same as enabling Centralized Configuration for HTML
servers. See Understanding How to Enable Centralized Configuration for EnterpriseOne HTML Servers for details.
Also see, Understanding How to Validate Centralized Configuration with Data Browser.
1. Access the AIS instance that has different configuration settings than the group it belongs to.
2. Navigate to Configuration > Advanced.
3. Open any configuration head. For example, the Cache configuration of the instance.
77
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
Note: The Revert to Group Defaults button is only activate if the instance level configuration settings are different
from the group level configuration settings. If the Revert to Group Defaults button is not available under the
configuration items of an instance, any configuration setting that you update at the server group level is applicable to
the instance as well.
Note: Release 9.2.8 extends the capability of Centralized Configuration to all the EnterpriseOne servers. If you have
enabled Centralized Configuration in the previous Releases 9.2.7 or 9.2.7.3, the Centralized Configuration will be
automatically enabled for all the EnterpriseOne servers in Release 9.2.8. Alternatively, with Tools Release 9.2.8, you can
perform a Change Component operation on the existing server instances which enables Centralized Configuration.
Change component will make all the current configuration entries in database as instance level configuration. See
Using Centralized Configuration for EnterpriseOne HTML Servers (Release 9.2.7) for details.
After you enable the Centralized Configuration, the group level default configuration settings will be applicable to the
server group as well as all the server instances in that server group. Any changes made on the configuration of server
groups will be applicable to server instances as well. However, if you change the configuration settings at instance level,
the system overrides the group level configuration settings and uses the instance level configuration. You have the
option to restore the default group level configuration settings for such instances. See Understanding How to Restore
Group Default Settings for Enterprise, BSSV, and Transaction Server Instances for details.
78
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
The steps to enable Centralized Configuration for Enterprise, BSSV, and Transaction servers are same as enabling
Centralized Configuration for HTML and AIS servers. See Understanding How to Enable Centralized Configuration for
EnterpriseOne HTML Servers for details.
Also see, Understanding How to Validate Centralized Configuration with Data Browser.
Note: For Transaction server horizontal cluster instance, adding e1central.properties file is not required. Whenever
there is a change in configuration, you can either copy the INI files from vertical machine to horizontal machine (path:
..\targets\rte_instance_name\config ) or update the changes in the horizontal machine's INI files manually.
Access the Enterprise, BSSV, or Transaction server instance that has different configuration settings than the group it
belongs to:
Note: The Revert to Group Defaults button is active only if the instance level configuration settings are different from
the group level configuration settings. If the Revert to Group Defaults button is not available under the configuration
items of an instance, any configuration setting that you update at the server group level is applicable to the instance
as well.
79
JD Edwards EnterpriseOne Tools Chapter 7
Server Manager Guide Configure the Default Server Group Configuration Settings
All server groups listed under the InstanceName column will have a prefix of star symbol. For the sever instances,
JdeHome and SmHostName columns will list the names of the managed home and host names they are part of.
80
JD Edwards EnterpriseOne Tools Chapter 8
Server Manager Guide Configure Management Console Users
An authorized user signs into the Management Console with JD Edwards EnterpriseOne credentials; a separate user
ID and password are not required. The Management Console uses a JD Edwards EnterpriseOne security server for
user authentication. The Management Console employs user groups as an efficient way to manage permissions and
servers. Instead of administering these items at the user level, you can associate permissions with a user group.
For example, you might assign a set of users to a user group that allows the users to view the log files of a particular
group of servers but not allow the users to start or stop the servers. You might also create a user group that enables its
group members to completely administer the development servers but not to see the production servers within the
Management Console application.
The Management Console user repository stores user group definitions, server group definitions, and authorization
information.
Refer to these applicable tasks in Advanced Console Administration part of this guide:
81
JD Edwards EnterpriseOne Tools Chapter 8
Server Manager Guide Configure Management Console Users
82
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
You use the Upload Software Components page to upload JD Edwards EnterpriseOne software components to
the Management Console . Once you have uploaded and distributed the Managed Software Components to a
Management Agent , you can use them to create new server instances.
83
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
84
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
1. On Upload Software Components, click the Browse button to locate the various .par files for each Managed
Software Component . Typically you will obtain these files from Customer Connection using the Change
Assistant, although they can also be on CD.
For example:
2. On File Upload, select the .par file(s) for the Managed Software Component that you wish to upload and click
the Open button.
3. On Upload Software Components, click the Upload button to upload the selected file.
As soon as the file is successfully uploaded, the Management Console updates the page to include the
Managed Software Component .
If you attempt to upload a Management Console that already exists with the identical file name, the Management
Console displays this warning, discards the request, and does not overwrite the existing file:
85
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
Tip: You can also add Managed Software Components by manually copying the files to the components directory on
the machine running the Management Console . This directory is auto-detected by Management Console and is
displayed in the tip section of the Upload Software Components section. For example, in the preceding section, the
directory is: D:\servermanager\demosystem\components
86
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
1. On Managed EnterpriseOne Software Components, select one or more available Software Components that
you want to distribute to a connect Managed Home .
2. Click the Distribute button.
The Management Console displays a page of connected Managed Homes to which you can distribute the
selected Software Component .
3. On the list of available Managed Homes to which you can distribute the selected Software Component , select
one or more Managed Homes .
87
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
The Management Console displays a progress panel and performs the requested operation.
5. To verify that the selected Software Component is distributed, you can navigate to the Managed Home
to which you distributed the Software Component and check the list of software components in Managed
Software Components. Management Consoles .
88
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
1. In the What do you want to do? section, click on the link for Manage Software.
2. On the Managed Software Components section, use the check box to select one or more Managed Software
Components to delete.
89
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
90
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
1. On the Managed Homes and Managed Instances page, click on the link to a Managed Home.
2. On the Managed Software Components section, use the check box to select one or more Managed Software
Components to delete.
91
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
• General
• Instance Properties
The General section of the page shows the status of the Managed Instance . If the status is either Started or
Stopped, the page contains either the Stop or Start button, as appropriate. If the status of the Managed Instance is
undetermined, the page does not contain either button.
For example, if the status is Running, you can stop the instance by pressing the Stop button as shown below:
Also for example, if the status is Stopped, you can start the instance by pressing the Start button as shown below:
92
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
When you click the link for a Managed Instance , the Instance Name page displays information in two categories:
• General
• Instance Properties
In the General section of the page contains a section for Software Component Version, under which is a Change button.
If there is only a single version of the Software Component associated with this Managed Instance , clicking the
Change button displays this Change Tools Release dialog that indicates there is no component available to which to
change:
93
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
If multiple versions of the Software Component are available to the Management Console , clicking the Change button
displays the Change Tools Release dialog that lists each available Software Component . For example:
1. Select the radio button associated with the Management Console to which you wish to change.
2. Click the Change Component button.
There is no confirmation dialog for this action. As soon as you click the Change Component button, the
Management Console begins the work. You can always revert to your previous version assuming you have a
copy of the Software Component for the Management Console to which you want to change.
Note: If you are using WebSphere Application Server and running JD Edwards EnterpriseOne as part of a federated
(or clustered) web server, you may need to regenerate the WebSphere global plugin configuration after deploying the
newest tools release. This is required when new servlets have been added to the tools release you are deploying.
94
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
1. Select a Managed Instance for which you wish to view the Software Release History.
2. In the General section of the page, click the Software Release History icon (refer to preceding graphic).
◦ Date
◦ User Name
◦ Old Release
◦ New Release
95
JD Edwards EnterpriseOne Tools Chapter 9
Server Manager Guide Managed Software Components
96
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
Server Manager allows you to centrally manage JDBC drivers that are required to enable the various web-based servers
to access their respective databases. Using Server Manager you can upload and install any of these JDBC drivers
supported by the JD Edwards EnterpriseOne web-based servers:
• Oracle Database
• MicroSoft SQL Server
• IBM DB2 for Windows or Unix
• IBM DB2 for IBM i
You should obtain the required driver files from the database vendor. Once all the required files have been obtained
they can be uploaded to the management console. This table lists the requisite JDBC drivers.
Oracle 9i classes12.jar
97
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
db2jcc_license_cu.jar
For the Oracle database, you can locate the driver file in these locations:
• Beginning with WebLogic 12.1.3, WebLogic is pre-configured to use a bundled Oracle 12c database JDBC
driver. This JDBC driver comes pre-installed with the WebLogic Server installation, and no additional steps are
required to connect to an Oracle 12c database.
• Oracle Database
Your installation of an Oracle database product includes the JDBC Thin driver for use with JDK 1.2 and JDK 1.3.
• Oracle Technology Network (OTN)
https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html
https://updatecenter.oracle.com/
98
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
1. Navigate to the JDBC driver management page using this quick link in the What do you want to do? section:
Database Drivers
2. Locate the section corresponding to the type of driver you wish to install.
The Management Console displays this JDBC Driver Upload form only if you have not previously uploaded the
JDBC driver.
For example, if you have not previously uploaded the Oracle driver, the form looks like this:
3. For each of the required files use the Browse button to select the corresponding file previously obtained.
For example, if you were uploading the driver for Oracle, you would browse to the location of the classes12.jar
file.
4. Click the Upload button.
The selected driver file(s) are uploaded to this directory, which contains the Management Console software
repository.
x:\JDE_HOME\components
99
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
where x: is the drive on which you installed the Management Console , and
where JDE_HOME is the name that you defined as the home for the Management Console .
Tip: External to the Management Console , the functional equivalent of using this form to upload the driver is to
place it in the specified directory by other means. Once you have placed the driver files in the appropriate directory,
refreshing the JDBC Drivers page displays the available application servers on which the drivers are not already
installed, but on which they can be installed. Server Manager will not display bundled JDBC drivers that come already
installed with Oracle WebLogic Server. The bundled JDBC driver does not need to be uploaded or installed through
Server Manager.
Note: If you need to update the JDBC driver for the WebLogic Server that is bundled with Server Manager, refer to the
following section entitled: Update Bundled JDBC Drivers for WebLogic Server
How To Update the JDBC and UCP Drivers Bundled with WebLogic Server (Doc ID 1970437.1)
Upgrading and Using Latest Oracle 19c JDBC Drivers with WebLogic Server
Upgrading to use the Latest Oracle 19.x Drivers with WebLogic Server
Management Console installs JDBC drivers in a web container within an Application Server installation. This installation
corresponds to a Managed Server within an Oracle WebLogic Server and to a J2EE server in IBM WebSphere.
100
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
1. Verify that the Status of the target application server for the installation is Not Installed.
2. Select the check box for the application server on which you want to install the driver.
3. Click the Install Driver button.
4. Refresh the JDBC Driver page and verify the status is changed to Installed.
101
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
1. Verify that the status of the J2EE server on which you wish to uninstall the JDBC Driver is Installed.
2. Enable the check box for the application server on which you want to uninstall the driver.
3. Click the Uninstall Driver button.
4. On the resulting confirmation dialog, click the OK button to confirm that you want to delete the JDBC driver
from the selected server.
5. Refresh the JDBC Driver page and verify that the status is changed to Not Installed.
102
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
1. Verify that the Status of the target Data Access Server for the installation is Not Installed.
2. Select the check box for the Data Access Server on which you want to install the driver.
3. Click the Install Driver button.
4. Refresh the JDBC Driver page and verify the status is changed to Installed.
103
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
1. Verify that the status of the Data Access Server on which you wish to uninstall the JDBC Driver is Installed.
2. Enable the check box for the Data Access Server on which you want to uninstall the driver.
3. Click the Uninstall Driver button.
4. On the resulting confirmation dialog, click the OK button to confirm that you want to delete the JDBC driver
from the selected server.
104
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
5. Refresh the JDBC Driver page and verify that the status is changed to Not Installed.
1. Verify that the Status of the target Enterprise Server for the installation is Not Installed.
2. Select the check box for the Enterprise Server on which you want to install the driver.
3. Click the Install Driver button.
105
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
4. Refresh the JDBC Driver page and verify the status is changed to Installed.
1. Verify that the status of the Enterprise Server on which you wish to uninstall the JDBC Driver is Installed.
2. Enable the check box for the Enterprise Server on which you want to uninstall the driver.
3. Click the Uninstall Driver button.
4. On the resulting confirmation dialog, click the OK button to confirm that you want to delete the JDBC driver
from the selected server.
106
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
5. Refresh the JDBC Driver page and verify that the status is changed to Not Installed.
107
JD Edwards EnterpriseOne Tools Chapter 10
Server Manager Guide Manage JDBC Drivers
108
JD Edwards EnterpriseOne Tools Chapter 11
Server Manager Guide Manage System Administration Tasks by Using
Administrative Orchestrations (Release 9.2.6)
Overview
The Server Manager system administrator can perform several system administration tasks by running system
administrative orchestrations, with only the Server Manager Console and AIS servers running and without any
dependency on other EnterpriseOne servers. For example, a system administrator can automatically bring up
the EnterpriseOne servers and perform administration tasks such as updating the Tools Releases or updating the
EnterpriseOne server configuration by running a system administrative orchestration even when the HTML, Database,
and Enterprise servers are down.
A system administrative orchestration is an orchestration that contains only these types of components: Open API-type
connectors connecting to a Server Manager Console Open API endpoint, rules, or child orchestrations with a similar
structure as the parent orchestration.
Prerequisites
To upload a system administrative orchestration to the Server Manager Console and run the orchestration, you must
ensure that:
For information about how to create orchestrations, see "Creating Orchestrations" in the JD Edwards
EnterpriseOne Tools Orchestrator Guide .
Orchestrations and orchestration components are saved and managed as user defined objects (UDOs) in JD
Edwards EnterpriseOne. For information about how to publish and share UDOs, see "Publishing UDOs" in the
JD Edwards EnterpriseOne Tools Using and Approving User Defined Objects Guide .
For information about how to export orchestrations, see "Exporting Orchestration Components from the
Orchestrator Studio" in the JD Edwards EnterpriseOne Tools Orchestrator Guide .
109
JD Edwards EnterpriseOne Tools Chapter 11
Server Manager Guide Manage System Administration Tasks by Using
Administrative Orchestrations (Release 9.2.6)
Note: You can upload only administrative orchestrations, which have been shared or published and then exported,
to the Management Console . An administrative orchestration is an orchestration that contains these types of
components: Open API-type connectors, rules, or child orchestrations.
3. On the Server Manager Offline Orchestration page, click the Browse button to locate and select the file that
contains the exported administrative orchestration components that you want to upload.
110
JD Edwards EnterpriseOne Tools Chapter 11
Server Manager Guide Manage System Administration Tasks by Using
Administrative Orchestrations (Release 9.2.6)
4. Click the Upload button to upload the selected file that contains the orchestration components.
The system displays a message that the orchestration has been imported successfully.
If you attempt to upload an orchestration that is not an administrative orchestration, the system displays a
warning message. The following image shows an example of a warning message that is displayed when you
attempt to upload a non-administrative orchestration:
After you upload an administrative orchestration to the Management Console , you can run the orchestration offline.
See Run Administrative Orchestrations.
111
JD Edwards EnterpriseOne Tools Chapter 11
Server Manager Guide Manage System Administration Tasks by Using
Administrative Orchestrations (Release 9.2.6)
For more information about running orchestrations, see "Testing Orchestrations" in the JD Edwards
EnterpriseOne Tools Orchestrator Guide .
On the Orchestrator Studio Home page, only the Run Orchestrations and Scheduler icons are enabled and all
the other orchestration component icons are disabled.
2. Click the Scheduler icon.
3. On the Scheduler user interface, select the orchestration job you want to start or stop and then perform either
of the following actions:
◦ To start the orchestration job, slide the toggle in the Started column to the right.
◦ To stop the orchestration job, slide the toggle in the Started column to the left.
For more information about the Scheduler, see "Working with Scheduler" in the JD Edwards EnterpriseOne
Tools Orchestrator Guide .
112
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
Note: Registration of an Oracle WebLogic Server requires that a Management Agent first be installed on the Oracle
WebLogic Server. This server must be installed with the correct user and also started with the correct user. Refer to
Installing the Server Manager Management Console and Agent.
1. Select the Managed Home where you want to register an Oracle WebLogic Server.
113
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
3. On Create/Register a Managed Instance, Instance Type, select the Oracle WebLogic Server 14c radio button.
114
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
5. On the Create/Register a Managed Instance screen for Instance Properties, complete these fields:
◦ Instance Name
Enter the installation location for the existing Oracle WebLogic Server. This is the Oracle WebLogic Home,
where the default value is:
C:\Oracle\Middleware
Enter the administrative user for the Oracle WebLogic Administrative Console on which this Managed
Instance will be created. The default admin user is:
Oracle WebLogic
◦ Oracle WebLogic Admin Password
Enter the administrative user for the Oracle WebLogic Administrative Console on which this Managed
Instance will be created.
6. Click the Continue button.
7. On the Create/Register a Managed Instance screen for Confirmation, there are no configuration items to
confirm.
115
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
9. On the Create/Register a Managed Instance screen for Finish, click the Create Instance button to complete the
registration of the Oracle WebLogic Server.
After you have completed the installation, the browser is redirected to the Management Console page for the newly
registered Oracle WebLogic Server. This server also appears as a Managed Instance within the corresponding Managed
Home.
For each registered Oracle WebLogic Server Managed Instance, the Management Console displays appropriate
information at the top of the web page:
General Properties
• Product Description
14.1.1.0.0
Instance Properties
• Instance Name
Displays a clickable link for the name assigned to the Oracle WebLogic Server Managed Instance at the time is
was created or registered.
116
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
Displays the complete path to the Oracle WebLogic Server Home where this Oracle WebLogic Server instance
was installed.
• Oracle WebLogic Administrative User
Displays the administrative user credential that is used by Server Manager to perform administrative tasks on
the Oracle WebLogic Server instance.
• Oracle WebLogic Administrative Password
Displays the administrative password credential that is used by Server Manager to perform administrative tasks
on the Oracle WebLogic Server instance.
You can click the Reset button and reset the administrative password.
Note: Registration of an Oracle WebLogic Server requires that a Management Agent first be installed on the Oracle
WebLogic Server. This server must be installed with the correct user and also started with the correct user. Refer to
Installing the Server Manager Management Console and Agent.
117
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
1. Select the Managed Home where you want to register an Oracle WebLogic Server.
118
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
3. On Create/Register a Managed Instance, Instance Type, select the Oracle WebLogic Server 12c radio button.
119
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
5. On the Create/Register a Managed Instance screen for Instance Properties, complete these fields:
◦ Instance Name
Enter the installation location for the existing Oracle WebLogic Server. This is the Oracle WebLogic Home,
where the default value is:
C:\Oracle\Middleware
◦ Oracle WebLogic Admin User
Enter the administrative user for the Oracle WebLogic Administrative Console on which this Managed
Instance will be created. The default admin user is:
Oracle WebLogic
◦ Oracle WebLogic Admin Password
Enter the administrative user for the Oracle WebLogic Administrative Console on which this Managed
Instance will be created.
6. Click the Continue button.
7. On the Create/Register a Managed Instance screen for Confirmation, there are no configuration items to
confirm.
120
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
9. On the Create/Register a Managed Instance screen for Finish, click the Create Instance button to complete the
registration of the Oracle WebLogic Server.
After you have completed the installation, the browser is redirected to the Management Console page for the newly
registered Oracle WebLogic Server. This server also appears as a Managed Instance within the corresponding Managed
Home.
For each registered Oracle WebLogic Server Managed Instance, the Management Console displays appropriate
information at the top of the web page:
General Properties
• Product Description
121
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
• Version
12.1.3.0.0
Instance Properties
• Instance Name
Displays a clickable link for the name assigned to the Oracle WebLogic Server Managed Instance at the time is
was created or registered.
• Oracle WebLogic Home
Displays the complete path to the Oracle WebLogic Server Home where this Oracle WebLogic Server instance
was installed.
• Oracle WebLogic Administrative User
Displays the administrative user credential that is used by Server Manager to perform administrative tasks on
the Oracle WebLogic Server instance.
• Oracle WebLogic Administrative Password
Displays the administrative password credential that is used by Server Manager to perform administrative tasks
on the Oracle WebLogic Server instance.
(Release 9.2.1)You can click the Reset button and reset the administrative password.
Note: Registration of an Oracle WebLogic Server requires that a Management Agent first be installed on the Oracle
WebLogic Server. This server must be installed with the correct user and also started with the correct user. Refer to
Installing the Server Manager Management Console and Agent.
122
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
1. Select the Managed Home with which you wish to register an Oracle WebLogic Server.
123
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
124
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
◦ Instance Name
Enter the installation location for the existing Oracle WebLogic Server. This is the Oracle WebLogic Home,
where the default value is:
/u01/Oracle/Middleware
Enter the administrative user for the Oracle WebLogic Administrative Console on which this Managed
Instance will be created. The default admin user is:
Oracle WebLogic
Enter the administrative user for the Oracle WebLogic Administrative Console on which this Managed
Instance will be created. For the default password refer to the /u01/Oracle/Middleware/utils/quickstart/
quickstart.sh program. Access the Start Administration Console option.
125
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the registration
of the Oracle WebLogic Server.
126
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
127
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
After you have completed the installation, the browser is redirected to the Management Console page for the newly
registered Oracle WebLogic Server. This server also appears as a Managed Instance within the corresponding Managed
Home.
For each registered Oracle WebLogic Server Managed Instance, the Management Console displays appropriate
information at the top of the web page:
• General Properties
◦ Product Description
10.3.6.0
128
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
• Instance Properties
◦ Instance Name
Displays a clickable link for the name assigned to the Oracle WebLogic Server Managed Instance at the
time is was created or registered.
◦ Oracle WebLogic Home
Displays the complete path to the Oracle WebLogic Server Home where this Oracle WebLogic Server
instance was installed.
◦ Oracle WebLogic Administrative User
Displays the administrative user credential that is used by Server Manager to perform administrative
tasks on the Oracle WebLogic Server instance.
◦ Oracle WebLogic Administrative Password
Displays the administrative password credential that is used by Server Manager to perform administrative
tasks on the Oracle WebLogic Server instance.
You can reset the administrative password using the Reset button. The following window is displayed
when you click the Reset button.
Enter the passwords in the fields, and click Change to confirm the new password.
129
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
Note: Registration of a WebSphere Application Server requires that a Management Agent first be installed on the
WebSphere Application Server. This server must be installed with the correct user and also started with the correct
user. Refer to Installing the Server Manager Management Console and Agent.
If you have enabled administrative security in a WebSphere Application Server profile, refer to Configure WebSphere
Application Server to Work With Server Manager When Administrative Security is Enabled in this section.
130
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
1. Select the Managed Home with which you wish to register the WebSphere Application Server.
131
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
2. Click the Create a New Managed Instance button to create the Managed Instance within the Managed Home
.
3. On Create/Register a Managed Instance, Instance Type, select the WebSphere Application Server 8.5/9.x
radio button.
132
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
◦ Instance Name
Enter the installation location for the existing WebSphere Application Server. This location should include
the path up to the parent folder of the profiles folder.
For example:
OS400 (IBM i)
/QIBM/ProdData/WebSphere/AppServer/V85/ND
Unix
/u01/WebSphere85/AppServer
5. Click Continue.
133
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
8. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the registration of
the WebSphere Application Server.
After you have completed the installation the browser is redirected to the Management Console page for the
newly registered WebSphere Application Server. This server also appears as a Managed Instance within the
corresponding Managed Home .
For each registered WebSphere Application Server Managed Instance , the Management Console displays
appropriate information at the top of the web page:
◦ Product Description
Displays the description for this WebSphere Application Server Managed Instance .
◦ General
- Version
Displays the full path for the install location of the selected WebSphere Application Server
Managed Instance .
- Instance Name
Displays a clickable link for the name assigned to the WebSphere Application Server Managed
Instance at the time is was created or registered.
134
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
WAS_Install_Location\profiles\Profile_Name\properties\soap.client.props
2. Modify these settings in the soap.client.props file:
com.ibm.SOAP.securityEnabled=true
com.ibm.SOAP.loginUserid=admin_user
com.ibm.SOAP.loginPassword=admin_password
Note: Registration of a WebSphere Application Server requires that a Management Agent first be installed on the
WebSphere Application Server. This server must be installed with the correct user and also started with the correct
user. Refer to Installing the Server Manager Management Console and Agent.
If you have enabled administrative security in a WebSphere Application Server profile, refer to Configure WebSphere
Application Server to Work With Server Manager When Administrative Security is Enabled in this chapter.
135
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
1. Select the Managed Home with which you wish to register the WebSphere Application Server.
136
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
2. Click the Create a New Managed Instance button to create the Managed Instance within the Managed Home
.
137
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
3. On Create/Register a Managed Instance, Instance Type, select the WebSphere Application Server 7.0 radio
button.
◦ Instance Name
Enter the installation location for the existing WebSphere Application Server. This location should include
the path up to the parent folder of the profiles folder.
For example:
/QIBM/ProdData/WebSphere/AppServer/V7/ND
Unix
/u01/WebSphere7/AppServer
5. Click Continue.
138
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
7. Click Continue.
139
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
8. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the registration of
the WebSphere Application Server.
After you have completed the installation the browser is redirected to the Management Console page for the
newly registered WebSphere Application Server. This server also appears as a Managed Instance within the
corresponding Managed Home .
For each registered WebSphere Application Server Managed Instance , the Management Console displays
appropriate information at the top of the web page:
◦ Product Description
Displays the description for this WebSphere Application Server Managed Instance .
◦ General
- Version
140
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
Displays the full path for the install location of the selected WebSphere Application Server
Managed Instance .
- Instance Name
Displays a clickable link for the name assigned to the WebSphere Application Server Managed
Instance at the time is was created or registered.
WAS_Install_Location\profiles\Profile_Name\properties\soap.client.props
2. Modify these settings in the soap.client.props file:
com.ibm.SOAP.securityEnabled=true
com.ibm.SOAP.loginUserid=admin_user
com.ibm.SOAP.loginPassword=admin_password
141
JD Edwards EnterpriseOne Tools Chapter 12
Server Manager Guide Register an Application Server
142
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
143
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
1. Select the existing Managed Instance for a running Oracle WebLogic Server Managed Instance with which you
wish to create a new Server.
144
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
145
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
2. In the Oracle WebLogic domains section, click on the link for the domain into which you want to create a new
Oracle WebLogic Server.
For example, in the above screen shot, the Oracle WebLogic Server Domain is E1_Apps.
146
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
147
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
3. In the J2EE Server section of the page, use the form to create a new J2EE Server instance within the Oracle
WebLogic Server domain by completing these fields:
◦ Server Name
Enter a unique port number. This Oracle WebLogic Server must listen on a port that is different from all
of the others servers in the domain.
◦ Machine
Use the pull-down to select an existing machine to which this Server is associated. The machine must
have already been created in the Oracle WebLogic Server Admin Console.
Note: All Servers created within Server Manager must be associated with a machine so that they can
be started and stopped through Server Manager.
4. After the above three (3) fields are complete, click the Create Server button.
148
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
5. On the J2EE Servers section of the page, select the J2EE Server that you just created and click the Start button.
Note: While technically you are not required to start the Oracle WebLogic domain, it is good practice to
ensure that it is properly created and able to start. Otherwise, it might not start as expected during the
installation process for a JD Edwards EnterpriseOne web-based server.
Tip: Server Manager displays a progress monitor indicating that the Start operation is in progress and will
continue even if you close the browser. After the progress monitor is no longer displayed, you can refresh the
Management Console page to verify that the newly-created Oracle WebLogic Domain starts as expected.
Note: If you do not install the JDBC drivers before installing the Web-Based Server Instance, the Web-Based Server
Instance will not be able to start as expected at the end of the installation. Refer to Install or Uninstall JDBC Drivers to
the J2EE Server (WLS or WAS).
149
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
1. Select the existing Managed Instance for a running WebSphere Application Server with which you wish to
create a new J2EE Server Container.
150
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
2. In the Profiles and Servers section of the page, click the on an existing Profile Name.
Tip: If you plan to use this J2EE Server Container to run a JD Edwards EnterpriseOne Business Services
Server , you should select a secure profile. This profile must be created and configured within the WebSphere
Application Server itself.
151
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
3. On the J2EE Servers section of the page, use the form to create a new J2EE Server Container, complete these
fields:
◦ Node Name
5. On the J2EE Servers section of the page, select the J2EE Server Container that you just created and click the
Start button.
Note: While you are not required to start the J2EE Server, it is good practice to ensure that it is properly
created and able to start. Otherwise, it might not start as expected during the installation process for a JD
Edwards EnterpriseOne web-based server.
Tip: The Server Manager displays a progress monitor indicating that the Start operation is in progress and
will continue even if you close the browser. After the progress monitor is no longer displayed, you can refresh
the Management Console page to verify that the newly-created J2EE Server starts as expected.
Note: If you do not install the JDBC drivers before installing the Web-Based Server Instance, the Web-Based Server
Instance will not be able to start as expected at the end of the installation. Refer to Install or Uninstall JDBC Drivers to
the J2EE Server (WLS or WAS).
152
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
In addition to and in conjunction with the procedure previously described in Manage JDBC Drivers this section
describes:
153
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
2. Use the JDBC Driver dropdown to select the JDBC driver to install.
Note: Only JDBC drivers that have been uploaded to the management console but are not currently installed
are displayed.
Server Manager installs the driver and adds it to the list of JDBC drivers that can be uninstalled.
154
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
1. From the JDBC Drivers section of the page, select the JDBC Driver Filename to be deleted.
2. Click the Uninstall button.
Note: If you Uninstall a JDBC driver, the J2EE Server (WLS or WAS) must be restarted in order to unload a memory
resident JDBC driver.
155
JD Edwards EnterpriseOne Tools Chapter 13
Server Manager Guide Create a J2EE Server Container
156
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
157
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
158
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
To start, stop, and restart an Oracle WebLogic Server, first select the server using the check box and then click the
appropriate button.
• Started
If the status is Started, you can select one or more application servers using the check box and then click the
Stop button to stop the WebSphere Application Server.
• Stopped
If the status is Stopped, you can select one or more application servers using the check box and then click the
Start or Restart button to start or restart the WebSphere Application Server.
Instance Properties
When you select an Oracle WebLogic Server Managed Instance, the top right portion of the page contains an Instance
Properties area that includes these fields:
• Instance Name
Identifies the name assigned to the managed instance at the time it was created or registered.
Displays the complete path to the Oracle Home where this Oracle WebLogic Server instance was installed. In
this example, the Oracle Home is:
159
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
Tip: You can determine the complete path to your Oracle Home by issuing the pwd command from the root
directory where your Oracle WebLogic Server is installed.
Displays the administrator user credential that you specified when creating the domain and is used by Server
Manager to perform administrative tasks on the Oracle WebLogic Server instance. By definition, all servers in
the same domain have the same administrative user and password.
This section includes a Save button that enables you to change your administrative user name.
• Oracle WebLogic Administrative Password
Displays the administrator password credential that you specified when creating the domain and is used by
Server Manager to perform administrative tasks on the Oracle WebLogic Server instance. By definition, all
servers in the same domain have the same administrative user and password.
This section includes a Save button that enables you to change your administrative user password.
160
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
When you click on the Managed Instance for your installed WebSphere Application Server, you can view the status of
the installed applications servers in the Application Servers column of the grid.
• Started
If the status is Started, you can select one or more application servers using the check box and then click the
Stop button to stop the WebSphere Application Server.
• Stopped
If the status is Stopped, you can select one or more application servers using the check box and then click the
Start or Restart button to start or restart the WebSphere Application Server.
161
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
162
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
• Profile Name
These are clickable links to existing profiles in the WebSphere environment. These profiles can only be created
using the WebSphere administration tool.
• Profile Path
Lists all applications servers associated with each profile. The status of the application servers is also shown. If
the status is Running, the display includes a clickable link to the application server.
163
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
Lists clickable links to EnterpriseOne servers that are deployed for this profile on this WebSphere application
server.
164
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
1. Select the existing Managed Instance for a running WebSphere Application Server with which you wish to
start, stop, or restart J2EE Server.
165
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
166
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
2. In the Profiles and Servers section of the page, click the Profile Name that contains the J2EE Server that you
want to start, stop, or restart.
Tip: The Server Manager displays a progress monitor indicating that the Start operation is in progress and
will continue even if you close the browser. After the progress monitor is no longer displayed, you can refresh
the Management Console page to verify that the J2EE Server is in the expected state.
167
JD Edwards EnterpriseOne Tools Chapter 14
Server Manager Guide Manage an Application Server and Related Components
168
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
Note: Registration of a Deployment Server requires that a Management Agent first be installed on the Deployment
Server. Refer to Installing the Server Manager Management Console and Agent.
1. Select the Managed Home with which you wish to register the Deployment Server.
169
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
2. Click the Create a New Managed Instance button to create the Managed Instance within the Managed Home.
3. On Create/Register a Managed Instance, Instance Type, select the Register an Existing Deployment Server radio
button.
4. Click Continue.
170
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
5. On Create/Register a Managed Instance, Instance Properties, complete these fields:
◦ Server Group
Use the dropdown to select the Server Group to which you want this instance to belong. Currently, the
only available option is 'default'.
◦ Instance Name
Enter a name in the Instance Name field. This field must be populated.
◦ Install Location
Enter a valid install location for the existing Deployment Server. This field must be populated. For
example:
C:\JDEdwards\E920
Note: The Deployment Server is only installed on the Microsoft Windows platform.
171
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
6. Click Continue.
172
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
173
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
7. Verify the configurations settings, then click Continue.
174
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the registration for
the Deployment Server.
After you have completed the installation, the browser is redirected to the Management Console page for the
newly registered Deployment Server. This server also appears as a Managed Instance in the corresponding
Managed Home .
For each registered Managed Instance , the Management Console displays appropriate information at the top
of the web page:
◦ General
- Status
Running
175
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
This status only indicates that Server Manager is able to communicate with the Management
Agent on the Deployment Server machine.
Stopped
This status only indicates that Server Manager is not able to communicate with the Management
Agent on the Deployment Server machine.
For information on log files, refer to the chapter entitled Available Log Files.
8. In the Oracle Database Settings section, make sure that the path in the Location filed points to the location
of the console. For example, /slot/ems6282/oracle/Middleware/jde_home_1/SCFMC/targets/home/config/
tnsnames.ora
9. In the File Content field for the Oracle Database, add the content in the TNSNAMES.ora file of your Database.
You can leave the field blank when connecting to a Microsoft SQL or an AS400 Database.
Example 1:
Navigate to the path C:\Oracle\E1Local\NETWORK\ADMIN, and then copy the section for the database that
you are using for EnterpriseOne and paste it in the File Content field.
176
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
Example 2:
Copy and paste the following section for the database that you are using for EnterpriseOne:
1. Sign in to the Server Manager console, and access the Deployment Server.
Note: The EnterpriseOne installers provided with Tools Release 9.2.9 are not compatible with those from the
previous Tools releases. Because of these incompatibilities, the 9.2.9 installers must be placed into empty
directories when the Deployment Server Component is updated by the Server Manager. To accomplish this
requirement, update the Server Manager Agent to 9.2.9 or higher before updating EnterpriseOne to Tools
Release 9.2.9 or higher. A change has been implemented in the Server Manager Agent that will place the
EnterpriseOne installers into empty directories (install and stage directories), and then copy the relevant
information from the old Development Client installer's oraparam.ini file into the new file. If the following
directories under the <E1_dep_svr_install_dir>\OneWorld Client Install directory exist, they are updated by the
Server Manager Agent.
◦ install
◦ stage
◦ ThirdParty\WLSH4A\install
◦ ThirdParty\WLSH4A\stage
◦ ThirdParty\WASH4A\install
◦ ThirdParty\WASH4A\stage
Important: Make sure to use 9.2.9 or higher oraparam.ini files (for Development Client, WLSH4A,
and WASH4A installers) and the H4A installers' response files (for example, WLSH4A_install.rsp and
WASH4A_install.rsp) during the installation.
177
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
2. Click the Change button.
You will see the following three new options at the bottom of the Change Tools Release window.
Selecting this option replaces the system and OneWorld Client Install directory without creating a backup of the
current system and the OneWorld Client Install directory.
This option:
◦ Replaces the system and the OneWorld Client Install with the new component.
◦ Copies the jdbj.ini, jas.ini, tnsnames.ora, and jdelog.properties from the old location to the new location.
◦ Copies the JRE into the system directory either from the current system\jre if it is the same bitness or
from the path entered by the user.
◦ Sets the PackageInfs and CurrentReleaseMasterPath entries in the oraparams.ini from the path in the
current oraparams.ini.
◦ Copies the jdbc directory to the OneWorld Client Install\ThirdParty\WebDevFeature directory from the
previous OneWorld client install.
◦ Copies the OneWorld Client Install\misc directory from the previous OneWorld client install.
◦ Resets the Desktop and Program File JDEdwards path.
◦ Resets any environment variable changes in the registry.
◦ Compresses the system into the systemcomp directory.
Selecting this option backs up the current system, systemcomp, and OneWorld Client Install into a version
directory, and replaces these directories with the new component.
This option:
◦ Backs up the current system, systemcomp, and OneWorld Client Install directory into a version directory
called 'foundation_<version>_<X86 or X64>'. For example, foundation_9.2.2.2_X86.
◦ Replaces the system and OneWorld Client Install with the new component.
◦ Copies the jdbj.ini, jas.ini, tnsnames.ora, and jdelog.properties from the old location to the new location.
◦ Copies the JRE into the system directory either from the current system\jre if it is the same bitness or
from the path entered by the user.
◦ Sets the PackageInfs and CurrentReleaseMasterPath entries in the oraparams.ini from the path in the
current oraparams.ini.
◦ Copies the jdbc directory to the OneWorld Client Install\ThirdParty\WebDevFeature directories from the
previous OneWorld Client Install.
◦ Copies the OneWorld Client Install\misc directory from the previous OneWorld client install.
◦ Resets the desktop and Program File JD Edwards path.
◦ Resets any Environment variable changes in the registry.
◦ Compresses the system into the systemcomp directory.
◦ Changes all the <package name> .inf files that point to the default system to the version directory.
◦ Updates any package .inf files that points to the default system to point to the version directory.
178
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
◦ Populates the F9883 table with a new Foundation item with the path pointing to the version directory.
◦ Updates the package record in the F9631 table to have a Foundation item if any package .inf files were
changed.
Selecting this option downloads the new component into a version directory.
This option:
179
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
3. To download a 64-bit component, select the option Component download for multi-foundation Only, and then
click the Change Component button.
180
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
5. On the login window, enter the Username and Password for the SYSTEM Datasource tables such as F00942,
and then click the Login button.
6. On the 64-bit JRE path, specify the path to the 64-bit JRE home directory, and then click the OK button to
download the 64-bit component to a 64-bit version directory.
181
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
7. Verify the following to make sure that the component was downloaded successfully to a version directory such
as 'foundation_9.2.3.0_X64'. The version directory will have a:
◦ New system directory.
◦ New systemcomp directory.
◦ OneWorld client Install directory.
8. In the Oracle Database Settings section, make sure that the path in the Location field points to the location
of the console. For example, /slot/ems6282/oracle/Middleware/jde_home_1/SCFMC/targets/home/config/
tnsnames.ora
9. In the File Content field for the Oracle Database, add the content in the TNSNAMES.ora file of your database.
You can leave the field blank when connecting to a Microsoft SQL or an AS400 Database.
Example 1:
C:\Oracle\E1Local\NETWORK\ADMIN, and copy the section for the database that you are using for
EnterpriseOne.
Example 2:
ems6282 = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = den60212jems)(PORT =
1603)) ) (CONNECT_DATA = (SID = ems6282) (SERVER = DEDICATED) ) )
182
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
ORACLR_CONNECTION_DATA =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))
)
(CONNECT_DATA =
(SID = CLRExtProc)
(PRESENTATION = RO)
)
)
10. Click the Save button.
11. Log off, and then log in again to Server Manager.
When you change the component for the Deployment Server you are presented with three options. When selecting
the first two; No multi-foundation, component change only or Component change and backup current system for
Multi-foundation, you can have 9.2.4.x 64-bit be installed as the default system. If you select a 64-bit component prior
to 9.2.4.0, it will install the Deployment Server as multi-foundation. You can select 9.2.4.0 32-bit or 64-bit as default
system. If you select 9.2.3.x 64-bit, it will install as multi-foundation regardless of the option selected.
183
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
◦ Sets the Package.Infs, CurrentReleaseMasterPath, SourceTnsnamePath, DataByPathCode, and
ConfigToolTimeoutMins entries in the oraparams.ini from the path in the current oraparams.ini.
◦ Copies the jdbc folder to the OneWorld Client Install\ThirdParty\WebDevFeature folders from the
previous OneWorld Client install.
◦ Copies the OneWorld Client Install\misc folder from the previous OneWorld client install.
◦ Resets the Desktop and Program File JDEdwards path.
◦ Resets any environment variable changes in the registry.
◦ Compresses the system into the systemcomp folder.
◦ Copies in new CD Templates\ESU and ASU files.
◦ Verifies the path in the jde.ini for InprocessJVMHome is valid.
Selecting this option backs up the current system, systemcomp, and OneWorld Client Install into a version
directory and replaces these directories with the new component.
This option:
◦ Backs up the current system, systemcomp, and OneWorld Client Install directory into a version directory
called foundation_<version>_<X86 or X64, for example, foundation_9.2.2.2_X86.
◦ Replaces the system and OneWorld Client Install with the new component.
◦ Copies the jdbj.ini, jas.ini, tnsnames.ora, and jdelog.properties from the old location to the new location.
◦ Deletes the Oneworld Client Install\thirdparty\OEE and the Oneworld Client Install\thirdparty\SSE
folders.
◦ Copies the JRE into the system folder either from the current system\jre if it is the same bitness or from
the path you entered.
◦ Sets the PackageInfs, CurrentReleaseMasterPath, SourceTnsnamePath, DataByPathCode, and
ConfigToolTimeoutMins entries in the oraparams.ini from the path in the current oraparams.ini.
◦ Copies the jdbc folder to the OneWorld Client Install\ThirdParty\WebDevFeature folders from the
previous OneWorld Client Install.
◦ Copies the OneWorld Client Install\misc folder from the previous OneWorld Client install.
◦ Resets the desktop and Program File JD Edwards path.
◦ Resets any Environment variable changes in the registry.
◦ Compresses the system into the systemcomp folder.
◦ Copies in the new CD Templates\ESU and ASU files.
◦ Verifies the path in the jde.ini for InprocessJVMHome is valid.
◦ Changes the <package name> .inf files that point to the default system to the version directory.
◦ Populates the F9883 table with a new Foundation item with the path pointing to the version directory.
◦ Updates the package record in the F9631 table to have a Foundation item if any package .inf files were
changed.
Downloads the new component into a version directory and updates the settings needed to install this system
with a package.
184
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
This option:
5. On the login window, enter the username and password for the SYSTEM data source an click the Login button.
185
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
6. On the 64-bit JRE path, specify the path to the 64-bit JRE home directory, and then click the OK button.
Note: The previous default 32-bit foundation will be backed up to a version directory.
186
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
6. Save the jde.ini file.
Note: For Tools Releases prior to 9.2.5.0 , clicking the Start and Stop buttons has no effect.
187
JD Edwards EnterpriseOne Tools Chapter 15
Server Manager Guide Register a JD Edwards Deployment Server as a New
Managed Instance
188
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
CAUTION: Not all JD Edwards EnterpriseOne Applications and Tools releases support various Visual Studio versions.
Refer to the JD Edwards EnterpriseOne Certifications (MTRs) and Package Management Guide for support levels.
The JD Edwards EnterpriseOne Administrator can navigate to the Compiler Selection screen by navigating to the
Enterprise Server Instance and clicking the Package Builds link.
As shown below, the supported and detected versions of Visual Studio on Microsoft Windows-based JD Edwards
EnterpriseOne Enterprise Server. The Administrator can select the appropriate version of Visual Studio and click the
Apply button. As a result, Server Manager updates the entries in the [JDE_CG] section and [BSFN BUILD] section of the
jde.ini file.
189
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
190
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
Only JD Edwards EnterpriseOne Enterprise Servers that are registered with the Management Console can be managed
by the Management Console . The Enterprise Server may have been installed using the Platform Pack installer or
manually created outside of Server Manager . Regardless of the method of creation, any Enterprise Server running
Tools Release 8.97 (and later), including multi-foundation Enterprise Servers, is fully supported.
Note: Registration of an Enterprise Server requires that a Management Agent first be installed on Enterprise Server.
Refer to Installing the Server Manager Management Console and Agent.
Registration of Tools Release prior to 8.97 is only intended to facilitate an upgrade to Tools Release 8.97 (and later). Once
you have upgraded to Tools Release 8.97 and later you cannot use Server Manager to revert to a release prior to the
base release of Tools Release 8.97. If you want to run simultaneous releases of 8.97 (and later) and releases prior to 8.97,
you should use Multiple Foundations, which is described in the JD Edwards EnterpriseOne Tools Release 9.2 Reference
Guide.
191
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
1. Select the Managed Home with which you wish to register the Enterprise Server.
192
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
2. Click the Create a New Managed Instance button to create the Managed Instance within the Managed Home .
193
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
4. Click Continue.
194
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
5. On Create/Register a Managed Instance, Instance Properties, complete these fields:
◦ Server Group
Use the dropdown to select the Server Group to which you want this instance to belong.
◦ Instance Name
Enter a valid install location for the existing Enterprise Server. For example:
UNIX:
/u02/jdedwards/e920
Windows:
c:\jdedwards\e920
For both Windows and UNIX, you must specify the Install Location as the full path.
IBM i:
e900SYS
IBM i Enterprise Servers. These systems do not require a full path. Instead, you should only enter the
library name that corresponds to the IFS directory in which JD Edwards EnterpriseOne is installed.
Ensure that there are no slash characters in the Install Location.
Based on this Install Path, the requested path code libraries and IFS directories are created accordingly by
appending the addendum at the end of the pathcodes. For example,
E920SYS will create the requested path codes in this format: DV920 , PY920, PS920, PD920.
E920SYS_1 will create the requested path codes in this format: DV920_1 , PY920_1, PS920_1, PD920_1
E920SYS_A will create the requested path codes in this format: DV920_A , PY920_A, PS920_A, PD920_A
195
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
6. Click Continue.
7. On Create/Register a Managed Instance, Confirmation, review the key configuration items, where the web page
displays a variety of fields depending on the database and environments of your installation
Note: If the server was installed using the Platform Pack installer, typically you are not required to perform
further configuration. Server Manager reads these values from the existing Enterprise Server installation;
they are valid if the Enterprise Server was functioning properly at the time of registration.
196
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
8. Click Continue.
197
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the registration of
the Enterprise Server.
After you have completed the installation, the browser is redirected to the Management Console page for the
newly registered Enterprise Server. This server also appears as a Managed Instance in the corresponding
Managed Home .
You must re-link the Business Functions after you install the 9.2 or later Tools Release to an IBM i-based
Enterprise Server using the Server Manager. For instructions, refer to the chapter entitled: Re-Linking Business
Functions in the JD Edwards EnterpriseOne Tools Release 9.2 Reference Guide.
198
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
For each registered Managed Instance , the Management Console displays appropriate information at the top
of the web page:
◦ General
Running
Stopped
Install Location
Displays the full path for the install location of the selected Managed Instance .
Instance Name
Displays a clickable link for the name of the selected Managed Instance .
For information on log files, refer to the chapter entitled Available Log Files.
To create an Enterprise Server as a new Managed Instance using Server Manager , you must obtain the appropriate
Enterprise Server software components either directly from the Management Console or from Customer Connection
using Change Assistant. There are two software components needed. The foundation(system) par file and the
application .par file from a Package Build. The Managed Software Components must be uploaded to the Management
199
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
Console and distributed to the Management Agent to which you wish to install the new Enterprise Server. For additional
information, refer to Managed Software Components.
1. Select the Managed Home with which you wish to create the Enterprise Server as a new Managed Instance .
200
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
2. Click the Create a New Managed Instance button to create the Managed Instance in the Managed Home .
201
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
4. Click Continue.
202
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
5. On Create/Register a Managed Instance, Instance Properties, complete these fields:
◦ Server Group
Use the dropdown to select the Server Group to which you want this instance to belong.
◦ Instance Name
For both Windows and UNIX, you must specify the Install Location as the full path.
IBMi:
E920SYS
IBMi Enterprise Servers. These systems do not require a full path. Instead, you should only enter the
library name that corresponds to the IFS directory in which JD Edwards EnterpriseOne is installed. Ensure
that there are no slash characters in the Install Location.
Based on this Install Path, the requested path code libraries and IFS directories are created accordingly by
appending the addendum at the end of the pathcodes.
For example,
- E920SYS will create the requested path codes in this format: DV920 , PY920, PS920, PD920.
- Addendum ‘_1’ creates E920SYS_1 with the requested path codes in this format: DV920_1 , PY920_1,
PS920_1, PD920_1.
- Addendum ‘_A’ creates E920SYS_A with the requested path codes in this format: DV920_A ,
PY920_A, PS920_A, PD920_A.
◦ Foundation Component
Select the required application component from the drop down menu that was created by package build.
Use the drop-down menus to select the foundation and application components from the list of
Enterprise Server components distributed to this Management Agent .
◦ Path Code
Pathcode built in the component will be automatically selected unless this is a PS package then all
pathcodes are available to be selected. This is used for One-Click provisioning.
203
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
6. Click Continue.
Validate or update the configuration items. Use the help which directs you to the setting in the ini file.
(Release 9.2.7.0) For IBMi, ensure that you fill out the Application Path Addendum under Installation
section. This will identify the Tools Release (example: 'E920SYS<addendum>') with the pathcode (example:
'DV920<addendum>, PY920<addendum>').
7. On Create/Register a Managed Instance, Confirmation, review the key configuration items. The web page
displays a variety of fields depending on the database and environments of your installation.
204
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
8. Click Continue.
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the installation of
the Enterprise Server.
After you have completed the installation, the browser is redirected to the Management Console page for the
newly registered Enterprise Server. This server also appears as a Managed Instance in the corresponding
Managed Home .
Beginning with Release 9.2.7.0, IBMi-based Enterprise servers do not need to re-link the business functions.
This is automatically done once the installation is complete.
Prior to Release 9.2.7.0 to an IBMi -based Enterprise Server, as in previous JD Edwards EnterpriseOne Tools
Releases, you must re-link the Business Functions.
For instructions, refer to the chapter entitled: Re-Linking Business Functions in the JD Edwards EnterpriseOne
JD Edwards EnterpriseOne Deployment Server Reference Guide Reference Guide.
205
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
For each registered Managed Instance , the Management Console displays appropriate information at the top of the
web page:
• General
206
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
◦ E1 Application Component Version (Release 9.2.1)
◦ Install Location
Displays the full path for the install location of the selected Managed Instance .
◦ Instance Name
Displays a clickable link for the name of the selected Managed Instance .
For information on log files, refer to the chapter entitled: Available Log Files.
Make changes to the jde.ini file as shown in the following example to get the Enterprise Server up and running by
pointing it to an existing Database Server. These ini file changes may be different depending on the environment you
are using.
DatabaseName2=SVM920
Default Env=DV920
Default PathCode=DV920
Default Pwd=JDE
Default Role=*ALL
Default User=JDE
Server=DENQAS7
ServerPort=0
[JDENET]
serviceNameConnect=6099
207
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
serviceNameListen=6099
[SECURITY]
DataSource=System - 920
SecurityServer=DENQAS1
[SVR]
ApplicationPathAddendum=_I
SpecPath=spec
[WORKFLOW]
WRIPassword=JDE
[SITE_KEYS]
CurrentKey=ADGkvS9o6gamyEF5Uwrqh7M54AX1mfNypjsLrksh4uiK4XG4bdgidkEkKqyOcXjwmYzCEfpsNnogl6tosZae0=
Note: See the section 14.2.1, "Setting Up the Password" to set up the password for the Enterprise server component
change. Starting with Tools Release 9.2.6.0, the pathcode directory structure has changed to support the no lock
on kernels during the deploy of the package. When there is a change component going from a Tools release prior
to 9.2.6.0 to a Tools Release starting with 9.2.6.0, the directories under each pathcode for that Instance will change.
The dll/.so under the <pathcode>/bin64 will now be under a <pathcode>/bin64/<package name>. For IBMi, the
SVRPGM are under the package name library and not the pathcode library. The spec.ini is now under 2 locations, the
<pathcode>/spec and <pathcode>/spec/<packagename>. The <pathcode>/spec/spec.ini references the deployed
package. The <pathcode>/spec/<packagename>/spec.ini references the Central Objects Data source. The TAM files,
dddict, ddtext and glbltbl are now under <pathcode>/spec/<packagename>. If you go back to a Tools Release prior to
9.2.6.0, it will restructure the pathcode directory back to the original way.
1. Sign in to the Server Manager console, and access the Enterprise Server.
208
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
2. Click the Change button.
For IBM i starting with Tools Release 9.2.6.0, the component change links the business function at the end
of the change if you select the Link the business functions option during the component change. After the
change is complete, you must wait until the linking of the business functions are complete before starting the
EnterpriseOne services.
209
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
3. Select the EnterpriseOne Enterprise Server 9.2.3.0_X64 option to change your component from 32-bit to 64-bit.
For IBM i, starting with Tools Release 9.2.6.0, an alert message is displayed to remind you to link the business
function at the end of the change if you did not select the Link the business functions option or to ensure that
the linking of the business function is complete before starting EnterpriseOne.
4. On the login window, enter the Username and Password for the Database Server, and then click the Login
button.
Note: Ensure that you have set the password correctly. For more information see Section 14.2.1, "Setting Up
the Password".
5. On the window that is displayed, as shown in the following image, click the OK button to change the Enterprise
Server Foundation from 32-bit to 64-bit.
210
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
6. On the window that is displayed, as shown in the following image, click the OK button.
Note: This message is displayed only if your Enterprise Server requires an Oracle Client.
7. On the 64-bit Database Client home directory window, enter the correct path, and then click the OK button.
Note: Make sure that the 64-bit Database Client install directory has permissions to allow the Server
Manager Agent to read and write contents into it's files. If you are on Unix, make sure that the system user
has the permission to start the SVM Agent process.
211
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
8. On the 64-bit JRE Path window, enter the correct path, and then click the Submit button.
9. (Release 9.2.7.0) If the new component is of version 9.2.7.0 or newer, the old version is older than 9.2.7.0, and the
Enterprise server is Windows with an Oracle database, you will see this popup to enter the path to the Oracle
Database.
10. With Release 9.2.7.0 and newer, a Database Driver is needed on the Enterprise Server. The change component
will check if the driver is already uploaded in the E920 misc folder on the Enterprise server. If there are no
drivers uploaded, you will see this alert message.
After the install, navigate to the Database Driver -> Driver Type -> Enterprise Servers Utilizing Driver to
upload and install the necessary driver to the Enterprise Server. For any Enterprise Server component change,
you will see this message until you upload the drivers.
212
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
11. Wait for the process to complete.
12. Verify that the component change is successful on the EnterpriseOne Enterprise Server window.
213
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
13. Verify that the values in the Installation, Package Builds, and JVM Location in the Miscellaneous section are
updated with the 64-bit information.
Note: To revert to a 32-bit component, access the Change Component window, and select a 32-bit
component that ends with _X86.
Note: Starting with Tools Release 9.2.8.2, your installed and custom fonts stored in the location <System
directory>/resource/truetype are retained by the system. In case of fonts that have duplicate names, the
system overrides the installed fonts with the fonts shipped with EnterpriseOne. The fonts that are no longer
supported by EnterpriseOne must be deleted manually.
To enable communication between Enterprise servers and database servers using TLS, perform the following
configuration steps on the Enterprise Server instance in the Server Manager Console:
Navigate to Enterprise Server Instance > Configuration > Advanced > Database > Bootstrap Datasource. Enter the
secured port number in the Database TCP/IP Port field.
The Database TCP/IP Port field is not applicable to AS/400 database and is not displayed when AS/400 database is
selected.
Note: You must update the Database TCP/IP Port field for IBM UDB and Oracle Database. However, AS/400 and MS
SQL Server have default Database TCP/IP Port and updating the Database TCP/IP Port field is not required.
214
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
Navigate to Enterprise Server Instance > Configuration > Advanced > Java Runtime Properties > JDBj Bootstrap
Datasource. Enter the secured port number in the Database TCP/IP Port field.
Navigate to Enterprise Server Instance > Configuration > Advanced > Java Runtime Properties > JDBj Runtime
Properties. Use the drop-down menu to select true for the Use TLS field.
Starting with Tools Release 9.2.7.3, you can enable TLS for communication between Deployment Server and database
servers.
To enable communication between Deployment Server and database servers using TLS, perform the following
configuration steps on the Deployment Server instance in the Server Manager Console.
To use secured database port in Database Configuration for Deployment Server, navigate to Deployment Server
Instance > Configuration > Advanced > Database > Bootstrap Datasource. Enter the secured port number in the
Database TCP/IP Port field.
215
JD Edwards EnterpriseOne Tools Chapter 16
Server Manager Guide Register or Create a JD Edwards Enterprise Server as a New
Managed Instance
Note: You must update the Database TCP/IP Port field for IBM UDB and Oracle Database. However, AS/400 and MS
SQL Server have default Database TCP/IP Port and updating the Database TCP/IP Port field is not required.
216
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note: Please make sure HTTP Server install location doesn't contain the Space.
Refer to JD Edwards EnterpriseOne HTML Web Server Reference Guide for details on installing and configuring
WLS and WAS.
3. Prerequisite: The Web-Based Server Software Component is uploaded to the Management Console.
Note: Exception. There is no Software Component available or required for creating the Business Services
Server.
4. Prerequisite: The Web-Based Server Software Component is distributed to the Managed Home.
Note: Exception. There is no Software Component available or required for creating the Business Services
Server.
5. Register an Application Server (WAS or WLS) to create a new Managed Instance for an Application Server in the
target Managed Home.
For WAS 8.5 or WAS 9, refer to Register a WebSphere Application Server, Version 8.5.5.0/9.0.
For WAS 7.0, refer to Register a WebSphere Application Server, Version 7.0.
217
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
6. Create a J2EE Container (WLS) or J2EE Server (WAS) in the Application Server.
Note: There is a one-to-one relationship between a web-based server and a J2EE container. You cannot
install more than one web-based server in each J2EE container.
For WAS 8.5 or WAS 9, refer to Register a WebSphere Application Server, Version 8.5.5.0/9.0.
For WAS 7.0, refer to Register a WebSphere Application Server, Version 7.0.
7. Install JDBC drivers to the J2EE Server (except Collaborative Portal Server).
Note: If you do not install the JDBC drivers before installing the Web-Based Server Instance, the Web-Based
Server Instance does not start as expected at the end of the installation unless the server already has a
bundled JDBC driver as part of the install.
Refer to:
• Create a HTML Web Server as a New Managed Instance
• Create a Transaction Server as a New Managed Instance
• Create a Collaborative Portal Server as a New Managed Instance
• Create a Business Services Server as a New Managed Instance
WebSphere Security Consideration for Federated Servers. For WebSphere Federated Servers only, if Administrative
Security is turned on for the profile containing the deployment manager, you must turn it OFF before proceeding
with the creation of the Managed Instance for the HTML Web Server . After disabling security, you must restart the
deployment manager. All nodes in the management domain will also have to be restarted and resynchronized. The
Management Agent to which the WebSphere Application Server is registered must also be restarted. For additional
details, refer Post Install for a Federated Server in Network Deployment Mode to in this chapter.
See Also
• Prerequisites and Recommended Installation Sequence for Managed Instances for Web-Based Server Instances
• JD Edwards EnterpriseOne HTML Web Server Reference Guide for details on installing and configuring WLS or
WAS and additional tasks and topics related to Server Manager .
218
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
To install an JD Edwards EnterpriseOne HTML Web Server instance:
1. Select the Managed Home in which you wish to install the HTML Web Server .
219
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
2. Click the Create a New Managed Instance button to create the Managed Instance in the Managed Home .
220
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
4. Click Continue.
Note: The Propagate Enterprise Server Config drop-down appears only if any enterprise server is registered
within the Server Manager console. The Propagate Enterprise Server Config drop-down contains the available
enterprise server instances registered with the SM console within a particular selected server group. NONE is
added to the drop-down by default.
221
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
5. On Create/Register a Managed Instance, Instance Properties, complete these fields:
◦ Server Group
Use the dropdown to select the Server Group to which you want this instance to belong.
Tip: A good business practice is to name your instances so that they are easily and consistently
identifiable. For example: PRODUCT_SERVER_PORT where PRODUCT is the JD Edwards EnterpriseOne server
type, such as Enterprise_Server, HTML_Web_Server, RTE_Transaction_Server, Collaborative_Portal, or
Business_Services, and where SERVER is the machine on which the instance is installed, and where PORT
is the HTTP port which is defined for use by this server.
◦ J2EE Server
You must ensure that the port that you specify is available and is not being used by any other application
currently installed and running on the server on which the application server is running.
Note:
- Verify HTTP Ports
- HTTP Ports on UNIX Operating Systems
◦ Software Component
Use the dropdown to select the version of this Software Component that you wish to install.
◦ Propagate Enterprise Server Config
Select the enterprise server from the drop-down list to propagate the configurations.
Note: By default, the selected item is set to NONE. Selecting NONE signifies that you do not wish to
propagate configurations from any available enterprise server. If any enterprise server is selected, all of
the inherited values are seen in the next screen, otherwise the properties are seen with blank/default
values. If propagated, the propagated values are not editable on the confirmation page, however they
can be modified post installation.
222
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
6. Click Continue.
223
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
224
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note: This example illustrates an installation on a WebSphere Application Server by selecting an enterprise
server to be propagated. If installing on WLS, the HTTP Server (WAS Only) field is not displayed.
225
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
226
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note: This example illustrates an installation on a WebSphere Application Server by selecting NONE under
Propagate Enterprise Server Config. If installing on WLS, the HTTP Server (WAS Only) field is not displayed.
227
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
7. On Create/Register a Managed Instance, Confirmation, review the key configuration items. The page displays
a variety of fields depending on your application server (WAS or WLS). The values on this form must be
confirmed manually. You must validate or update, as appropriate, all configuration items.
Tip: For help, click the Information icon next to the title of a field.
Note:
◦ Configure the Default Server Group Configuration Settings
8. After you have validated and updated all configuration items, click Continue to proceed to the next installation
step.
228
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the installation of
the HTML Web Server .
After you have completed the installation, the browser is redirected to the Management Console page for
the newly registered HTML Server. This server also appears as a Managed Instance in the corresponding
Managed Home .
For each registered Managed Instance , the Management Console displays appropriate information at the top
of the page:
◦ General
- Status
Running
Stopped
229
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note: Start or Stop a Managed EnterpriseOne Software Component
◦ Instance Properties
- Instance Name
The name assigned to the Managed Instance at the time it was created or registered.
- HTTP Port
Displays the HTTP Port for this server and also provides a link to the HTTP server.
- Application Server Instance
Displays the application server into which this EnterpriseOne server is installed and also provides
a link to the application server instance and associated domain (Oracle webLogic Server) or profile
(WebSphere Application Server).
Note: The display of some information is dependent on the status of the Managed Instances . For example, if a
Managed Instance is not running, then the Software Component information cannot be displayed.
For information on log files, refer to the chapter entitled: Available Log Files.
Do not click the Synchronize Configuration button yet. Follow the steps in this section.
To install a HTML Web Server HTML Web Server to a WebSphere Federated Server in Network Deployment Mode:
Note: Steps 1 and 3 below are only applicable if the J2EE server you selected to create the HTML Web Server
managed instance resides on a machine different that the deployment manager. The remainder of the steps are
applicable to all federated deployments. You may ignore steps 2 and 4 if the federated server you selected resides on
the same machine as the deployment manager.
1. If you are using an Oracle database, configure the tnsnames.ora setting using these steps:
230
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
a. Use this navigation path for the Managed Instance you just created in Server Manager :
Configuration > JDBJ Database Configuration > Oracle Database Settings > TNSNAMES.ORA Location
b. Configure the setting to tnsnames.ora without the full file path.
For example:
2. If you have not already done so, install the JDBC driver to the J2EE container. Refer to Install JDBC Drivers to
J2EE Servers in this guide.
231
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
3. After installing the JDBC driver, you must modify the WebSphere JDBC provider as described in these steps:
a. Copy the JDBC driver file(s) appropriate to your database to a location on the physical machine on which
the federated server resides. For example:
/u01/JDBCDriver
b. Use these steps to modify the JDBC provider for the remote J2EE container in WebSphere to point to the
driver file in this new location.
i. In the WebSphere Administrative Console (for the deployment manager), navigate to the section called
JDBC Providers as shown in this screen:
232
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
ii. Complete the filter fields with the appropriate Cell, Node and Server information for the J2EE Container
to which the HTML Web Server was deployed.
For example:
iv. On JDBC Providers, click on the appropriate JDBC provider for the database which you are using with
HTML Web Server .
233
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note: The preceding example screen assumes an Oracle database.
v. Replace the path to the JDBC driver files as configured by Server Manager to the machine-specific
path where you previously placed the drivers. Refer to the preceding Step 3 where you copied the JDBC
234
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
driver file(s) appropriate to your database to a location on the physical machine on which the federated
server resides.
This example screen assumes Oracle JDBC driver files were placed in the location /u01/JDBCDriver:
vi. Click the OK button to save the configuration change and initiate node synchronization through the
deployment manager.
c. This completes the modification of the WebSphere JDBC provider.
235
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
4. Configure the HTTP Server by copying the appropriate text:
JDE_HOME/targets/e1_html_server_instance_name/Readme.txt
to this file:
The httpd.conf file of the HTTP server you wish to use for this Managed Instance .
You must modify the path to the Readme.txt file to reflect the JDE_HOME location and the Managed Instance
name in your environment. This is an example of a properly configured Readme.txt file:
236
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
5. Make any other configuration changes required to define this Managed Instance .
6. In Server Manager , navigate to the page for the Managed Instance and click on the Synchronize Configuration
button.
The synchronization process may take a few minutes to complete. The JD Edwards EnterpriseOne Managed
Instance is configured and ready to use after the preceding steps have been completed.
For any subsequent configuration changes made to this Managed Instance , Management Console re-displays the
Synchronize Configuration button with the corresponding warning message. You must click the button to apply the
configuration changes to the remote server. After the changes are applied, the Management Console no longer
displays the button and warning message.
237
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note:
• Prerequisites and Recommended Installation Sequence for Managed Instances for Web-Based Server Instances
• Refer to the JD Edwards EnterpriseOne Transaction Server Reference Guide for details on additional tasks and
topics related to Server Manager .
1. Select the Managed Home in which you wish to install the Transaction Server.
2. Click the Create a New Managed Instance button to create the Managed Instance in the Managed Home .
238
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
239
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
4. Click Continue.
Note: The Propagate Enterprise Server Config drop-down appears only if any enterprise server is registered
within the Server Manager console. The Propagate Enterprise Server Config drop-down contains the available
enterprise server instances registered with the SM console within a particular selected server group. NONE is
added to the drop-down by default.
240
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
5. On Create/Register a Managed Instance, Instance Properties, complete these fields:
◦ Server Group
Use the dropdown to select the Server Group to which you want this instance to belong.
Tip: A good business practice is to name your instances so that they are easily and consistently
identifiable. For example: PRODUCT_SERVER_PORT where PRODUCT is the JD Edwards EnterpriseOne server
type, such as Enterprise_Server, HTML_Web_Server, RTE_Transaction_Server, Collaborative_Portal, or
Business_Services, and where SERVER is the machine on which the instance is installed, and where PORT
is the HTTP port which is defined for use by this server.
◦ J2EE Server
You must ensure that the port that you specify is available and is not being used by any other application
currently installed and running on the server on which the application server is running.
Note:
- Verify HTTP Ports
- HTTP Ports on UNIX Operating Systems
◦ Software Component
Use the dropdown to select the version of this Software Component that you wish to install.
◦ Propagate Enterprise Server Config
Select the enterprise server from the drop-down list to propagate the configurations.
Note: By default, the selected item is set to NONE. Selecting NONE signifies that you do not wish to
propagate configurations from any available enterprise server. If any enterprise server is selected, all
of the inherited values are seen in the next scree, otherwise the properties are seen with blank/default
values. If propagated, the propagated values are not editable on the confirmation page, however they
can be modified post installation.
241
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
6. Click Continue.
242
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note: This example illustrates an installation on a WebSphere Application Server by selecting an enterprise
server to be propagated. If installing on WLS, the HTTP Server (WAS Only) field is not displayed.
243
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
244
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note: This example illustrates an installation on a WebSphere Application Server by selecting NONE under
Propagate Enterprise Server Config. If installing on WLS, the HTTP Server (WAS Only) field is not displayed.
7. On Create/Register a Managed Instance, Confirmation, review the key configuration items. The page displays
a variety of fields depending on your application server (WAS or WLS). The values on this form must be
confirmed manually. You must validate or update, as appropriate, all configuration items.
Tip: For help, click the Information icon next to the title of a field.
Note:
◦ Configure the Default Server Group Configuration Settings
245
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
8. After you have validated and updated all configuration items, click Continue to proceed to the next installation
step.
246
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the installation of
the Transaction Server.
After you have completed the installation, the HTTP server associated with the J2EE Server (WAS) must
be restarted manually. If you do not restart the HTTP server, you will not be able to login to JD Edwards
EnterpriseOne .
After you have completed the installation, the browser is redirected to the Management Console page for the
newly registered Transaction Server. This server also appears as a Managed Instance in the corresponding
Managed Home .
For each registered Managed Instance , the Management Console displays appropriate information at the top
of the page:
◦ General
- Status
Running
Stopped
247
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
When the status is Stopped, the Start button is available.
◦ Instance Properties
- Instance Name
The name assigned to the Managed Instance at the time it was created or registered.
- HTTP Port
Displays the HTTP Port for this server and also provides a link to the HTTP server.
- Application Server Instance
Displays the application server into which this EnterpriseOne server is installed and also provides
a link to the application server instance and associated domain (Oracle WebLogic Server) or profile
(WebSphere Application Server).
For information on log files, refer to the chapter entitled: Available Log Files.
The WebSphere 7.0 or 8.5 installation must also include an HTTP Server.
Note:
• Prerequisites and Recommended Installation Sequence for Managed Instances for Web-Based Server Instances
• Refer to the JD Edwards EnterpriseOne Collaborative Portal Server Reference Guide for details on additional
tasks and topics related to Server Manager .
1. Select the Managed Home in which you wish to install the Collaborative Portal Server.
248
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
249
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
2. Click the Create a New Managed Instance button to create the Managed Instance in the Managed Home .
250
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
4. Click Continue.
◦ Server Group
Use the dropdown to select the Server Group to which you want this instance to belong.
Tip: A good business practice is to name your instances so that they are easily and consistently
identifiable. For example: PRODUCT_SERVER_PORT where PRODUCT is the JD Edwards EnterpriseOne server
type, such as Enterprise_Server, HTML_Web_Server, RTE_Transaction_Server, Collaborative_Portal, or
Business_Services, and where SERVER is the machine on which the instance is installed, and where PORT
is the HTTP port which is defined for use by this server.
◦ J2EE Server
Use the dropdown to select the version of this Software Component that you wish to install.
251
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
6. Click Continue.
252
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
7. On Create/Register a Managed Instance, Confirmation, review the key configuration items. The values on this
form must be confirmed manually. You must validate or update, as appropriate, all configuration items.
Tip: For help, click the Information icon next to the title of a field.
Note:
◦ Configure the Default Server Group Configuration Settings
8. After you have validated and updated all configuration items, click Continue to proceed to the next installation
step.
253
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the installation of
the Collaborative Portal Server.
After you have completed the installation, the browser is redirected to the Management Console page for the
newly registered Collaborative Portal. This server also appears as a Managed Instance in the corresponding
Managed Home .
For each registered Managed Instance , the Management Console displays appropriate information at the top
of the page:
◦ General
- Status
Running
Stopped
Note:
◦ Start or Stop a Managed EnterpriseOne Software Component
Note:
◦ Change a Managed EnterpriseOne Software Component
◦ Instance Properties
- Instance Name
254
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
The name assigned to the Managed Instance at the time it was created or registered.
- Application Server Instance
Displays the application server into which this EnterpriseOne server is installed and also provides a
link to the application server instance and associated WebSphere Application Server profile.
For information on log files, refer to the chapter entitled: Available Log Files.
Note: To deploy JAX-WS business services to a business services server instance on WebLogic Server or WebSphere
Application Server, ensure that your Server Manager Console and Agent (under which the business services server
instance on WebLogic Server or WebSphere Application Server are registered) are the same level as the Management
Console.
Note: Starting with Tools release 9.2.1, when you build a new BSSV package for deployment, the files
BSSVpackage.EAR and BSSVpackage.JAR are created. You can deploy this JAR file directly from the Server Manager
Console See Deploying the JAR file from the Server Manager Console
See Also
• Prerequisites and Recommended Installation Sequence for Managed Instances for Web-Based Server Instances
• Refer to the JD Edwards EnterpriseOne Business Services Server Reference Guide for details on additional
tasks and topics related to Server Manager .
• Refer to the for details on other tasks and topics extraneous to Server Manager .
To install a Business Services Server Instance:
255
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
1. Select the Managed Home in which you wish to install the Business Services Server .
256
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
2. In the Managed Instances section of the page, click the Create a New Managed Instance button.
257
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
3. On Create/Register a Managed Instance, Instance Type, select this radio button:
Note: The Propagate Enterprise Server Config drop-down appears only if any enterprise server is registered
within the Server Manager console. The Propagate Enterprise Server Config drop-down contains the available
enterprise server instances registered with the SM console within a particular selected server group. NONE is
added to the drop-down by default.
258
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
4. On Create/Register a Managed Instance, Instance Properties, complete these fields:
◦ Server Group
Use the dropdown to select the Server Group to which you want this instance to belong.
Tip: A good business practice is to name your instances so that they are easily and consistently
identifiable. For example: PRODUCT_SERVER_PORT where PRODUCT is the JD Edwards EnterpriseOne server
type, such as Enterprise_Server, HTML_Web_Server, RTE_Transaction_Server, Collaborative_Portal, or
Business_Services, and where SERVER is the machine on which the instance is installed, and where PORT
is the HTTP port which is defined for use by this server.
◦ J2EE Server
Ensure the J2EE Server that you choose is a secure WebSphere 7.0 or 8.5 profile (releases prior to 7.0 are
not supported). Otherwise, Server Manager will not allow you to continue the installation.
◦ HTTP Port
You must ensure that the port that you specify is available and is not being used by any other application
currently installed and running on the server on which the application server is running.
Note:
- Verify HTTP Ports
- HTTP Ports on UNIX Operating Systems
Select the enterprise server from the drop-down list to propagate the configurations.
Note: By default, the selected item is set to NONE. Selecting NONE signifies that you do not wish to
propagate configurations from any available enterprise server. If any enterprise server is selected, all
the inherited values are seen in the next screen, otherwise the properties are seen with blank/default
values. If propagated, the propagated values are not editable on the confirmation page, however, they
can be modified post installation.
259
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
5. Click Continue.
260
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
261
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
262
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
263
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
264
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note: This example illustrates an installation by selecting NONE under Propagate Enterprise Server Config.
265
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
6. On Create/Register a Managed Instance, Confirmation, review the key configuration items. The values on this
form must be confirmed manually. You must validate or update, as appropriate, all configuration items.
Tip: For help, click the Information icon next to the title of a field.
Note:
◦ Configure the Default Server Group Configuration Settings
7. After you have validated and updated all configuration items, click Continue to proceed to the next installation
step.
266
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
8. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the installation of
the Business Services Server.
After you have completed the installation, the browser is redirected to the Management Console page for
the newly created Managed Instance . This Managed Instance also appears as a Managed Instance in the
corresponding Managed Home .
Note: After you have created the EnterpriseOne Business Services Server Managed Instance , unlike all
other web-based server products it does not start automatically. This is because the Managed Instance is
not functional until the Business Services components are installed in it through the special JD Edwards
EnterpriseOne package build process designed for that product. Refer to the JD Edwards EnterpriseOne
Tools Release 9.2 Package Management Guide.
For each registered Managed Instance , the Management Console displays appropriate information at the top
of the page:
◦ General
- Status
Running
Stopped
267
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note:
◦ Start or Stop a Managed EnterpriseOne Software Component
- Instance Name
The name assigned to the Managed Instance at the time it was created or registered.
- HTTP Port
Displays the HTTP Port for this server and also provides a link to the HTTP server.
- Application Server Instance
Displays the application server into which this EnterpriseOne server is installed and also provides a
link to the application server instance and associated WebSphere Application Server profile.
For information on log files for Managed Instances , refer to the chapter entitled: Available Log Files.
You can configure a clustered business services server instance to support clustering for consumer business services.
This clustering feature enables scalability, load balancing, and high availability for consumer business services by
providing multiple incoming ports so that multiple servers in the cluster can open socket connection to different ports
to receive incoming JDENet messages from the Enterprise Server, and the Enterprise Server can send JDENet messages
to multiple clustered business services server ports.
After you create and register a managed instance of a business services server, you can configure the business services
server instance to support clustering for consumer business services.
268
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
3. In the left-hand side Configuration pane, select Advanced from the View drop-down list, and then click the
Miscellaneous link.
Specify multiple servers in the cluster with assigned JDENet listen ports for each server in host1:port1|
host2:port2|host3:port3 format. Host can be specified with machine name or fully qualified machine name and
IP address.
1. In the INSTALL section of the Server Manager Console, click the Manage Software.
2. Upload the JAR file generated from the BSSV Package build process.
3. Select the uploaded file, and then click the Distribute button.
4. Navigate to the BSSV Server in the Server Manager Console.
5. Stop the BSSV Server.
6. To change the deployed component version, click the Change button.
7. Choose the previously uploaded package and then click the OK button.
8. Start the BSSV server.
269
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
If you are using Oracle WebLogic Server 12.2.1 to host the AIS Server, then you must upgrade the AIS Server and Server
Manager to EnterpriseOne Tools 9.2.0.5. You cannot run AIS Server releases 9.2.0.4 and lower on Oracle WebLogic
Server 12.2.1.
Note:
• Prerequisites and Recommended Installation Sequence for Managed Instances for Web-Based Server Instances
• JD Edwards EnterpriseOne Application Interface Services Server Reference Guide
Note: Starting with Tools Release 9.2.7, you can select the JAS server while creating an AIS server as a New Managed
Instance. The Propagate JAS settings column enables you to choose the JAS server and the settings for JDBj.ini and
tnsnames.ora are copied directly from the JAS server to the AIS instance.
1. Select the Managed Home in which you wish to install the AIS Server.
2. Click the Create a New Managed Instance button to create the Managed Instance in the Managed Home.
270
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
271
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
4. Click Continue.
◦ Server Group
Use the dropdown menu to select the Server Group where you want this instance to belong.
Tip: A good business practice is to name your instances so that they are easily and consistently
identifiable. For example: PRODUCT_SERVER_PORT where PRODUCT is the JD Edwards EnterpriseOne server
type, such as JAS, RTE, CollabPortal, AIS, or BusSvcs; where SERVER is the machine on which the
instance is installed; where PORT is the HTTP port which is defined for use by this server.
◦ J2EE Server
You must ensure that the port that you specify is available and is not being used by any other application
currently installed and running on the server on which the application server is running.
Note:
- Verify HTTP Ports
- HTTP Ports on UNIX Operating Systems
◦ Software Component
Use the dropdown to select the version of this Software Component that you wish to install.
◦ Propagate JAS Settings (Tools Release 9.2.7)
Use the dropdown to select the JAS instance to propagate the JDBj.ini and tnsnames.ora file of the JAS
instance into the AIS instance.
272
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
6. Click Continue.
7. On Create/Register a Managed Instance, Confirmation, review the key configuration items. The page displays
the settings that are typically required to successfully start your instance. The values on this form must be
confirmed manually. You should validate or update, as appropriate, all configuration items.
Note: When setting up an AIS server instance, you should also review the Allowed Hosts setting for the
corresponding EnterpriseOne HTML server instance.
Tip: For help, click the Information icon next to the title of a field.
8. After you have validated and updated all configuration items, click Continue to proceed to the next installation
step.
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the installation of
the AIS Server.
After you have completed the installation, if you are running on WebSphere, the HTTP server associated with the
J2EE Server must be restarted manually. If you do not restart the HTTP server, you will not be able to login to the AIS
instance.
273
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
You can verify the updated fields for JDBj.ini and tnsnames.ora after you have created the new managed instance. To
check
1. Open the newly created managed instance.
2. Navigate to the Configuration section on the left
3. Click Database.
4. Scroll down to view the JDBj.in and tnsnames.ora sections. The information is updated, except the password
fields, as per the JAS server you selected while creating the managed instance.
If you want to use TLS with AIS server, ensure that you update the field Use TLS to true under JDBj Runtime Properties
section.
Note: AIS instances created prior to this enhancement will also have the Database configuration with default values
for JDBj.ini and tnsnames.ora. You can configure the fields as per your requirement.
Note: The Test connection link is only enabled when the server is running.
After you have completed the installation, the browser is redirected to the Management Console page for the newly
registered AIS Server. This server also appears as a Managed Instance in the corresponding Managed Home.
For each registered Managed Instance, the Management Console displays appropriate information at the top of the
page:
• General
◦ Status
274
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Valid values are:
Running
Stopped
• Instance Properties
◦ Instance Name
The name assigned to the Managed Instance at the time it was created or registered.
◦ HTTP Port
Displays the HTTP Port for this server and also provides a link to the HTTP server.
◦ Application Server Instance
Displays the application server into which this EnterpriseOne server is installed and also provides a link
to the application server instance and associated managed server (Oracle WebLogic Server) or profile
(WebSphere Application Server).
For information on log files, refer to the chapter entitled: Available Log Files
The Instance Access Configuration fields are prepopulated with default values in the Managed Instance home page. The
administrative user can edit these values in the Instance Access Configuration section and save the values by clicking
the Apply button. The Instance URL field in the Instance Properties section is updated based on the values provided by
the user.
275
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
Note: The value in the Hostname/ IP Address configuration field is used as the Instance URL. If your managed
instance is on Cloud, enter the Public IP in the Hostname/ IP Address configuration field. The Health Check feature
uses the Fully Qualified Domain Name to access the managed instance.
The following example shows the Instance Access Configuration window for the HTML Web Server and the
EnterpriseOne Application Interface Services Server.
You can click the help icon next to each of these fields to see the details.
The following configuration options are available for the EnterpriseOne Transaction Server and EnterpriseOne Business
Services Server:
• SSL Enabled
• Port
• Fully Qualified Domain Name
Similarly, the following configuration options are available for the Enterprise One ADF Server and Enterprise One
Orchestrator Studio:
• SSL Enabled
• Port
• Hostname/ IP Address
Note: As of Tools Release 9.2.2.2, the Instance URL is displayed instead of the HTTP port in the Instance Properties
section of the HTML Server, AIS Server, ADF Server and the Orchestrator Studio. This instance URL is displayed only if
the instance is running.
The previously shipped release for Groovy was Groovy 2.5.8. The following five jars are recommended to support the
main functionality in orchestrations using Groovy.
groovy-2.5.8.jar
groovy-json-2.5.8.jar
groovy-jsr223-2.5.8.jar
276
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
groovy-sql-2.5.8.jar
groovy-xml-2.5.8.jar
You can also upload additional groovy-* jar files based on the use of the Groovy API.
Note: Verify that the uploaded JAR file is listed in the Available Scripting Libraries section along with the
scripting library file name, type, and version details. To delete an already uploaded scripting JAR file, select
the required JAR file in the Available Scripting Libraries section and then click Delete.
277
JD Edwards EnterpriseOne Tools Chapter 17
Server Manager Guide Create a JD Edwards EnterpriseOne Web-Based Server as a
New Managed Instance
278
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
Tip: For integration with BI Publisher, the recommended configuration is the Data Access Driver.
For implementation details, refer to the JD Edwards Interoperability Guide on the Oracle Technology Network:
http://www.oracle.com/technology/documentation/index.html
This list shows the prerequisites and recommended installation sequence for the JD Edwards EnterpriseOne Data
Access Driver:
Note:
• Refer to the JD Edwards EnterpriseOne Interoperability Guide in the chapter Using Java Database Connectivity
for additional tasks and topics related to the Data Access Driver.
• JD Edwards EnterpriseOne BI Publisher for JD Edwards EnterpriseOne Guide
279
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
Note:
• Prerequisites and Recommendation Installation Sequence for the Data Access Driver
280
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
1. Select the Managed Home in which you wish to install the Data Access Driver.
281
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
2. Click the Create a New Managed Instance button to create the Managed Instance in the Managed Home.
Tip: Ensure you choose the correct instance type for your intended installation. That is, there are two similar
appearing instance types, one for Data Access Server and one for Data Access Driver.
282
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
4. Click Continue.
Note: The Propagate Enterprise Server Config drop-down appears only if any enterprise server is registered
within the Server Manager console. The Propagate Enterprise Server Config drop-down contains the available
enterprise server instances registered with the SM console within a particular selected server group. NONE is
added to the drop-down by default.
283
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
◦ Server Group
Use the pull-down to select the Server Group to which you want this instance to belong.
Tip: A good business practice is to name your instances so that they are easily and consistently
identifiable. For example: PRODUCT_SERVER_PORT where PRODUCT is the JD Edwards EnterpriseOne
instance type, such as Data_Access_Driver, and where SERVER is the machine on which the instance is
installed, and where PORT is the HTTP port which is defined for use by this server.
◦ Usage Type
Use the pull-down to select the usage type for this Data Access Driver.
If you choose BI Publisher, that application must already be installed. By default, Server Manager
populates this field with the typical value for a BI Installation location, where you must manually complete
this variable value for your installation:
<BIPUB_ROOT>
BI_Home\applications\xmlpserver\xmlpserver\WEB-INF\lib
If you choose Generic, you must provide the complete path to the application directory into which you
wish to install the Data Access Driver. For example:
C:\jde_generic_read_only_driver_application
This location must be unique, must be empty, and must not be within the Management Agent directory
structure.
◦ Software Component
Use the dropdown to select the version of this Software Component that you wish to install. For example:
284
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
6. Click Continue.
285
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
286
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
287
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
Note: This example illustrates an installation by selecting NONE under Propagate Enterprise Server Config.
7. On Create/Register a Managed Instance, Confirmation, review the key configuration items. The values on this
form must be manually confirmed. You must validate or update, as appropriate, all configuration items.
Tip: For help, click the Information icon next to the title of a field.
Note:
◦ Administer Management Console Users and User Groups
8. After you have validated and updated all configuration items, click Continue to proceed to the next installation
step.
288
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the installation of
the EnterpriseOne Data Access Driver.
Once the installation is complete the browser is redirected to the Management Console page for the newly registered
Data Access Driver. This driver also appears as a Managed Instance within the corresponding Managed Home.
For each registered Managed Instance, the Management Console displays appropriate information at the top of the
page:
• General
◦ Status
- Running
This status is set whenever the Management Agent on the machine where the Data Access Driver
is installed reports that the Java class is loaded for use by BI Publisher or the Generic application.
The agent checks and reports status periodically so the status shown by Server Manager will be
accurate within a few minutes.
Note that unlike Managed Instances for Servers, there is no option to Stop the driver from Server
Manager. Therefore, no Stop button is displayed.
289
JD Edwards EnterpriseOne Tools Chapter 18
Server Manager Guide Install a JD Edwards EnterpriseOne Data Access Driver
- Stopped
This status is set whenever the Management Agent on the machine where the Data Access Driver
is installed reports that the Java class is unloaded by BI Publisher or the Generic application.
The agent checks and reports status periodically so the status shown by Server Manager will be
accurate within a few minutes.
Note that unlike Managed Instances for Servers, there is no option to Start the driver from Server
Manager. Therefore, no Start button is displayed.
◦ Software Component Version
You must stop the system using the Data Access Driver (BI Publisher or Generic) before you can change
the Software Component Version.
Note:
• Change a Managed EnterpriseOne Software Component
• Instance Properties
◦ Install Location
Identifies the usage type of the Data Access Driver as either BI Publisher or Generic.
◦ Instance Name
The name assigned to the Managed Instance at the time it was created or registered.
For information on log files, refer to the chapter entitled: Available Log Files.
290
JD Edwards EnterpriseOne Tools Chapter 19
Server Manager Guide Manage an Oracle Database Instance
1. Management Agent is installed on the same target machine where you have installed the Oracle Database
which you are trying to register.
2. As an oracle user, you must be able to login to the database using the following value:
sqlplus / as sysdba.
Ensure that the ORCL_SID, ORACLE_HOME, and PATH environment variables are properly configured.
Refer to Chapter 1, "Installing the Server Manager Management Console and Agent".
1. Select the Managed Home with which you wish to register the Oracle Database. Click the Create a New
Managed Instance button to create the Managed Instance within the Managed Home.
291
JD Edwards EnterpriseOne Tools Chapter 19
Server Manager Guide Manage an Oracle Database Instance
3. Click Continue.
292
JD Edwards EnterpriseOne Tools Chapter 19
Server Manager Guide Manage an Oracle Database Instance
◦ Server Group
Use the drop-down menu to select the Server Group to which you want this instance to belong.
◦ Instance Name
5. Click Continue.
6. On Create/Register a Managed Instance, Confirmation, review the key configuration items, where the web page
displays a variety of fields depending on the database and environments of your installation.
293
JD Edwards EnterpriseOne Tools Chapter 19
Server Manager Guide Manage an Oracle Database Instance
9. After you have completed the installation, the browser is redirected to the Management Console page for
the newly registered Oracle Database. This Oracle Database also appears as a Managed Instance in the
corresponding Managed Home.
For each registered Managed Instance, the Management Console displays appropriate information at the top of
the web page:
General
Running
Stopped
Instance Properties
◦ Instance Name
To change the Oracle Database password, click the Reset button, enter the new password, and then click
the Save button. Note that this functionality works only with the Database Cloud Service if the PDB name
is jdeorcl.
294
JD Edwards EnterpriseOne Tools Chapter 19
Server Manager Guide Manage an Oracle Database Instance
295
JD Edwards EnterpriseOne Tools Chapter 19
Server Manager Guide Manage an Oracle Database Instance
296
JD Edwards EnterpriseOne Tools Chapter 20
Server Manager Guide Manage an IBM i Database Instance
2. As an IBM i user, you must be able to log in to the database with the following authority:
*ALLOBJ *SECADM *SAVSYS *IOSYSCFG *JOBCTL
3. You must enable the IBMi DB2 database for Transport Layer Security (TLS). Refer to the JD Edwards
EnterpriseOne Applications Installation Guide for Code Current.
297
JD Edwards EnterpriseOne Tools Chapter 20
Server Manager Guide Manage an IBM i Database Instance
3. Click Continue.
4. On Create/Register a Managed Instance, Instance Properties, complete these fields:
◦ Server Group
Use the drop-down menu to select the Server Group to which you want this instance to belong.
◦ Instance Name
5. Click Continue.
6. On Create/Register a Managed Instance, Confirmation, review the key configuration items, where the web page
displays a variety of fields depending on the database and environments of your installation.
For each registered managed instance, the Management Console displays the appropriate information at the
top of the web page:
298
JD Edwards EnterpriseOne Tools Chapter 20
Server Manager Guide Manage an IBM i Database Instance
General
Running
Stopped
Instance Properties
◦ Instance Name
299
JD Edwards EnterpriseOne Tools Chapter 20
Server Manager Guide Manage an IBM i Database Instance
To update an HTML Server to enable Transport Layer Security (TLS) to an IBM DB2 database server:
1. Select the Managed Home of the JAS instance for which you want to enable TLS.
2. Navigate to <HTML Server Instance > Configuration > Advanced > Database > JDBj Runtime Properties.
3. Set the following value:
300
JD Edwards EnterpriseOne Tools Chapter 20
Server Manager Guide Manage an IBM i Database Instance
301
JD Edwards EnterpriseOne Tools Chapter 20
Server Manager Guide Manage an IBM i Database Instance
1. Import the Database Server certificate to the WebLogic Server Java trust store on the HTML Web Server.
2. Select the Managed Home of the JAS instance for which you want to enable TLS.
3. Navigate to <HTML Server Instance > Configuration > Advanced > Database > JDBj Runtime Properties.
4. Set the following value:
302
JD Edwards EnterpriseOne Tools Chapter 20
Server Manager Guide Manage an IBM i Database Instance
303
JD Edwards EnterpriseOne Tools Chapter 20
Server Manager Guide Manage an IBM i Database Instance
304
JD Edwards EnterpriseOne Tools Chapter 21
Server Manager Guide Deploy an Oracle Application Development Framework
(ADF) Server Instance (Release 9.2.1.2)
Overview
Note: Alternatively, you can use the createadfinstance Server Manager REST API to create the ADF Server instance.
See REST API for Server Manager guide. Although not recommended, you can manually install an ADF Server using
the EnterpriseOne ADF Application Build Scripts. See the JD Edwards EnterpriseOne Tools Deploying and Developing
Oracle Application Development Framework (ADF) Applications for EnterpriseOne guide.
Applications built with Oracle Application Development Framework (ADF) must be deployed on an Oracle WebLogic
Server with ADF runtime, hereafter referred to as an ADF Server.
Oracle delivers EnterpriseOne applications developed with Oracle ADF. This chapter describes how to deploy an ADF
Server instance through Server Manager, which involves installing the EnterpriseOne ADF Foundation and determining
which EnterpriseOne ADF applications you want to deploy in the ADF Server instance.
Prerequisites
Note: This configuration supports Oracle WebLogic Server version 12c (also known as 12.1.3 and 12.2.1.x). Refer to the
Oracle Certifications for more information about minimum technical requirements for your particular environment.
Deploying an ADF Server through Server Manager requires the following prerequisites:
• A minimum of EnterpriseOne Tools 9.2.1.2.
• An Oracle Fusion Middleware WebLogic Server with ADF runtime installed.
For Oracle WebLogic Server 12.1.3, you have to install Oracle WebLogic Server and then configure it with the
runtime libraries for Oracle ADF.
If using Oracle Fusion Middleware Infrastructure 12.2.1.2 to install Oracle WebLogic Server, it comes
preconfigured to support ADF applications; the additional configuration of ADF runtime libraries is not
required. Oracle Fusion Middleware Infrastructure also provides an option to install Oracle WebLogic Server
separately, which after installing, requires configuring it with the runtime libraries for Oracle ADF.
• A Management Agent installed on the target machine where Oracle WebLogic Server resides.
Refer to Installing the Server Manager Console and Agent.
• The Oracle WebLogic Server registered with the Server Manager Management Agent.
• A J2EE Container installed in this domain. See Install JDBC Drivers to the J2EE Server (WLS or WAS).
305
JD Edwards EnterpriseOne Tools Chapter 21
Server Manager Guide Deploy an Oracle Application Development Framework
(ADF) Server Instance (Release 9.2.1.2)
• An EnterpriseOne Application Interface Services (AIS) Server configured with an EnterpriseOne HTML Server.
https://updatecenter.oracle.com
2. In the Type field, select EnterpriseOne ADF, and then make sure that All Releases is selected in the Release field.
3. Click SEARCH.
4. Download the E1 ADF Foundation.
The download includes the ADF Par file, which you can save to your destination server.
https://updatecenter.oracle.com
2. In the Type field, select EnterpriseOne ADF, and then make sure that All Releases is selected in Release field.
3. Click SEARCH.
306
JD Edwards EnterpriseOne Tools Chapter 21
Server Manager Guide Deploy an Oracle Application Development Framework
(ADF) Server Instance (Release 9.2.1.2)
2. Click Upload.
307
JD Edwards EnterpriseOne Tools Chapter 21
Server Manager Guide Deploy an Oracle Application Development Framework
(ADF) Server Instance (Release 9.2.1.2)
3. Verify that the EnterpriseOne ADF server components are uploaded as shown in the following example.
4. Select the EnterpriseOne ADF server components, and then click Distribute.
308
JD Edwards EnterpriseOne Tools Chapter 21
Server Manager Guide Deploy an Oracle Application Development Framework
(ADF) Server Instance (Release 9.2.1.2)
5. In the Managed Software Components window, select required Managed Instances, and then click Distribute
Software.
The Distributed ADF Server Components will be available in the selected Server Manager Agent as shown in the
following example.
309
JD Edwards EnterpriseOne Tools Chapter 21
Server Manager Guide Deploy an Oracle Application Development Framework
(ADF) Server Instance (Release 9.2.1.2)
6. To create a new ADF Server instance, select EnterpriseOne ADF Server in the "Deploy a New EnterpriseOne Web
Component" window.
310
JD Edwards EnterpriseOne Tools Chapter 21
Server Manager Guide Deploy an Oracle Application Development Framework
(ADF) Server Instance (Release 9.2.1.2)
7. On Create/Register a Managed Instance, Instance Properties, complete these fields:
◦ Server Group
Use the pull-down to select the Server Group to which you want this instance to belong.
Also refer to Administer Management Console Users and User Groups
◦ Name
Enter a name for the instance.
◦ J2EE Server/Cluster
Select the already created J2EE Container for creating the ADF Server Instance.
◦ Foundation Component
Select the Foundation Component. The distributed ADF Server Foundation component(s) will be
available in the drop-down menu.
◦ Application Components
The ADF Application components are auto selected. Select or deselect the ADF Application Components
as required.
8. In the AIS Server URL field, enter the AIS Server to use with this ADF Server.
9. In the HTML Server Whitelist field, enter the URLs to the supported EnterpriseOne HTML Servers for this ADF
Server. For each EnterpriseOne HTML Server, you must provide the long and short host name along with port
number.
311
JD Edwards EnterpriseOne Tools Chapter 21
Server Manager Guide Deploy an Oracle Application Development Framework
(ADF) Server Instance (Release 9.2.1.2)
Note: After the ADF Server instance is created, you must update the HTML Server configuration setting in
Server Manager to point to this ADF Server.
It is not necessary to install the JDBC Driver on the ADF Server instance since it does not connect to the EnterpriseOne
database directly.
By default, the ADF Server timeout setting is 20 minutes and the AIS Server timeout setting is 30 minutes. If you adjust
these settings, make sure that the timeout for the ADF Server is less than the timeout for the AIS Server.
312
JD Edwards EnterpriseOne Tools Chapter 22
Server Manager Guide Install an EnterpriseOne Orchestrator Studio
Overview
Note: As an alternative to following the instructions in the chapter, you can use the createorchinstance Server
Manager REST API to create the Orchestrator Studio instance. See REST API for Server Manager guide.
Note: Support for deploying the EnterpriseOne Orchestrator Studio with Server Manager starts with the 9.2.1.2 Tools
Release for Server Manager and Orchestrator Studio version 5.0.0.
The JD Edwards EnterpriseOne Orchestrator Studio was built with Oracle Application Development Framework (ADF).
Applications built with Oracle ADF must be deployed on an Oracle WebLogic Server with ADF runtime, hereafter referred
to as an ADF Server.
This chapter describes how to use Server Manager to install the EnterpriseOne Orchestrator Studio on an ADF Server
instance.
Note: You cannot deploy the EnterpriseOne Orchestrator Studio on the same ADF Server instance used for running
other EnterpriseOne ADF applications. When you install the Orchestrator Studio through Server Manager, the steps
include deploying an ADF Server instance for running the Orchestrator Studio.
Note: Orchestrator Studio 9.2.4.0 is the latest version which requires a minimum of EnterpriseOne Tools 9.2.4.0.
The Orchestrator Studio 9.2.4.0 is deployed as a component of the Application Interface Services (AIS) server. The
standard Server Manager process is used to deploy an AIS server, and the Orchestrator Studio 9.2.4.0 is immediately
available through a URL endpoint to that server. The Orchestrator Studio 9.2.4.0 does not require the installation and
maintenance of a discrete WebLogic Server or ADF environment.
Prerequisites
Note: This document covers installations for Oracle WebLogic Server version 12c (also known as 12.1.3 and 12.2.x).
Follow the Oracle Certifications to determine which version is supported for your particular environment.
313
JD Edwards EnterpriseOne Tools Chapter 22
Server Manager Guide Install an EnterpriseOne Orchestrator Studio
Installing the EnterpriseOne Orchestrator Studio 5.0.0 or higher through Server Manager requires the following
prerequisites:
• A minimum of:
Note: The Orchestrator Studio 9.2.4 is deployed along with the AIS Server 9.2.4.0 and can be accessed by
using the AIS server URL. Therefore, the Orchestrator Studio 9.2.4 does not require additional set-up or
installation steps. The JD Edwards EnterpriseOne Orchestrator Studio 9.2.4 is installed on AIS server instance.
• An EnterpriseOne Application Interface Services (AIS) Server configured with an EnterpriseOne HTML Server.
See Create an Application Interface Services (AIS) Server as a New Managed Instance for more information.
You can use an existing AIS Server or deploy a new AIS Server instance through Server Manager for the
sole purpose of running orchestrations. It is recommended that you set up two AIS Server instances for an
Orchestrator configuration, one for testing orchestrations and one for production.
For an AIS Server deployed on Oracle WebLogic Server, there is an additional required configuration that
enables the Orchestrator Client (the tool for testing orchestrations) to run properly. See "Configuring Oracle
WebLogic Server Domain for HTTP Basic Authentication" in the JD Edwards EnterpriseOne Application
Interface Services Server Reference Guide .
• An Oracle Fusion Middleware WebLogic Server with ADF runtime installed.
For Oracle WebLogic Server 12.1.3, you have to install Oracle WebLogic Server and then configure it with the
runtime libraries for Oracle ADF. For instructions on how to install Oracle WebLogic Server with ADF Runtime,
see "Setting Up Oracle WebLogic Server with ADF Runtime" in the JD Edwards EnterpriseOne Tools Deploying
and Developing Oracle Application Development Framework (ADF) Applications for EnterpriseOne Guide.
If using Oracle Fusion Middleware Infrastructure 12.2.1.2 to install Oracle WebLogic Server, it comes
preconfigured to support ADF applications; the additional configuration of ADF runtime libraries is not
required. Oracle Fusion Middleware Infrastructure also provides an option to install Oracle WebLogic Server
separately, which after installing, requires configuring it with the runtime libraries for Oracle ADF.
• A Management Agent installed on the target machine where Oracle WebLogic Server resides.
314
JD Edwards EnterpriseOne Tools Chapter 22
Server Manager Guide Install an EnterpriseOne Orchestrator Studio
https://updatecenter.oracle.com
2. In the Type field, select EnterpriseOne Orchestrator, and then make sure that All Releases is selected in the
Release field.
3. Click SEARCH.
4. Download the Orchestrator Components file, making sure the version is supported with your EnterpriseOne
Tools release.
The download contains additional files that are not needed for the Orchestrator Studio installation. The additional
files are for developing custom Java for orchestrations. See "API and JAR Files for Developing Custom Java for
Orchestrations" in the JD Edwards EnterpriseOne Tools Orchestrator Guide for Studio Version 8 and Prior .
1. In the Managed Software Components window of the Server Manager Console, click Choose File, select the
Orchestrator Components file downloaded from the Update Center and click Open.
2. Click Upload.
315
JD Edwards EnterpriseOne Tools Chapter 22
Server Manager Guide Install an EnterpriseOne Orchestrator Studio
3. Verify that the EnterpriseOne Orchestrator components are uploaded as shown in the following example. Select
the Enterprise Orchestrator components, and then click Distribute.
316
JD Edwards EnterpriseOne Tools Chapter 22
Server Manager Guide Install an EnterpriseOne Orchestrator Studio
4. In the Managed Software Components window, select required Managed Instances, and then click Distribute
Software.
5. The Distributed EnterpriseOne Orchestrator Components will be available in the selected Server Manager Agent
as shown in the following example.
317
JD Edwards EnterpriseOne Tools Chapter 22
Server Manager Guide Install an EnterpriseOne Orchestrator Studio
6. To create a new EnterpriseOne Orchestrator instance, select EnterpriseOne Orchestrator Studio Server in the
Deploy a New EnterpriseOne Web Component window.
318
JD Edwards EnterpriseOne Tools Chapter 22
Server Manager Guide Install an EnterpriseOne Orchestrator Studio
Select EnterpriseOne Orchestrator Studio Components available in the drop-down menu as required.
◦ Propagate Application Interfaces Services
8. The Orchestrator Studio connects with a working AIS Server in order to function. In the CONFIGURATION
section, enter the AIS Server Details, and then click Continue.
319
JD Edwards EnterpriseOne Tools Chapter 22
Server Manager Guide Install an EnterpriseOne Orchestrator Studio
9. The Orchestrator Studio instance is created successfully as shown in the following example. You can start the
EnterpriseOne Orchestrator Studio instance after it is created.
10. You can also modify the configuration entries after the installation is created successfully.
It is not required to install the Database JDBC Driver into the Orchestrator Studio instance since it does not
connect to the EnterpriseOne Database directly.
After installing the Orchestrator Studio, you need to set up the Orchestrator Studio as described in the "Setting Up the
Orchestrator Studio" section of the JD Edwards EnterpriseOne Tools Orchestrator Guide for Studio Version 8 and Prior.
320
JD Edwards EnterpriseOne Tools Chapter 23
Server Manager Guide Remove a Managed Instance
321
JD Edwards EnterpriseOne Tools Chapter 23
Server Manager Guide Remove a Managed Instance
1. On the Managed Instances section of the page, select the Managed Instance Type associated with the
application server that you want to remove.
322
JD Edwards EnterpriseOne Tools Chapter 23
Server Manager Guide Remove a Managed Instance
2. Click the Remove Instance button to remove the selected application server Managed Instance .
3. On the confirmation dialog, click OK if you are sure that you want to remove the selected Managed Instance .
If you choose OK, the application server will not be physically removed from the remote machine. It will,
however, no longer be manageable with Server Manager .
If you attempt to remove an application server that has a dependent Managed Instance , the Management Console
displays this error message:
323
JD Edwards EnterpriseOne Tools Chapter 23
Server Manager Guide Remove a Managed Instance
1. On the Managed Instances section of the page, select the Managed Instance Type associated with the JD
Edwards EnterpriseOne server you want to remove.
324
JD Edwards EnterpriseOne Tools Chapter 23
Server Manager Guide Remove a Managed Instance
2. Click the Remove Instance button to remove the selected JD Edwards EnterpriseOne server Managed Instance
.
3. On the confirmation dialog, click OK if you are sure that you want to remove the selected Managed Instance .
If you choose OK, the Managed Instance will be permanently removed from the application server to which it
was installed.
325
JD Edwards EnterpriseOne Tools Chapter 23
Server Manager Guide Remove a Managed Instance
326
JD Edwards EnterpriseOne Tools Chapter 24
Server Manager Guide Overview of Management Console Administration
The Management Console supports granular control of the managed instances a user may view and actions a
user may perform. The Management Console employs user groups as an efficient way to manage permissions
and servers. Instead of administering these items at the user level, you can associate permissions to a user
group. You can determine which JD Edwards EnterpriseOne users have access to the Management Console
and the user group or user groups to which the user should belong.
• Assigning permissions to user groups
The Management Console contains two sets of permissions that you can assign to user groups: global
permissions and server group permissions. Global permissions allow members of a user group to perform
particular administrative tasks in the Management Console . Server group permissions allow users to perform
certain administrative tasks on the servers that are managed centrally through the Management Console .
• Creating server groups
327
JD Edwards EnterpriseOne Tools Chapter 24
Server Manager Guide Overview of Management Console Administration
328
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
You can import users from JD Edwards EnterpriseOne using the Management Console Setup and Configuration Wizard,
or you can add them as needed using the Management Console. JD Edwards EnterpriseOne users are authenticated
using the security server services of an EnterpriseOne Enterprise Server. The Enterprise Server name and port used by
the Management Console must be properly configured.
Note: JD Edwards EnterpriseOne users cannot access the Management Console with their JD Edwards EnterpriseOne
user IDs and passwords until they have been added as Management Console users.
See Complete the Management Console Setup Wizard for information about using the Management Console Setup
Wizard to add JD Edwards EnterpriseOne users to the Management Console.
Note: All servers managed by an instance of Server Manager must use the same site key. For example, to have a
production environment with servers that use one site key and a test environment with servers that use a different site
key, you would need to install two separate Management Consoles, one for all servers in the production environment
and one for all servers in the test environment. The configured Security Server must be a managed instance in the
Server Management Console. Previously, the Security Server could have been managed by a different Server Manager
Console.
329
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
1. In the Quick Links section of the Management Console, click the Server Manager Users link.
2. In the Server Manager User Authentication pane, in the Server Name field, enter the name of the Enterprise
Server to use for security services. The server must be running and listening on the same JDENET port that this
instance is configured to use for outgoing connections.
3. In the Outgoing JDENET Port field, enter the TCP port to use for outgoing JDENET communications
with a JD Edwards EnterpriseOne Enterprise Server. This value must match the JDENET Incoming Port
(ServiceNameListen) defined for the Enterprise Server(s) with which this web server will communicate.
4. Click the Save button.
Note: It may be necessary to restart the management console application for the new settings to take effect.
1. In the Quick Links section of the Management Console, click the Server Manager Users link.
330
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
2. In the jde_admin Password section in the left pane, complete the Old Password, New Password, and Verify New
Password fields to change the jde_admin password.
Note: If you lose the jde_admin password, there is no way to recover it. You will have to reinstall the
Management Console.
• Add a User
• Remove a User
Add a User
1. In the Quick Links section of the Management Console, click the Server Manager Users link.
2. On Server Manager Users, in the Management Console Users pane, enter the name of the JD Edwards
EnterpriseOne user in the EnterpriseOne User Name field.
3. Click Add User.
The Management Console adds the user to its user repository. The added user will not belong to any user
groups.
331
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
Remove a User
1. On Server Manager Users, in the Management Console Users pane, select the check box next to the user that
you want to delete.
2. Click the Delete button.
See Assign Server Manager Permissions for a list of all the permissions that you can assign to user groups in Server
Manager.
The Management Console displays each user group that you add in a grid. You can sort alphabetically on each column
of the grid by clicking the column heading. The Management Console displays this information for each user group:
• User Group Name
• User Group Description
• Users Belonging to User Group
• Granted Permissions
The Management Console is delivered with the following predefined groups:
• console_user
Any user who successfully authenticates and possesses this role may utilize the management console. If users
do not belong to this user group, they cannot access any of the management console pages. You must have
this permission to sign into the Management Console.
• console_admin
This role is equivalent to having all permissions granted to a user. Users who belong to this user group
automatically assume the rights of the console_user user group; it is not necessary to assign them to the
console_user user group. The jde_admin user is always a member of the console_admin user group.
Note: The user groups that are delivered with Server Manager cannot be altered or deleted.
332
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
2. In the User Groups pane, click the Create User Group button.
3. Complete the User Group Name and Description fields and then click the Add User Group button.
The Management Console adds the new user group and displays the details about the user group in the grid.
1. In the User Groups pane, select the check box of the row that contains the user group that you want to delete.
2. Click the Delete User Group button.
333
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
Global permissions allow users to perform administrative tasks in the Management Console that do not pertain to a
particular server group, such as updating the Management Console software, distributing software components to
managed homes, and granting other JD Edwards EnterpriseOne users access to the Management Console.
Server group permissions allow users to perform certain tasks on a particular server group. When you assign a server
group permission, the permission applies to all servers that belong to the server group.
See Administer Server Groups for information about setting up and managing server groups.
334
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
J2EE servers within the application server, start and stop application server components, and modify the
configuration of the application server components. Users without this permission may see the application
servers within the management console but may not perform any actions directly on those servers.
• Manage Software Components managedComponents
This permission allows users to manage software components within Server Manager. With this permission,
users can add software components to the Management Console User Repository, distribute or copy those
components to managed homes, and delete software components both from the managed homes and from
the management consoles.
• Monitor Configuration monitorConfig
This permission allows users to manage the monitoring components of Server Manager. With this permission,
users can create, delete, and start or stop configured monitors. Any user allowed to use Server Manager may
view the contents of a running monitor; however, this permission is required to make any changes to the
configuration of an existing monitor. In addition, users with this permission may remove any monitor reports
from the monitor history.
• Console Configuration and Administration consoleConfig
This permission allows users to manage the configuration of Server Manager. With this permission, users
can update the Server Manager release, update deployed managed home agents, remove managed homes,
configure the TCP/IP ports used by Server Manager, and download managed home agent installers. This
permission is not required to manage the Management Console user repository; that permission is granted by
the userManagement permission.
• Server Manager User Management userManagement
This permission allows users to administer the Server Manager user management repository. With this
permission, users can add additional JD Edwards EnterpriseOne users as Management Console users and
assign permissions.
• Web Product User Session Management
This permission allows users to manage web product user sessions. It allows users to terminate OWVirtual
sessions, terminate user sessions including any running OWVirtual sessions, broadcast messages to OWVirtual
clients, and temporarily disable logins to a web product.
To assign global permissions to a user group:
1. In the Quick Links section of the Management Console, click the Server Manager Users link.
335
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
2. In the User Groups pane, click the link of the user group to which you want to add permissions. For example, if
you chose Global Permissions you would have these available options:
3. On Modify a User Group, in the Global Permissions pane, select a permission from the Available Options box.
4. Click the Move link (single right arrow) to move the permission to the Selected Options box.
You can also grant the user group all global permissions by clicking the Move All link (double right arrow).
To remove global permissions from a user group:
1. In the User Groups pane, click the link of the user group to which you want to remove permissions.
2. In the Global Permissions pane, select the permission that you want to remove from the Select Options box.
3. Click the Remove link (single left arrow).
You can also remove all permissions in the Selected Options box by clicking the Remove All link (double left
arrow).
336
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
This permission allows users to view the JD Edwards EnterpriseOne servers that are members of a server
group. Without this permission, users cannot view the server group members in the Management Console. You
must explicitly grant this permission to each desired server group; no other permission implies or inherits this
permission.
• Web Product Instance Management webProductInstance
This permission allows users to create new web product instances, remove existing web product instances,
configure web products, register/de-register application servers, configure application servers, and start
or stop application servers and web products. This permission also allows users to change the JD Edwards
EnterpriseOne Tools release of a corresponding server. This permission is required to allow users to manage JD
Edwards EnterpriseOne web products including HTML servers, Transaction Servers, Business Service servers,
and the corresponding application servers (Oracle WebLogic and IBM WebSphere).
• Web Product User Session Management webSessions
This permission allows users to manage web product user sessions. With this permission, users can terminate
OWVirtual sessions and user sessions (including any running OWVirtual sessions), broadcast messages to
OWVirtual clients, and temporarily disable anyone from signing onto a web product.
To assign server group permissions to a user group:
1. In the Quick Links section of the Management Console, click the Server Manager Users link.
2. In the User Groups pane, select the user group to which you want to assign server group permissions.
The Management Console displays a separate pane for each server group in the Management Console. Each
pane displays the permissions for that particular server group.
3. On Modify A User Group, scroll to the server group to which you want to add server group permissions for the
user group.
4. Select the permission from the Available Options box and then click the Move link (single right arrow) to move
the permission to the Selected Options box.
You can also grant the user group all server group permissions by selecting the Move All link (double right
arrow).
To remove server group permissions from a user group:
1. In the User Groups pane, select the user group to which you want to remove server group permissions.
2. On Modify A User Group, scroll to the server group to which you want to remove server group permissions from
the user group.
337
JD Edwards EnterpriseOne Tools Chapter 25
Server Manager Guide Administer Management Console Users and User Groups
3. On Modify A User Group, in the Server Group pane, select the permission from the Selected Options box and
then click the Remove link (single left arrow) to remove the permission.
You can also remove all server group permissions from the user group by selecting the Remove All link (double
left arrow).
You must have the userManagement global permission to be able to view the report.
1. In the Quick Links section of the Management Console, click the Server Manager Users link.
2. In the User Management Tasks section, click the User Access Report link.
338
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
E-Mail Configuration
When you click the Server Activity link in the What do you want to do? pane, the Management Console displays
another pane under What do you want to do? called E-Mail Configuration.
Starting With Tools Release 9.2.7, JD Edwards EnterpriseOne provides secured email communication by enabling the
TLSv1.2 and SMTP authentication for the email notification framework.
339
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
340
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
Defines the name of the SMTP mail server Server Manager will utilize for sending e-mails.
◦ SMTP Port
The TCP/IP port to use when connecting to the SMTP mail server for sending e-mails. The default value
is 25, though some mail servers may be configured to use an alternate port.
◦ Sender Email
The e-mail address to use as the sender for e-mail notifications sent by Server Manager.
◦ Email Address
PLAIN Connection shall be established/made with the SMTP server without encryption.
STARTTLS Informs the mail server to upgrade the non-encrypted connection to an encrypted connection.
SSL/TLS (Secure Sockets Layer/ A secured connection shall be established or made with the SMTP server by encrypting the
Transport Layer Security) communication with the TLS1.2 protocol.
◦ Enable Authentication
Enter True or False. The email is delivered only when the value is True and when authentication is
enabled on the SMTP server.
◦ SMTP Username
Enter the username to authenticate with the SMTP server. This applies only when authentication is
enabled on the SMTP server.
◦ SMTP Password
Note: If the Server Manager is TLS enabled, the system selects the Keystore name, Truststore name, and password
settings automatically from the global Server Manager settings. Therefore, separate TLS level settings are not
provided in the Email Configuration pane.
JD Edwards EnterpriseOne Email delivery system has been tested and certified with the SMTP Server for Microsoft
Office 365 Exchange.
341
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
Consider the following to ensure that the EnterpriseOne email delivery system works with Microsoft Office 365
Exchange:
Monitors
This section describes:
• Create a Monitor
• Monitor Configuration
• Available Monitors
• Monitor History
Create a Monitor
You use monitors to track events that occur within the management domain and record historical data of managed
instances. Once you create the monitor, the configuration page for the new monitor will be displayed. Multiple monitors
can be created with different parameter settings to monitor various aspects of managed instances. An email can then
be sent to the appropriate person or group alerting them to specified status changes in the managed instances.
342
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
Monitor Configuration
All configuration items for the new monitor are displayed on this page.
General Properties
343
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
Note: The Save button applies only to the pane where the Save button is located. It does not save the entire page.
The Save button must be clicked within each pane for changes made within that pane.
Managed Instances
This section describes:
• Include a Managed Instance(s) in a Monitor
• Remove a Managed Instance(s) from a Monitor
Note: Changes made to the instance selection, if the monitor is currently running, will take effect immediately and
does not require restarting the monitor.
344
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
Monitored Events
You can select the individual events that a specific monitor should observe that will trigger an e-mail alert.
Examples include:
345
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
346
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
Note: As the business function details and the user details are retrieved from the respective
EnterpriseOne databases, you must upload the correct JDBC drivers during the initial Server Manager
Console configuration. If the Enterprise Server JDE.INI files are encrypted, then Server Manager
Console will have a valid Enterprise Server registered which will be used during the site key decryption
to retrieve the EnterpriseOne database authentication details.
347
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
This event occurs when a user cannot sign onto a HTML server due to a system related failure. It does not
include login failures caused by incorrect user activity, such as supplying incorrect login credentials.
◦ Enterprise Server Disk Space
This event occurs when a physical disk on a monitored enterprise server meets the specified threshold
value(s). You may specify the 'Percent Used Threshold', in which an event will be triggered if the usage on
the disk/volume reaches or exceeds the specified percentage. An event may also be specified when the
disk has less than a specified number of kilobytes available. The enterprise server must be running at the
time of collection for this metric to be evaluated.
◦ Percent Used Threshold
Allows you to specify, in seconds, a threshold value for the duration of UBEs. If a UBE takes longer than
the specified threshold to complete a notification will be sent.
◦ Time Limit (Seconds)
This event enables receiving notification whenever a problem occurs while performing a CallObject
(business function) request from an EnterpriseOne HTML server to an enterprise server. You may specify
a threshold for each of the error types that may occur. Once reached notifications will be sent for the
corresponding CallObject error.
◦ Application Error Threshold
This event occurs when a kernel process reaches the supplied threshold value for outstanding request.
Outstanding requests are requests that are queued for the kernel but have not yet executed to do current
348
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
work. The notification will be sent each time outstanding requests are greater than the last sample period
and above the specified threshold value.
◦ Outstanding Requests Threshold
This event occurs if a user attempts to sign on to a web product and the configured security server did
not successfully respond to the authentication request.
2. Click the Save button to save your settings.
Note: Changes to the event selection for a monitor, if running, will take effect immediately and do not require
restarting the monitor.
Note: If input values are used in the enterable fields, the parameter field immediately above the input section must
have the check box selected in order for the input values to be applied.
Notification Hours
You may specify the hours of the day in which e-mail notifications will be sent. If an event occurs outside the configured
times the event will still be recorded in the monitor history. An email per event, per threshold, per duration will be sent.
You may have identical monitors assigned to different time frames to notify different people. A monitor may be set up
to notify a person during prime hours, and a different identical monitor to notify a different person for non-prime hours.
To specify notification hours, enter start and stop times using the twenty four hour clock. For example 11:33 PM would
be specified as 23:33. The day's range is between 00:00 and 23:59.
E-Mail Subscriptions
Specified e-mail addresses, including distribution lists, will receive a notification when any of the subscribed events
occur. An unlimited amount of e-mail addresses may be added to a monitor.
349
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
Available Monitors
Displays each of the monitors. Use the links to modify the configuration of the individual monitor. If the monitor is
currently running or has been run since the management console was started you may view the monitor results.
• Start a Monitor
• Stop a Monitor
• Delete a Monitor
• Modify the Monitor Configuration
• View a Monitor Report
• Create a Duplicate Monitor
350
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
Start a Monitor
To start a monitor:
Stop a Monitor
To stop a monitor:
Delete a Monitor
To delete a monitor:
1. Click the icon in the Create Duplicate column for the monitor.
351
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
2. Specify a name for the new monitor, by completing the Monitor Name field.
Monitor History
The Monitor History section displays all monitors that are currently or have previously run.
352
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
View Report
To view a monitor history report:
The report provides information for the event and email. The Emails Not Sent field will report the number of emails
accumulated outside the Notification Hours designated in the configuration settings for the monitor. The Failed Emails
field will report the number of emails not delivered due to any issues with the email system, such as an email server
being down.
Note: Currently running monitors will also appear in the monitor history list. Their history may not be deleted while
the monitor is active.
353
JD Edwards EnterpriseOne Tools Chapter 26
Server Manager Guide Monitor JD Edwards EnterpriseOne Servers
354
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
• Details
• Agent Log Level
Server Manager generates log files detailing its activity within the Managed Homes . Managed Home logging
can be accessed from the main menu. Upon logging into Server Manager , find the Managed Home that you
want to access by selecting the view in the Select View field called Managed Homes and Managed Instances. In
the grid field called Managed Home Location, select the Managed Home Location with the logs that you want
to view.
Details
When a Managed Home Location has been selected, the Managed Home Details section appears on the next screen.
This section provides selection options for configuring the messaging level for the Management Agent logs.
355
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
The log file receives all messages that are at or above the selected log level. For example, if the log level is configured to
Fine the log files will receive all generated messages at the Fine, Config, Info, Warning, and Severe level.
The default and recommended level is Fine. The finer and finest log levels should only be used for troubleshooting a
specific Server Manager issue.
• Off
This setting prevents any log messages from being written. It is not recommended to disable logging.
• Severe
This level is for errors from which the system is not able to recover. Severe events are very rare for Server
Manager and indicate a significant problem that needs to be addressed.
• Warning
This level is for errors from which the system can recover; however these errors indicate a deviation from the
expected path of least resistance scenario and are indicative of failure points in overall system health.
• Info
This level receives messages that indicate the high-level tasks the agent is performing.
• Config
This level includes information about the configuration or environment used by the Management Agent .
• Fine
356
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
This level includes trace-level logging messages used to understand not just which actions the Management
Agent is performing but also details about how it is performing those tasks.
• Finer
This level contains the most detailed messages and may generate large log files.
• All
At this level all log messaging levels are displayed; it is equivalent to selecting Finest.
The Management Agent writes log files to a subdirectory named logs on its the installation path. The log files may be
viewed using the Server Manager log file viewer.
The Management Agent maintains up to ten log files with a maximum size of 10MB each. The most recent log file
always has _0 in the filename. As the current log file reached the 10MB limit, the last log file is removed, the log index
file for existing log files is increased, and the logging continues with a new file using the zero log index.
357
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
• Filename
The complete path and name of the log file.
• File Size
The size of the log file, in bytes.
• Last Modified
The date and time the log file was last modified as reported by the operating system.
Server Manager provides a mechanism for adding messages to the active log files. This mechanism is available only
for the web-based JD Edwards EnterpriseOne servers and only when the instance is running. A free-form text message
can be entered that is written to all the active log files for the Managed Instance . After entering the message, click the
Write Log Message button to post the message to the active log files.
• Message to Write
358
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
A free-form text message can be entered that is written to all the active log files for the managed instance.
Log files that are no longer of interested can be deleted using Server Manager . To remove a log file select the check
box next to the desired log file(s) and click the Delete button. The selected log files are removed from the file system and
no longer appear in the Available Log Files section.
Log files that are currently in use cannot be deleted. A warning indicates which log files cannot be deleted because they
are in use.
On UNIX-based operating systems it might be possible to delete a log file while it is still in use. The file is removed from
the file system and no additional log messages are written to the file.
Log files should be deleted only if you are sure they are no longer needed.
359
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
360
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
Criteria
Criterion may be added to narrow the results that are returned. Additional rows can be added by clicking the Add
Another Row button.
• Criterion Type
The Criterion Type field has a dropdown list with the following filter criteria:
Contains
Matches regex
361
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
Apply Filter
• Page Size
Log file contents are displayed using finite page lengths. Use this dropdown to customize the maximum
number of lines that may be displayed in a single returned page. Select from these options:
250 Lines
500 Lines
1000 Lines
362
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
• Match Type
Select how multiple criteria will be evaluated. Selecting Any Criterion returns log lines that match one or more
of the supplied filter criteria. Selecting All Criterion (should be criteria, but if its that way in the software, then
leave it of course) returns only those lines that match all of the supplied criteria.
After selecting the filtering preferences, click the Apply Filter(s) button to apply the filtering.
Save As Favorite
This section describes:
• Save a Favorite
• Run a Favorite
• Remove a Favorite
Save a Favorite
To save a favorite:
1. Click the Save As Favorite button.
2. Specify a name for the save criteria.
3. Click the OK button.
The favorite appears in the Favorite field drop down list for selection. These filter favorites are saved to the user account
used to sign in to the management console.
Run a Favorite
To run a favorite:
1. Click the Favorite dropdown arrow.
2. Select a favorite from the list.
3. Click the Go button.
Remove a Favorite
To remove a favorite:
1. Click the Favorite dropdown arrow.
2. Select a favorite from the list.
3. Click the Remove button.
363
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
Download
You can download log files for viewing or parsing using other tools.
◦ Open with
◦ Save to Disk
3. Click the OK button.
Some very large log files might not be displayed properly within the log file viewer. If a file is too large for viewing using
the integrated viewer, an appropriate message appears. You can still download these large log files for viewing with
tools more suited to handling large text files.
Results
The second segment of the log file viewer is the log file. Results are color-coded and displayed in pages. EnterpriseOne
log files are color coded for improved readability. The last date modified and file size information appears in the Last
Modified and File Size fields.
364
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
If the log file contains more lines than the current page size a dropdown appears on the upper and bottom right of the
log contents. Use the dropdown or Previous/Next links to view the page of interest.
jde.properties Logging
The web based EnterpriseOne servers use the jdelog.properties file to configure their logging activity. The Java-based
Enterprise Server kernels also utilize the jdelog.properties file to configure their own logging activity. Server Manager
provides an interface to configure these log files without having to directly modify the corresponding properties file.
From the management page for an EnterpriseOne server select the Database link in the Configuration pane. A page
appears that provides details about the current configuration defined within the properties file.
365
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
Each configured log file appears as a row in the Log File Configuration section.
◦ Critical Errors
◦ Warnings and Recoverable Errors
◦ Application Level Activity
◦ Low Level Troubleshooting Messages (Verbose)
• Log Format
366
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
There are three different formats available that differ in the amount of technical information included with each
log message.
The recommended format is Applications Format. The technical format contains the same information
but adds the line number of the originating logging call. Line number information is not included in the
EnterpriseOne products. Technical with Threads adds the name of the thread in which the log message
originated.
• Append Log Files
If TRUE, log files will append to existing log files with the same name. If FALSE, existing log files with the same
name is truncated prior to writing the first log message.
• Max. Log Size
This value defines the maximum size a log file may reach before it is renamed to a backup file and new log is
created. The value should be specified in xxMB, where xx is a number specifying the number of Megabytes.
Example: 10MB.
• Max. Backup Index
The maximum number of backup files to retain. When a log file reaches the maximum allowed file size it is
archived to another log file. This value specifies the maximum number of those backup entries to keep.
• Log Components
Specifies the components within the EnterpriseOne product to log. You may specify ALL or the individual
components (such as Runtime, JDBJ, etc.) that should be logged.
Apply Changes
After making changes, click the Apply button to save any modifications. Changes including adding new log
configurations are dynamically re-loaded by the running managed instance each time the Apply button is selected.
For the web-based server products adding, modifying, or removing log files takes effect immediately after pressing
Apply if the corresponding server is running. Java based enterprise server kernels will take up the modifications the next
time the server is started.
367
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
Server Manager creates a new log definition using default values based on the E1LOG definition, if present. The log file
path is created based on the log definition name supplied. You can change any of the default values created just as you
would modify any of the log configurations.
368
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
The configuration for the user-level logs is stored in the userloggingconfig.xml file on the Server Manager Console and
contains the user name and component information.
User Logging also enables you to combine logs for a specific user and download them in a single compressed file.
Under User Logging Configuration, enter the name of the user in the User Name field for whom you want to configure
user logs. You can enter only one user at a time.
369
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
From Instance Type list, you can select the server type for which you want to configure user level logs. By default,
Enterprise servers have CallObject as the defined Log Component.
For HTML and AIS servers you have the below log configurations available to update:
• Log Level Threshold
Defines the threshold of log messages that should be written to the file. The order is Critical Errors, Warnings
and Recoverable Errors, Application Level Activity, and Low Level Troubleshooting Messages (Verbose).
Selecting Application Level Activity, for example, will receive all Critical Errors, Warnings and Recoverable
Errors, and Application Level Activity level messages and Low Level Troubleshooting Messages (Verbose is
ignored).
• Log Format
There are three different formats available that differ in the amount of technical information included with each
log message.
The recommended format is Applications Format. The technical format contains the same information
but adds the line number of the originating logging call. Line number information is not included in the
EnterpriseOne products. Technical with Threads adds the name of the thread in which the log message
originated.
• Append Log Files
If TRUE, log files will append to existing log files with the same name. If FALSE, existing log files with the same
name is truncated prior to writing the first log message.
• Max. Log Size
This value defines the maximum size a log file may reach before it is renamed to a backup file and new log is
created. The value should be specified in xxMB, where xx is a number specifying the number of Megabytes.
Example: 10MB.
• Max. Backup Index
The maximum number of backup files to retain. When a log file reaches the maximum allowed file size it is
archived to another log file. This value specifies the maximum number of those backup entries to keep.
• Log Components
Specifies the components within the EnterpriseOne product to log. You may specify ALL or the individual
components (such as Runtime, JDBJ, etc.) that should be logged.
After you have entered the user name, selected the instance type, and updated the fields for HTML and AIS servers, you
can use the below options to manage the user-level logs.
370
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
Note: The time taken to enable user logs depends on the total number of server instances registered on the
Server Manager Console.
This removes the user-level log entry from the userloggingconfig.xml file for the selected user in the Sever Manager
Console. Additionally, all the selected servers stop logging the user-level logs for the selected user.
Based on the instance type, the log files are divided in different sections. Enterprise Server Resources section lists
the user-level logs for the Enterprise servers and EnterpriseOne HTML Server Sessions and EnterpriseOne AIS Server
Sessions list the user-level logs for HTML and AIS servers respectively.
Note: After you delete the user logs, you must disable the user-level logs and enable it again to get the CallObject
Kernel logs.
371
JD Edwards EnterpriseOne Tools Chapter 27
Server Manager Guide Available Log Files
372
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
You must manually update a Management Agent when notified, as described in this chapter. If you do not update the
Management Agent , unpredictable and undesirable results can occur in the execution of Server Manager requests on
the target machine on which the Management Agent resides.
If you update the Management Console to a new Tools Version (for example, 8.98.3), you must upgrade the
Management Agents to the same version. Otherwise your Server Manager cannot communicate and operate with the
target machines as expected.
You update the Management Console by changing its Software Component using the same method as changing any
other Server Manager Managed Instance (refer to Managed Software Components).
CAUTION: Changing the Software Component version for the Management Console will automatically restart the
Management Console application and terminate any active user sessions.
373
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
374
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
1. On Managed Homes and Managed Instances, locate the Managed Home Location for your Software
Component and click the link for the associated Managed Instance for home.
This is the location you specified when you installed the Software Component , where the default is c:\jdehome.
2. In the General section of the page, under Software Component Version, click the Change ... button.
The Management Console displays a popup with a list of available Managed Software Components is
displayed. For example:
375
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
3. On the Change Tools Release popup, you can select a Software Component radio button and click the Change
Component button to change to that version.
The update process starts immediately and upon completion the Management Console application will
automatically restart. If the Management Console fails to restart as expected, refer to Troubleshooting an
Unsuccessful Management Console Update in this chapter for a description of symptoms and recovery.
Note: To update the WebLogic Server to 12.2.1.3, you must first update the Tools Release to 9.2.2.4.
To resolve the Warning you must restart the Management Agent to complete the update process.
When the Management Console determines that a Management Agent version is out of sync (mismatched) with the
version of the Management Console itself it displays a notification under the Managed Home Location of the applicable
Management Agent . For example:
376
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
377
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
1. On Managed Homes, select the Managed Home Location for which indicates: Agent Update Required.
378
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
2. Use the check box to select the appropriate Managed Home Location.
4. Click OK to immediately begin updating the selected Management Agent . Once the update is complete, Server
Manager will automatically restart the Management Agent .
When the pre 9.2 Server Manager Agent is updated to 9.2 (the update process initiated from the Server
Manager Console itself when the "Agent Update Required" message is seen by the Administrator and the
Administrator selects the checkbox and performs the update operation) from an earlier tools release, it is
necessary for the Administrator to manually change/replace the $SCFHA/jdk/jre within the Server Manager
Agent after the update.
The Administrator should use a 32-bit jdk/jre if the Server Manager Agent is going to manage a Deployment/
Enterprise Server, otherwise use a 64-bit jdk/jre.
It is recommended not to use the existing jdk/jre which came with the older Server Manager Agent installation.
379
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
(Release 9.2.1) To start or to stop all the instances, on Managed Homes and Managed instances, click Start All Instances
or Stop All Instances button.
\jde_home\targets\home\_staging
380
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
The script takes one parameter, which is the password used to initially install the Management Console . For
example
redeployManagementConsole.cmd password
Upon successful execution of this script, you can log on to the Management Console application.
(Release 9.2.2.4) If you updated WebLogic Server to 12.2.1.3 and the Management Console update was unsuccessful,
troubleshoot the Management Console update before updating to EnterpriseOne Tools release 9.2.2.4 or later.
1. Ensure that the Server Manager Console is on a Tools Release earlier than 9.2.2.4.
2. Stop the Managed Server where Server Manager Console is installed on the WebLogic Server.
3. Extract the ManagementAgent_JAR file from 9.2.2.4 Server Manager JAR file. The ManagementAgent_JAR file
is located at <E1_ServerManagerConsole.jar>\ManagementConsole_WAR.ear\ManagementConsole_WAR.war\WEB-IN\lib
\.
4. Replace the ManagementAgent_JAR file with the file you have extracted in the previous step at following
locations:
◦ <jde_home>/SCFMC/stage/ManagementConsole_WAR.ear/ManagementConsole_WAR.war/WEB-INF/lib
◦ <WLS_HOME>/user_projects/domains/<domain_name>/servers/<server_name>/tmp/_WL_user/
<application_name>/<folder_name>/war/WEB-INF/lib
You need not replace the ManagementAgent-JAR file at this location if the lib folder is not available.
5. Start the Managed Server.
6. Update the Tools Release for Server Manager to 9.2.2.4.
381
JD Edwards EnterpriseOne Tools Chapter 28
Server Manager Guide Update Server Manager
382
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
Note:
• Refer to the JD Edwards EnterpriseOne Interoperability Guide in the chapter Using Java Database Connectivity
for additional tasks and topics related to the Data Access Server.
• JD Edwards EnterpriseOne BI Publisher for JD Edwards EnterpriseOne Guide
• Refer to various Red Papers in the Red Paper Library on Customer Connection.
Navigation: Customer Connection > Implement, Optimize, and Upgrade > Implementation Guide >
Implementation Documentation and Software > Red Paper Library
http://www.peoplesoft.com/corp/en/iou/red_papers/index.jsp
383
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
You must use Server Manager to install a Data Access Server instance.
Note:
• Prerequisites and Recommended Installation Sequence for Managed Instances for Data Access Server Instance
384
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
1. Select the Managed Home in which you wish to install the Data Access Server.
385
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
2. Click the Create a New Managed Instance button to create the Managed Instance in the Managed Home .
386
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
4. Click Continue.
◦ Server Group
Use the pulldown to select the Server Group to which you want this instance to belong.
Tip: A good business practice is to name your instances so that they are easily and consistently
identifiable. For example: PRODUCT_SERVER_PORT where PRODUCT is the JD Edwards EnterpriseOne server
type, such as Data Access_Server, and where SERVER is the machine on which the instance is installed,
and where PORT is the HTTP port which is defined for use by this server.
◦ Install Location
This location must be unique and not within the Management Agent directory structure.
◦ Software Component
Use the dropdown to select the version of this Software Component that you wish to install.
387
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
6. Click Continue.
388
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
389
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
7. On Create/Register a Managed Instance, Confirmation, review the key configuration items. The values on this
form must be manually confirmed. You must validate or update, as appropriate, all configuration items.
Tip: For help, click the Information icon next to the title of a field.
Note:
◦ Configure the Default Server Group Configuration Settings
8. After you have validated and updated all configuration items, click Continue to proceed to the next installation
step.
390
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
9. On Create/Register a Managed Instance, Finish, click the Create Instance button to complete the installation of
the EnterpriseOne Data Access Server.
Once complete the browser is redirected to the Management Console page for the newly registered Data
Access Server. This server also appears as a Managed Instance within the corresponding Managed Home.
For each registered Managed Instance, the Management Console displays appropriate information at the top of
the page:
◦ General
- Status
Running
Stopped
391
JD Edwards EnterpriseOne Tools Chapter 29
Server Manager Guide Create a JD Edwards EnterpriseOne Data Access Server as a
New Managed Instance
Note:
◦ Start or Stop a Managed EnterpriseOne Software Component
Note:
◦ Change a Managed EnterpriseOne Software Component
Allows you to change the Data Access Server Password when the Data Access Server is running.
The new password is taken from the current configuration value for the Data Access Server
Password.
◦ Instance Properties
- Install Location
The name assigned to the Managed Instance at the time it was created or registered.
For information on log files, refer to the chapter entitled: Available Log Files.
392
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
A Runtime Metrics information summary and links to detailed information are available for each Enterprise Server
that is running. Metrics are provided by an embedded variant of the management agent built into each EnterpriseOne
server. A new kernel definition, the management kernel, was added in 8.97. A single management kernel process is
created when the enterprise server is started. The management kernel is responsible for securely networking between
the enterprise server and the server manager management console while providing the runtime details of the enterprise
server.
Note: You must import the Server Manager Console certificate to the Trust Sore of all the Managed Targets that have
the Runtime Metrics. Otherwise, the Runtime feature will not work with the Server Manager Console configured on
HTTPS/SSL.
393
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
The following runtime metrics are available for a running enterprise server:
• General
• Process Detail
• Environment Variables
• Disk Space Usage
• Kernel Ranges
• Audit History
General
Runtime Metrics will display runtime information for these parameters:
• Uptime
The amount of time the Enterprise Server has been running.
• Network Jobs
The number of network listener processes (jdenet_n) that are currently running.
• Kernel Jobs
The total number of kernel processes (jdenet_k) that are currently running.
• Zombie Processes
Zombie status refers to an Enterprise Server process that has unexpectedly terminated without properly
cleaning ups its resources. This value will display the total number of zombie processes that are tracked in the
enterprise server shared memory segment.
• Security Kernel Users
The number of EnterpriseOne users that have a currently active security server connection to the Enterprise
Server.
• Call Object Users
The number of EnterpriseOne users that have a currently active CallObject (business function) connection to
the Enterprise Server.
Process Detail
Information about all of the running network, kernel, and other enterprise server processes can be viewed by selecting
the Process Detail hyperlink from the Runtime Metrics pane. The management kernel process will periodically query
the enterprise server to retrieve the runtime information. This polling will occur approximately every thirty seconds;
therefore it is possible that the information displayed through the server manager process detail pages may be up to 30
seconds old.
394
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
• A Process Table
The top of the page includes a Process Summary section providing a quick reference to the number of active enterprise
server processes and provides a Batch Summary that displays the running batch queues, active batch jobs, and pending
batch jobs.
A Process Summary
The status information fields for Process Summary are:
• Network Jobs
The total number of network listener jobs active on the Enterprise Server.
• Kernel Jobs
A Batch Summary
The status information fields for Batch Summary are:
• Batch Queues
The number of batch queues that are managed by the queue kernel process on the Enterprise Server.
• Active Jobs
The number of jobs that are currently being processed (running) in the batch queues.
• Waiting Jobs
The number of jobs that are currently in the queue awaiting processing.
A Process Table
The process table contains a row for each EnterpriseOne server process contained within the shared memory segment.
The shared memory segment is created by the first server process created during server startup. Each additional server
process will register itself within that shared memory segment. Server Manager uses this shared memory to identify
and display all the running server processes.
The process table lists each of the processes found. Each process is displayed along with some key columns. The table
also provides links to directly view the associated JDE and JDEDEBUG log files.
395
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
• Remove Zombie
• Process Detail
Remove Zombie
A zombie process is an enterprise server process registers itself within the shared memory segment then terminates
without removing its registration information shared memory. The most likely cause of a zombie process is a process
that performs an illegal operation and is terminated by the host operating system.
Zombie process may have their information removed from the shared memory segment. Removing the zombie process
will prevent it from showing up in the process table. To remove a zombie process select the check box next to a process
in the zombie state and click the Remove Zombie button. Selecting and attempting to remove a process that is not in
the zombie state will have no effect.
396
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
Process Detail
Selecting the process name in the process table section will display additional information about that process.
• General Information
• Connected Users
• Log File Configuration
• Thread Detail
When an individual process is selected for viewing, a process detail screen will be displayed with the Process ID number
in the heading of the page. The General Information section is always displayed followed by additional relevant sections.
Hyperlinks will appear below the Process ID that will link to the additional sections.
General Information
397
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
The General Information section will provide information for these parameters:
• Process Name
The name of the kernel process. The name indicates which kernel definition the kernel belongs to.
• Process Type
The description of the Enterprise Server process type.
• Kernel Range
The kernel definition index. The Enterprise Server is composed of kernels that process messages from other
servers and clients. There are more than thirty different types of kernels. The range index indicates which
kernel group this kernel belongs to.
• Process ID
The operating system assigned process identifier for the kernel process.
• Process Index In Shared Memory
An internal identifier used to locate the process position in the shared memory resources that track kernel and
network processes.
• Start Time
The time the process was created.
• Last Active Time
The last time the kernel performed any activity such as processing incoming JDENET messages.
• Messages Received
The total number of messages (requests) that have been processed by the kernel process.
• Outstanding Requests
The number or requests that are queued and awaiting processing by the kernel process.
• Parent Process ID
The operating system assigned process identifier of the parent process.
• IBM i Job Number
The job number of the process, valid on the IBM i platform only.
• Process User ID (OS)
The operating system user id under which the process is running.
• OS Group ID
The group identifier of the os user running the process; valid only on unix based platforms.
• OS Username
The operating system user name under which the process is running.
• OS Status
The status of the process as reported by the operating system:
398
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
0 = Sleeping
1 = Running
2 = Stopped
3 = Zombie
4 = Other
Connected Users
Security and CallObject kernel processes have active users associated with the process. The page will display a section
containing the names, originating machine, and connection time of each remote user that is active on the kernel
process.
399
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
The Log File Configuration section will contain up to three segments. The first segment allows for configuration
enablement of the JDE.LOG and the JDEDEBUG.LOG, and for setting the log levels for different log files.
• Enable JDE.LOG
This setting controls whether error and other significant messages are written to the jde.log. It is highly
recommended this logging type always be enabled.
• Enable JDEDEBUG.LOG
This setting controls whether debug and trace messages are written to the jdedebug.log. These messages
are very useful when troubleshooting an Enterprise Server; however, enabling debug logging will impact
performance.
• JDECACHE log level
Configures the level of logging generated by the cache manager. This setting will have no effect if JDEDEBUG
logging is disabled.
• IPC log level
Configures the level of logging generated by the interprocess communication (IPC) related functionality. This
setting will have no effect if JDEDEBUG logging is disabled.
• JDENET log level
Configures the level of logging generated by the JDENET network related functionality. This setting will have no
effect if JDEDEBUG logging is disabled.
400
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
Configures the level of logging generated by the thread handling functionality. This setting will have no effect if
JDEDEBUG logging is disabled.
• JDETAM log level
Configures the level of logging generated by the TAM specification access routines. This setting will have no
effect if JDEDEBUG logging is disabled.
• Security log level
Configures the level of logging generated by the security related functionality. This setting will have no effect if
JDEDEBUG logging is disabled.
• ENVDOC log level
Configures the level of logging generated by the EVNDOC (Interop) functionality. This setting will have no effect
if JDEDEBUG logging is disabled.
• IEO log level
Configures the level of logging generated by the IEO (Interop) functionality. This setting will have no effect if
JDEDEBUG logging is disabled.
Click the Save button to save any changes made to the parameters.
The second segment will display the filename, size, and last modified date of the JDE.LOG file. Select the View button to
retrieve and view the log file contents using the integrated log file viewer.
The third segment will display the filename, size, and last modified date of the JDEDEBUG.LOG file. Select the View
button to retrieve and view the log file contents using the integrated log file viewer.
401
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
Thread Detail
The active threads for the Enterprise Server process are displayed in the Thread Detail section. Each thread is displayed
along with its thread identifier, index in shared memory, and thread name. If thread metrics are enabled selecting a
thread identifier will display additional thread related metrics.
If Thread metrics has been enabled, then when the hyperlink for a Thread ID is clicked, then a Thread metrics screen
will appear with additional information for the Thread ID. If Thread metrics has not been enabled, then this screen will
appear:
Environment Variables
The Environment Variables hyperlink, when selected, will display the environment variables that are active on the
selected Enterprise Server. The displayed environment variables are those that were used to create the server process.
Changes made after the kernel process was started will not be reflected.
402
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
403
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
• Name
Kernel Ranges
Selecting the Kernel Ranges hyperlink will link to the Kernel Ranges screen. This screen has two sections:
The first section of this screen is for Network Listener Jobs (JDENET_N). The maximum number of simultaneous
network listener jobs can be designated by entering a number into the Maximum Net Listeners field.
The maximum number of network listener jobs (jdenet_n) that may be active at any given time.
404
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
This section will list each of the kernel types and the current number of processes for each type. The information in this
section includes:
• Kernel Index
The kernel definition index. Each kernel type has a distinct value, which corresponds to the
JDENET_KERNEL_DEF## section in the JDE.INI where ## represents the kernel index value.
• Kernel Type
The current maximum number of processes of the specified type that may simultaneously exist. This value is
an in-memory value only; if the Enterprise Server is restarted the maximum processes will be reloaded from the
INI configuration file.
• New Maximum
You may specify a new maximum number of simultaneous processes for a particular kernel. The value must be
equal to or greater than the current number of processes of the specified kernel type.
If the New Maximum has been changed, click the Save button next to the changed number to save the change.
Audit History
You may view the configuration changes that have occurred over time by selecting the audit history link. Each
configuration item that has changed will be listed in chronological order. You may also use the filter criteria to narrow
405
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
down the results returned. Audit history will also contain a record for each start and stop of the server that was
performed using server manager. This screen has three sections:
• Report Configuration
• Deployment History
• Changed Metrics
Report Configuration
The Report Configuration section will display all of the timestamps in which audit events have been recorded.
• Timestamp
This field will have values that can be selected from a dropdown box in the format of date, then time.
• Granularity
• This field allow you to choose:
Minute
Hour
Day
• Metric Name
This field permits narrowing down the returned results to specific configuration topics.
After selecting the values for these parameters, click the Submit button to process your selection.
406
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
Deployment History
Deployment History will provide information for the selected instance including installs, uninstalls, and changes to the
tools release within the selected time period.
Changed Metrics
Changed Metrics will display all the configuration metric changes within the selected time period.
407
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
• CallObject Stats
• JDBj Database Caches
• Database Connections
• JDBj Runtime
• JDENET Stats
• Java Environment
• Terminate
• Send Message
In the Instance Name field, select the instance name of the managed instance from which you wish to view user
sessions, or select ALL to view all instances.
• Instance Name
ALL
home
408
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
The name of the remote machine used to create the user session. This may be returned as the machine name
or IP address. If proxy servers are used the machine name may be that of the proxy server and not the actual
remote client.
• Environment
This value indicates the type of user session: 'HTML' for HTML server session, 'Data Browser', or 'Portal'.
• Login Time
The amount of time, in seconds, that the user has been idle.
• Remote Environments
Each remote environment represents a call object kernel session that has been created for the user. The format
is host:port PID:pid, where host indicates the name of the enterprise server, port indicates the JDENET port of
the enterprise server, and pid indicates the process id of the corresponding call object kernel process.
• Session Identifier
409
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
Each application stack currently active for the user session will be listed.
Terminate
The Terminate button is available to terminate user sessions. You may terminate a user session along with any
applications that are running. Use caution because the user will not be informed of this action and any work in progress
may be lost. Select a check box for the user session that needs termination, and then click the Terminate button. A
management console user must posses the userSession permission granted for the managed instance on which the
user is active in order to terminate the session.
Send Message
The Send Message button is available to send messages to the applications active within a user session. You may select
users and send a message. Messages will be received only by users who have an application running, and only when
they perform an activity within the application such as pressing Find on the toolbar.
CallObject Stats
The CallObject statistics detail the business functions that have been invoked by a web product. Each business function
that is called is recorded and displayed along with timing, invocation counts, and error counts.
Business function invocations and related statistics may be viewed for a single instance or multiple instances In the
Instance Name field, select the instance name of the managed instance from which you wish to view user sessions, or
select ALL to view all instances you are authorized to view. After making the selection, click the Submit Query button to
refresh the results.
• Instance Name
ALL
home
CallObject Table
Statistics may be dynamically cleared for individual or all business function invoked.
410
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
The Call Object (BSFN) Stats window displays cumulative data about each type of business function that has run during
a server session. This table summarizes the information displayed for each business function:
• JVM Node Id
An identifier that uniquely identifies an individual JVM. This column will appear only if an instance was
detected with multiple JVMs.
• Enterprise Server
The Enterprise Server name and port of the Enterprise Server to which the statistic applies.
• Business Function Name
The amount of time, in milliseconds, that a first invocation of the business function took. The first invocation is
not counted towards the average due to its initial overhead.
• Average Time
The average time, in milliseconds, that a first invocation of the business function took. The first invocation is
not counted towards the average due to its initial overhead.
• Shortest Time
The shortest amount of time, in milliseconds, that an invocation of this business function took.
• Longest Time
The longest amount of time, in milliseconds, that an invocation of this business function took.
• Total Time
The longest amount of time, in milliseconds, that an invocation of this business function took.
• Timeout Errors
The number of invocations of this business function that resulted in a JDENET timeout rather than a successful
completion.
• Application Errors
The number of invocations of this business function that resulted in an application returned error rather than a
successful completion.
411
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
• System Errors
The number of invocations of this business function that resulted in a system error rather than a successful
completion.
The CallObject Information view also displays the number of business function processes in progress. This number can
be important for troubleshooting purposes. A large number of in-progress processes may indicate that the Enterprise
Server is running slowly and alert you that you need to investigate the possible causes.
Reset Statistic
The Reset Statistic button will reset the statistics for the selected business functions.
In the Instance Name field, select the instance name of the managed instance from which you wish to view user
sessions, or select ALL to view all instances. After making the selection, click the Submit Query button.
• Instance Name
All can be selected which will display every instance selected, or an individual instance can be selected. The
selections available are:
All
home
412
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
• Cache Name
All can be selected which will display every cache within the instance selected, or an individual cache can be
selected.
Serialized Objects
Menu Cache
Select a value from the Instance Name and Cache Name field. When both fields have been selected, then click on the
Submit Query button.
JDBj Services Caches are displayed for the selected managed instances.
• Instance Name
This will display based on the Instance Name selected in the previous Instance Name drop down selection. The
unique name assigned to the managed instance at the time it was created or registered.
413
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
• Cache Name
This will display based on the Instance Name selected in the previous Instance Name drop down selection. The
name of the JDBj service cache.
• Cache Hit Ratio
The total number of requests the cache has serviced and returning a matched result.
• Cache Misses
The total number of requests the cache has serviced and did not find within its cache.
Clear Cache
The Clear Cache button will clear cache for the selected Instance/JVM.
Database Connections
Database connections and prepared statement caches can be viewed across a single instance or multiple instances
simultaneously. The Database Connections hyperlink will link to the JDBj Connection Caches screen.
414
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
The Instance Name field allows for all instances to be selected which will display every instance, or an individual
instance can be selected. Once the Instance Name has been selected, click the Submit Query button.
• Instance Name
All can be selected which will display every instance selected, or an individual instance can be selected. The
selections available are:
All
home
JDBj Pooled Database Connections shows the number of available pooled connections for each JDBj logical data source.
The numbers below represent the number of available, unused connections and do not include open connections that
are currently in use.
The Prepared Statement Cache Detail shows each of the SQL prepared statements being cached on each managed web
server. The numbers indicate the number of pooled database connections that are caching that prepared statement.
These values are further broken down by the logical database connection URL.
Note: Prepared statement caches are not maintained for the Oracle products; Oracle products use the Oracle native
prepared statement caching instead.
JDBj Runtime
The JDBj Runtime screen allows for viewing or modifying the runtime configuration of JDBj, which can be done across a
single instance or multiple instances simultaneously.
415
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
In the Instance Name field, select the instance name of the managed instance from which you wish to view user
sessions, or select ALL to view all instances. After making the selection, click the Submit Query button.
• Instance Name
All can be selected which will display every instance selected, or an individual instance can be selected. The
selections available are:
All
home
Properties
The Properties section allows the Value of the property to by dynamically changed.
416
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
The Properties section allows the value of the property to by dynamically changed.
• Value
The current value in use for the property. This value may be defined in a drop down menu or may be a text field
that allows free-form entry of the value.
Apply
When a value has been entered, click the Apply button to dynamically apply the change.
417
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
Note: You can access the Serialized Objects page from the Serialized Objects link in Runtime Metrics pane when
you log in as a Server Manager Console Administrative user.
• Type
Select the type of serialized object you want to delete. You can select the following object types:
Application
Report
NER
Business View
Table
Data Dictionary
• Name
JDENET Stats
The JDENET Stats hyperlink connects to the JDENET Connections screen, which has these sections:
• JDENET Connections
• JDENET Connection Pools
• JDENET Socket Connections
418
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
JDENET Connections
EnterpriseOne web products maintain a pool of JDENET connections that are shared among all the active users of the
web product. A connection pool is created for each foreign host, such as an Enterprise Server, that the web product
contacts using JDENET. Each connection pool has a number of established JDENET connections to the foreign host.
A request to a particular host will use one of these sockets, or if no sockets are available, wait until a socket in the pool
becomes available.
Viewing the JDENET statistics for connections established by the HTML server can be viewed across a single instance or
multiple instances simultaneously.
The Instance Name field allows for all instances to be selected which will display every instance, or an individual
instance can be selected. Once the Instance Name has been selected, the screen will refresh with the updated
information. In the Instance Name field, select the instance name of the managed instance from which you wish to view
user sessions, or select ALL to view all instances.
• Instance Name
All can be selected which will display every instance selected, or an individual instance can be selected. The
selections available are:
All
individual instance name
home
• Host Name
The name of the Enterprise Server the connection pool represents.
• JDENET Port
419
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
420
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
• Messages Written
The number of JDENET messages that have been written on the socket connection.
• Bytes Written
The number of bytes that have been written on the socket connection.
• Socket in Use?
The time the socket was checked out by the thread using it.
Java Environment
The java environment runtime metrics provide insight into the JVM(s) running the EnterpriseOne Web products. This
information may be helpful in understanding or troubleshooting the java environment in which these products operate.
The Java Environment hyperlink, when selected, will link to the Java Environment Runtime Detail screen.
421
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
General information about the Java virtual machine for the managed instance is displayed in the General Java
Information section:
• JVM Node Id
422
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
Information about the current memory usage is available. The information is current at the time the page is initially
loaded.
• Thread Name
423
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
AIS Information
The AIS Information section provides metrics for:
• AIS JVM Count
• AIS Uptime
• Online Users
424
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
See the context sensitive help for more information on each metric.
Login Metrics
Displays the login request and response metrics for the AIS Server.
Runtime Configuration
Displays the runtime configuration settings being used by the AIS Server.
Form Metrics
Displays the form related metrics specific to user activity with a particular application and form.
Session Metrics
Displays the user session SSO metrics.
Java Environment
See: Java Environment Runtime Detail
425
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
• Failed Events
• Subscribers
• Event Metrics
Failed Events
The Failed Events section contains:
426
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
Subscribers
The Subscribers section contains:
• Select [Subscriber]
• Purge Subscriber Queued Messages
427
JD Edwards EnterpriseOne Tools Chapter 30
Server Manager Guide View Runtime Metrics for a Managed Instance
Select [Subscriber]
The subscribers section outlines the subscribers for the transaction server.
Event Metrics
The Event Metrics section outlines the event metrics for the transaction server. Information is provided for the Metric
Name and the Metric Value grid fields.
428
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Configuration Overview
Every configuration setting (*.INI, .PROPERTIES, etc.) is manageable through the management console. The
configuration files still exist in the same form as prior tools releases. The management console provides a front end for
modifying the configuration values and adds the following benefits:
• Every configuration item is present and documented with online help.
• A list of values, when applicable, is used for settings that have distinct allowed values.
• Changes to configuration settings are recorded for historical analysis and auditing, including the user that
made the change.
• The configurations of multiple managed instances may be compared to identify differences.
• New configuration settings are merged into existing configuration files when a tools release upgrade is
performed.
Configuration is accessed from the management page for an instance. Configuration settings are grouped into high
level categories. Selecting a category displays all the settings contained within.
Each high level category is divided into sub-categories containing the individual configuration parameters.
There is also a drop down menu that displays options for Standard and Dynamic views.
429
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
• Compare Instances
• Save or Restore
• Configuration Summary
Save or Restore
Save or Restore allows users to:
Configuration Summary
The Configuration Summary provides a list of all current configuration values for an instance on one page.
430
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
431
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Instance Properties
The Instance Properties section of the page lists specific properties for a managed instance. For example, the properties
for a Managed Instance for a JD Edwards EnterpriseOne HTML Web Server would include:
• Instance Location
• Instance Name
• CallObject Kernel Memory Limit
• Runbatch Memory Limit
432
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
433
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
1. Enter the passphrase in the Enter Passphrase to Generate the Site Key field. The conditions to set the pass
phrase are as shown in the following screenshot. This window is displayed if you enter an invalid passphrase.
2. Click Generate. You will see the following window if the site key is generated successfully. Also, you will see a
warning window saying "Both Current Key and Previous Key are found in JDE.ini." if you enter a duplicate value.
434
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
The JDBC interface of the EnterpriseOne HTML Server is a single-process connection to a database; on the other
hand, multiple connections are made through the Enterprise Server kernel processes using JD Edwards EnterpriseOne
CallObject kernels. The EnterpriseOne HTML Server depends on communication to the Enterprise Server Security kernel
for authentication and other security process requests to function properly; thus loss of database connections on the
Enterprise Server Security and Metadata kernel processes has a subsequent downstream effect on the EnterpriseOne
HTML Server performance.
Kernels that are classified as static use a bootstrap login to establish the connection. This means that the login
credentials are stored in and read from the jde.ini of the Enterprise Server. This is called the login environment. Unlike
dynamic connections, a login to a static kernel is never logged out during the process lifetime. Again, this is because
unlike dynamic connections, a static login environment is not subject to timeouts due to inactivity or logouts. Under
normal conditions, these static kernels are only restarted when the Enterprise Server is restarted. Otherwise static
kernels can only be restarted by manually killing the process and restarting it.
Among the key functions of a static kernel are database connections. If the connection to the database is temporarily
lost for any reason such as network unavailability, the kernels have fault-tolerant logic to retry the connection for up to
75 seconds reusing the same connection. If the connection cannot be reestablished within 75 seconds, the process is
failed. As previously mentioned, an entire static process can only be restarted by either restarting the Enterprise Server
or by manually killing and restarting the process.
In order to avoid the situation where the database connection within a kernel process are in a failed state (timed out
for more than 75 seconds) that is unknown to the system, functionality is added to Server Manager to refresh those
database connections in static environments either periodically or on demand. This functionality is only available to an
Admin user for Server Manager. When invoked, this function refreshes each static kernel for all database connections.
The list of such static kernels may change from release to release, so it is not important that they be individually listed.
Additionally, a static environment type, such as Security, may include multiple kernels of the same type. In such cases,
this function will refresh each kernel in a static environment type.
It is important to note that the intent of a "refresh" is primarily to reestablish the database connections without
resorting to a destructive "kill" action. As such, a refresh preserves the other logical states in the kernel and the kernel
maintains the same internal functional state as it was prior to the refresh of the database connections.
One exception to the static kernel model is the Workflow kernel. This kernel can only free expired environments, that
is, environments that have timed out. If a workflow environment is still active, it will not be forcibly freed by the refresh
process.
435
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Note: The implementation of Automatic Kernel Refresh is only compatible with Oracle databases that are using multi
node Real Time Application Cluster (RAC). This is because the process depends on the availability of a functioning
node, which is not the case in a single node database in the event of a failure due to such factors are hardware
or network issues. Multi node RAC environments are typically available for Oracle Autonomous Database (ADB)
implementations.
In order to avoid disrupting normal processing, the JD Edwards kernel automatic kernel refresh logic only executes on
an idle kernel process. If a kernel uses multiple threads, the logic will wait to refresh until all threads are idle. Basically
a refresh involves a logout and a bootstrap login which reestablishes the database connections either using existing
connections or establishing new connections; thus ensuring the connections are valid. This logout/login process does
not kill a process or establish a new process - it reuses the existing process with reestablished database connections
and returns the kernel to its prior state.
For implementation details, refer to the following section entitled: Using Automatic Kernel Refresh.
You can use the Refresh Environments button to force a refresh for all static environments and CallObject kernels
(which are dynamic kernels).
For static environments, the refresh will occur regardless of whether the kernel is idle. However, the refresh will wait
until all threads of the kernel are complete. As with the automatic kernel refresh, the refresh does not kill a process or
establish a new process - it reuses the existing process with reestablished database connections.
For CallObject kernels, these are dynamic kernels which are created by actual or programmatic user logins. Clicking the
Refresh Environment button flags these kernels for recycling. In this case, recycling means the system will attempt
to terminate a CallObject kernel gracefully, which means when all users of the CallObject kernel are either voluntarily
logged out or forcibly logged out by an inactivity timeout (typically either 6 or 12 hours, for inactive or forced logouts,
respectively). New CallObject kernels are created upon user login. This reestablishes the database connections for the
kernel.
For example, in Production environments you might use the on-demand function if you are performing database
patching during a planned maintenance window. In this case you would not be constrained by a short loss in system
availability.
For implementation details, refer to the following section entitled: Using On-Demand Kernel Refresh.
Note: You must have Administrator privileges in Server Manager in order to enable automatic kernel refresh.
The automatic kernel setting is set by Server Manager in the Security section for the Enterprise Server. The Bootstrap
Environment Refresh Interval setting allows you to set the automatic refresh environmental interval for all static
environments. Values can be set in one hour increments 0 to 24. If the value is set to 0, then no automatic refresh will
occur for static environments. For a description of the logic, refer to the preceding section entitled: Understanding
Kernel Refresh.
436
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Note: This function creates Server Manager logs which you can use to verify program functionality or to perform
additional debug, if necessary.
1. In Server Manager, select the Enterprise server that you wish to configure for automatic kernel refresh.
2. Navigate to Configuration > Advanced > Security
437
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Valid values are from 0 to 24 hours (0 to 86,400 seconds), where the default value is 3600 (one hour).
Enter a value of 0 if you want to disable this functionality.
438
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
439
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
4. You can also set a value for this database setting that enables, disables, and controls the broadcast functionality
for Automatic Kernel Refresh.
Note: This function is related to the implementation of Automatic Kernel Refresh, which is only compatible
with Oracle databases that are using multi node (2 or more nodes) in a Real Time Application Cluster (RAC).
This is because the process depends on the availability of a functioning node, which is not the case in a single
node database in the event of a failure due to such factors are hardware or network issues. Multi node RAC
environments are typically available for Oracle Autonomous Database (ADB) implementations.
Specify a value (in seconds) for the interval to send a broadcast message regarding the availability of a
RAC node for kernel refresh.
Valid values are from 0 to 30 seconds, where the default value is 0. Enter a value of 0 if you want to
disable this broadcast functionality.
When enabled, after connections are drained from one of the multiple RAC nodes, for every SQL
statement execute and call to refresh the environment, if the system detects that the database
connection is not connected to the database server, it sends a broadcast message indicating the
440
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
database is not connected. Examples of reasons why a database might be disconnected are for planned
maintenance, or some type of node malfunction.
441
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
442
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
You can trigger an on-demand kernel refresh (which also includes a recycle of CallObject kernels) from Server Manager.
For a description of the logic, refer to the preceding section entitled: Understanding Kernel Refresh.
Note: This function creates Server Manager logs which you can use to verify program functionality or to perform
additional debug, if necessary.
1. In Server Manager, select the Enterprise server that you wish to trigger an on-demand kernel refresh.
443
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
444
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
This will refresh static environments in system kernel processes and will trigger all callobject kernels to recycle.
Are you sure you want to refresh environments in this enterprise server instance?
5. Click the OK button to begin the processes to refresh the static environments and to trigger all CallObject
kernels to recycle.
Logging SAW process callstacks creates a log with a snapshot of each active kernel process, including associated
threads, in their current state at the point in time that this function executes.
Note: A practical debugging use case might be to take multiple snapshots over time and compare the callstacks to
the expected function.
445
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Note: The snapshot includes the callstack of every active kernel and every thread within that kernel.
Therefore, depending the volume of threads in your environment, the entire process can take some time.
446
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
This will log call stacks for all active SAW processes in this enterprise server and will log them in the jdelogstk
program's jde.log in the enterprise server log folder.
Are you sure you want to log all active SAW processes in this enterprise server instance?
5. Click the OK button to begin the processes to log all callstacks.
6. Note: The resulting log files are named: jdelogstk.xnn. For example, jdelogstk.c42.
For example:
cd /slot/ems12345/appmgr/jdedwards/ddp/e920/system/bin64
3. Launch the jdelogstk program using the following command:
For example:
For example:
447
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
448
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Use the command syntax in this example to get the callstack for a specific process ID, with these assumptions:
• Kernel job number: 157619
• PID: 1832185
SBMJOB CMD(CALL PGM(PP926SYS20/JDELOGSTK) PARM('1832185')) JOB(JDELOGSTK)
After the job is submitted, the console displays the following to confirm the progress of the callstack logging.
1832185 Tue Apr 19 12:48:24.375624 netcfg.c316
Starting 64Bit Kernel of Type: QUEUE KERNEL
1832195/22030 MAIN_THREAD Tue Apr 19 12:55:18.066520 jdelogstk.c47
Generating Call Stack for PID 1832185 from PID 1832195 with 1 active threads out of 1 total threads
available
================================
PID/PSThread_ID: 1832185/3604
System Thread ID: 3604
Thread Name:
CALLSTACK:
Level Program Library Module Statement Procedure
0 QC2UTIL1 QSYS QC2MI3 0000000001 deq
1 JDEIPC PP926SYS20 MSG 0000000018 JDE_msgrcv
2 JDEIPC PP926SYS20 IPCSYSV 0000000011 receiveMessage
3 JDEIPC PP926SYS20 IPCPUB 0000000032 ipcGetQueueEntry
4 JDENET PP926SYS20 EXTMSGQ 0000000032 getExternalQueueEntry
5 JDENET PP926SYS20 NETQUEUE 0000000015 processKernelQueue
6 JDENET PP926SYS20 NETPUB 0000000041 JDENET_RunKernel
7 JDENET_K PP926SYS20 JDENET_K 0000000019 main
8 JDENET_K PP926SYS20 JDENET_K _C_pep
9 QP0ZPCPN QSYS QP0ZPCPN 0000000286 Qp0zNewProcess
10 QP0ZPCP2 QSYS QP0ZPCP2 _CXX_PEP__Fv
Note: This setting is only applicable for an Oracle Real Application Cluster (RAC) database. Do not enable this setting
for a standalone non-RAC single instance or single node database.
To configure the Refresh Environment on OCI Server Not Connected Interval setting, navigate to Configuration >
Advanced > Database
449
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
By default JD Edwards EnterpriseOne fetches a preset number of rows and bytes from an Oracle database. However,
you can override the default setting by using Server Manager to:
• Configure the Database Fetch Size on the Enterprise Server
• Set the SQL Statement Fetch Size on the HTML Server
450
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
This is the maximum number of bytes to fetch for a SQL select statement for an Oracle database. If the
buffer size of the maximum rows is less than the maximum number of bytes, then the maximum number
of rows is used. Otherwise, the number of rows is adjusted to fit into the maximum number of bytes limit.
The following shows example settings.
1. Use Server Manager to select the HTML server for which you want to override the default fetch size to an Oracle
database.
2. Navigate to Configuration > Advanced > Database > JDBj Runtime Properties
451
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
You can set this integer value greater than the default value of 0 to override the number of records to fetch for a
SQL select statement. This is used only for Oracle database. The default value of 0 uses the default value of the
Oracle JDBC driver to fetch a number of records to fetch for a SQL select statement.
The following shows example settings.
452
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Configuration Groups
The Configuration section displays a list of Configuration Groups that varies according to the server type. This section
lists the Configuration Groups for these JD Edwards EnterpriseOne servers:
• EnterpriseOne Enterprise Server
• EnterpriseOne HTML Server
• EnterpriseOne Business Services Server
• EnterpriseOne Application Interface Services (AIS) Server
• EnterpriseOne Transaction Server
• EnterpriseOne Data Access Server
• EnterpriseOne Data Access Driver
453
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
• Web Runtime
For details of each Configuration setting within a configuration group, refer to the Server Manager internal help for each
setting.
Note: In the Cache group, you can use the UDOCheckInterval setting to set a specified time for the system to
automatically clear the shared UDOs cache. The default value for this setting is 24 hours (86400000 milliseconds).
Depending on the number of shared UDOs a user has access to, the UDOCheckInterval setting can be set to an
appropriate value. If the number of shared UDOs available to a user is small (for example: less than 100), you can set
a shorter time, so that the purging can take place more frequently. The UDOCheckInterval setting is applicable to
UDOs such as notification, orchestration, rule, whitelist, cross reference, form service, schedule, search group, form
extension, and personal form. (Release 9.2.3.4)
• Cache
• Database
• HTTP Settings
• Inbound Settings
• Miscellaneous
• Network
• Runtime Settings
• Security
For details of each Configuration setting within a configuration group, refer to the Server Manager internal help for each
setting.
Note: In the Cache group, you can use the UDOCheckInterval setting to set a specified time for the system to
automatically clear the shared UDOs cache. The default value for this setting is 24 hours (86400000 milliseconds).
Depending on the number of shared UDOs a user has access to, the UDOCheckInterval setting can be set to an
appropriate value. If the number of shared UDOs available to a user is small (for example: less than 100), you can set
a shorter time, so that the purging can take place more frequently. The UDOCheckInterval setting is applicable to
UDOs such as notification, orchestration, rule, whitelist, cross reference, form service, schedule, search group, form
extension, and personal form. (Release 9.2.3.4)
• All Settings
For details of each Configuration setting within a configuration group, refer to the Server Manager internal help for each
setting.
454
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
• Database
• Network
• Real Time Events
• Security
For details of each Configuration setting within a configuration group, refer to the Server Manager internal help for each
setting.
• Database
• Installation
• Network
• Security
For details of each Configuration setting within a configuration group, refer to the Server Manager internal help for each
setting.
Configuration Items
This section describes:
• Help
• History
455
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Help
Each configuration item is identified using a short, readable name. Clicking the Help icon will link to the following
information
History
History is maintained for each configuration item. The old and new values are recorded along with the user that made
the change. Changes made directly to the configuration files are not audited.
456
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
The History - <configuration item> popup screen that appears contains these fields:
• Date
History may also be viewed for all configuration parameters for an instance.
See Also
• Audit History
Compare Instances
Two or more managed instances may be selected to identify configuration differences. Each selected instance will also
be compared with the default configuration of the server group to which it belongs.
• Create Comparison
• Comparison Results
457
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
458
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Create Comparison
To create an instance comparison:
If selected all configuration items for each selected instance and corresponding server group(s) will be
displayed. If not selected only configuration items that are not identical between the selected instances and
their server groups will be displayed.
4. Click the Run Comparison button.
Comparison Results
This section describes:
• Results
• Modifications
Results
The comparison results appear in a new pane under the Instance Selection section.
• Configuration Metric
Configuration items are associated into logical groupings, which are referred to as a Configuration Metric.
• Configuration Item
The individual configuration item that is being compared between the selected instance(s) and their
corresponding server group.
• Permissions for Server Group: <Server Group Name>
459
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Modifications
You can apply the Server Group default values to an instance by selecting the configuration items and then selecting the
Apply Server Group Default button.
• Permission Denied
460
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
Permission Denied
If you receive an error that permission is denied to write to a configuration file, you need to ensure that the file is not
purposely locked in a manner that prevents the user under which Server Manager is running from modifying it. You
should check the file permissions to ensure the file is writable.
461
JD Edwards EnterpriseOne Tools Chapter 31
Server Manager Guide Configure Enterprise Server Instances
462
JD Edwards EnterpriseOne Tools Chapter 32
Server Manager Guide Administer Server Groups
The Management Console provides a default server group that you can use to initially manage servers. You can move
any server from the default server group to a newly created server group. A server cannot belong to more than one
server group, including the default server group.
Note: You can manage and monitor certain features of application servers (Oracle WebLogic or IBM WebSphere
Application Server) through the Management Console, but these types of servers cannot be members of a server
group. See Overview of Basic Instance Administration for more information.
Security for server groups, or server group permissions, is assigned to user groups. See Assign Server Manager
Permissionsfor more information.
463
JD Edwards EnterpriseOne Tools Chapter 32
Server Manager Guide Administer Server Groups
Note: When you create a server group, the Management Console copies default configuration settings from the
default server group to the new server group. In the new server group, you can modify the default configuration
settings as appropriate.
1. In the Quick Links section of the Management Console, click the Server Groups link.
2. On Server Groups, enter a unique name in the Server Group Name field.
3. Complete the Group Description field.
464
JD Edwards EnterpriseOne Tools Chapter 32
Server Manager Guide Administer Server Groups
The Management Console displays the new server group in the grid.
Note: You must have the consoleConfig permission to create a new server group.
A server, or managed instance, cannot belong to more than one server group.
1. In the Quick Links section of the Management Console, click the Server Groups link.
2. On Server Groups, click the group name link for the group that you want to add a server to the server group.
3. In the Add Server Group Members section, click the Instance Name drop-down menu to select a managed
instance (server) that you want to migrate to the server group. The list contains all the servers that do not
belong to the current server group. The group to which the servers belong is shown in parenthesis.
4. Click the Add Group Member button to add the server as a member of the server group.
The system displays all members of the server group under the Server Group Members heading.
465
JD Edwards EnterpriseOne Tools Chapter 32
Server Manager Guide Administer Server Groups
1. On Server Groups, click the check box next to the server group that you want to delete.
Note: You may not remove a server group that has server members.
466
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
Clear Table Cache refresh allows a specific JDB table cache that is registered in the F98613 table to be cleared across
kernel processes and across all Enterprise Servers as long as they are managed by the same Server Manager. As a result,
all Enterprise Servers and all JD Edwards EnterpriseOne HTML Web Servers managed by the same Server Manager no
longer need to be bounced (restarted) in order to clear cache. Since there is no table caching for the HTML Web Servers,
it is not necessary to clear the cache on those machines.
467
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
468
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
2. In the What do you want to do? section, click the Table Cache link.
469
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
470
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
3. On the Clear Table Cache Results page there are two sections:
◦ Table Name
Enter a valid table name that is registered as a cached table in F98613 table using the P98613 application.
◦ Environment Name
Enter a valid JD Edwards EnterpriseOne environment from which the table cache will be cleared.
471
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
The system displays a section that lists all cache that has been cleared for the requested table. For example, if
you chose the F0010 table and the JDV910SA1 environment the following is displayed:
472
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
473
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
The system displays a section that lists all cache that has been cleared for all tables in the selected
environment. An example is shown below.
474
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
a. On the EnterpriseOne HTML Server managed instance page, click the Clear Caches button to clear the
Form Extension, Personalized Forms, and Search Group caches.
b. On the EnterpriseOne Application Interface Services managed instance page, click the Clear Caches
button to clear the Notification and Orchestration caches. Click the second Clear Caches button to clear
the Form Service and Data Service, and Read Data caches.
Note: The Clear Caches button is disabled if the status of the HTML or AIS server is anything other than "Running".
475
JD Edwards EnterpriseOne Tools Chapter 33
Server Manager Guide Clear Table Cache
476
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
Note: The health check feature is supported only for the instances running with Tools Release 9.2.2.0 and higher. The
health check feature is available only to administrative users. If the user does not have permission to run the health
check on a particular instance, the message " User <user name> doesn't have access to run Health Check on this
instance" is displayed.
• Login
Logs in to the server using the health check user name and password.
• Interactive App
Tools Release 9.2.6. An administrator can specify the interactive application and version to run
as part of executing the Health Check through Server Manager and Server Manager APIs. The
Server Manager navigation to configure a specific application and version for a health check is
Configuration → Advanced View → Miscellaneous → Health Check Configurations.
• UBE
477
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
Tools Release 9.2.6. An administrator can specify the UBE and version to run as part of executing
the Health Check through Server Manager and Server Manager APIs. The Server Manager
navigation to configure a specific UBE and version for a health check is Configuration →
Advanced View → Miscellaneous → Health Check Configurations.
• OVR
• Port Test
Tools Release 9.2.6. An administrator can specify the UBE and version to run as part of executing
the Health Check through Server Manager and Server Manager APIs. The Server Manager
navigation to configure a specific UBE and version for a health check is Configuration →
Advanced View → Miscellaneous → Health Check Configurations.
• BSFN
• Login
Logs in to the server using the health check user name and password.
• Form Service App
Tools Release 9.2.6. An administrator can specify the interactive application and version to run
as part of executing the Health Check through Server Manager and Server Manager APIs. The
Server Manager navigation to configure a specific application and version for a health check is
Configuration → Advanced View → Miscellaneous → Health Check Configurations.
• Form Service UBE
Tools Release 9.2.6. An administrator can specify the UBE and version to run as part of executing
the Health Check through Server Manager and Server Manager APIs. The Server Manager
navigation to configure a specific UBE and version for a health check is Configuration →
Advanced View → Miscellaneous → Health Check Configurations.
• JWT Trust Login
478
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
Checks the BSSV login and runs the dbservice BSSV (JPR01000 - getAddressBook).
• BSFN Execution
• DB Connection
• Connection
The File System I/O options of the DB. Displays the status as success if the value is SETALL;
otherwise a warning is displayed.
The DB log mode. Displays the status as success if the DB log mode is ARCHIVELOG; otherwise a
warning is displayed.
The schema deployment status. Displays the status as success if the pathcode/shared shemas
are available else, displays an error.
479
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
To set up the permissions for the Target Servers, add the following ini entries in jas.ini, jdeinterop.ini, jde.ini, rest.ini files
for the RTE and JAS server, BSSV server, Enterprise server, and AIS server respectively.
[HEALTHCHECK]
HealthCheckEnvironment=JDV920
HealthCheckPwd=JDE
HealthCheckUser=JDE
1. In the Server Manager Management Dashboard, click Server Groups link in the Configure section.
2. In the User Groups section, click the required name of the user group.
480
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
3. In the Permissions for Server Group: default section, move the HealthCheck from the Available Options window
to the Selected Options window.
4. Navigate to the Server Manager Users Page and in the Management Console Users section, select the required
user to whom you want to grant the Health Check permission.
5. Click Grant or Revoke User Groups, and select the user group to which you added the Health Check permission
in step 3.
6. Click Save.
481
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
Note: The OVR should not contain any sensitive or critical data because this report is used while running the Health
Check.
482
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
7. Click the Executable tab, select the Task Type as One View Report, and complete the fields as shown in the
following example.
8. Click the Task Description tab, and enter the description for your new Task ID.
9. Click OK.
Note: You can create a new OVR or use an existing OVR to create the Task ID called OVRHEALTHCHECK.
483
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
Icon Description
Indicates a warning. For example, warning occurs if the pre-requisites for running the health checks are
not configured properly.
484
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
485
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
3. In the Health Check Results window, select the following options as required, and then click Run Health Check:
◦ Target Machine - Select this option to choose the required target machine.
486
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
◦ Server Group - Select this option to choose the required server group.
487
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
◦ All Servers - Select this option to view the health check information for all the servers of the supported
target types configured in Server Manager.
488
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
In the recommended EnterpriseOne production architecture, the web tier comprises a set of interrelated servers:
• An HTML Server, sometimes called a "front-end" HTML Server because it receives the requests from end users'
browsers
• An application interface services (AIS) Server
• A second HTML Server, sometimes called a "back-end" HTML Server because it fulfills the requests from the
AIS Server
Taken collectively, these servers are called a "pod". For scalability and fault tolerance, it is common to deploy redundant
sets of pods, often behind a load balancer, which directs traffic across the pods. The Enterprise Server and the database
489
JD Edwards EnterpriseOne Tools Chapter 34
Server Manager Guide Health Check (Release 9.2.2)
are also essential parts of the complete stack. If any servers in the stack are experiencing a fault, EnterpriseOne
transactions will fail.
The pod health check is a lightweight service which returns the health information of the POD. In a load-balanced
environment, the load balancer can run this service to determine if it is possible to forward load to a particular POD. You
can send a HTTP GET request to an HTML Server instance to verify the health of a group of interdependent servers:
If the servers are available, an HTTP response with the 200 status is returned, otherwise, the status is either 500
(servers down) or 404 (front end JAS is down).
Note: To run the POD health check, AIS and Server Manager Health Check must be configured on this server
instance.
In addition, the system returns the details in the JSON format. Here are some sample responses.
• If the servers are down, the system returns{"status":"AIS or backend JAS not available"}
Starting with Tools Release 9.2.7.4, if the JAS instance reaches the maximum user limit, the pod health check service
returns the 409 status with the message "Exceeds maximum JAS user limit".
490
JD Edwards EnterpriseOne Tools Chapter 35
Server Manager Guide Collect and Generate Diagnostics (Release 9.2.3.4)
Important: Technical tables, files, and logs may contain confidential data and passwords. Therefore, it is your
responsibility to verify that sensitive data is removed prior to attaching the collected data to a Service Request or
sharing the data.
Note: The password values in the .ini files are removed prior to collection.
Deployment Servers
This section describes the available fields for the Deployment Server.
Deployment Servers
Lists the available Deployment Servers you can select to collect diagnostics.
491
JD Edwards EnterpriseOne Tools Chapter 35
Server Manager Guide Collect and Generate Diagnostics (Release 9.2.3.4)
Collects the files under the OneWorld Client Install directory, which includes the following:
• installManager.htm
• install/oraparam.ini
• misc/ini files
• stage/products.xml
• ThirdParty/WebDevFeature/WASH4A
• WLSH4A/ install/oraparam.ini
• reponse/WXXH4A_install.rsp
• stage/products.xml
The jde.ini, jdbj.ini, jas.ini, jdelog.properties, ptf.log and logs from the Deployment Server are also collected.
Collects the package.inf file, ServerLogs, the local svrpkgbuild.log, the local clientpkgbuild.log and the work folder for
the specified package name entered.
The jde.ini, jdbj.ini, jas.ini, jdelog.properties, ptf.log, local logs, and the last five instances of the Package Build pdfs
(R9621S and R9622C) in the Print Queue are also collected.
Pathcode of Package
Package Name
UBE Output
Collects the last five PDF files for the UBE entered in the UBE Report Name field. The jde.ini, jdbj.ini, jas.ini,
jdelog.properties, ptf.log and logs from the Deployment Server are also collected.
492
JD Edwards EnterpriseOne Tools Chapter 35
Server Manager Guide Collect and Generate Diagnostics (Release 9.2.3.4)
The name of the UBE(s) you want to collect. You can enter multiple UBE reports by separating them with a comma.
Collects the Server Management Agent logs for the Deployment Server specified in the drop-down.
Each time the Collect and Generate button is clicked a .zip file is generated from the contents of the CaptureDiagnostics
directory with a specific naming convention (DEP_CaptureLogs.zip) and saved in the temp directory.
Downloads the zip file from the agent to the local machine.
Enterprise Servers
This section describes the available fields for the Enterprise Server.
Enterprise Servers
Lists the available Enterprise Servers you can select to collect diagnostics.
Collects the jde.ini, ptf.log, and the jde logs from the Enterprise Server specified in the Enterprise Server dropdown.
UBE Output
Collects the last five PDF files for the UBE entered in the UBE Report field. The jde.ini, ptf.log and logs from the
Enterprise Server are also collected.
The name of the UBE(s) you want to collect. You can enter multiple UBE reports by separating them with a comma.
Collects the Server Manager Agent logs, jde.ini, ptf.log and logs from the Enterprise Server specified in the dropdown.
Each time the Collect and Generate button is clicked a .zip file is generated from the contents of the CaptureDiagnostics
directory with a specific naming convention (ENT_CaptureLogs.zip) and saved in the temp directory.
493
JD Edwards EnterpriseOne Tools Chapter 35
Server Manager Guide Collect and Generate Diagnostics (Release 9.2.3.4)
Downloads the zip file from the agent to the local machine.
HTML Servers
This section describes the available fields for the HTML Server.
HTML Server
Dropdown list of the available HTML Servers you can select to collect diagnostics.
HTML Logs
Collects the HTML logs from the HTML Server specified in the dropdown.
Collects the Server Management Agent Logs from the HTML Server specified in the drop down.
Each time the Collect and Generate button is clicked a .zip file is generated from the contents of the CaptureDiagnostics
directory with a specific naming convention (HTML_CaptureLogs.zip) and saved in the temp directory.
Downloads the zip file from the agent to the local machine.
Dropdown list of the available Server Manager Consoles you can select to collect diagnostics.
CNC Tables
494
JD Edwards EnterpriseOne Tools Chapter 35
Server Manager Guide Collect and Generate Diagnostics (Release 9.2.3.4)
495
JD Edwards EnterpriseOne Tools Chapter 35
Server Manager Guide Collect and Generate Diagnostics (Release 9.2.3.4)
Each time the Collect and Generate button is clicked a .zip file is generated from the contents of the CaptureDiagnostics
directory with a specific naming convention (SMC_CaptureLogs.zip) and saved in the temp directory.
Downloads the zip file from the agent to the local machine.
◦ Database Type
◦ Database Name
◦ Database Server Name
◦ Database TCP/IP Port
◦ Physical Database
◦ Object Owner
◦ Support Large Objects (LOBS)
◦ Unicode Database
4. Click the Apply button.
To configure TNSNAMES in Server Manager Console:
1. On Managed Homes and Managed Instances page, under the Managed Instances column, click "home" for the
Management Console.
2. On the left of the page, under the Configuration Panel, click on JDBJ Database Configuration.
3. Scroll down to Oracle Database Settings.
4. If the EnterpriseOne database is an Oracle database, complete the File Contents with the tnsames.ora
information for the sign on to the database. This is found under the Oracle Client location: product
\12.1.0\client_1\network\admin.
496
JD Edwards EnterpriseOne Tools Chapter 35
Server Manager Guide Collect and Generate Diagnostics (Release 9.2.3.4)
When the data retrieval is complete, an on-screen message will be presented providing the path to the zip file
of the collected data.
7. Click the link for the specific server to download the .zip files from the agent.
Note: It could take some time to collect all files, depending on your system.
497
JD Edwards EnterpriseOne Tools Chapter 35
Server Manager Guide Collect and Generate Diagnostics (Release 9.2.3.4)
498
JD Edwards EnterpriseOne Tools Chapter 36
Server Manager Guide Automatic Pre-Generation of Serialized Objects (Release
9.2.6)
At some point you must generate JD Edwards EnterpriseOne specifications into Java code to access JD Edwards
EnterpriseOne applications in HTML that is delivered using HTML/JAS Web Servers. The JD Edwards EnterpriseOne
forms and applications that you generate are serialized Java objects. JD Edwards EnterpriseOne stores these objects in a
database (in serialized object tables F989998 & F989999), and retrieves them at runtime.
The automatic pre-generation of serialized objects is optional. If you do not enable this feature to pre-generate
serialized objects, then the objects will be generated on demand. If you enable automatic pre-generation of serialized
objects, you can further specify which objects to pre-generate.
If you enable automatic pre-generation of serialized objects, and you do not list specific objects, then these objects are
generated:
• All objects that are not already generated (based on entries in the serialized object tables)
• Any objects in a full or update package that are new or changed
• All objects that are part of a newly applied Tools Release
Optionally, instead of generating objects as described above, you can specifically list objects to generate in these
categories:
• Applications To Generate
• Reports To Generate
• NERs To Generate
• Business Views To Generate
• Tables To Generate
• Data Dictionaries To Generate
When enabled, the process for automatic pre-generation of serialized objects is triggered by a JD Edwards
EnterpriseOne HTML Web Server machine restart or by the deployment of a new package (full or update). If multiple
HTML/JAS Web Servers are configured to use this function, the system will only generate serialized objects for one
server at a time.
499
JD Edwards EnterpriseOne Tools Chapter 36
Server Manager Guide Automatic Pre-Generation of Serialized Objects (Release
9.2.6)
1. In Server Manager, select the HTML/JAS server that you wish to enable auto-generating serialized objects.
2. Navigate to Configuration > Advanced > Miscellaneous > Automatic Spec Generation Settings
500
JD Edwards EnterpriseOne Tools Chapter 36
Server Manager Guide Automatic Pre-Generation of Serialized Objects (Release
9.2.6)
3. Complete the following fields:
◦ Automatic Spec Generation
Set this to true to enable automatic pre-generation of serialized objects.
Enter a value to specify the thread pool size to pre-generate serialized objects concurrently using
automatic spec generation. Valid values are from 1 to 30, where the default value is 10.
◦ Generate Spec For Frequently Used Object (Release 9.2.8.2)
Select the Generate Spec For Frequently Used Object check box to generate specs for the previously
accessed objects. Frequently used objects are determined based on the data available in the Object
Usage Tracking table (F98911). These specs will be generated when the server starts.
◦ Language Preference (Release 9.2.8.2)
Select the Language Preference for serialized object. Select NONE if only the default English language
serialized objects are required. You can select multiple languages to generate specs for different
languages. NONE must not be selected along with other languages.
◦ Applications To Generate
Optionally you can list a specific application, list of applications, or all applications to be automatically
pre-generated. Multiple application names must be specified with comma separators. To pre-generate
specs for all applications, use the * character.
Optionally you can list a specific report, list of reports, or all reports to be automatically pre-generated.
Multiple report names must be specified with comma separators. To pre-generate specs for all reports,
use the * character.
Optionally you can list a specific NER, list of NERs, or all NERs to be automatically pre-generated. Multiple
NER names must be specified with comma separators. To pre-generate specs for all NERs, use the *
character.
501
JD Edwards EnterpriseOne Tools Chapter 36
Server Manager Guide Automatic Pre-Generation of Serialized Objects (Release
9.2.6)
For example, FetchUBEMapping.
◦ Business Views To Generate
Optionally you can list a specific business view, list of business views, or all business view to be
automatically pre-generated. Multiple business view names must be specified with comma separators. To
pre-generate specs for all business views, use the * character.
Optionally you can list a specific tables, list of tables, or all tables to be automatically pre-generated.
Multiple table names must be specified with comma separators. To pre-generate specs for all tables, use
the * character.
Optionally you can list a data dictionary, list of data dictionaries, or all data dictionaries to be
automatically pre-generated. Multiple data dictionaries names must be specified with comma separators.
To pre-generate specs for all tables, use the * character.
◦ Product Code Specific Objects To Generate (Release 9.2.8.2)
The default value is blank (no product code specific objects will be pre-generated).
Optionally, you can list product codes for which specs must be generated. Multiple product code names
must be specified with comma separators.
502
JD Edwards EnterpriseOne Tools Chapter 36
Server Manager Guide Automatic Pre-Generation of Serialized Objects (Release
9.2.6)
503
JD Edwards EnterpriseOne Tools Chapter 36
Server Manager Guide Automatic Pre-Generation of Serialized Objects (Release
9.2.6)
504
JD Edwards EnterpriseOne Tools Chapter 37
Server Manager Guide Enabling Oracle Database Connection Pooling (Release
9.2.6)
• Enterprise Server
• Deployment Server
1. In Server Manager, use this navigation:
Enterprise_Server_ or _Deployment_Server_Instance > Configuration > Database > Configuration > View:
Advanced > Bootstrap Datasource
2. The following settings are mandatory in order to enable Oracle Database Connection Pooling:
◦ Database Connection Timeout
◦ Oracle DB Statement Cache Size
◦ Use Oracle DB Connection Pool
◦ Oracle DB Connection Pool Max Connections
◦ Oracle DB Connection Pool Min Connections
◦ Oracle DB Connection Pool Inc Connections
The following shows the default values for the above settings (circled in red):
505
JD Edwards EnterpriseOne Tools Chapter 37
Server Manager Guide Enabling Oracle Database Connection Pooling (Release
9.2.6)
506
JD Edwards EnterpriseOne Tools Chapter 37
Server Manager Guide Enabling Oracle Database Connection Pooling (Release
9.2.6)
Note: The Oracle Database Connection Pooling is not applicable to AIS Web Servers.
Web_Server_Instance > Configuration > Database > View: Advanced > Database
The following shows default values for settings in the JDBj Connection Pools section:
507
JD Edwards EnterpriseOne Tools Chapter 37
Server Manager Guide Enabling Oracle Database Connection Pooling (Release
9.2.6)
• jdbj.ini
The following are mandatory settings and default values in the jde.ini file to enable Oracle Database Connection
Pooling for the Development Client:
[DB SYSTEM SETTINGS]
UseOracleDBConnectionPool=1
OracleDBConnectionPoolDebug=0
OracleDBConnectionPoolIncConnections=1
OracleDBConnectionPoolMaxConnections=30
OracleDBConnectionPoolMinConnections=0
OracleDBStatementCacheSize=50
DBConnectionTimeout=300
The following are required settings and recommended values in the jdbj.ini file to enable Oracle Database Connection
Pooling for the Development Client:
[JDBj-CONNECTION POOL]
useOracleDBConnectionPool=true
enableFastConnectionFailoverInOracleDBConnectionPool=false
enableOracleDBConnectionPoolTrace=false
oracleDBConnectionPoolFactoryClassName=oracle.jdbc.pool.OracleDataSource
minConnection=0
maxConnection=50
initialConnection=1
poolGrowth=1
connectionTimeout=300000
cleanPoolInterval=100000
508
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
To install multiple Management Consoles on a single machine, you should install each Management Console in
completely separate locations. The Management Console installer automatically detects a prior console installation
and will properly configure any subsequent installations. This includes the configuration of the TCP/IP ports used by
the embedded J2EE application server and the creation of the Microsoft Windows service name to ensure there are no
conflicts. Additionally, you should ensure the HTTP port supplied during the Server Manager installation is unique and
not currently in use. Refer to Verify HTTP Ports in this appendix.
When you are installing an additional Management Console on a machine it is important that the existing previous
installations be stopped. There are two TCP/IP ports utilized by server manager that must be manually configured to
prevent conflicts during the setup wizard:
• Management Server JMX Port
This is the port on which the Management Console listens for incoming connections from remote
Management Agents . The default value is 14501.
You must define this value to an unused port on the machine. A good practice is to increase the value by 1000
to 15501 for the second console, 16501 for the third, and so on, provided those ports are not used by any other
application running on the machine. You must properly set this value prior to installing any Managed Homes .
• Management Agent Starting Port
This port is the start port the Management Console will assign to remote Management Agents . The default
value is 14502.
If you will be using the new Management Console to manage machines that are also managed from another
Management Console , you must change this value. A good practice is to change this value anytime you change
the Management Agent Starting Port. Unlike the Management Server JMX Port, you can change this port at any
time, including after you have installed Managed Homes .
When you have properly configured these ports you can simultaneously start and run any other Management Console
instances on the same machine.
Management Agents
This section describes these recommendations:
• One Agent Per Application Server Installation
• Management Agents on WLS
• Management Agents on JD Edwards EnterpriseOne Enterprise Servers
509
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
• Management Agent A
WAS_HOME/Profile1/ServerA:
For the above two agents, Management Agent B cannot determine if Management Agent A has an EnterpriseOne HTML
Server installed on WAS61/Profile1/ServerA. As a result, if you start or stop ServerA you would also unknowingly start or
stop the JD Edwards EnterpriseOne HTML Web Server .
For UNIX systems, if you cannot install the agent as a non-root user (for example, on AIX), then install the agent as the
ROOT user and then change the owner using the chown command.
Before proceeding, you should ensure that you stop the Management Agent and select it with the new owner.
• jde900
• jde910
• jde920
510
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
Note: During profile creation, it is recommended that you specify your starting port number to a value that will give
you a sufficient amount of port numbers (for example, 1000) between the last profile you created so as to not conflict
with other currently assigned ports and ports that will be assigned in the future.
Note: If you configure the WebSphere Application Server SOAP_CONNECTOR_ADDRESS port number outside of Server
Manager (for example, from the WebSphere Administrative Console), you must restart the Management Agent
that is managing that WebSphere Application Server instance. This is required because Server Manager uses that
port to communicate with the WebSphere Application Server and only acquires the port value on start up of the
Management Agent .
511
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
Note: WAS Base/Standalone. The general recommendation is to use a single WAS profile to deploy and manage
multiple instances of EnterpriseOne web-based servers (such as HTML Web Server, PIM Sync Server, and Business
Services Server). This is because of the limitation of WAS Base/Standalone functionality and how the web server
plug-ins are used and modified across profiles. The exception to the general recommendation is the Transaction
Server. The recommendation is to deploy and manage the Transaction Server in a separate WAS profile. This is
because of conflicts between HTML Server and Transaction Server within the same profile. In WAS standalone, when
creating separate profiles you must create a separate web server definition and have a separate HTTP Server. See IBM
WebSphere Administration documentation for more details on this requirement.
512
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
513
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
514
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
515
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
3. On Windows Firewall Settings, on the Exceptions tab, click the Add Port button.
516
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
4. On Add a Port, complete these fields to add a port for the Server Manager Agent:
◦ Name
14502
◦ Protocol
TCP
5. Click the OK button.
On Add a Port, complete these fields to add a port for the Server Manager JMX connection:
◦ Name
14501
◦ Protocol
TCP
517
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
7. At this point, if not already installed, you can install the Server Manager Agent for Microsoft Windows as
described in the Server Manager Guide, in the section entitled: Installing the Server Manager Management
Console and Agent.
518
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
519
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
8. On Windows Firewall Settings, on the Exceptions tab, click the Add Program button.
520
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
11. At this point, if not already installed, you can install a Managed Instance for the Enterprise Server as described
in the Server Manager Guide, in the section entitled: Register or Create a JD Edwards Enterprise Server as a New
Managed Instance.
521
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
522
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
12. On Windows Firewall Settings, on the Exceptions tab, click the Add Port button.
523
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
13. On Add a Port, complete these fields to add a port for the Server Manager Agent:
◦ Name
JDENET <port>
where <port> is a variable value for JDENET corresponding to the JD Edwards EnterpriseOne
Applications Release. See description below for valid values.
◦ Port Number
<port>
where <port> is a variable value for JDENET corresponding to the JD Edwards EnterpriseOne
Applications Release. For example, the default values per release are listed in this table:
9.0 6015
9.1 6016
◦ Protocol
TCP
524
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
14. On Windows Firewall Settings, on the Exceptions tab, highlight the jdenet_k program and click the Add Program
button.
15. On Edit a Program, verify the values in these fields are correct for jdenet_k:
◦ Name
jdenet_k
◦ Path
D:\JDEdwards\E810\DDP\system\bin32\jdenet_k.exe
525
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
526
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
18. Optionally, if the database for your JD Edwards EnterpriseOne applications reside on a different machine than
the Enterprise Server, you must repeat the applicable steps above to add a port for that database. You may
need to check with your DBA or database vendor documentation to determine the applicable port.
The below example shows the typical database port for SQL Server 2008.
527
JD Edwards EnterpriseOne Tools Chapter 38
Server Manager Guide Appendix A - Best Practices
are described in the JD Edwards EnterpriseOne HTML Reference Guides for WebSphere. Refer to the chapter entitled:
Installing and Configuring WebSphere 8.5.5, which is in platform-specific guides on OTN at the following links:
https://docs.oracle.com/cd/E61420_01/doc.92/e55810/inst_config_was85_ibm.htm#EOHII216
https://docs.oracle.com/cd/E61420_01/doc.92/e55808/inst_config_was85_win.htm#sthref4
https://docs.oracle.com/cd/E61420_01/doc.92/e41914/inst_config_was85_win.htm#sthref4
If the user fails to do this, then they will receive this error:
528