Running the Platform Pack Installer

Caution: If you are installing the Enterprise Server and the Database Server on different machines, you cannot run the installer on the Enterprise Server and install the Database Server remotely. You must copy the installer images to the Database Server and run the installer on that machine. For the Enterprise Server only, you will need the image for disk1. For a Database Server, you will need the disk1 image plus the database disk images.

Note: On the Linux platform, you must install the Korn Shell (ksh) scripting language because all the database install scripts use this language. If ksh is not installed in the /bin directory, you must create a link to the install location within the /bin directory. For example, if your ksh is installed in /usr/local/bin, run this command:

ln -s
                    /usr/local/bin/ksh /bin/ksh

Caution: Beginning with Tools Release 9.2, you must have a supported JRE already installed on the target Enterprise Server for which you are installing JD Edwards EnterpriseOne system code. The Platform Pack installer prompts for the location of the preinstalled JRE and upon execution copies the JRE to the location where it is accessible by the runtime of JD Edwards EnterpriseOne. The Platform Pack installer determines whether the JRE Home Location is valid and whether the JRE is a supported version. This JRE must be a 32-bit version.

To run the JD Edwards EnterpriseOne Platform Pack Installer:

Create a folder into which you will copy the .zip file of the Platform Pack image. In addition to the Platform Pack image, you will copy one .zip file image of the Oracle database into this same directory. The directory can be any name but cannot contain spaces or special characters in the directory path. For example, the folder might be named:
/u01/UnixPPack
Caution: Do not extract the database files into a directory other than the same base directory for the Platform Pack installation. You cannot end up with a functional installation with a structure such as:/u01/UnixPPack/ORCL/ORCL
Extract the two zip files within the root of the folder created above. Using the example in this guide, a correctly extracted structure is:

Note: The byte counts in this example will likely not match those of your unzipped files.
In the above extracted structure, locate and execute the runInstaller file under the /install subdirectory.
Caution: You must sign on as the Oracle instance owner in order to run the runInstaller file. You cannot run a OUI installer as root.The installer requires that you are signed on as the Oracle database user, even if you are only installing the Logic portion of the Platform Pack. You must install the Oracle database client software and sign on as the owner of that install when running the Platform Pack. The Installer uses information about this account to configure the enterpriseone.sh. If you sign on as any other user, you will see errors during the install and will need to manually configure the database variables in enterpriseone.sh.Before running the OUI installer, ensure that the ORACLE_HOME and ORACLE_SID environment variables are set. Also ensure that the ORACLE_HOME/bin is present in the PATH environment variable.
Note: The Oracle Universal Installer takes a few minutes to start up.
On Welcome, click the Next button.
On Select Installation Type, choose your installation type:
- Full
  Choose this setup type if you wish to complete the Platform Pack installation with no further specifications. This installation option includes the required JD Edwards EnterpriseOne files for the Prototype and Pristine environments.
- Custom
  In most cases this is the mode you should choose for Upgrades.
  This mode is recommended for experienced users, choose this setup type if you wish to complete the Platform Pack installation by specifying the installation of a subset of pre-defined environments.
  Tip: If you choose Custom installation, continue with the steps below in this task which immediately follow.
- Database
  You should only use this option if you are installing a database intended to match an Oracle VM Template (OVM) for a JD Edwards EnterpriseOne Enterprise Server.
  Tip: Database only. If you want to install the database only for a non-OVM configuration, you should use the Custom option and deselect the logic components.
Click the Next button.
On Specify Home Details, complete these fields:
- Name
  Caution: Do not accept the default value for this field. If any Oracle product is already installed, the installer automatically populates this field with the existing ORACLE_HOME values, which will be incorrect for JD Edwards EnterpriseOne.
  Enter a unique name for the JD Edwards EnterpriseOne Platform Pack installation. For example:
  JDE_PPack_920_HOME
  Caution: Due to Java file and directory naming conventions, the directory name you specify here cannot contain special characters or blank (space) characters.
- Path
  Caution: Do not accept the default value for this field. If any Oracle product is already installed the installer automatically populates this field with the value corresponding to the home for the ORACLE_HOME of the installed product, which will be incorrect for JD Edwards EnterpriseOne.
  Enter the mount point where you want the files installed on your Enterprise Server.
  /u01/jdedwardsppack/e920
  Caution: Make sure to choose a disk or drive with enough space to accommodate required space for the mandatory logic server components and optionally the database components. If desired, later in the installation you can specify to install the database artifacts (such as tablespaces and tables) on a different disk and/or machine.
  If you are rerunning the JD Edwards EnterpriseOne Platform Pack Installer, refer to Rerunning the Platform Pack Installer.
Click the Next button.
The Oracle Universal Installer displays a list of available JD Edwards EnterpriseOne product components, as shown in the example below:

