9 Installing the Workstations for Developers and System Administrators

This chapter contains the following topics:

9.1 Workstation Installation

This section discusses these topics:

9.1.1 Overview of Workstation Installation

Release 9.1 software is first installed on the Deployment Server, and then deployed from the Deployment Server to developer and system administrator workstations. The workstation installation can occur using either interactive mode, silent mode, or push mode. Push mode is described in the JD Edwards EnterpriseOne Tools Package Management Guide.

The workstations for developers and system administrators are Microsoft Windows-based machines. Refer to the Certifications (Formerly Known as Minimum Technical Requirements) for specifically-supported versions of Microsoft Windows.

Note:

The JD Edwards EnterpriseOne 9.1 Installation delivers pre-built packages that are ready for use as delivered.

For the workstation to reflect the language installed on the Deployment Server, you must perform tasks for both the Enterprise Server and workstations, in addition to the procedures to verify and modify the JDE.INI on the workstations and the JDE.INI on the Enterprise Server.

See Also:

To facilitate the administration and maintenance of the JDE.INI for multiple client workstations, all instances of the JDE.INI are stored on the Deployment Server. To make a change to a JDE.INI for a workstation, change the original file on the Deployment Server. The file is then copied from the Deployment Server to its respective workstation during the web development client installation process.

9.1.2 Prepare for Workstation Installation

To prepare for the installation of Release 9.1 on individual workstations you must:

The workstation installation program copies all necessary components of Release 9.1 to a workstation. During installation, the installation program verifies that enough disk space exists and, if not, you are prompted to create more space before continuing.

Note:

Refer to the JD Edwards EnterpriseOne Development Client Installation Guide for additional details on installing the Web Development Client.

9.1.3 Prerequisites

Before installing Release 9.1 on a workstation used for development, you must install the Microsoft Visual C++ Compiler. The specific version of the compiler is detailed in Accessing Minimum Technical Requirements. Also refer to the appropriate Microsoft documents for installation information.

The names of the Deployment Server, Enterprise Server, and client workstation cannot exceed 15 characters in length.

Note:

You do not need full administrator privileges to install Release 9.1 on the workstation. However, you do need proper privileges for writing to the disk and the registry. If you do not have these privileges, you will receive a warning during the installation. If you receive a warning, contact your administrator, who can perform the installation or can grant proper disk and registry access.

For more information about granting disk and registry access, see the section entitled: ”Granting Disk and Registry Access for Microsoft Windows Workstations” in the JD Edwards EnterpriseOne Applications Release 9.1 Installation Guide for Oracle on Unix.

During workstation installation, connectivity is required for:

  • Read/write access to this client install directory on the primary Deployment Server in the base location:

    \oneworld

  • Read access to the subdirectories located under this directory:

    \pathcode\package

    For example:

    \\deployment_server_name\E910\PD910\package

  • Read/write access to this directory on the primary Deployment Server:

    \client

    For example:

    \\deployment_server_name\E910\client

9.1.4 Configure the jde.ini File on the Deployment Server to Specify the Security Server

Prior to installing the Web Development Client used for development, you must modify the jde.ini file on the Deployment Server to specify the Security Server. These files on this server are used by the Web Development Client installation program. If these files are not configured properly, the Web Development Client that is installed from the Deployment Server will not be able to connect to the requisite JD Edwards EnterpriseOne servers.

  1. Edit the jde.ini file in this directory on the Deployment Server:

    \\<deployment_server>\e910\OneWorld Client Install\Misc

  2. Locate this setting:

    SecurityServer=

  3. Add a valid value for your installation for the Security Server so the configured setting is:

    SecurityServer=your_server_name

  4. Save the configured jde.ini file on the Deployment Server.

9.1.5 Modifying the Workstation JDE.INI on the Deployment Server for Languages (Optional)

Note:

This is an optional task if you are using languages on your Web Development Client.

This task describes modifications required to make to the workstation JDE.INI before installing Release 9.1 on the workstation.

When using a double-byte language, modify the ODBCDataSource.inf on the Deployment Server by adding this value to all ODBC Data Sources:

DBCSNoTruncErr=1

Caution:

If the ODBC Data Sources do not have this registry value on the workstations, some records will not be inserted into tables and Insert Record Failed errors will appear.

