JD Edwards EnterpriseOne Standalone Client Installation Guide Applications Release 9.2 With Tools Release 9.2.x PDF
JD Edwards EnterpriseOne Standalone Client Installation Guide Applications Release 9.2 With Tools Release 9.2.x PDF
JD Edwards EnterpriseOne Standalone Client Installation Guide Applications Release 9.2 With Tools Release 9.2.x PDF
December 2015
JD Edwards EnterpriseOne Standalone Client Installation Guide Applications Release 9.2 with Tools Release
9.2.x
E61424-01
Copyright 2011, 2015, Oracle and/or its affiliates. All rights reserved.
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 installed on the hardware, and/or documentation, delivered to U.S. Government end users
are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and
agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and
adaptation of the programs, including any operating system, integrated software, any programs installed on
the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to
the programs. 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 Xeon 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,
Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced
Micro Devices. UNIX is a registered trademark of The Open Group.
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.
Contents
Preface ................................................................................................................................................................ vii
Audience...................................................................................................................................................... vii
Documentation Accessibility .................................................................................................................... vii
Related Documents .................................................................................................................................... vii
Conventions ............................................................................................................................................... viii
1 Introduction
1.1
1.2
1.3
1.4
Overview......................................................................................................................................
Certifications................................................................................................................................
Microsoft Windows Security.....................................................................................................
Minimizing Locked Files ...........................................................................................................
1-1
1-2
1-3
1-4
2-1
2-1
2-2
2-3
2-3
2-3
2-4
4-2
4-2
4-3
4-3
4-4
iii
Overview......................................................................................................................................
Post Installation - Set Up Media Object Queues.....................................................................
Troubleshooting Standalone Client Startup Errors ...............................................................
General ..................................................................................................................................
Cannot Connect to the Security Server.............................................................................
Still Cannot Connect to the Security Server.....................................................................
7-1
7-3
7-4
7-4
7-5
7-6
Overview......................................................................................................................................
Troubleshooting Standalone Web Client Startup Errors ......................................................
General ..................................................................................................................................
Cannot Connect to the Security Server.............................................................................
8-1
8-1
8-1
8-2
iv
13-1
13-1
13-2
13-2
13.1.4
Error Message Details ......................................................................................................
13.1.5
Error Messages Generated by Applications .................................................................
13.1.6
Frequent Generic Error Messages ..................................................................................
13.1.7
Memory Violations ...........................................................................................................
13.1.8
Form and Grid Add Failures...........................................................................................
13.1.9
Communication Failure ...................................................................................................
13.2
Troubleshooting the Standalone Client (Production Mode) .............................................
13.2.1
Understanding Standalone Client (Production Mode) Troubleshooting.................
13.2.1.1
Troubleshooting a Standalone Installation of JD Edwards EnterpriseOne ......
13.2.1.2
Troubleshooting Printing Problems........................................................................
13.2.2
Performing Preliminary Troubleshooting.....................................................................
13.2.3
Troubleshooting Interactive Application Problems ....................................................
13.2.4
Troubleshooting Batch Processes Resulting in No Data .............................................
13.2.5
Troubleshooting Batch Processes Displaying Errors on the Report..........................
13.2.6
Troubleshooting Batch Processes Displaying Unexpected Data on the Report ......
13.2.7
Troubleshooting Local Data-Availability Problems ....................................................
13.2.8
Troubleshooting .DLL Problems on a Standalone Client ...........................................
13.3
Troubleshooting the Standalone Client (Development Mode) .........................................
13.3.1
Understanding Standalone Client (Development Mode) Troubleshooting.............
13.3.2
Troubleshooting .DLL Problems on a Standalone Client (Development Mode) ....
13.3.3
Troubleshooting Event Rule Problems........................................................................
13.3.4
Troubleshooting Business Function Problems ...........................................................
13.3.5
Troubleshooting Global Table Problems.....................................................................
13.4
Working with the Standalone Client Log Files..................................................................
13.4.1
Understanding the Standalone Client Log Files ........................................................
13.4.1.1
Logic Processing Logs.............................................................................................
13.4.1.2
Batch Processing Log ..............................................................................................
13.4.1.3
Application Development Logs ............................................................................
13.4.1.4
Object Management Workbench Transactions ...................................................
13.4.2
Viewing Log Files ...........................................................................................................
13.4.3
Configuring Logging Options ......................................................................................
13.4.4
Setting Up the Standalone Client jde.log.....................................................................
13.4.5
Setting Up the Standalone Client jdedebug.log .........................................................
13.4.6
Setting Up the Batch Process Log .................................................................................
13.4.7
Using Logs to Troubleshoot Issues ..............................................................................
13.4.7.1
Standalone Client jdedebug_xxx_mmddyy.log ..................................................
13.4.7.2
Batch Process Log ....................................................................................................
13.4.8
Compile Error Log..........................................................................................................
13.4.9
jdecpy.log .........................................................................................................................
13-2
13-3
13-3
13-3
13-4
13-4
13-4
13-4
13-5
13-5
13-6
13-6
13-6
13-7
13-7
13-8
13-8
13-8
13-9
13-9
13-10
13-10
13-10
13-11
13-11
13-12
13-12
13-12
13-12
13-12
13-13
13-13
13-14
13-16
13-16
13-17
13-17
13-18
13-18
B.2
vi
Preface
Welcome to the JD Edwards EnterpriseOne Standalone Client Installation Guide.
Audience
This guide is intended for end users that install the JD Edwards EnterpriseOne
Standalone Client.
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.
Access to Oracle Support
Oracle customers that have purchased support have access to electronic support
through My Oracle Support. For information, visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing
impaired.
Related Documents
You can access related documents from the JD Edwards EnterpriseOne Release
Documentation Overview pages on My Oracle Support. Access the main
documentation overview page by searching for the document ID, which is 876932.1, or
by using this link:
https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=876932.1
To navigate to this page from the My Oracle Support home page, click the Knowledge
tab, and then click the Tools and Training menu, JD Edwards EnterpriseOne, Welcome
Center, Release Information Overview.
This guide contains references to server configuration settings that JD Edwards
EnterpriseOne stores in configuration files (such as jde.ini, jas.ini, jdbj.ini,
jdelog.properties, and so on). Beginning with the JD Edwards EnterpriseOne Tools
Release 8.97, it is highly recommended that you only access and manage these settings
for the supported server types using the Server Manager program. See the JD Edwards
EnterpriseOne Server Manager Guide.
vii
Conventions
The following text conventions are used in this document:
viii
Convention
Meaning
boldface
italic
monospace
1
Introduction
1
1.1 Overview
The JD Edwards EnterpriseOne Standalone Client contains components that run as
standard Microsoft Windows programs (for example, Active Console, Forms Design
Aid (FDA), and Report Design Aid (RDA)) and components that run in a web browser.
Note: This document uses the following terminology when
discussing JD Edwards EnterpriseOne clients:
Windows Client
Contains components that run as standard Microsoft Windows
programs.
Web Client
Contains components that run in a web browser.
Standalone Client
Composed of components that run as standard Microsoft
Windows Client and also components of the Web Client that run
in a web browser.
Introduction
1-1
Certifications
Note:
Note: This document uses the terms "deinstall " and "uninstall"
interchangeably. The terms are synonymous and describe the removal
of a product from your workstation.
1.2 Certifications
Customers must conform to the supported platforms for the release as detailed in the
JD Edwards EnterpriseOne Certifications. In addition, JD Edwards EnterpriseOne may
integrate, interface, or work in conjunction with other Oracle products. Refer to the
following link for cross-reference material in the Program Documentation for Program
prerequisites and version cross-reference documents to assure compatibility of various
Oracle products.
http://www.oracle.com/corporate/contracts/index.html
Note:
Refer to the Certifications tab on My Oracle Support and search for this product:
2.
b.
Select properties.
c.
d.
At the end of the Target field, add a space, a forward slash, and the string
admin to the end of the Target. The screen shot sample below illustrates this
setting:
Introduction
1-3
Exit from all running programs. You can use Microsoft Windows Task Manager to
verify that the programs are stopped. In particular, be sure that EnterpriseOne,
JDeveloper, and SQL Developer are stopped, but other programs may also need to
be stopped. Exceptions to this rule include the database service(s) which should be
running.
2.
3.
Verify that neither the installation directory nor any of its subdirectories are open
in Microsoft Windows Explorer.
4.
Verify that no Command Prompt window has as its current working directory
either the Standalone Client installation directory or any of its subdirectories.
2
Understanding the Standalone Client
Installation
2
Section 2.5, "Installing Compiler, Linker, and Software Development Kit (SDK)"
Understanding the Destination Paths of Oracle Products, also called Oracle Homes
2.
3.
4.
b.
Application server
c.
Database
d.
Database client
e.
Browser
With the exception of the browser, the other components listed above are covered
in this document. The specific versions of these products are specified in the
Oracle JD Edwards EnterpriseOne Certifications (refer to the section of this guide
entitled: Section 1.2, "Certifications").
2-1
Important Notes
The following table shows some examples these terms for the installations of an Oracle
WebLogic Server, an Oracle database and JD Edwards EnterpriseOne Standalone
Client.
Oracle Base
Path
C:\Oracle\Middleware\WLS_Home C:\Oracle
Oracle Home
Name
C:\Oracle\Middleware\WLS_Home WebLogic_Home
C:\Oracle2
C:\Oracle2\E1Local
E1Local
JD Edwards
EnterpriseOne
C:\E920_1
C:\E920_1
JDE_Standalone_
HOME
C:\E920_1
During the installation of an Oracle product, OUI copies the files from the package to
subdirectories under the Oracle Home path and then performs the necessary
configurations. In addition, it places a copy of OUI into the Oracle Home Path.
OUI also creates a submenu of items in the Start / All Programs menu. This submenu
is named "Oracle - <Oracle_Home_Name>" where <Oracle_Home_Name> is the name
that the user specified during the installation. This submenu will include links to some
of the products programs and the submenu Oracle Installation Products. Oracle
Installation Products includes a link to the copy of OUI that is in the Oracle Home
Path. Although you can run other copies of OUI to uninstall (remove) the
EnterpriseOne Standalone Client, it is safest to uninstall using the link in this
submenu.
Caution:
1.
OUI installs its own Java Runtime Environment (JRE) so one is not required to be
present before OUI is run. However, OUI will attempt to use any Java-related
Microsoft Windows environment variables that are set before it is run. Examples of
some Java environment variables are JAVA_HOME, JAVA_TOOL_OPTIONS,
and _JAVA_OPTIONS. If any of these are set to invalid values, OUI may fail to
run, or it may fail during the installation. Be sure to either validate these
environment variables or delete them before running OUI.
It is very important to understand that the JRE that OUI
uses is separate from the one that the Standalone Client uses. The one
used by the Standalone Client must be downloaded and installed
prior to installing either WebLogic Server or the Standalone Client.
Caution:
2.
Microsoft Visual Studio is not required unless you are building business functions
on the Standalone Client. If you plan to build business functions, you will need the
compiler and additional libraries that Visual Studio and Windows Software
Development Kit (SDK) provides.
3.
4.
The Standalone Client does not require Software Protection Codes (SPCs; that is,
an EnterpriseOne license) to run so you will not need to perform the steps for
applying SPCs that previous EnterpriseOne releases required.
5.
Applications Release 9.2 supports only Oracle Enterprise Edition (OEE) as the
local database.
6.
If you previously had installed a local Oracle 12c database for the Standalone
Client and you are reinstalling the Standalone Client, you do not have to uninstall
the database first. However, if you need to reinstall the OEE database for some
reason, follow the instructions in the appropriate section of this guide entitled:
Section 4, "Installing the Oracle Local Database".
7.
If you need to install the OEE database and the Microsoft Windows environment
variable ORACLE_HOME exists, the OEE installer will delete it during the
installation.
After the disk images are downloaded onto the machine on which you will install the
Standalone Client, log on to that machine as a user with Administrator rights.
Ensure that the Administrator account name that you use
does not contain any special characters.
Caution:
Use a program such as 7-Zip or WinZip to expand all disk images to be under a
common directory called Disk1 on your Standalone Client. For example:
C:\Standalone_9.20\Disk1
2-3
itself before you can run the installer for the Standalone Client. Visual Studio runtime
libraries provide the support files for C and C++ based programs to run. The Visual
Studio product includes these runtime libraries as well as a compiler and linker which
can be used to build JD Edwards EnterpriseOne business functions.
JD Edwards EnterpriseOne Tools (foundation) and Applications (business functions)
are built with different releases of Visual Studio; hence, they each require specific
installations of the Visual Studio runtime libraries or product.
You should check Oracle Certifications for the most current specifications for
supported releases of Visual Studio and the Windows SDK for your Tools Release and
Applications Release. Refer to Section 1.2, "Certifications" in this guide.
The Visual Studio runtime libraries (which are partial products with no development
tools) for each supported release of Visual Studio are freely available from the
Microsoft Download Center. The complete Visual Studio product (which includes the
runtime and the compiler and associated tools) must be purchased and licensed from
Microsoft. The Windows SDK is also free from the Microsoft Download Center.
Note: Only 32-bit versions of Visual Studio runtime libraries are
supported for use with JD Edwards EnterpriseOne. Note these
Microsoft product attributes:
2.5.2 Obtaining and Installing Visual Studio and the Microsoft Windows SDK
You should only install Microsoft Visual Studio 2013 on operating systems supported
both by Microsoft Visual Studio and Oracle JD Edwards. Refer to the Oracle
Certification system on support.oracle.com for the latest service packs, releases, and
operating systems supported with Visual Studio 2013 (the information will be under
the JD Edwards EnterpriseOne Standalone Client products).
As of the GA of Tools and Applications Release 9.2 these links and navigation to the
microsoft.com web site are valid:
Microsoft.com > Downloads > Search > Windows Software Development Kit for
Windows 8.1
https://msdn.microsoft.com/en-us/windows/desktop/bg162891.aspx
2-5
3
Installing the Application Server: Oracle
WebLogic Server 12.1.3
3
The Web Client part of the EnterpriseOne Standalone Client requires that an
application server is installed. An application server processes requests from a browser
and returns results to the browser to be displayed to the user.
The Standalone Client supports only the Oracle WebLogic Server application server.
This chapter describes how to install WebLogic Server.
Note: This document covers installations for WebLogic Server
version 12c (also known as 12.1.3). Follow the Oracle Certifications to
determine which version is supported for your particular
environment.
For example, if the supported version of the JDK is 1.7.y, follow these steps to
determine if you have a 32-bit 1.7.y JDK:
1.
2.
The terminology for the version of Java JDKs is not consistent between versions of
Java. The important things that must be present in the installed program
description are defined by these rules:
The first number of the JDK version (for example, the number 1 in 1.7.0.y) is
dropped in the Programs and Features list.
In the JDK version 1.7.0.y, the y is specified as the Update number in the
Programs and Features list.
As an example of the above rules, a 32-bit 1.7.0.60 JDK will be designated as:
Java SE Development Kit 7.0 Update 60
3.
If the correct JDK is not installed, you must download and install one.
2.
Review the site usage license agreement and click the Accept button to continue.
3.
4.
5.
On Oracle Software Delivery Cloud, in the Select Platforms pulldown, select this
checkbox:
Microsoft Windows x64 (64-bit)
6.
7.
Expand the entry Oracle WebLogic Server Standard Edition by clicking the arrow
to the left of the release name.
8.
For Available Release, turn off all checkboxes except for the highest version Oracle
WebLogic Server.
9.
10. On Oracle Standard Terms and Restrictions, read the license agreement, click the
11. On the File Download screen, click the link for the Oracle WebLogic Server.
12. Save the downloaded file to your computer.
13. Extract the contents of the downloaded file. For WebLogic Server 12.1.3, the
Caution:
2.
For more details on supported versions of the JDK, refer to the section of this
chapter entitled: Section 3.1, "Installing a JDK for WebLogic Server".
3.
Run this command in the command prompt window to launch the WebLogic
Server installer:
java -jar <path_to_wls_file>\fmw_12.1.3.0.0_wls.jar
For example:
The Java command executes and displays the Welcome screen for the Oracle
Fusion Middleware.
4.
5.
On Installation Location, in the Oracle Home field, enter or browse to a path into
which you want to install WebLogic Server.
Note: You can choose any install location; however, using a location
that contains "space" characters in the path may cause problems.
6.
7.
8.
9.
3-11
The installer displays the Installation Progress as a percentage in the progress bar.
13. On Installation Progress, the installation is complete when the progress bar
indicates 100%.
14. Click the Next button.
3-13
4
Installing the Oracle Local Database
4
Complete this chapter to install the local Oracle Enterprise Edition (OEE) database that
the Standalone Client will use.
This release of the Standalone Client requires that the local
Oracle database version is 12c.
Caution:
For the Standalone Client machine, the Oracle database 12c and the
previously supported release (Oracle 11g) cannot coexist. If 11g is
installed, before you install the 12c version of the Oracle database, you
must uninstall the Oracle 11g version using the instructions as
described in the chapter of this guide entitled: Section 11,
"Uninstalling the Oracle Local Database".
If you encounter errors during the installation process, refer to these troubleshooting
chapters:
Caution:
If you have not already installed the database engine and a database called E1Local
does not exist on your Standalone Client, use the procedures in this section to install
these requisite components before installing the JD Edwards EnterpriseOne
Standalone Client. If the local database engine is already installed and an E1Local
database exists, you can skip this chapter.
Caution:
C:\Oracle
If you attempt to install to an existing Oracle directory, the
OEE12Setup.exe installer will likely fail. Later releases of this installer
may be able to programmatically resolve this issue.
This section discusses these topics:
Section 4.1.2, "Specifying the Oracle Home User and Oracle Base Directory"
Otherwise, the OEE12Setup.exe program will fail to execute and return an error stating
the JDK is invalid.
Note: For instructions on launching InstallManager to install the
local Oracle database with default parameters, refer to the section
entitled: Section 4.2, "Using InstallManager to Install a Local
Database".
4.1.2 Specifying the Oracle Home User and Oracle Base Directory
When you launch the OEE12Setup.exe program with no switches (this is the default
operation when launched from the link on InstallManager) an OEESetup GUI is
displayed prompting for Oracle Home User login and Oracle Base Directory
information.
1.
On Local Users and Groups (Local)\Users, in the left pane, select Users.
2.
3.
User name:
Enter a name for the user. For example, e1dbuser.
4.
If you have not already done so, obtain the appropriate disk images from Oracle
Software Delivery Cloud or Update Center for the Standalone Client and local
database.
2.
Caution:
3.
If you have not already done so, expand all disk images to be under a common
directory called Disk1 on your Standalone Client.
4.
Caution:
5.
On JD Edwards Install Manager, select this link to install the local OEE database:
EnterpriseOne Database Engine
6.
On User Account Control, click the Yes button to launch the OEE12Setup.exe
installer.
7.
If you receive an Install Manager - Security warning dialog with the message "The
publisher could not be verified", click the Run button to continue the execution of
the OEESetup12.exe program to install the local Oracle database.
8.
On OEESetup, in the Oracle Home User section, you must select an Oracle Home
User. For security purposes, Oracle recommends that you specify a standard
Windows user account (that is, an account that is not in the Administrator group
of the computer). The OEE12Setup.exe program will not allow you to specify an
account that has Administrator privileges. Valid choices are:
Choose this option if you want to use an existing account for a Windows user.
This user must not have Administrator privileges. You must specify a valid
User Name and associated Password for the user.
For instructions on how to manually create an Oracle Home User, refer to the
section entitled: Section 4.1.3, "Manually Creating Oracle Home User".
Caution:
http://docs.oracle.com/database/121/NTQRF/oh_usr.htm
If you choose this selection, you are presented with the following dialog where
you must confirm that you understand the security impact of this selection.
Click the Yes button to confirm and continue, or the No button to exit the
OEE12Setup.exe program.
9.
On OEESetup, in the Oracle Base Directory section, enter the path where you want
to install the local Oracle database. You can accept the default location or specify a
location. If you accept the default location (which is c:\Oracle), some auxiliary
files are installed in that location while the local Oracle database itself is installed
in the following location:
C:\Oracle\E1Local
Caution: Do not install the Oracle Database 12c into an existing
Oracle Base directory. For example, do not install into this directory if
it already exists:
C:\Oracle
If you attempt to install to an existing Oracle directory, the
OEE12Setup.exe installer will likely fail. Later releases of this installer
may be able to programmatically resolve this issue.
Caution:
C:\Oracle\E1Local\E1Local
10. On OEESetup, click the OK button to accept the selected values. If the values are
valid the OEE12Setup.exe program proceeds to install the local Oracle database.
You must reboot your machine before continuing with the
installation of the JD Edwards EnterpriseOne Standalone Client as
described in the section in this guide entitled: Chapter 6, "Installing
the Standalone Client".
Caution:
5
Working with the Oracle Database Client
5
If you installed OEE on a 64-bit version of Microsoft Windows, you must also install a
32-bit version of the Oracle database client and then copy your tnsnames.ora file to a
subdirectory under the database client installation directory.
64- vs. 32-bit Oracle database drivers. Because JD Edwards
EnterpriseOne is a 32-bit program, it needs to load 32-bit Oracle
database driver DLLs; however, you must install a 64-bit Oracle
database in the section of this guide entitled: Chapter 4, "Installing the
Oracle Local Database". Therefore, you also need to install 32-bit
Oracle database driver DLLs. These 32-bit DLLs are provided by a
32-bit Oracle database client.
Note:
Section 5.3, "Working with the Microsoft Windows PATH Environment Variable"
Download the 32-bit Oracle 12c database client from the Oracle Software Delivery
Cloud located at this link:
http://edelivery.oracle.com
2.
Click through the license agreement if you accept the terms of the Oracle site
usage.
5-1
3.
4.
5.
On Oracle Software Delivery Cloud, in the Select Products pulldown, select this
checkbox:
Microsoft Windows x64 (64-bit)
6.
5-3
7.
On the results screen, expand the entry Oracle Database Enterprise Edition by
clicking the arrow to the left of the release name.
8.
Under the expanded entry for Oracle Database Enterprise Edition, uncheck all
checkboxes except this:
Oracle Database Client
9.
10. On Oracle Standard Terms and Restrictions, read the license agreement, click the
5-5
11. On File Download, click the link for the Oracle Database Client for Microsoft
Windows (32-bit).
12. Save the downloaded file to your computer.
13. Extract the contents of the downloaded file.
In the directory where you expanded the download in the previous step in this
chapter, run this setup file to start the Oracle database client installer:
\client32\setup.exe
2.
On Step 1 of 6, select the Administrator radio button and click the Next button.
3.
On Step 2 of 6, select the English language from the list of Available languages
and click the Next button.
5-7
4.
5.
6.
On Step 4 of 8, enter path values for the Oracle base and Software location.
7.
5-9
8.
On Step 6 of 8, verify the Global Settings and click the Install button.
9.
10. On Step 8 of 8, the installer indicates the installation was successful. Click the
If you installed the 64-bit Oracle database, the installer placed the path to the database
(for example, c:\Oracle\E1local\bin) at the start of the Windows PATH environment
variable. Then when you installed the 32-bit Oracle database client, the installer placed
the path to the database client (for example, c:\Oracle\product\12.1.0\client_
1\bin) at the start of the Windows PATH environment variable.
When EnterpriseOne runs, it looks for database drivers in each directory from start to
finish in the PATH. The first occurrence of a driver DLL that EnterpriseOne finds will
be loaded. This means that the path to the 32-bit Oracle database client must come
BEFORE the path to the 64-bit Oracle database.
If you installed the 64-bit database and 32-bit database client in that order, the order in
the PATH should be correct. However, if you installed them in the opposite order, you
need to correct the order in the PATH.
To reverse the order of the 64-bit database and 32-bit database client paths in the
Windows PATH, follow these steps:
1.
From the Start button, select Control Panel and then System.
2.
On the left side of the window that comes up, click Advanced system settings.
3.
4.
5.
In the System variables box, highlight the variable path and click the Edit
button.
6.
In the Variable value field, cut the 32-bit database client's path including the
trailing semicolon. For example:
c:\Oracle\product\12.1.0\client_1\bin;
7.
Paste the client's path and semicolon at the start of the Path value.
8.
9.
10. Click the OK button to exit from the System Properties window.
11. Close the Control Panel system window.
impdp.exe
expdp.exe
For example, you could change the extension on these files (so they are not executable)
using these commands:
cd <32-bit_db_client_install_dir>\bin
rename impdp.exe impdp.exe.bak
rename expdp.exe expdp.exe.bak
6
Installing the Standalone Client
6
This chapter describes installing the Standalone Client. Optionally, the Web Client may
be installed during the Standalone Client installation or during a separate installation.
As described earlier in this document, the Web Client uses an application server that
processes requests from a browser and then returns the results back to the browser.
The application server must be the Oracle WebLogic Server.
This chapter discusses these topics:
6-1
1.
2.
3.
6-3
4.
On Specify Home Details, you must specify an Oracle Home path and a name for
that path. For example:
Name:
JDE_E920_Standalone_Client1
Path:
C:\E920_1
Each Oracle product that is installed on a machine has what is termed an Oracle
Home path. This path contains all the files for each Oracle product. This path has a
user-specified name as well.
Caution: Do not specify the same Oracle Home name or path into
which you installed the local OEE database; however, you can specify
a path that has the same parent path as the OEE database's Oracle
Home.
Note: The OUI installer appends a number to the ends of the default
Oracle Home name and path. This number is initially "1." If an Oracle
Home already exists with the given default name and path, the OUI
installer increments this number in both the name and path.
You do not have to take the default values; you can enter your own
name and path values.
2.
5.
6.
On Package Selection, select the Demo package for the Standalone Client.
7.
6-5
8.
Development
These are needed if you plan to modify E1 objects such as business functions,
applications, forms, etc.
Production
Select this type if you do not plan to modify E1 objects.
9.
10. On Specify JRE Home Location, enter the directory of a Java Runtime
Environment (JRE) that is compatible with the Standalone Client. The installer will
provide a default JRE directory if it detects that one exists.
In order to proceed, you cannot leave this value blank and you must specify an
existing valid location and the JRE in that location must be a 32-bit version. If you
accepted the default value for installation path when you installed the 32-bit Java
Runtime Environment, the location will be in a directory under:
c:\Program Files (x86)\Java\jdk<version>
Note: When you install WebLogic Server (which is a prerequisite for
the Standalone Client), you are also required to specify an existing
JDK location. A JDK contains a JRE. The JRE that you specify above
can be the same one associated with the JDK for WebLogic Server;
however, it does not have to be the same one. If you followed the
recommendation in the chapter of this guide entitled: Chapter 3,
"Installing the Application Server: Oracle WebLogic Server 12.1.3",
you installed the requisite 32-bit JDK/JRE for WebLogic.
In any case, you should always refer to the Oracle Certifications for JD
Edwards EnterpriseOne Development Clients (which have the same
Certifications as the Standalone Client) for additional details and
supported vendors and releases of JREs for your platform and
operating system.
The installer validates the specified location and the bitness. Then it copies the JRE
to a location where it can be used by the runtime processes of the JD Edwards
EnterpriseOne Standalone Client.
Installing the Standalone Client
6-7
12. On Summary, verify that what will be installed is what you expect.
The "Space Requirements" in the upper half of the window show the space
that OUI requires for its support files. This space does not include the size of
the package that you selected.
The "Package Disk Space Requirements" shown in the lower half of the
window are for the package being installed.
The above screen is displayed near the end of the installation, At this point, the
Standalone Client installer spawns the WLSH4A installer. As the Configuration
Assistants spawned installer runs, the OUI installer displays the name of the log
file at the bottom of the screen in "Details (see full log at ...". If you do not note the
location of the log before the message or screen closes, you can find the installation
logs in this directory:
C:\Program Files (x86)\Oracle\Inventory\logs
When you display that directory using Windows Explorer, you should sort the
contents by date. The results of each installation will be logged in three files, all
with the same date_time in their names, but with different file extensions:
.log
.err
.out
For information about the WLSH4A installer, refer to the section of this guide
entitled: Section 6.2, "Installing the EnterpriseOne Web Client for WebLogic Server
(WLSH4A)".
6-9
Note:
Caution:
2.
3.
On Specify Home Details, click either one of the drop downs and select the same
name or path as the Standalone Client. When you select a path or name from one
of the drop downs, the corresponding name or path will automatically be
displayed in the other field.
It is imperative that you select the Oracle Home Name and
Path where the Standalone Client is installed. If you do not do this, the
installation will fail or the resulting installation will not be runnable.
Caution:
4.
On WebLogic Admin Server Information, you are prompted for information that is
necessary to access and configure the local WebLogic Server, which is already
installed on the Standalone Client. Using these credentials the WLSH4A installer is
able to create and configure a WebLogic Admin user and domain.
Note: It it not necessary for users to know any of this information for
an existing WebLogic Server Admin user or installation because this
installation process deletes any such existing information and
recreates the required components using the information entered on
this screen.
Note:
If the password you enter here does not meet the WebLogic password
policy on your machine the WLSH4A installer will fail later in the
installation process. To recover, you must determine a valid value for
your WebLogic Server and re-run the WLSH4A installer and enter a
valid password.
Confirm Password
Re-enter the password to confirm it.
5.
6.
Caution:
<WebLogic_install_dir>\user_projects\domains\E1DevDomain
<E1_install_dir>\system\JAS\EA_JAS_80.ear
7.
8.
9.
If running as a feature in a package, you will see the End of Installation screen.
Click the Exit button to complete the Standalone Client installation and return to
the OUI installer.
Otherwise, if you are running the WLSH4A installer manually, you will not see the
End of Installation screen.
10. On the Exit dialog, click the Yes button to exit the OUI installer.
If you encounter errors during the installation process, refer to these troubleshooting
chapters in this guide:
7
Starting the Standalone Client
7
7.1 Overview
To start the Standalone Client
1.
Overview
2.
On JD Edwards EnterpriseOne Login, enter the default user ID, which is DEMO
and the default password, which is also DEMO. If the environment and role fields
are shown, you can accept the defaults, which are environment DEMO920 and
role *ALL.
3.
If you have installed any Oracle Business Accelerators (OBA), click the Options
button to display the environment and role fields. In this case, you should enter
the role: DEMOROLE and take the default environment: DEMO920.
4.
2.
3.
Most of the records found should be prefixed with the string below in the Queue
path On-Line column:
\\SERVERNAME\E920
4.
You must manually replace the string \\SERVERNAME\E920 in Queue path On-Line
with the installation path of the Standalone Client. For example, if one of the
entries is:
\\SERVERNAME\E920\MEDIAOBJ\SELFSERVICE
And the installation directory is c:\E920_1, change the entry to:
C:\E920_1\MEDIAOBJ\SELFSERVICE
5.
7.3.1 General
If you have any trouble running the Standalone Client, turn on additional logging and
rerun the Standalone Client.
1.
2.
3.
If the column titled PID is not displayed, use this procedure to turn it on:
a. In the menu, go to View > Select Columns
b. Turn on the check box next to PID (Process Identifier).
c. Click OK.
4.
5.
activConsole.exe
jdenet_n.exe
LaunchJVM.exe
6.
In the [DEBUG] section, change the value of the Output key to FILE, as shown
below:
[DEBUG]
Output=FILE
7.
Note the names of the log files specified for the JobFile and DebugFile keys in the
Debug section so you can locate them when needed. If no directory is specified,
the files will reside in the root directory.
8.
9.
mmddyy is the month, day, and year in which the log was generated.
Try again to sign on. The security server (process jdenet_n.exe) may have simply
been slow in starting causing the activConsole.exe to time out.
2.
By default, the Standalone Client attempts to start the web client at the same time
that activConsole.exe starts. This could cause the security server (process
jdenet_n.exe) to take too long to start causing the activConsole.exe to time out.
You can specify that the web client should start only when you attempt to bring up
the Web menu (described in the next section entitled: Still Cannot Connect to the
Security Server). To do so, follow these steps:
a.
b.
c.
d.
e.
Rerun activConsole.exe.
2.
OracleServiceE1LOCAL
OracleE1LocalTNSListener
If not, for each stopped service click Action > Start in the menu.
3.
b.
c.
8
Starting the Standalone Web Client
8
8.1 Overview
To start Standalone Client Web Applications
1.
Follow the steps in this section of this guide entitled: Chapter 7, "Starting the
Standalone Client".
2.
From the menu on the main screen, select Tools > EnterpriseOne Menu.
The Standalone Client should automatically sign you into the Standalone Web Client.
8.2.1 General
If you have any trouble running the Web Client, look at the Web Client logs.
1.
In Microsoft Windows Explorer, drill down to the location of the Web Client logs.
By default, the logs are located in this directory:
C:\E920_1\system\JAS\EA_JAS_80.ear\webclient.war\logs
2.
3.
Examine any logs that were recently created, especially logs that are prefixed with
either:
jas
jde
If you do not find any logs with the above prefixes, the logs may be in another
folder. Use this procedure to determine the location of those logs:
a.
b.
Search through the file and note the value of the FILE key. In each of the
sections that describe a log file there are section headers that are enclosed in
square brackets ([ and ]). If a section header or the FILE key is commented out
with a pound or hash sign (#), you can ignore that section. For example:
# [E1LOG]
or
# File=log\jderoot.log
The value of the FILE key in each section is the name and path of a log file
associated with that section. For example:
File=log\jderoot.log
The actual file name will be the value of the FILE key with an underscore and
the current date appended. For example:
jderoot_020512.log
If a log file name and path starts with a drive letter followed by a colon and
slash, the path is absolute. This means that the log file will be located on the
specified drive in the specified directory. For example:
File=c:\standalone_logs\jas.log
If a log file name and path starts with a slash, the path is also absolute. This
means that the log file will be located on the drive on which the E1 Standalone
Client is installed and in the specified directory. For example:
File=\log\jderoot.log
If a log file name and path start with neither a drive letter nor a backslash, the
path is relative to this folder:
C:\E920_1\system\JAS\EA_JAS_80.ear\webclient.war
For example, if the value for the FILE key is log\jas.log and the Standalone
Client is installed in C:\E920_1, the log file is written to:
C:\E920_1\system\ JAS\EA_JAS_80.ear\webclient.war\log
2.
OracleServiceE1LOCAL
OracleE1LocalTNSListener
If not, for each stopped service click Action > Start in the menu.
3.
b.
c.
d.
activConsole.exe
jdenet_n.exe
LaunchJVM.exe
Rerun activConsole.exe to restart the Standalone Client, sign in, and start the
Standalone Web Client by selecting Tools > EnterpriseOne Menu from the
Standalone Client main screen.
9
Replacing the JD Edwards EnterpriseOne
Tools Release Component
9
For the following instructions, it is assumed that the folder where the
expanded Standalone Client installer resides is:
<drive>:\Standalone_9.20
1.
2.
activConsole.exe
jdenet_n.exe
LaunchJVM.exe
If any of these processes are running, either wait for them to finish or kill them via
Task Manager.
3.
Download the appropriate Tools Release WINCLIENT from the Update Center.
The download is transferred to your machine as a .par file. This file may be
opened with the standard 7-Zip or WinZip program.
Improper Unzipping. You should not open the .par file by
double clicking on it. It is a self-extracting file that is normally
installed on a deployment server. If you double-click on it, it will
assume that your workstation is a deployment server and attempt to
install it in an incompatible manner.
Caution:
9-1
4.
5.
Inside the .par file are multiple .CAB files in the Disk1\System folder. The files are
called SystemX.CAB where X is either nonexistent or a whole number. Extract these
.CAB files into the "system" folder where you placed the temporary installation
directory (for example, \Standalone_9.20\system).
6.
Uninstall the existing Standalone Client and reinstall using the new
foundation, or
b.
Backup the existing system directory and reinstall the Standalone Client in the
same Oracle Home path.
If you are backing up your existing system directory in your installed Standalone
Client, simply rename the system directory. For example, rename C:\E920_
1\system to C:\E920_1\system_old.
Note: Unable to Rename. If Microsoft Windows does not allow you
to rename the directory, one or more running java.exe processes may
have the directory locked. In this case, either reboot your machine or
use Microsoft Windows Task Manager to kill the java.exe process(es).
7.
8.
After reinstalling the client, it is best to clear the cache in your browser using these
browser-dependent procedures:
Microsoft Internet Explorer
a.
b.
c.
d.
e.
Mozilla Firefox
9.
a.
b.
On the Network tab and in the Cache section, click the Clear Now button.
c.
d.
10
Uninstalling the Standalone Client
10
This chapter describes how to uninstall the Standalone Client. This uninstall is
interactive. If you want to perform a silent uninstall by running OUI from the
command line, refer to the instructions in Appendix D, "Uninstalling a Standalone
Client from the Command Line".
Be sure to follow the guidelines in the preceding sections of
this guide entitled:
Caution:
Note: This document uses the terms "deinstall " and "uninstall"
interchangeably. The terms are synonymous and describe the removal
of a product from your workstation.
2.
Highlight the Universal Installer, right click and choose to Run as administrator.
3.
4.
On Inventory, turn on the check box next to the Oracle Home for the Standalone
Client that you want to uninstall.
Note: At this step, you should select only the Oracle Home that is
associated with this particular OUI. That is, the Oracle Home name
that you select on this screen should match the Oracle Home name
that you navigated to in Step 1.
5.
6.
7.
If you get the pop-up message box shown above, you can ignore it. Click the OK
button.
8.
9.
Verify that the installation directory (Oracle Home) for the uninstalled Standalone
Client has been deleted. If it still exists, you should manually delete it.
11
Uninstalling the Oracle Local Database
11
Note: This document uses the terms "deinstall " and "uninstall"
interchangeably. The terms are synonymous and describe the removal
of a product from your workstation.
With one small exception, the steps are identical to uninstall either the Oracle 12c or
Oracle 11gR2 local database from the Standalone Client. The exception is noted in the
steps below.
When the Oracle Enterprise Edition (OEE) database was installed, it was installed into
a subdirectory called E1Local under a base directory. By default, this base directory is
C:\Oracle. This means that the database was installed into C:\Oracle\E1Local by
default.This path is used in the uninstall steps listed below.
Follow these steps to uninstall the OEE local database.
1.
OracleE1LocalTNSListener
OracleServiceE1LOCAL
2.
3.
4.
5.
During installation, the OEE12Setup.exe program should have created several files
in the C:\Oracle\E1Local\deinstall directory. If the files were successfully
created, the deinstall.bat program will not prompt for any input from the user.
If for some reason the files were not created, the deinstall.bat program prompts
the user for information needed to uninstall the database. You can take the default
values (shown in square brackets) for most of the prompts. These are the prompts:
a.
11-1
b.
Specify the list of database names that are configured in this Oracle home
[E1LOCAL]:
c.
d.
e.
f.
Specify the list of directories if any database files exist on a shared file system.
If 'E1LOCAL' subdirectory is found, then it will be deleted. Otherwise, the
specified directory will be deleted. Alternatively, you can specify list of
database files with full path [ ]:
g.
Specify the flash recovery area location, if it is configured on the file system. If
"E1LOCAL" subdirectory is found, then it will be deleted. []:
h.
i.
6.
When the uninstall finishes, be sure that the following directories do not exist. If
they do, you will need to manually delete them.
Oracle 12c and 11gR2
C:\Oracle\E1Local
Oracle 12c only
C:\Oracle\oradata
It is very important that no files exist in the above directory
or directories (as applicable) when you next attempt to install the OEE
database. If any files do exist, the OEE installation will probably fail.
Caution:
If the database does not uninstall cleanly for some reason, you will
need to manually remove it. Follow the instructions in the Appendix
of this guide entitled: Appendix F, "Manual Cleanup of an Uninstalled
Oracle Database".
12
Troubleshooting the Installation Process
12
SEVERE - This indicates that an error occurred that should not be ignored.
Exception - Some of these may be ignored. You have to determine if they are
serious enough to warrant concern. For example, an exception that occurs when
copying a file may not be of concern to you because you will not run the
Standalone Client's functionality that uses that file. If you are in doubt whether or
not you can ignore an error, contact Oracle's Global Customer Support.
installActions<date_time>.log
oraInstall<date_time>.err
oraInstall<date_time>.out
where <date_time> is the date and time that the installation started.
Log Files
installActions<date_time>.log
oraInstall<date_time>.err
oraInstall<date_time>.out
where <date_time> is the date and time that the installation started.
Log Files
Microsoft Firewall
<Oracle_Base_dir>\cfgtoollogs
Where <Oracle_Base_dir> is the parent directory of the E1Local directory. For
example:
C:\Oracle\cfgtoollogs
Note that this cfgtoollogs directory is at the same level as the E1Local directory.
After installing the local Oracle database, use a text editor to open the log.xml file
which is typically located in this directory
C:\Oracle\diag\tnslsnr\[MACHINE NAME]\listener\alert\.
2.
Examine the contents of the log.xml file for indicators that the machine is using
IPv6 addresses.
IPv6 addresses can be distinguished by alphanumeric digits separated by colons,
rather than periods as in IPv4 addresses.
One example is if you see host_addr='::1'>. This indicates an IPv6 address,
which in this case is the machine's local loopback address, whose equivalent IPv4
address is 127.0.0.1.
Another example that indicates the use of IPv6 is if this string exists:
host_addr='fe80::7045:1aba:cb6d:1b50%13'
3.
If you see references to IPv6 addresses in the logs after installing the Oracle local
database, then you may need to uninstall the Standalone Client and Oracle
database as described in the chapters of this guide entitled: Chapter 10,
"Uninstalling the Standalone Client" and Chapter 11, "Uninstalling the Oracle
Local Database".
Also, you may possibly need to perform additional cleanup for the Standalone
Client and Oracle Database as described in the appendices of this guide entitled:
Appendix E, "Manual Cleanup of an Uninstalled Standalone Client" and
Appendix F, "Manual Cleanup of an Uninstalled Oracle Database".
4.
After the uninstall and cleanup is complete, you must apply a software patch from
Microsoft to disable IPv6 before reinstalling the Standalone Client and the Oracle
local database. The Microsoft patch for disabling IPv6 is at the following link:
How to disable IPv6 or its components in Windows
http://support.microsoft.com/kb/929852
On the above Microsoft web page, click the link labeled Disable IPv6 (Microsoft
Fix it 50409).
5.
After you apply the Microsoft patch to disable IPv6, you can reinstall the Oracle
database and JD Edwards EnterpriseOne Standalone Client using the procedures
in this guide.
Caution:
13
Troubleshooting the Standalone Client
31
For store-and-forward operation, data entered to the local database is not moved
to the server as expected.
Tables are missing.
Look for conditional statements that determine whether to activate the error message.
Look for table names to determine whether the program attempts to retrieve data.
Look for other programs that the program might call. Also, read the programmer
comments that are included in the source, which might provide a literal explanation
for why the code issues an error.
Also look at the data item that caused the error. The data item represents a control on
the form. If you get a Blanks Invalid error without an indication of what field you left
blank, look at the data item in this error detail box to see which control triggered the
error. The field that contains the error might be a hidden field. For example, if you
process a transaction that requires a supplier number determined by an Item/Branch
combination decided by JD Edwards EnterpriseOne (not by a value that you define on
the form) but no supplier number exists for the Item/Branch combination, the
software returns the Blanks Invalid error. The field for supplier number does not
appear on the form, so the cause of the error is not readily apparent. The data item
might alert you to the hidden field and help you resolve the error.
Look at the jdedebug.log to find information about the processing that occurred
at the time of the error, such as programs called and tables accessed.
Follow the exact steps that led to the error to reproduce the memory violation.
If you cannot duplicate the violation, then the application is accessing different
lines of code than it did when the violation occurred. Also look at the information
in the error detail box, such as the source file, the source line, and the data item.
For UBEs, if the UBE uses a business function that causes memory violations, the
UBE will simply stop. In this case, the UBE log is the only way to find out what
failed.
The jde.log is a helpful reference when these errors occur. In general, it includes
detailed information about the table into which the user attempted to add a duplicate
record.
For example, if the error resulted from within a business function, the system displays
the business function and line number where the error was set.
If the errors cannot be resolved through the error messages that are received in the
application, check the error messages in the log files for additional information.
A user might encounter several problems when attempting to run a batch process. For
example, the output might display only the report headings or it might print a
message such as "No Data Selected." If the result of a batch process is no data, several
factors could be causing the problem.
Some batch processes will give error messages directly on the report. These messages
should include both the short description and error message number. You can view the
full description of the error by opening the message in Data Dictionary Design.
If errors are received when you are attempting to sign in to a JD Edwards
EnterpriseOne environment, a possible cause is an incorrect data source setup on the
Standalone Client. Some indications of incorrect setup are:
A form continues to request a user ID, a password, and a data source even after
valid ones are entered.
Data is displayed incorrectly on an interactive application.
Messages in the logs refer to problems connecting to data sources or concerning
incorrect passwords.
The batch application produces error messages on the report, for example, Invalid
Company Number.
The report batch process displays the wrong font on the report.
Check the report properties of the version that you just ran. Also, for the section
that is not printing the correct font, check the section properties for the font. If the
font is correct, then try printing to a different printer. Otherwise, try using another
machine to see whether the font that is being sent to the printer is not interpreted
correctly.
The report batch process prints portrait instead of landscape or landscape instead
of portrait.
Check the report properties of the version that you just ran and verify that the
properties are correct.
See Also:
2.
3.
4.
2.
Press F8.
To see the full description of an error message, right-click and select Full
Description.
The system displays a full glossary of the error and includes information for
resolving the issue.
Verify that the data selection on the batch process is appropriate and that data
should result.
Data selection on an item that has no data, such as an inactive company, or an
incorrect value will result in a batch process with no data.
2.
Check the Work Center to see whether the batch process resulted in an error.
Most error messages are not printed on the report but are sent as an email message
to the user who submitted the report.
These messages will give the user an example of why the batch process ended
without producing the desired results. For example, when the system runs a GL
post that ends in error, the report will print only the report headings. All error
messages are sent to the Work Center.
Upon quitting the Work Center, the user receives error messages and a glossary
description that indicate why the batch process resulted in no data. Some error
messages include hot links that link the user directly to the appropriate interactive
application to correct the error.
3.
If checking the data selection and correcting any errors does not resolve the issue,
activate the applicable logs and continue with these steps.
4.
Run the batch process and locate the batch process log for the report that you ran.
JD Edwards EnterpriseOne names this log with these conventions:
report name_version_other identifiers.log
This log is located in the local directory under \E920_1\PrintQueue. If you ran
report R04431, it would appear in the local directory, \E920_1\PrintQueue, like
this:
R04431_XJDE0001_D960823_T104512.log
5.
View the log file using the JD Edwards EnterpriseOne Log Viewer or an ASCII
editor such as Notepad or Wordpad.
Inspect the log for errors or failures of any kind. Also examine the SQL statements
that were created by the batch process and verify that they should result in data on
the report. The batch process log is the main source for debugging batch processes.
However, you can look in the jde.log and jdedebug.log for errors or failures of
any kind.
6.
Verify that data exists in the tables for the database that you are accessing.
Use the Universal Table Browser tool to view the database table.
2.
3.
Language
Alpha Description
On the grid, enter values in the Data Item field and click Find to narrow the search
to the particular error code.
For example, enter 0002 to search for the data item that is associated with the
Record Invalid error condition.
4.
To see an extended description of the error, select Glossary from the Row menu.
Verify that the data selection on the batch process is correct and should result in
the data output that is expected.
2.
3.
Examine the report process flow and SQL statements to see why the data output
on the report is selected.
To find the calling SQL statement, open the batch process log.
JD Edwards EnterpriseOne names this log using these conventions: report name_
version_other identifiers.log. This log is located in the local directory, \E920_
1\PrintQueue.
2.
Highlight the SQL statement, right-click, and copy the contents to the clipboard.
3.
To view data in the local database, open the Universal Table Browser (UTB) and
retrieve the table that the batch application is accessing from the local data source.
4.
Use the information that you copied from the SQL statement to query the table in
UTB.
If this action causes the expected records to be found, the data that you specified in
the data selection matches the SQL statement, which means that data selection is
not the cause of the problem.
Such a message might indicate that the object does not exist on the Standalone Client.
Use a tool such as Windows Explorer to verify whether the file exists. You can find
consolidated .DLLs in the \E920_1\demo\bin32 directory.
If the .DLL does not exist on the Standalone Client or if it exists but you continue to get
the error even after restarting JD Edwards EnterpriseOne, you can get the correct
parent .DLL by reinstalling JD Edwards EnterpriseOne on the Standalone Client.
Another option is to copy the parent .DLL from another functioning Standalone Client.
This option will be successful if the business functions that are built into the parent
.DLL are the same on the Standalone Client that you are copying to as they are on the
one that you are copying from. Use caution when copying .DLLs. A Standalone Client
reinstallation is the preferred method.
Such a message might indicate that the object does not exist on the Standalone Client.
Use a tool such as Windows Explorer to verify whether the file exists. You can find
consolidated .DLLs in \E920_1\demo\bin32 and E920_1\system\bin32.
If the .DLL does not exist on the Standalone Client or if it does exist but you continue
to get the error even after restarting JD Edwards EnterpriseOne, the Standalone Client
has a problem with the build of one or more consolidated .DLLs. You can rebuild
libraries or .DLLs using the Busbuild application from Microsoft Windows Explorer.
The path to Busbuild.exe is \E920_1\system\bin32\Busbuild.exe.
If you are receiving the error on a specific business function that cannot be found in
the parent .DLL, use this procedure:
1.
Verify that the correct parent .DLL for the business function that is being run is
referenced when you receive the error.
2.
If the wrong parent .DLL is referenced, run Busbuild and select Synchronize
JDEBLC from the Tools menu within Busbuild to correctly synchronize the parent
.DLLs.
3.
4.
To verify which business functions are part of a parent .DLL, select Dumpbin from
the Tools menu within Busbuild.
This option lists all of the business functions that are included in the parent .DLL.
Review the event rules that are attached to the application or batch process for
obvious problems such as disconnected assignments or incorrect parameters that
were passed to business functions.
When the system generates the application, a compile error log is generated,
which documents errors in the event rules.
Review this log for errors within the Event Rules.
Do not leave the debugging logs active when the logs are not in use. The logs consume
disk and processor resources, and therefore affect performance.
If you do not use data replication in the configuration, ignore error messages that refer
to these tables in the jde.log and jdedebug.log:
F98DRPUB
F98DRENV
F98DRSUB
F98DRLOG
F98DRPCN
Logic processing.
Batch processing.
13-11
jde.log
This log displays fatal errors. The jde.log can track any fault that might occur
within JD Edwards EnterpriseOne.
jdedebug.log
This log tracks API calls and SQL statements as well as other messages. You can
use this file to determine the point in time when normal processing stopped. The
system does not use jdedebug.log to track errors. Instead, this log is used to track
the timing of JD Edwards EnterpriseOne processes.
compile_error.log
The compile_error.log contains compilation errors for event rules. You can use
this log to view event rules that might not properly compile and run. These
include Named Event Rules, Table Event Rules, and event rules that are embedded
in applications.
jdecpy.log
This log is produced each time you run the copy table program (cpytbl.exe).
Copy table error messages and IDs are logged. This log also indicates whether any
inserts failed that could indicate a possible error.
2.
3.
On Log Viewer, select File, Open to locate and open a JD Edwards EnterpriseOne
log file.
You can also use the View menu selection to select log files. If you have viewed log
files previously, the File menu keeps a history of those files.
If the value of Output in the DEBUG section of the C:\Windows\jde.ini file is NONE,
output from all EnterpriseOne processes will be written to the jde.log file.
If the value of Output in the DEBUG section of the C:\Windows\jde.ini file is other
than NONE, a new Job File and Debug File will be created for each EnterpriseOne
process that is started on the Standalone Client. In these cases, the Windows process
ID (PID) and date will be inserted into the log file names immediately before the dot.
For example, if we use the default file names (jde.log and jdedebug.log), Output is
set to FILE, activConsole.exe is run, and the PID of activConsole.exe is 123, two
new logs will be created:
jde_123_101315.log
jdedebug_123_101315.log
where _101315 indicates the date that the log was created in mmddyy format.
Similarly, if a new Busbuild.exe process is started with process ID 456, the logs
associated with Busbuild.exe would be jde_456_101315.log and jdedebug_456_
101315.log. Because the process ID is generated anew when a process first starts,
restarting activConsole.exe or Busbuild.exe in this example would result in new
sets of jde_xxx_mmddyy.log and jdedebug_xxx_mmddyy.log files for these processes
(where "xxx" is the ID of the new process and "mmddyy" is the date).
2.
3.
In the [DEBUG] section, verify or change this setting for the JobFile variable:
13-13
Setting
Purpose
JobFile=
Specifies the location and name of the jde.log file. The default value is
C:\jde.log.
Note: You can disable the jde.log on the Standalone Client by specifying a blank
or invalid value for JobFile. If you delete or disable (comment out) the JobFile
parameter, JD Edwards EnterpriseOne automatically creates and writes to a log
file called jde.log in the C:\ directory of the Standalone Client.
4.
2.
3.
Setting
Purpose
DebugFile=
Specifies the location and name of the jdedebug.log file. The default value is
C:\jdedebug.log.
4.
Enable or disable the logging of events to the jdedebug.log file through this
setting in the [DEBUG] section:
Setting
Purpose
Output=
Set the level of debugging information that you want written to the jdedebug.log
file.
The debug level is determined by this parameter in the [DEBUG] section:
Setting
Purpose
LEVEL=
Specifies the debug level. You can specify any combination of allowable values
using commas as delimiters. The default setting is LEVEL=BSFN,EVENTS.
Valid values are:
EVENTS
BSFN
SF_x
GRID
PARENT_CHILD
GENERAL
MESSAGING
WORKFLOW
WORKFLOW_ADMIN
MEDIA_OBJ
CONTROL
13-15
Note: If you get the error Access denied when trying to save the
jde.ini, you may need to exit from your text editor, discarding your
changes, and restart the editor with Run as administrator.
2.
3.
Set the level of batch report debugging information that you want written to the
batch process log file, and set whether you want the file to be saved.
These settings are controlled by these parameters in the [UBE] section:
Setting
Purpose
UBEDebugLevel=
UBESaveLogFile=
4.
If you know the problem is not related to startup, you can clear and save the logs
without quitting JD Edwards EnterpriseOne. When you recreate the problem, the
contents of the logs should contain only errors that occurred since you cleared the logs.
You can also rename the logs to indicate the kind of problem. For example, you might
delete the logs and then run an application that causes an error condition. You could
group the set of logs in a common directory such as C:\P01012_error_logs_run_1.
Another alternative is to add comment lines to a log indicating the sequence of events
that you are performing. For example, you might be running an application that you
know causes an error. Just before you run the application, you could edit the jde_xxx_
mmddyy.log to add a comment line stating that you are about to start the suspect
application.
Most error messages in the jde.log have a unique number assigned to them. You can
view an extended description of the error, including possible causes and resolutions,
by searching on the error number in the Error Messages application (P92002).
This section discusses these logs:
Not Found
Failure
Also, look at the end of the log to see what commands or tasks ran last. In general,
important lines in the log are:
SELECT
The SELECT lines indicate which table you are selecting. The log tells you in
which environment the table resides. You should verify that the selected libraries
and environments are correct.
13-17
ER Level Process
DB Level Process
The batch process log can contain ER references, batch process flow, and SQL
statements, among other messages. You can use the batch process log file to determine
when normal processing stopped.
The batch process log file displays the process flow in batch processes. This flow is
completed in these steps:
1.
When batch processes complete a section, starting with the INIT section, a
business view is opened.
After the INIT Section log, you should see a SQL statement.
2.
After INIT Section, the batch engine calls Adv Section to retrieve a record.
3.
4.
From Do Section, each object is processed in Init Object - Do Object - End Object
order.
5.
After Do Object message, you should see Printed value in the log.
ER events are logged in a different event level.
13.4.9 jdecpy.log
The system produces output for jdecpy.log each time the copy table program
(cpytbl.exe) is run on the Standalone Client. In general, the file contains records of
those tables that were successfully copied. This log also indicates whether any inserts
failed. Such failures indicate a possible error. This log is automatically stopped after
cpytbl.exe finishes.
The jdecpy.log resides in the root directory of the Standalone Client, usually in c:\.
This log is automatically generated by EnterpriseOne every time you run cpytbl.exe.
The log is created or overwritten each time it runs.
After you use jdecpy.log to determine that a copy table error has occurred, you
should refer to the jde.log. If a table does not copy properly, the detail of the error
text is written to jde.log. The jde.log contains the actual error message and message
ID. The message ID relates to the line prefix numbers in the jdecpy.log. This ID will
help you locate the applicable error text that was written to the jde.log.
13-19
A
Working with ReconfigDB.exe
Section A.2, "Encrypting and Decrypting the Password of the Local Database"
Enhanced Encryption
You should use this option with the local Oracle database and
Tools Release 9.2.0.0 and greater.
Legacy Encryption
You should use this option with Tools Releases prior to 9.2.0.0.
Note: With Tools Release 9.2.0.0 and greater, the program for
changing the password of the superuser of the local database is
ReconfigureDB.exe. The program allows these password options:
Plain Text
Enhanced Encryption
Legacy Encryption
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!! IMPORTANT !!! IMPORTANT !!! IMPORTANT !!! IMPORTANT !!! IMPORTANT !!!
!!! The superuser password must be set to the E1 encrypted password
!!!
!!! for E1 to work. Select "Enhanced" for Tools Release 9.2.0.0
!!!
!!! and later. Select "Legacy" for older Tools Releases.
!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
SYNTAX
ReconfigureDB [-options] [Old_Password|-E|-L] [New_Password|-E|-L]
LOG FILE
- The log file is
C:\ReconfigureDB.log
OPTIONS
- May be preceded by either a slash (/) or hyphen (-).
- May be either upper- or lowercase.
- Include one space before the slash or hyphen.
- The order of the options is important. The old password (or option -E or -L)
must come before the new password (or option -E or -L).
- If an old password (or option -E or -L) is given, a new password (or
option -E or -L) must be given.
- If no options are provided, a GUI will prompt for the type of database and
the passwords.
? or -H
-T[ORACLE|SSE]
Old_Password|-E|-L
2) -E
3) -L
New_Password|-E|-L
EXAMPLE
In this example, the password for the JDESSELocal database SA user will be
changed from "MyOldPassword" to a generated password that is then encrypted
with the new enhanced method:
ReconfigureDB -TSSE MyOldPassword -E
If you do not specify any command line options, this program will launch in GUI
mode and you can proceed as described in the following steps in this section.
Optionally you can use command line options to execute ReconfigureDB.exe .
For details of syntax and command line options for
ReconfigureDB.exe , refer to the preceding section in this document
entitled: Section A.1, "Understanding the ReconfigureDB.exe
Program".
Tip:
2.
On the main ReconfigureDB screen, the Select the local database section lists the
types of local databases that are currently installed; options for database types that
are not installed will be inactive.
3.
In the Select the action for the E1Local database users section, the first column
titled Change from password indicates the old password; that is, the from
password that you want to change. Select one of the available options:
Enhanced Encryption
Click this radio button if the old password was encrypted with the enhanced
encryption that is applicable to a local Oracle database and Tools Release
9.2.0.0 or greater. This option uses an enhanced encryption algorithm (relative
to prior releases) providing greater security for the local Oracle database.
Legacy Encryption
Click this radio button if the old password was encrypted with the legacy
encryption that is applicable to a local Oracle database and Tools Release prior
to 9.2.0.0 (for example, if you have an older Standalone or Development Client
on the computer).
This option uses an older, less secure encryption algorithm (relative to later
releases) providing less security for the local database.
4.
The second column titled To password indicates the new password; that is, to
what you want to change the password. Select one of the available options:
Caution:
Note: The password cannot contain any spaces. Spaces at the start or
end of the password will be removed.
Enhanced Encryption
Click this radio button if the new password will be encrypted with the
enhanced encryption that is applicable to a local Oracle database and Tools
Release 9.2.0.0. The option uses an enhanced encryption algorithm (relative to
prior releases) providing greater security for the local Oracle database.
Legacy Encryption
Click this radio button if the old password will be encrypted with the legacy
encryption that is applicable to a local Oracle database and Tools Release prior
to 9.2.0.0 (for example, if you have an older Standalone or Development Client
on the computer).
This option uses an older, less secure encryption algorithm (relative to later
releases) providing less security for the local database.
5.
6.
7.
A dialog box indicates that the password was successfully changed. Click the OK
button to exit the dialog.
8.
Watch the status bar at the bottom of the dialog for informational messages.
Tip: If changing the password fails, look in this log file for additional
information:
C:\ReconfigureDB.log
Also, ensure you are using the correct password as perhaps the
password you are trying is not what you thought it was.
If neither of the above helps resolve a password failure, attempt to
stop and restart these database services:
Oracle Database
OracleServiceE1LOCAL
OracleE1LocalTNSListener
After the database services are stopped and restarted, you can retry
ReconfigureDB.exe.
B
Understanding Executable Files on the
Standalone Client
Executable
Description
Call Details
Ap22.exe
Obsolete.
BLC2Text.exe
Obsolete.
Dir2txt.exe
Drilldwn.exe
DSArguments.exe
B-1
Executable
Description
Call Details
GBLib.exe
InstMon.exe
JDEGenEx.exe
Rtt.exe
Vdt.exe
ubeprint.exe
genver.exe
poda.exe
RDA.exe
FDA.exe
JdeCabExtract.exe
JdeCompress.exe
pssg.exe
GLBUILD.exe
Obsolete.
krnlspec.exe
This table includes descriptions and instructions for running the standalone executable
files:
Executable
Description
JDECOMConnector2.exe
LogViewer.exe
SnapShot.exe
jdedebug.log
jde.log
olt.log
jde.ini
Manages multiple
workstation installations on
the same PC.
Run Instructions
Exit JD Edwards
EnterpriseOne and then
double-click the executable.
GenCORBA.exe
Syntax:
GenCORBA generates
CORBA interfaces for JD
Edwards EnterpriseOne
business functions.
GenJava.exe
GenCORBA[options]
[libraries]
For example:
GenCORBA /Cat /UserID
Devuser1 /Password
Denuser1 /Environment
ADEVHPO2 CAEC
B-3
Executable
Description
Run Instructions
LaunchUBE.exe
VSMerge.exe
UTBrowse.exe
tda.exe
Modifies JD Edwards
EnterpriseOne tables.
tc.exe
The JD Edwards
EnterpriseOne Table
Conversion Design Tool used
to design JD Edwards
EnterpriseOne Table
Conversion batch
applications.
tamtool.exe
Executable
Description
Run Instructions
tampack.exe
pdf2pdl.exe
activConsole.exe
Main EnterpriseOne
interactive program.
appgen.exe
BsfnBuilder.exe
Obsolete.
Busbuild.exe
Debugger.exe
EndEOneMobileUI.exe
Obsolete.
endnet.exe
Obsolete.
EOneMobileUI.exe
Obsolete.
Jdeclntuni_Blanks.exe
Obsolete.
jdenet_n.exe
Obsolete.
Jdesnet.exe
Obsolete.
ReconfigureDB.exe
ServerAdministrationWorkbe
nch.exe
Monitored EnterpriseOne
servers
Obsolete.
B-5
C
Installing a Standalone Client from the
Command Line
Caution:
Instead of using the OUI-based installer in interactive mode for the Standalone Client,
optionally you can run the installation from the Microsoft Windows command line.
This may be more efficient if you have many Development Clients that you need to
install.
The OUI installer for the Standalone Client is setup.exe, which is located in this
directory:
<extracted_standalone_client_files_location>\OneWorld Client
Install\install
You can provide options to the setup.exe on the command line. Most of the options
are generic OUI options, but a few are specific to the EnterpriseOne Standalone Client
installer.
You can enter the following line to get a list of and descriptions of the generic OUI
options:
<extracted_standalone_client_files_location>\OneWorld Client
Install\install\setup.exe -help
Below is an example command line string using some of the available options (which
are listed and described later in this section). The command should be entered on a
single contiguous line with no line breaks or returns:
setup.exe -debug -force PACKAGE_NAME=DEMO INSTALL_MODE=Compact ORACLE_
HOME=c:\E920 ORACLE_HOME_NAME=JDE_E920_Client
Below is a list of the most useful generic OUI options:
-logLevel
-debug
-force
-help
-silent
Installing a Standalone Client from the Command Line
C-1
ORACLE_HOME
Required
Case sensitive
ORACLE_HOME_NAME
Required
Case sensitive
Note: Any generic options other than those listed above have not
been tested with the EnterpriseOne Standalone Client installer.
Required?
Example
Key
Description
E1_USER
EnterpriseOne user
account
No
Yes, if installing an
E1_USER=DEMO
update package that
has XML specs stored
in the database.
E1_PASSWORD
EnterpriseOne user
password. Must be
generated or
specified per the E1_
ENCRYPTION_
METHOD
Yes
Yes, if installing an
E1_
update package that PASSWORD=DEMO
has XML specs stored
in the database.
E1_ENCRYPTION_
METHOD
Encryption method
used to produce the
E1_PASSWORD.
N/A
No.
E1_ENCRYPTION_
METHOD=3
Yes
Yes
PACKAGE_
NAME=DEMO
Name of package to
install.
Key
Value Case
Sensitive?
Required?
Example
Yes
No
E1_INSTALL_
MODE=Compact
Specifies whether
No
package's files should
be copied to the
target.
No
COPY_FILES=Y
Description
C-3
D
Uninstalling a Standalone Client from the
Command Line
Caution:
2.
4.
Verify that the Oracle_Home directory (for example, C:\E920_1) was deleted. If
not, delete it.
You can provide additional options to the setup.exe on the command line. Most of the
options are generic OUI options, but those listed above must be used at a minimum.
You can enter the following line to get a list of and descriptions of the generic OUI
options:
<location_of_OUI>\setup.exe -help
Any options other than those listed above have not been tested
with the JD Edwards EnterpriseOne Standalone Client installer or
uninstaller.
Note:
E
Manual Cleanup of an Uninstalled Standalone
Client
Caution:
1.
Exit from all running programs. You can use the Microsoft Windows Task
Manager to verify that the programs are stopped. In particular, be sure
that EnterpriseOne, JDeveloper, and SQL Developer are stopped, but
other programs may also need to be stopped. Exceptions to this rule
include the database service(s) which should be running.
2.
3.
Verify that neither the installation directory nor any of its subdirectories
are open in Microsoft Windows. Explorer.
4.
If the uninstallation of the Standalone Client fails for some reason, you need to
perform the manual steps in this procedure to completely remove the old installation
before reinstalling the Standalone Client.
1.
b.
On ReconfigureDB, near the top, select the type of local database, where
E1Local (Oracle Enterprise Edition - OEE) is the only valid option for JD
Edwards 9.2 Standalone Client.
c.
d.
e.
Click OK.
f.
Caution:
3.
4.
Delete the installation directory for the Standalone Client (for example, c:\E920_
1).
If you cannot delete the installation directory because a file in that directory is
locked, follow these steps:
a.
Determine which file is locked and which process has the lock on the file. A
freeware program called Process Explorer can be helpful in determining this
information. You can obtain a free copy of Process Explorer from this web site:
http://technet.microsoft.com/en-us/sysinternals
5.
b.
Either kill the locking process with Process Explorer or Microsoft Windows
Task Manager or, if the process was started as a Microsoft Windows service,
change the Startup Type to Manual and reboot the computer.
c.
b.
c.
6.
b.
c.
d.
In the System variables box near the bottom, highlight Path and click the
Edit... button.
7.
e.
f.
g.
Click OK.
b.
c.
d.
e.
Click OK.
F
Manual Cleanup of an Uninstalled Oracle
Database
If the uninstallation of the OEE database fails for some reason, you need to perform
the manual steps in this procedure to completely remove the old installation before
reinstalling the database.
1.
2.
3.
Determine which file is locked and which process has the lock on the file. A
freeware program called Process Explorer can be helpful in determining this
information. You can obtain a free copy of Process Explorer from this web site:
http://technet.microsoft.com/en-us/sysinternals
4.
b.
Either kill the locking process with Process Explorer or Microsoft Windows
Task Manager or, if the process was started as a Microsoft Windows service,
change the Startup Type to Manual and reboot the computer again.
c.
b.
c.
5.
b.
c.
d.
In the System variables box near the bottom, highlight Path and click the
Edit button.
e.
f.
6.
Click OK.
b.
c.
d.
In the System variables box near the bottom, highlight ORACLE_HOME and
click Delete.
e.
Click OK.
G
Working With SnapShot on the Standalone
Client
Understanding SnapShot
The preceding image shows the JD Edwards main SnapShot window. The main
features of this window, from top to bottom, include:
Close (icon)
The Close icon is located in the upper right hand corner. Click this icon to exit
SnapShot.exe.
System (icon)
The System icon is located in the upper left hand corner. Click on this icon or
right-click on the title bar to display a drop-down menu that contains "About
EnterpriseOne SnapShot." Selecting this item displays version and build
information about SnapShot as shown below:
Understanding SnapShot
Existing Version
This area contains these fields and buttons:
Version
The existing installed Standalone Client. Initially, this is the release specified in
the installed package. After you save and then restore a SnapShot, this field
will be the name that you gave the SnapShot when you saved it.
Location
The JD Edwards EnterpriseOne installation directory.
Save Button
Saves the installed JD Edwards EnterpriseOne to a snapshot.
Saved Versions
The Saved Versions area contains a field that lists saved versions (also called
snapshots). The example in this image shows the following versions: B9_Perf and
E910_aaa.
Restore Button
Restores a saved version (snapshot) to a runnable JD Edwards EnterpriseOne
installation.
Delete Button
Prerequisites
Log File
Displays the log file path and name.
Close Button
Exits SnapShot.
G.2 Prerequisites
Before saving or restoring a JD Edwards EnterpriseOne installation using SnapShot, be
sure that:
You are signed into Microsoft Windows using an account with sufficient privileges
(for example: read, write, execute) to the registry and to the JD Edwards
EnterpriseOne installation and saved directories.
All JD Edwards EnterpriseOne programs are closed.
No applications (for example, Windows Explorer) have a file or subfolder open in
either the installation or the saved directory or one of their subdirectories.
The SnapShot.exe that you are running is not in either the installation or the saved
directory or one of their subdirectories.
The database(s) that both the JD Edwards EnterpriseOne installation and the
saved snapshot use is installed and running.
Ensure that the Oracle product JDeveloper is not running.
Additional considerations:
Before installing a new Standalone Client into a new Oracle Home, make sure you
do not have any previous versions in the Existing Version field of SnapShot. All
versions must be saved and should appear in the Saved Versions field.
Caution:
1.
2.
Snapshot Name
Enter a name for the snapshot that will be saved. You may choose any name
with the exceptions that the name cannot be empty and it cannot contain a
backslash ( '\' ). A recommended scheme is to make it release specific, for
example, Xe, B9, or E920.
3.
1.
On the main SnapShot window and in the Saved Versions section, highlight the
saved instance that you want to restore.
2.
Renaming an Environment
1.
On the main SnapShot window and in the Saved Versions section, highlight the
instance that you want to delete.
2.
Renaming an Environment
1.
2.
3.
4.
In the New Values section of the window, enter the new names for the
environment you want to rename.
5.
Note:
Caution:
2.
3.
Open the registry by clicking on Windows Start button and entering regedit in
the search field.
2.
Troubleshooting
can change this value or, if it does not exist yet, you can add the value with name
LogFileName, type string value, and the directory and/or file name of your
choice.
3.
The rules listed below are used for determining the final log file directory and
name based on the value of LogFileName:
In all cases, the date and time that SnapShot.exe is run will be inserted
immediately before the period in the extension of the file name.
If the value of LogFileName does not contain any backslashes, the name
represents only the file name. The value of the Windows TEMP variable will
be used as the directory.
If the value of LogFileName contains backslashes but does not start with a
drive letter or a backslash, everything up to the last backslash represents a
subdirectory or hierarchy of subdirectories below the directory designated by
the Windows TEMP variable. Everything after the last backslash is the file
name.
If the value of LogFileName starts with a backslash, it represents a
subdirectory below the root directory of the drive (that is, directory "\"). The
drive letter is derived from the drive specified in the Windows TEMP variable.
If the value of LogFileName starts with a letter followed by a colon and
backslash, the letter is considered the drive letter where the log will reside.
Any other applicable rule in the preceding rules above then apply.
The following are examples of values of the LogFileName registry entry and the
resulting log file path and name. In these examples, the assumed value of the
TEMP variable is C:\Users\John\AppData\Local\Temp and assumes the log was
created on June 5, 2012, at 3:46:9 PM.
Value for LogFileName
SnapShot.log
C:\Users\John\AppData\Local\Temp\SnapShot_2012-6-5_15-46-9.log
MyFile.txt
C:\Users\John\AppData\Local\Temp\MyFile_2012-6-5_15-46-9.txt
MyTempDir\MyFile.txt
C:\Users\John\AppData\Local\Temp\MyTempDir\MyFile_2012-6-5_15-46-9.txt
MyTempDir\MyFile.txt
C:\MyTempDir\MyFile_2012-6-5_15-46-9.txt
D:\MyTempDir\MyFile.txt
D:\MyTempDir\MyFile_2012-6-5_15-46-9.txt
4.
G.7 Troubleshooting
If SnapShot encounters a problem when trying to perform an action, it is designed to
attempt to rollback the actions performed up to the point of failure. This means that
during a save operation, SnapShot attempts to restore the JD Edwards EnterpriseOne
instance back to a runnable state. If a failure occurs during a restore action, SnapShot
attempts to resave the JD Edwards EnterpriseOne snapshot so you can correct the
problem and then retry the action.
G-11
Troubleshooting
Caution:
When an error is encountered in SnapShot, the first thing that you should do is to
carefully examine any on screen error messages for an indication of what went wrong
and why. If you are not able to determine the cause and possible resolution of an error
by examining the error message on the screen, examine the log file. As shown in the
preceding screen example, the location and name of the log file is specified in the Log
File section near the bottom of the main SnapShot window.
Troubleshooting
G-13
Troubleshooting
The reason for the failure is displayed at the top of the window followed by some
suggested remedies. In a box immediately below that are some recommendations to
resolve the error. Another box lists processes running on the workstation that have one
or more resources (for example, files, directories, handles, and so on) locked that
prevented the directory rename action from succeeding-resulting in the Access is
denied error. Click on a process in the list to get a list of open resources for that
particular process.
Troubleshooting
When you highlight a Process, the list of resources in the Resources that are open for
the selected process section at the bottom of the window shows the type as File for
both files and directories.
It is important that you follow these steps to resolve the file or directory locking
problem:
1.
Attempt to gracefully close the programs that have a resource open. That is, close
the program in the normal manner such as selecting File > Exit from the program's
main menu. You can attempt to close just the resource, but many programs
continue to hold a lock on a resource (such as a file) even after closing that
resource. Freeing the resource may require closing the actual program. For
example, if Microsoft Word has a file locked, you may have to close Microsoft
Word instead of simply closing the file from within Microsoft Word.
2.
If the program does not terminate, you may have to resort to forcefully
terminating it using Microsoft Task Manager.
G-15
Troubleshooting
3.
The SnapShot.exe program may appear in the list of active programs either by
itself or along with other processes that are locking resources. First, be sure that
you are not running SnapShot.exe from within either the installation or the save
directory or one of their subdirectories.
4.
If the SnapShot.exe program is listed with other programs, try to close those other
programs and then click Retry.
5.
If SnapShot.exe is the lone program listed, simply click Retry. Many times, the
rename action will continue after the second Retry.
6.
Not all 64-bit programs are automatically shown in the list of locking processes.
You may need to examine all the running programs on your system to determine
which one may be preventing the rename action from succeeding.
7.
If you cannot close the program(s) that holds the lock(s) on the necessary
resource(s) or determine which program(s) holds a lock, click Cancel, exit from
SnapShot, reboot the machine, run SnapShot and try the action again.
The preceding window may appear during a directory rename operation (that is,
when saving or restoring a snapshot). In this case, either SnapShot could not
determine which processes hold locks on resources in the installation or save
directories or some other reason caused the directory rename to fail. For example,
perhaps the user did not have read or write permissions on one of the affected
directories or subdirectories.
Troubleshooting
G-17
Troubleshooting
In the preceding image example, note that when you save a snapshot of the JD
Edwards EnterpriseOne installation, the highlighted files and subdirectory shown
above are created. Here are brief descriptions of the new files and subdirectory.
STARTMENU*.*
The subdirectory that is prefixed with STARTMENU is the folder in the Start menu for
the original installation.
DESKTOP*.*
The file that starts with DESKTOP is the shortcut to JD Edwards EnterpriseOne that
was on the desktop of the workstation.
jde.ini
The jde.ini file is the same file that was in the c:\Windows directory.
RegKeys*.*
Troubleshooting
The files that are prefixed with RegKeys are binary files that contain the saved
registry entries.
The preceding image shows the registry entries for a healthy JD Edwards
EnterpriseOne Standalone Client installation.
G-19
Troubleshooting
The preceding image shows the registry keys for a saved JD Edwards EnterpriseOne
snapshot.
Troubleshooting
G.7.3.2.1
If the Existing Version fields are empty when you run SnapShot.exe and you are
certain that a JD Edwards EnterpriseOne instance is active, it is likely that this file is
missing:
c:\Windows\jde.ini
If you happened to save a copy of the jde.ini file when you last saved a snapshot of
this installation, you can copy that jde.ini file into the c:\Windows directory and
rerun SnapShot.exe.
G-21
Troubleshooting
G.7.3.2.2
If a saved snapshot is not listed in the Saved Versions field and you know that the
saved snapshot exists, some registry entries are probably missing or pointing to the
wrong directory.
To resolve this issue, perform these steps:
1.
2.
3.
4.
5.
Set the value data for this to the directory where the saved snapshot is stored.
6.
7.
Set the value data for this to the installation directory (that is, the directory in
which the saved snapshot will be restored).
Troubleshooting
G-23
Troubleshooting
Glossary
This glossary provides descriptions of terms and acronyms used in this document.
Database driver
A set of code used to connect to a database. Usually consists of one or more Dynamic
Link Libraries (DLLs) or JAR files on Windows.
Oracle Software Delivery Cloud
An Oracle site from which applications can be downloaded.
H4A (HTML for Applications)
The Standalone Web Client.
Install Manager
The JD Edwards EnterpriseOne program that starts the Standalone Client installer. The
actual program name is InstallManager.exe.
Java Development Kit (JDK)
A set of tools and Java code used to develop Java applications.
Java Runtime Environment (JRE)
A set of tools used when running Java applications. May be downloaded by itself or as
part of a JDK.
JDBC driver
A database driver that is used by Java programs to connect to a database. Consists of a
file with the extension .jar.
Local database
A database that resides on the workstation on which the Standalone Client is installed.
Minimum Technical Requirements (MTRs)
The minimum software and hardware requirements needed to install and run the
Standalone Client. These are referred to as Certifications and are posted on Oracle
Certify.
Oracle Enterprise Edition (OEE)
A version of the Oracle database product. The particular version of OEE that is used
and installed by the Standalone Client is a stripped down version intended only for JD
Edwards EnterpriseOne client and deployment server installations.
Glossary-1
Deployment Server
Database Server
Glossary-2