Tip: Use the scroll bar to on the right hand side of the screen to view the complete list of available components.
On Available Product Components, select from these choices:
JD Edwards EnterpriseOne Database Server
- System Database
  Note: This selection includes mandatory system tables. If you do not select this box and the OUI installer does not detect that the component was previously installed, it selects this component automatically. Likewise, if you rerun the JD Edwards EnterpriseOne Platform Pack Installer to add an environment it will check to ensure that this component has already been installed and you will not be given an option to install the environment on a machine, drive, or directory that is different from that which contains the JD Edwards EnterpriseOne System Database.
- Production Databases
- Prototype Databases
- Development Databases
- Pristine Databases
JD Edwards EnterpriseOne Enterprise Server
- JD Edwards EnterpriseOne Foundation
  Note: This selection includes system files. You must choose this feature for all initial installations of the Enterprise Server. If you do not select this feature, the JD Edwards EnterpriseOne Platform Pack Installer automatically selects it for installation.
- ES Production
- ES Prototype
- ES Development
- ES Pristine
Note: For any Upgrades, you should always select the Pristine environment. Otherwise, Table Conversions will not process correctly.For Simplified Upgrades, you must have the Pristine environment in order to run Spec Merge.
After you have verified your selection of components, click the Next button.
On Would you like to Install or Upgrade EnterpriseOne?, choose whether you want to install or upgrade JD Edwards EnterpriseOne. The list below describes each run mode.
- Install
  Install EnterpriseOne
  In this mode, the JD Edwards EnterpriseOne Platform Pack Installer checks for the existence of JD Edwards EnterpriseOne business data and control tables; if either exists, the JD Edwards EnterpriseOne Platform Pack Installer aborts. This prevents the inadvertent overwriting of existing critical business data and control tables. If the JD Edwards EnterpriseOne Platform Pack Installer does not detect pre-existing JD Edwards EnterpriseOne data or control tables, the installation process continues normally.
  Caution: You should always back up all databases that you want to preserve.
- Traditional Upgrade
  Traditional Upgrade EnterpriseOne
  In this mode, the JD Edwards EnterpriseOne Platform Pack Installer checks for the existence of JD Edwards EnterpriseOne business data and control tables which are prerequisites to an upgrade of JD Edwards EnterpriseOne.
  In this Upgrade mode, the installer replaces all objects in the selected pathcodes.
  Caution: You should always back up all databases that you want to preserve.
- Simplified Upgrade
  Simplified Upgrade EnterpriseOne
  Note: The Simplified Upgrade is only available when upgrading from JD Edwards EnterpriseOne Applications Releases 9.0 Update 2 or 9.1.
  As with the Traditional Upgrade, in this mode the JD Edwards EnterpriseOne Platform Pack Installer checks for the existence of JD Edwards EnterpriseOne business data and control tables which are prerequisites to an upgrade of JD Edwards EnterpriseOne.
  The Simplified Upgrade does not deliver Central Objects, except for PS920. The existing Central Objects are preserved and the data sources are configured to point to existing prior release path codes, which can be either from JD Edwards Release 9.0.2 or 9.1. The installer delivers logic objects and path codes for each environment that is selected for the upgrade.
  For example, if you run a Simplified Upgrade from DV900 to DV920, the DV900 Central Objects do not match those that are required for Applications Release 9.2. The Central Objects - DV920 points to DV900. The process ensures that an attempt for an object match on these objects does not occur until you run the Spec Merge. The Platform Pack requires the 9.2 table definitions in order to run the TC Workbench (which runs before Spec Merge). Therefore the Platform Pack installs a second spec.ini (Simplified_spec.ini) which points ALL pathcodes to PS920FA
  If you choose a Simplified Upgrade, the Platform Pack renames the existing spec.ini to another name (for example, spec.bak) so that it can rename the file for Simplified Upgrade, which is Simplified_spec.ini, to spec.ini. If you build and deploy and new PS920 package before upgrading DV, you will need to update the spec.ini in DV920 to point to the new PS package. For example, PS920FB.
  If you choose to upgrade the Pristine and Development environments, the installer delivers databases for these path codes:
  - PS920
  - PS920CTL
  - PS920DTA
  - SY920
  - OL920
  - DD920
  - SVM920
  For the database, the JD Edwards EnterpriseOne Platform Pack Installer performs the same as a Traditional Upgrade in terms of delivering the entire database for the Pristine environment. However, unlike the Traditional Upgrade, the Simplified Upgrade does not deliver Central Objects for other environments.
  Note: For Simplified Upgrade, for all databases, these users are created by the Platform Pack but they are not used:
  Caution: You should always back up all databases that you want to preserve.
Click the Next button.
On Database Options, complete these fields:
- Database Type
  Use the pulldown to choose Oracle.