Use this procedure to modify settings in the JDE.INI in this directory on the Deployment Server:

\JDEdwards\E910\OneWorld Client Install\Misc

To modify the workstation JDE.INI on the Deployment Server:

  1. Open the workstation JDE.INI and modify these settings:

    Note:

    For language installations, ensure that the workstation is set up correctly for language preferences to display and print forms. If multiple languages are installed, verify that the appropriate JDE.INI values are set to your preferred language. See for appropriate values.
    • [INTERACTIVE RUNTIME]

      For the language you are installing, enter:

      Initial_Language_Code = x

      where x is the value for the language installed or, if multiple languages are installed, for the preferred language.

    • [INSTALL]

      Verify that the LocalCodeSet value and code page setting are set to the appropriate values. The system reads the JDE.INI setting for the installed language.

    • [JDENET]

      Verify that the port number specified for ServiceNameListen and ServiceNameConnect matches the port number in the Enterprise Server JDE.INI.

  2. Save and close the file.

9.2 Copying the Configured tnsnames.ora File

Use this procedure to ensure the Client Installer and the OH4A installer are using the correct the tnsnames.ora

To copy the configured tnsnames.ora file:

  1. On the Deployment Server, drill down to this folder:

    oracle\E1Local\NETWORK\admin

  2. Locate the tnsnames.ora file in the above folder and copy it to this folder:

    \\deployment_server_name\E910\client

  3. When prompted whether to overwrite the existing file, you must choose to overwrite it.

9.3 Copying the JDK to the Deployment Server

As with the JDBC drivers, you must store the correct version of JDK in a defined directory on the Deployment Server. This application is then automatically downloaded to the Web Development Client during the installation process. To set up this process, the administrator must first obtain the required JDK from Sun Microsystems and copy this application to the Deployment Server as described below.

  1. On the Deployment Server, create a directory called \JDK under the folder that contains the Web Development Client installation program. For example:

    OneWorld Client Install\ThirdParty\WebDevFeature\JDK

  2. Refer to Certifications (Formerly Known as Minimum Technical Requirements)to determine the correct JDK required for this installation.

  3. Locate and download the appropriate JDK from the Sun web site:

    http://www.oracle.com/us/sun/index.htm

    The JDK may be called Java 2 Platform, Standard Edition (J2SE) for Windows or just J2SE.

    Note:

    Do not install a JDK with a version higher than what is indicated in the MTRs for the Web Development Client unless instructed to do so by JD Edwards EnterpriseOne support.
  4. Save the JDK to a temporary directory.

  5. From Windows Explorer, navigate to the temporary directory and run the executable program as an administrator.

  6. Click Next.

  7. Select Accept and click Next.

  8. Click Change, and select the \JDK directory you created in Step 1.

  9. Accept all other default values, and click Next.

  10. Deselect both Browse Registration options.

  11. Click Install.

    The installation process takes several minutes.

  12. When the process is complete, click Finish.

9.4 Understanding Workstation Installation Methods

You can select from three methods to deploy Release 9.1 and to launch the workstation installation program:

  • Interactive Mode

  • Silent Mode

  • Push Mode

9.4.1 Interactive Mode

This section discusses:

  • Creating a Desktop Shortcut

  • Using a Shared Drive

9.4.1.1 Creating a Desktop Shortcut

A system administrator can create a shortcut to InstallManager.exe from the JD Edwards EnterpriseOne client install directory on the Deployment Server and can deploy the shortcut to the workstation. For example, the client install directory is typically:

\JDEdwards\E910\OneWorld Client Install

To ensure that the shortcut works correctly, ensure the Start in field contains the location of the installmanager.htm file.

To create a desktop shortcut:

  1. To edit the Start in: field, in Microsoft Windows Explorer or on the desktop, right-click the shortcut.

  2. Click Properties, and then click the Shortcut menu.

  3. Double-click the Release 9.1 InstallManager shortcut to start the Release 9.1 installation manager.

  4. Skip to the next task immediately following entitled: Using a Shared Drive, and begin with Step 2 of that task.

9.4.1.2 Using a Shared Drive

An installer can connect to the \JDEdwards\E910 shared drive on your Deployment Server from Microsoft Windows Explorer.

