9.0 With 8.98 Standalone Installation_rev0

8/12/2019 9.0 With 8.98 Standalone Installation_rev0

1/34

JD Edwards EnterpriseOne 9.00/8.98Standalone Client Installation GuideRunning on the Oracle Application Server

September 2008


2/34

JD Edwards EnterpriseOne 9.00 Standalone Client Installation GuideCopyright 2008, Oracle. All rights reserved.The Programs (which include both the software and documentation) contain proprietary information; theyare provided under a license agreement containing restrictions on use and disclosure and are also protected

by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly,or decompilation of the Programs, except to the extent required to obtain interoperability with otherindependently created software or as specified by law, is prohibited.The information contained in this document is subject to change without notice. If you find any problems inthe documentation, please report them to us in writing. This document is not warranted to be error-free.Except as may be expressly permitted in your license agreement for these Programs, no part of thesePrograms may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any

purpose.If the Programs are delivered to the United States Government or anyone licensing or using the Programson behalf of the United States Government, the following notice is applicable:U.S. GOVERNMENT RIGHTSPrograms, software, databases, and related documentation and technical data delivered to U.S. Governmentcustomers are commercial computer software or commercial technical data pursuant to the applicableFederal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication,disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall

be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the

extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065.The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherentlydangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup,redundancy and other measures to ensure the safe use of such applications if the Programs are used for such

purposes, and we disclaim liability for any damages caused by such use of the Programs.The Programs may provide links to Web sites and access to content, products, and services from third

parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites.You bear all risks associated with the use of such content. If you choose to purchase any products orservices from a third party, the relationship is directly between you and the third party. Oracle is notresponsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of theagreement with the third party, including delivery of products or services and warranty obligations relatedto purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may

incur from dealing with any third party.Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation and/or itsaffiliates. Other names may be trademarks of their respective owners.Open Source DisclosureOracle takes no responsibility for its use or distribution of any open source or shareware software ordocumentation and disclaims any and all liability or damages resulting from use of said software ordocumentation. The following open source software may be used in Oracle's PeopleSoft products and thefollowing disclaimers are provided.This product includes software developed by the Apache Software Foundation (http://www.apache.org/). Copyright (c)1999-2000 The Apache Software Foundation. All rights reserved. THIS SOFTWARE IS PROVIDED AS IS ANDANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FORANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OFUSE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THEPOSSIBILITY OF SUCH DAMAGE.


3/34

Table of Contents

INTRODUCTION...............................................................................................................................................1

PREREQUISITES..............................................................................................................................................1

MINIMUM TECHNICAL REQUIREMENTS .............................................................................................................1MISCELLANEOUS ...............................................................................................................................................1

DOWNLOADING THE 9.00 STANDALONE CLIENT FROM THE ORACLE E-DELIVERY

WEBSITE............................................................................................................................................................1

INSTALLING THE REQUIRED JDBC DATABASE DRIVER (SSE LOCAL DATABASE ONLY) ......1

INSTALLING THE JD EDWARDS ENTERPRISEONE 9.00 STANDALONE CLIENT .......... ............ ...1

POST INSTALLATION TASKS.......................................................................................................................1

UPDATING THE TNSNAMES.ORA FILE (ORACLE LOCAL DATABASE ONLY) ........................................................1INSTALLING THE REQUIRED JDK.......................................................................................................................3

STARTING ENTERPRISEONE STANDALONE ..........................................................................................1

STARTING ENTERPRISEONE STANDALONE WEB APPLICATIONS.................................................1

REPLACING ENTERPRISEONE STANDALONE TOOLS RELEASE.....................................................2


4/34


5/34

Introduction

This document includes these sections:

Prerequisites

Downloading the 9.00 Standalone Client from the Oracle E-Delivery Website

Installing the Required JDBC Database Driver (SSE Local Database Only)

Installing the JD Edwards EnterpriseOne 9.00 Standalone Client

Post Installation Tasks

Starting EnterpriseOne Standalone

Starting EnterpriseOne Standalone Web Applications

Replacing EnterpriseOne Standalone Tools Release


6/34


7/34

Prerequisites

Make sure your system meets the following requirements.

Minimum Technical Requirements