- Database Server
  By default, the JD Edwards EnterpriseOne Platform Pack Installer automatically detects and populates this field with the machine name on which it is running. The JD Edwards EnterpriseOne Platform Pack Installer validates the Database Server name and compares it against the name of the local computer. If these values are different (for example, if you manually change the value of this field), the JD Edwards EnterpriseOne Platform Pack Installer assumes the Database Server is either a clustered or remote server. If you have selected to install databases, and the database server name that you entered cannot be validated, a warning dialog is displayed with resolution instructions. Refer to the section of this chapter entitled: Warning - Database Server Name Does Not Match.
  For additional details on all Platform Pack error conditions, refer to the section of this chapter entitled: Troubleshooting Platform Pack Installation.
  Caution: If you are installing the Enterprise Server and the Database Server on different machines, you cannot run the installer on the Enterprise Server and install the Database Server remotely. You must copy the installer images to the Database Server and run the installer on that machine. For the Enterprise Server only, you will need the image for disk1. For a Database Server, you will need the disk1 image plus the database disk images.
- Secure Password
  Caution: In order to ensure data security, Oracle strongly recommends that you change this to a secure password.
  If you wish to change the default password that the JD Edwards EnterpriseOne installer uses when creating Oracle users, you can enter a value for the Secure Password that conforms to the password policy of your operating system. The maximum length of the Secure Password is 10 characters and cannot contain any of these special characters: @ $ / \
  Caution: The non-encrypted value for the Secure Password is stored in the ORCL_set.sh file. This password is used to load the database components. Oracle strongly recommends that you erase this value once the database scripts have run successfully.Note: If you subsequently add an additional database component, you must set the value in the set script back to the Secure Password before running the scripts or the OUI installer (which calls the scripts) for the additional components.
  Note: If you do not change the default value (DEFAULT), the system creates a password for each user where the password is the same as their user ID. For example, if a user ID is JDE, then by default the system creates a corresponding password of JDE for that user.
  Caution: When you change the default password in the Platform Pack installation for your Enterprise Server, you must also manually change the [DSPWD] section in the jde.ini on the Deployment Server and specify the new secure password that you are using. If you fail to synchronize these database password settings, the various Installation Workbenches will not be able to connect to the database.For additional details on working with the [DSPWD] section of the jde.ini file, refer to the section of this chapter entitled: Working with Database Security.
- Confirm Password
  Re-enter the password.
Click the Next button.
The installer displays the Password Strength panel if you have chosen a weak password.
Caution: The installer program does not force you to change your password for a weak value. However it is highly recommended that you change your password. Use of mixed case, numerics and special characters raise complexity.
Click the Back button to go back and change the password or click the Next button to continue.
On Administrator and End User Roles, specify the roles that the installer will create and assign to the JDE users in the database:
- Admin Role
  The default value is JDEADMIN.
- End User Role
  The default value is JDEUSER.
Caution: For your Production systems, Oracle highly recommends that you change these default values for roles.
Click the Next button to continue the configuration of the Oracle database.
On Oracle Database Information, complete these fields referring to the Oracle Database Server that you want to use:
Note: You must specify the SYSADMIN user as system. The Oracle portion of the install will fail if you supply sys or any other user that must connect with "as SYSDBA".
- Connect String
  Enter a valid value for your Oracle connect string. You may need to obtain this value from your Oracle DBA. You cannot proceed with the installation until this value can be validated by the JD Edwards EnterpriseOne Platform Pack Installer; that is, the Installer will not allow you to proceed if it cannot connect to the database.
- SYSADMIN User
  The value system (or equivalent) identifies the system administration user for your Oracle installation. This user must have full DBA privileges which are standard for Oracle installations. The OUI installer uses the Oracle export / import tool (data pump).
  Caution: Unlike versions of the JD Edwards EnterpriseOne Platform Pack installer for Oracle databases which were previous to Release 9.1 and greater, you cannot use the value sys here. Oracle recommends you use the default value of system.
- SYSADMIN Password
  Enter a valid password for the system administration (SYSADMIN) user under which you will be installing the JD Edwards EnterpriseOne Oracle databases.
  Caution: The non-encrypted value for the SYSADMIN Password is stored in the ORCL_set.shORCL_set.bat file. This password is used to load the database components. Oracle strongly recommends that you erase this value once the database scripts have run successfully.Note: If you subsequently add an additional database component, you must set the value in the set script back to the SYSADMIN Password before running the scripts or the OUI installer (which calls the scripts) for the additional components.