To use a shared drive:

  1. Double-click InstallManager.exe to start the Release 9.1 installation manager.

    The InstallManager.exe file is located in this folder:

    OneWorld Client Install

  2. On JD Edwards EnterpriseOne Release 9.1 Installation Manager, click Workstation Install.

  3. On Client Workstation Setup, click the Next button.

    If you do not have the latest versions of Microsoft Internet Explorer the Release 9.1 Client Workstation Setup Third Party Application form appears. The option to install Internet Explorer is selected. To install this application, click the Next button. If you do not want to install these applications at this time, clear the option for one or both of them, and click the Next button.

    If the latest versions of Internet Explorer or SSE are already installed, the Third Party Application form is not displayed.

  4. On Client Workstation Setup Package Selection, select the package you want to install and click the Next button.

    Tip:

    Click the Filters ON button to narrow the displayed list of available packages. This can help you find the package you want. Notice that a short description of each package appears below the list.
  5. On Client Workstation Setup Type, complete these fields:

    • Select Setup Type

      Select Development or Production objects.

      Note:

      You should only select the Development option if you intend to develop Release 9.1 applications.
    • Install Path

      Select the drive and directory in which to install the package. For example, this is the typical path for Release 9.1:

      c:\E910

  6. To install the package, click the Finish button.

    InstallManager shows the status of the installation process through a series of forms.

    The Congratulations form indicates that the installation finished successfully. InstallManager creates a Release 9.1 shortcut in the Programs folder of your Start menu and on your desktop.

  7. Reboot if necessary.

    Caution:

    The JD Edwards EnterpriseOne client workstation installation process verifies that several of the system DLL files are current. If they are not current, you receive a message to reboot your system. When you reboot, the system updates the DLL files in your Microsoft Windows directories.

    Note:

    When you open Release 9.1 after installing the client workstation, or upgrading to Release 9.1, a security violation screen may appear. Click Get Authorization to obtain a local license, and then click OK.

9.4.2 Silent Mode

JD Edwards EnterpriseOne can also be installed to the workstation by the silent mode, which is optional. The silent installation mode lets you specify the installation path by command-line arguments instead of entering them on the Workstation Installation forms. As a result, submit the silent installation from the command line or through any scheduling service (such as Microsoft Windows schedulers) that you have installed.

Verify that you are connected to this shared drive on the Deployment Server:

\JDEdwards\E910

To work with silent mode:

  1. From the Start menu, select Run.

  2. Click the Browse button.

  3. Locate the \JDEdwards\E910\OneWorld Client Install directory on the Deployment Server, select SETUP.EXE, and then click the Open button.

  4. In the Run box, append the required parameters to setup.exe so that the command line conforms to this structure:

    setup.exe -S -P packagename -D installpath

    where packagename is a valid package name and installpath is the installation path on the workstation where Release 9.1 should be installed (for example, c:\E910).

    You also can include the following optional parameters:

    -t Typical

    Using the typical parameter installs the development objects.

    -t Compact

    Using the compact parameter does not install the development objects.

    -r

    Using the -r parameter indicates you want to uninstall the previous installation before continuing. The results of the uninstallation appear in c:\jdeinst.log.

    Caution:

    If the specified installation path already exists, the directory structure contents are overwritten.
  5. To run the command line, click the OK button.

    During a silent installation, Release 9.1 Client Installation appears in the Microsoft Windows taskbar.

  6. Verify a successful installation by viewing the c:\jdeinst.log file.

    Note:

    When you open Release 9.1 after installing the client workstation, or upgrading to Release 9.1, a security violation screen may appear. Click Get Authorization to obtain a local license, and then click the OK button.

9.4.3 Push Mode

Push mode is described in the JD Edwards EnterpriseOne Tools Package Management Guide.

9.5 Understanding Third-Party Products

The use of Microsoft Internet Explorer is optional. Adobe Acrobat Reader 6.0 or greater is strongly recommended to view reports online. Neither the browser or reader applications are delivered with the JD Edwards EnterpriseOne 9.1 Installation.

Microsoft Internet Explorer provides:

  • An option for a Web-like menu view within JD Edwards EnterpriseOne Explorer.

  • An option for an Internet connection capability directly from the JD Edwards EnterpriseOne Explorer interface.