Customers must conform to the supported platforms for the release as detailed in the JDEdwards EnterpriseOne Minimum Technical Requirements. In addition, JD EdwardsEnterpriseOne may integrate, interface, or work in conjunction with other Oracleproducts. Refer to the following link for cross-reference material in the ProgramDocumentation for Program prerequisites and version cross-reference documents toassure compatibility of various Oracle products.

http://www.oracle.com/corporate/contracts/index.html

Access the current Minimum Technical Requirement (MTR) listing the JD EdwardsEnterpriseOne 9.00 Standalone client from Customer Connection. You can access theMTRs through multiple entry points. This path and link are one example:

Navigation: Customer Connection > Implement, Optimize + Upgrade > OptimizationGuide > Supported Platforms > EnterpriseOne

http://www.peoplesoft.com/corp/en/iou/platforms/enterpriseone.jsp

Miscellaneous

Verify that all previous releases of JD Edwards EnterpriseOne have been completelyuninstalled or saved via Snapshot before installing the EnterpriseOne 9.00 Standaloneclient.


8/34


9/34

Downloading the 9.00 Standalone Client from the Oracle E-

Delivery Website

Complete the instructions in this chapter if you are downloading the EnterpriseOne 9.00Standalone client software from the Oracle E-Delivery web site(http://edelivery.oracle.com). If you are installing the EnterpriseOne 9.00 Standaloneclient from DVD or a network share location, skip to the following chapter: Installing theRequired JDBC Database Driver (SSE Local Database Only).

To download the 9.00 standalone client from the Oracle E-Delivery website

1. On your client machine, create a temporary local folder called:

\ St andal one_9. 00

2. Open the E-Delivery web site, and enter the following values in the dropdown boxes:

Select a Product Pack: JD Edwards EnterpriseOne

Platform: Microsoft Windows (32 bit)

3. Click Go to display the results.


10/34


2 GA.Rev0 Copyright 2008, Oracle. All rights reserved

4. In the Result grid, click the Continue button to display the page entitled:

JD Edwards EnterpriseOne Tools 8.98 Media Pack for Windows (32-bit)

5. Locate the item with the description for the version of the Standalone Client

with your desired local database, where Microsoft Local Database is SQLServer 2005 Express Edition (SSE) and Oracle Local Database is OracleEnterprise Edition (OEE):

JD Edwards EnterpriseOne 9.0 Standalone-Microsoft LocalDatabase

JD Edwards EnterpriseOne 9.0 Standalone-Oracle LocalDatabase

6. Select the radio button (Part 1 of 2) for the item you wish to download andclick the Download button.

Note: Due to the maximum file size restrictions for downloads on e-delivery,you will need to download multiple parts for a selected part number.

7. When prompted, click the Save button.

8. Save the .zip file to the temporary folder created in the first step.

9. After you finish downloading (Part 1 of 2), select the corresponding row for(Part 2 of 2) and click the Download button.

10. When prompted by the File Download dialog of your browser, click the Save

button.

11. Select a temporary folder in which to save the .zip file.

12. After you finish downloading all parts of your item, navigate to the temporaryfolder and double click the first .zip file.

13. When prompted, extract the contents of this file into the root of the temporaryfolder you created in the first step of this procedure:

St andal one_9. 00

Note: When extracting, be sure to specify: Use folder names.

14. In the same manner, extract the remaining .zip files.

If you are installing the OEE version of the JD Edwards EnterpriseOne 9.00Standalone Client, all files necessary to perform the installation now reside inthe temporary folder (in this example, Standal one_9. 00). If you areinstalling the SSE version, you will need to download the SSE drivers and put


11/34



them into the proper location under this temporary folder (e.g.,Standal one_9. 00). Follow the instructions in the next section Installingthe Required JDBC Database Driver (SSE Local Database Only).


12/34


13/34

Installing the Required JDBC Database Driver (SSE Local

Database Only)

Note: SSE Local Database. The procedures in this chapter are applicable only if youare using SSE as the local database on your Standalone Client.

Note: Oracle Local Database. If you are using Oracle as the local database, the Oracledatabase drivers are included on the installation DVD for JD EdwardsEnterpriseOne. Skip this chapter.

If you are using SSE as your local database on the Standalone Client, you MUST have alocal copy of the JD Edwards EnterpriseOne 9.00 Standalone Client installer and thendownload the appropriate JDBC driver from Microsoft beforeinstalling the StandaloneClient. To complete this task, follow the steps in this chapter. Check with Microsoft forlicensing requirements before downloading their SSE database drivers.

To install the required JDBC drivers

1. If you have a JD Edwards EnterpriseOne installation DVD (as opposed todownloading from the E-Delivery web site), do the following:

a. On your client machine, create a temporary local folder called:\ Standal one_9. 00.

b. Copy the contents of the DVD to this temporary folder.

2. In the location to which you copied the JD Edwards EnterpriseOne installationDVD or the installation download (e.g., c:\Standal one_9. 00), create thisdirectory:

c: \ St andal one_9. 00\ Thi r dPar t y\ WebDevFeat ure\ J DBC

3. On the client workstation, create a directory called \JDBC to use whendownloading the required drivers. For example:

C: \ TEMP\ J DBC

4. To obtain the JDBC drivers from Microsoft, navigate to this website:

http://www.microsoft.com/downloads


14/34

Installing the Required JDBC Database Driver (SSE Local Database Only)


5. On Microsofts Download Center, scroll to the Download Categories andclick the Drivers link.

6. On the Drivers site, locate the link for the SQL Server 2005 JDBC Driver(JDBC SP2 or higher).

7. Click the Download button for the selected driver and save it in the \JDBCdirectory that you created in step 3, and click Save.

8. Navigate to the c: \ Temp\ J DBCdirectory and double-click the executablefor the driver that you downloaded.

9. Click Run, and then click Next.

10. Click Browse and select this directory:

c: \ Temp\ J DBC

21. Click Unzip.

12. Click OK.

13. Navigate to this directory:

c: \ Temp\ J DBC\ sql j dbc_1. 1\ env

14. Copy the sql j dbc. j ar file to this directory:

c: \ St andal one_9. 00\ Thi r dPar t y\ WebDevFeat ure\ J DBC


15/34


16/34



2. Click the link for EnterpriseOne E900.

3. Click Next.


17/34



4. Highlight the appropriate language and click Next to accept the licenseagreement.

5. Select DEMOand click Next.


18/34



6. Oracle Local Database.If you are using the Oracle local database version ofthe Standalone Client and the local Oracle database software has not alreadybeen installed, the above screen is displayed.

SSE Local Database.If you are using the SSE local database version of theStandalone Client and the local SSE database software has not already beeninstalled, a screen similar to the above screen is displayed, where ORACLE isreplaced with SSE.

7. Select Development and click Finish.


19/34


20/34



10.If you are installing the SSE local database version of the Standalone Client,you could get the error shown above if you did not follow the instructions inthe section Installing the Required JDBC Database Driver (SSE LocalDatabase Only). If you do get this error, do the following:

a. Complete the installation of the Standalone Client.

b. When the installation is through, complete the steps in the section

Installing the Required JDBC Database Driver (SSE Local DatabaseOnly).

c. Run the EnterpriseOne H4A installer calledc: \ St andal one_9. 00\ Thi r dPar t y\ WebDevFeat ure\ OH4A1013_set up. exe .


21/34



11. Click Next on the message regarding the Java compiler installation.

You will manually install the required JDK after the Standalone Clientsinstaller completes.

10. Click OK to finish the installation of the JD Edwards EnterpriseOne 9.00Standalone Client.

11. Examine the c:\jdeinst.log file and address any errors that you find. You canignore the following benign errors:

AddWorkstationInfoFile(): Directory permissions on'\package_inf\feature_inf\VS2005RTL_1.INF' are invalid.

AddWorkstationInfoFile(): Directory permissions on'\Package_inf\Feature_inf\WebDevelF_1.inf' are invalid.

12. Perform the tasks in the section Post Installation Tasks.


22/34


23/34


After installing the JD Edwards EnterpriseOne 9.00 Standalone client, you must performthe following post installation tasks:

Updating the tnsnames.ora file (Oracle Local Database Only)

Installing the Required JDK

Note:The JDK may be downloaded directly from Sun Microsystems.

Updating the tnsnames.ora file (Oracle Local Database Only)

Note: This process is applicable only if you are using Oracle as the local database onyour Standalone Client andthis machine is used to connect to other Oracledatabases (i.e., those that were not installed as part of the JD EdwardsEnterpriseOne Standalone Client installation).

The Oracle local database that is installed with the JD Edwards EnterpriseOne StandaloneClient is called E1Local. It has its own copy of the t nsnames. or afile which is usedto define how a connection to the database is made (e.g., port number, SID).

If you have other Oracle databases installed on this machine or access remote Oracledatabases, other t nsnames. or afiles will define those connection parameters.Unfortunately, the t nsnames. or afor the last installed Oracle database is used by anysoftware running on your local machine to access all the Oracle databases. Because theE1Local database should have been installed during the installation of the EnterpriseOneStandalone Client, it should be the last database installed; therefore, the E1Localst nsnames. or afile needs to be updated with the database connection information thatis stored in the other t nsnames. or afiles on your machine. Follow these steps toupdate the newly installed Oracle local databases t nsnames. or a.

To update the tnsnames.orafile

1. Edit the new t nsnames. or afile located in this directory:

C: \ Or acl e\ E1Local \ NETWORK\ ADMI N\ t nsnames. or a


24/34



2. Edit the t nsnames. or afiles on your machine for any other Oracledatabases that you may access (whether remote or local databases). Thesetnsnames.ora files will be located in the NETWORK\ ADMI Ndirectory underthe Oracle database clients installation directories (e.g.,c: \ Apps\ db\ or acl e102\ NETWORK\ ADMI N\ t nsnames. or a).

3. Copy the contents of these other t nsnames. or afiles to the end of the newJD Edwards EnterpriseOne local version of the file.


25/34



Installing the Required JDK

To use the Oracle Application Server with the Standalone Client, you must install the

correct version of the Java Development Kit (JDK) in a directory on the client. Tocomplete this task, you must obtain the required JDK from SUN Microsystems and copythis application to the client machine.

Refer to the Minimum Technical Requirementsto determine the correct JDK required forthis installation.

To install the required JDK

1. On the Standalone client, create two JDK directories in these paths:

c: \ Temp\ J DKc: \ E900\ syst em\ J DK

2. Navigate to this Sun Microsystems website:

http://java.sun.com/javase/downloads/index.jsp

On the displayed web page, locate the JDK version specified in the MinimumTechnical Requirementsfor the JD Edwards Standalone Client. If the currentrelease of the JDK version is greater than that specified by the MTRs, youmay need to drill down further on the Sun web site. For example, from themain index there may be a tab or a link for Previous Releases of the JDK.

3. Once the requisite JDK has been located, click the download button, reviewthe license agreement and if you choose to accept, select the Accept option toaccept the license agreement.

4. On Save As, navigate to a temporary directory on your local drive (forexample, c: \ Temp) and click Save.

5. The program downloads the JDK self-extracting executable to the temporarydirectory.

Note: Do not download the .exe file of the JDK into the JDK directorythat you created in Step 1. The reason is because when youextract this file, the file cannot exist in the same directory intowhich the extraction occurs.


26/34


27/34


To start EnterpriseOne Standalone

1. Launch JD Edwards EnterpriseOne by double clickingact i vConsol e. exefrom this directory:

c: \ E900\ syst em\ bi n32

Note: Allow sufficient time for all background processes to start beforeattempting to log in. Even though the login screen appearsimmediately, wait at least 30 seconds before signing in. Failure todo so may result in security server (processj denet _n. exe)startup errors.

2. Login to the Standalone client with the user ID DEMOand the passwordDEMO. If the environment and role fields are shown, take the defaults ofenvironment DEMO900and role *ALL.

3. If you have installed any Oracle Business Accelerators (OBA), click theOptions button to display the environment and role fields. In this case, you


28/34



should enter the role: DEMOROLEand take the default environment:DEMO900.

To troubleshoot EnterpriseOne Standalone Client startup errors

If you have any trouble running the Standalone client, turn on additional logging andrerun the Standalone client.

1. Run the Windows Task Manager.

2. Kill these processes if they are running:

act i vConsol e. exe

j denet_n. exe

3. Edit the c: \ Wi ndows\ j de. i ni file.4. In the Debug section, change the value of the Output key to FILE (without

the quotes).

5. Take note of the names of the log files specified for the JobFile and DebugFilekeys in the Debug section.

6. Run act i vConsol e. exefrom the c: \ E900\ syst em\ bi n32directory.

7. Attempt to sign into the Standalone client.

Logs are generated in the directory specified by the JobFile and DebugFilekeys in the Debug section of thej de. i ni . However, the names of the fileswill be of the formsj de_pi d_mmddyy. l ogorj dedebug_pi d_mmddyy. l ogwhere

pid is the ID of the process generating the log.

mmddyy is the month, day, and year in which the log was generated.

You can determine which process ID belongs to each E1 process by noting theprocess IDs and names shown in the Windows Task Explorer and byexamining the first few lines of the generated logs.

8. If you get an error (either in a pop-up window or in the logs) indicating that theStandalone client could not connect to the security server, try the following:


29/34


30/34


31/34


32/34




The JD Edwards EnterpriseOne 9.00 Standalone client is shipped with the 8.98.0.1version of the EnterpriseOne Tools Release. When a newer Tools Release becomesavailable, you may wish to install that release. Follow the instructions in this section toreplace the installed Tools Releasealso called system code. Also, because the H4Ainstaller will be run to configure some files, you will also replace the H4A installer with anewer installer.

Note: For the following instructions, we will assume that the folder where youcopied the JD Edwards EnterpriseOne installation DVD (in the section entitledDownloading the 9.00 Standalone Client from the Oracle E-Delivery Website) is

c: \ St andal one_9. 00.

To Replace the System

1. If EnterpriseOne is running, stop it. Verify in Task Manager that thefollowing processes stopped:

o act i vConsol e. exe

o j denet _n. exe

If either or both of these processes are running, either wait for them tofinish or kill them via Task Manager.

2. Because the entire system needs to be replaced, renamethe old systemdirectory in your installed EnterpriseOne Standalone Client; that is,c: \ E900\ syst em. If you cannot rename the directory, one or morerunningj ava. exeprocesses may have the directory locked. In thiscase, either reboot your machine or use Task Manager to kill thej ava. exeprocesses.

3. Make a backup copy of the H4A installer file calledc: \ St andal one_9. 00\ Thi r dPar t y\ WebDevFeat ure\ OH4A1013_set up. exe .

4. Download the appropriate Tools Release WINCLIENT from the UpdateCenter. The download is transferred to your machine as a . par file. Thisfile may be opened with the standard WinZip program.


33/34



Note: Do NOTopen the .par file by double clicking on it. It is a self-extracting file that is normally installed on a deployment server. If youdouble-click on it, it will assume that your workstation is a deployment serverand attempt to install it.

5. Open the . par file with WinZip.

6. Inside the . par file will be multiple . CABfiles in the Di sk1\ Syst emfolder. The files will be called Syst emX. CAB where X is eithernonexistent or a whole number. Extract these . CABfiles into a temporaryfolder. Be sure to specify Use folder names. The system . CABfiles willextract to Di sk 1\ Syst emunder your temporary folder.

7. Open each of these . CABfiles in turn in WinZip and expand them into theDi sk 1\ Syst emfolder under your temporary folder. When extracting

the . CABfiles, be sure to specify Use folder names.

8. Copy the new systemdirectory and all its files and subdirectories toyour installed EnterpriseOne Standalone Client (e.g., c: \ E900).

9. Also inside the . par file will be the H4A installer called Di sk1\ Thi r dPar t y\ WebDevFeat ure\ OH4A1013_set up. exe.Extract this file to thec: \ Standal one_9. 00\ Thi r dPar t y\ WebDevFeaturedirectory.

10.If the SSE version of the Standalone Client is installed, follow the

instructions in the section Installing the Required JDBC Database Driver(SSE Local Database Only).

11.Run the H4A installer:c: \ St andal one_9. 00\ Thi r dPar t y\ WebDevFeat ure\ OH4A1013_set up. exe.

12.Follow the instructions in the section Installing the Required JDK. If theMinimum Technical Requirement for the JD Edwards Standalone Client'sJDK has not changed from the original installation of the StandaloneClient, you may copy the JDK from the original installation (e.g.,c: \ E900\ syst em_ol d\ j dk) into the new system.

13.Clear your browser's cache.


34/34

Documents

9.0 With 8.98 Standalone Installation_rev0