- Have you pre-created the tablespaces?
  Choose the radio button applicable to your installation:
  - Yes
  - No
  Note: The database load scripts support creating ASM tablespaces.You should use the Yes option if you wish to do anything other than creating the tablespaces in the most basic fashion. If you select Yes, the installer will not create the tablespaces. In this case, you should also choose to the Run Scripts Manually option, and then edit the tablespace creation scripts to your specifications before running the scripts yourself. Refer to the section of this chapter entitled: Manually Running the Database Creation Scripts.
- Tablespace Directory
  Enter the path where you want the JD Edwards EnterpriseOne Platform Pack Installer to create your Oracle database tables. For example:
  /u01/JDEdwardsPPack/ORCL/Tables
  Note: If you are installing to ASM, put the name of your ASM Disk Group in place of the directory name example above. Tip: You can find the name of your ASM Disk Group using the following SQL statement:SELECT name FROM v$asm_diskgroup;For example, if your ASM Disk Group is named "DATA", you would complete this field as shown below:
- Index Tablespace Directory
  Enter the path where you want the JD Edwards EnterpriseOne Platform Pack Installer to create your Oracle database indexes. For example:
  /u01/JDEdwardsPPack/ORCL/Indexes
  Note: If you are installing to ASM, put the name of your ASM Disk Group in place of the directory name example above. Tip: You can find the name of your ASM Disk Group using the following SQL statement:SELECT name FROM v$asm_diskgroup;For example, if your ASM Disk Group is named "DATA", you would complete this field as shown below:
- Run Scripts Option
  The default value is Run Scripts Automatically.
  Optionally, you can use the pulldown to choose Run Scripts Manually. If you choose this option, refers to a later section in the chapter entitled: Manually Running the Database Creation Scripts.
  The following Oracle connect information screen only appears if you did not select any database components. Usually this is the case because you are installing the database components and the logic components on separate machines.
  
  On Oracle connect information, enter the connect string for your Oracle database and click the Next button. The installer continues with the next screen as described below.
  If you did not select any database components, the installer will not show the Oracle connect information screen and will proceed to install both the logic and the database components on this machine.
On Automated Storage Management, select the Yes or No radio button to indicate whether your Oracle database is using ASM. The default selection is No.
Note: If you are installing to ASM, for the preceding screen entitled "Oracle Database Information", for tablespace and index locations, ensure you have put the name of your ASM Disk Group in place of the directory names.
Click the Next button.
If you chose Traditional or Simplified Upgrade, the installer checks for the existence of Business Data for JD Edwards EnterpriseOne. This data is required for an Upgrade. If the Business Data does not exist, the installer displays the following error:

The error indicates the installer could not detect the Business Data and Control tables for the Prototype environment. You cannot proceed with an Upgrade if these databases are not present and available. If these are not available, then your only option is to choose an Install and not an Upgrade.
Click the Next button.
On Specify JRE Home Location, enter or browse to the location of your 32-bit Java Runtime Environment (JRE). 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 Java Runtime Environment, the location will be in a directory under:
c:\Program Files (x86)\Java\jdk<version>
/usr/java/jdk<version>/jre
or
/usr/lib/jvm/java<version>/jre
The installer validates the specified location and copies the JRE to a location where it can be used by the runtime processes of JD Edwards EnterpriseOne.
Caution: This JRE is a prerequisite to installing JD Edwards EnterpriseOne. Because JD Edwards EnterpriseOne running on an Enterprise Server as a 32-bit application, the pre-installed JRE for use by JD Edwards EnterpriseOne on the Enterprise Server must be a 32-bit version. Refer to the Oracle Certifications for JD Edwards EnterpriseOne Enterprise Servers for additional details and supported vendors and releases of JREs for your platform and operating system.
Click the Next button.
On Summary, in the top half of the screen, review your selections and in the bottom half of the screen review the NOTES, which detail the disk space requirements for OUI support files and also for the Platform Pack being installed on this machine.
Click the Install button.
As the installer runs it displays the Install progress, as shown in the following example.
When the installation completes, the following Running scripts as root dialog is displayed.
On Running scripts as root, the dialog instructs you to perform these actions outside the installer:
1. Sign on as root.
2. Navigate to the SharedScripts subdirectory of the JD Edwards install directory. For example:
  /u01/jdedwardsppack/e920/SharedScripts
3. Run this script to complete setting up the system accounts:
  addacct.sh
  This script also locks down permissions to this directory:
  /u01/jdedwardsppack/e920
4. When the scripts have completed successfully, click the OK button to exit the dialog and return to the OUI Platform Pack installer End of Installation screen.
On End of Installation, verify the installation of the EnterpriseOne Platform Pack was successful.
Review the Please remember ... portion for the installer log file location. The log file name is specified with the date and stamp when the installer ran. For example:
/u01/app/oraInventory/logs/installActions2015-05-10-11-16-47PM.log
Click the Exit button to exit OUI.
On Exit, click the Yes button.