A Working With Multiple Tools Release Foundations

As a best practice, you should always set up multiple tools release foundations, including a test environment for applying tools release fixes. This helps ensure that a stable environment exists before you promote fixes to your production environment. You can also use this same principle and procedure to set up multiple foundations of major tools releases, such as Tools Release 9.1 and Tools Release 9.2 (when applicable).

The procedures described in this document enable customers to target specific environments when they install a tools release. For example, customers can keep the production environment running on the existing foundation and apply the new tools release to all other environments. This configuration enables them to perform tests on the new foundation code without impacting the production environment. When they complete the testing, they can then apply the new tools release to production.

By completing the tasks below, you can configure your JD Edwards EnterpriseOne systems to handle many foundations on a single enterprise server. These tasks require that you reconfigure pathcodes and jde.ini files to set up multiple foundations, but once the initial tasks are completed, the new configuration requires very little maintenance.

Before you begin the installation, consider these factors:

• The multiple foundation setup uses one security server process per port.

• If you have multiple Enterprise Servers at different tools release levels, make sure each of them is pointing to the correct security data sources.

• If you have multiple foundations or multiple Enterprise Servers at different tools release levels, a dual maintenance of users and passwords is required.

• Before beginning installation of the Tools Release 9.1, check the associated readme.txt file for late-breaking information and requirements.

This appendix consists of the following tasks:

• Section A.1, "Understanding Multiple Foundation Code on the Enterprise Server"

• Section A.2, "Understanding Multiple Foundation Code on the Deployment Server"

• Section A.3, "Working with Packages for Multiple Foundations"

• Section A.4, "Working with the Development Client"

• Section A.5, "Editing the Development Client jde.ini File"

• Section A.6, "Setting up the Multiple jde.ini Files on the Deployment Server"

A.1 Understanding Multiple Foundation Code on the Enterprise Server

To install multiple foundations, you must first install and configure new system code on the Enterprise Server. This section includes these topics:

• Section A.1.1, "Working With Tools Releases on the Enterprise Server"

• Section A.1.2, "Registering an Existing Enterprise Server with Server Manager"

• Section A.1.3, "Understanding PORTTEST"

Note:

If your JD Edwards EnterpriseOne configuration includes multiple servers running JD Edwards EnterpriseOne host code (for example, additional application servers or data servers), then you will need to apply the procedures for installing multiple foundations to each server. For this type of configuration to work successfully:

• Make sure that the port settings for the [JDENET] section in the jde.ini match between all servers running the same foundation.

• Ensure the new services are running on all servers.

• Run PORTTEST successfully on all servers for all foundation releases that you have installed.

A.1.1 Working With Tools Releases on the Enterprise Server

Refer to the JD Edwards EnterpriseOne Server Manager Guide as described in the section of this guide entitled: Section 1.3, "Understanding Server Manager and This Guide".

This section discusses these topics:

• Section A.1.1.1, "Creating an IFS Directory"

• Section A.1.1.2, "Editing the JDE.INI"

• Section A.1.1.3, "Deleting the Subsystem Entry"

• Section A.1.1.4, "Creating a Subsystem for the Service Pack"

• Section A.1.1.5, "Verifying that the Library List is Set Up Correctly"

• Section A.1.1.6, "Linking Business Functions to Service Packs"

A.1.1.1 Creating an IFS Directory

Create a new IFS directory for storing the JDE logs for the new service pack by entering the following command:

MD DIR(logdirectory)

where logdirectory is the name of the IFS directory for storing the JDE logs. For example, your directory name might be PSE910SP.

A.1.1.2 Editing the JDE.INI

This section discusses editing the JDE.INI on an IBM i server.

Note:

Do not use the A98OWMNU option to access the JDE.INI. This option takes you to the Production JDE.INI, not the service pack JDE.INI.

1. Edit the JDE.INI you just copied by entering the following command:

   WRKMBRPDM FILE(syslib/INI)

   where syslib is the name of the new system library. For example, B9SPSYS.

2. Enter Option 2 to Edit the file.

3. Locate the [DEBUG] and [INSTALL] sections in the JDE.INI, and change the paths in each of the entries below to point to the new IFS directory and Library respectively:

   [DEBUG]
   DebugFile=logdirectory/JDEDEBUG
   JobFile=logdirectory/JDE.LOG
   JDETSFile=logdirectory/JDETS.LOG
   

   [INSTALL]
   DefaultSystem=syslib
   

4. Locate the [JDEIPC] section and change the startIPCKeyValue. This value should be an unused start key not within the IPC range of another instance. For example, if the IPC value of another instance is 5000, then you should set the startIPCKeyValue to 7000.

   [JDEIPC]
   startIPCKeyValue=7000
   

5. Locate the [JDENET] section, and find the port settings for serviceNameList and serviceNameConnect. For each entry, add 100 to the number. For example, if the settings are both 6013, change them to 6113.

   [JDENET]
   serviceNameListen=6113
   serviceNameConnect=6113
   

6. In the [SECURITY] section, either clear security or edit DefaultEnvironment to reference a valid environment that accesses the new Tools Release.

7. Replace all references to the production environment (for example, PD9) with a valid environment that will access the new service pack (for example, PD812).

A.1.1.3 Deleting the Subsystem Entry

The service pack installation creates an entry for the new service pack under the existing subsystem. This is not necessary, as a new subsystem will be created for the new service pack.

1. To delete the entry, type the following command:

   WRKSBSD SBSD(syslib/*ALL)

2. Enter Option 4 next to the entry that includes the new syslib and delete the entry.

A.1.1.4 Creating a Subsystem for the Service Pack

1. Ensure you are signed on as QSECOFR before performing these steps.

2. Add the SYSTEM library to your library list.

   ADDLIBLE syslib

3. Enter these commands, depending on your Tools Release:

   CHGCMD CMD(CRTOWSBS) PGM(*LIBL/CRTOWSBS)

   CRTOWSBS SUBSYSTEM(subsystemname) SYSLIB(syslib)

   where subsystemname is the name of the new subsystem for the newly installed Tools Release. For example, PSE9101SP.

   Note:

   The CALL PGM command requires four parameters, and the last three parameters should be the new SYSTEM library.

A.1.1.5 Verifying that the Library List is Set Up Correctly

Sign onto your IBM i as ONEWORLD. To ensure the library list is set up correctly, verify that it contains the newly created SYSTEM library. For example, E910PSYS.

A.1.1.6 Linking Business Functions to Service Packs

For each JD Edwards EnterpriseOne path code you want associated with the new service pack, re-link the business functions located in the associated IBM i library. The following commands must be executed against each full package for a specified path code:

1. Run LINKBSFN against the pathcode's full package. Type LINKBSFN, then press F4 to display the system prompt. Enter the package library name for the first parameter and the pathcode for the second parameter.

2. Wait until the previous step completes successfully before continuing to the next step.

3. Repeat this step for every package and pathcode you are updating.

A.1.2 Registering an Existing Enterprise Server with Server Manager

Any Enterprise Server running Tools Release 8.97 and greater should be registered with Server Manager. For details, refer to the section entitled: "Register or Create a JD Edwards Enterprise Server as a New Managed Instance" in the JD Edwards EnterpriseOne Server Manager Guide.

A.1.3 Understanding PORTTEST

To ensure that the new tools release is properly installed on the Enterprise Server, complete the following task to run PORTTEST on all environments accessing the new tools release.

Note:

If Security Server is on, then JD Edwards EnterpriseOne services must be running before PORTTEST can be run.

This section contains the following topics:

• Section A.1.3.1, "Running the PORTTEST"

• Section A.1.3.2, "Starting the Services"

A.1.3.1 Running the PORTTEST

This section discussing running the PORTTEST application on an IBM i Enterprise Server.

1. Sign on to the IBM i as ONEWORLD.

2. On Current Release 9.1 Versions, select the newly installed instance of JD Edwards EnterpriseOne.

3. Go to the Release 9.1 Menu by entering the following commands:

   ADDLIBLE JDEOW

   GO JDEOW/A98OWMNU

4. Choose option 4 to run PORTTEST.

5. Repeat the PORTTEST command for each environment accessing the new service pack

A.1.3.2 Starting the Services

This section discusses how to manage Services on an IBM i Enterprise Server.

1. Sign on to the IBM i as OneWorld.

2. On Current Release 9.1 Versions, select the newly installed instance of JD Edwards EnterpriseOne.

3. Enter these commands:

   ADDLIBLE JDEOW

   GO JDEOW/A98OWMNU

4. Choose option 6 to end JDE server.

5. Choose option 7 to clear the IPC.

6. Start the Enterprise Server using these options:

   1. Choose option 5 to start the JDE server.

   2. Choose option 8 to display active jobs.

7. Verify that the entry NETWORK is running with a PGM-MONITOR in SELW status.

8. Verify that the entry SENTINEL is running with a PGM-MONITOR in SIGW status.

Note:

Until you perform a net request, the CPU is 0 (zero).

A.2 Understanding Multiple Foundation Code on the Deployment Server

This chapter discusses:

• Installing Multiple Tools Releases on the Deployment Server

• Adding a New Machine Record for the New Tools Release

• Modifying the Existing Machine Record to Remove Environments

A.2.1 Installing Multiple Tools Releases on the Deployment Server

1. Sign on to the Deployment server using the JDE user ID.

2. Make sure that all JD Edwards EnterpriseOne processes (for example, Solution Explorer) are not running.

3. On the Deployment server, navigate to this directory:

   z:\JDEdwards\E910

   where z: is the drive on which the JD Edwards EnterpriseOne host code is installed.

4. In the E910 directory, create a directory called

   System_TR_Original

   where TR_Original is the release number of the tools release currently installed. For example, System_894_M1.

5. From the \JDEdwards\E910 directory, copy (not move) the following directories to the new System directory (System_TR_Original) that was just created. This will serve as backup or rollback location for the previous release.

   System

   SystemComp

   OneWorld Client Install

   Caution:

   Ensure you do not move these directories; they are required in both locations. This is because the installer needs to save a copy of the jdbj.ini and jas.ini files so you can relocate them in the new system directory.

   Note:

   If you get a warning message, it indicates files are locked. You need to ensure that JD Edwards EnterpriseOne or any other application is not running and causing a lock on any file.

6. If the Deployment Server is directly connected to the Internet, run the installation using one of these two methods to acquire the tools release:

   1. Change Assistant

   2. Directly from the Update Center

   In either case it is recommended to save the downloaded executable to a temporary directory and run it later from there.

7. When you run the downloaded executable, you will receive a dialog indicating that the files are extracting.

8. On Installation Complete, click OK.

   The program installs the new System, SystemComp, and OneWorld Client Install files and directories onto the Deployment Server.

9. In the E910 directory, create another new directory called System_TR_New where TR_New is the release number of the tools release being installed. For example, System_91_A1.

10. Move the newly installed System, SystemComp, and OneWorld Client Install files and directories into the new directory:

    \JDEdwards\E910\System_TR_New

    For example, \JDEdwards\E910\System_91_A1.

11. Restore the original directories by copying the System, SystemComp, and OneWorld Client Install directories from System_TR_original to the base installation directory x:\JDEdwards\E910.

12. Locate the jde.ini in this location:

    \JDEdwards\E910\System_TR_New\OneWorld Client Install\Misc

13. Modify the above-located jde.ini to change the port to that on which you wish to run the multiple foundation. For example, valid ports might be 6014, 6015, etc.

A.2.2 Adding a New Machine Record for the New Tools Release

1. On the Deployment Server, log on to the deployment environment.

2. From the Fast Path menu, run P9654A.

3. On Work with Locations and Machines, click Find and expand the location tree.

4. Click Enterprise Servers and then click Add.

5. On Enterprise Server Revisions, complete the following fields:

   Field	Description
   Machine Name	Enter the name of your existing primary Enterprise Server.
   Description	Enter a description for the machine.
   Release	Enter E910.
   Host Type	Click the visual assist button and select the type of Enterprise Server.
   Port Number	This should match the port number previously set in the new tools release jde.ini
   Database Type	Click the visual assist button and select the type of database being used on the Enterprise Server.
   Installation Path	Enter the installation library in which Release 9.1 is installed on the Enterprise Server. For example: SYSLIB

   
   

6. Click OK.

7. On Work with Locations and Machines, click Find and expand the tree.

8. Expand the Enterprise Server, click the newly added machine and click Select.

9. On Enterprise Server Revisions, click the Environments form exit.

10. On Machine Environments Revision, add the environments which you want to access with the new tools release. You can add the environments either by typing their names into the grid or by selecting them using the visual assist.

11. Click OK twice to return to Work with Locations and Machines.

A.2.3 Modifying the Existing Machine Record to Remove Environments

1. On the Deployment Server, log on to the deployment environment.

2. From the fast path menu, run P9654A.

3. On Work with Locations and Machines, click Find and expand the location tree.

4. Expand Enterprise Servers, click the initial Enterprise Server machine record and click Select.

5. On Enterprise Server Revisions form, click the Environments form exit.

6. Delete all the environments that you added in the previous section.

   This should leave you with only those environments that you have defined to access the production tools release (for example, PD910).

7. Click OK twice.

A.3 Working with Packages for Multiple Foundations

Deploying the new tools release is easily done using the Package Build application by using a non-default foundation. Use these steps to create and include a new foundation for the multi-foundation tools release.

1. Sign on to the Deployment Server using the JDE user ID.

2. Sign on to EnterpriseOne using the JDE user ID into the Deployment (DEPXXX) environment.

3. Launch the Package Assembly application from menu GH9083.

   
   

4. On Package Component Revisions, select the Multi-foundation Update Package and enter a valid value for the Parent Package.

   
   

5. On Foundation Component Selection, search for and select the new update package you specified in the previous screen.

   
   

6. On Foundation Item Revisions, complete these fields:

   Item	Value	Description
   Foundation Name	TR_NewVersion	Enter a unique name of the foundation. For example, 896_A1.
   Description	TR New Version	Enter a description corresponding to the new foundation name.
   Service Pack Number	TR New Number	Enter an arbitrary tools release number where the maximum string value is four characters. For example: 896A.
   Release	E1 Release	Use visual assist to appropriately select the EnterpriseOne release level.
   Platform Type	99 – Client	Enter Client because the foundation is to be deployed to the development client workstation.
   Build Type	20 – Optimize	You must select optimize as the build type.
   Foundation Build Status	30 – Build is Available	You must identify the package build as available.
   Date Built	Installed Date	Enter the date the tools release was installed.
   Time of Build	Time of Installation	You can enter any time. Typically you should enter the approximate time the installation was performed.
   Foundation Machine Key	Deployment Server Name	Enter the UNC name of the deployment server.
   Foundation Path	path	Enter the relative path to the new system folder. Be sure to include the front –\– and the System directory at the end. For example: \E910\System_TR_New\System

   
   

7. Click OK to save the Foundation Item Revision information.

8. On Foundation Item Revisions, select the browse button.

   
   

9. On Foundation Component Selection, select the Multi-foundation Update Package by clicking the first column of the selected row.

   Ensure that the checkmark displays in the first column of the selected row record.

10. Click Add to create a new foundation to be used.

    
    

11. On Package Component Revisions, verify that the Multi-foundation Update Package you added is displayed in the Foundation field and click OK.

    
    

12. On Package Build Revisions, select the Compression Options tab and select your compression options.

13. Click End to complete the Package Assembly process.

14. Proceed to build and deploy the package.

A.4 Working with the Development Client

Use the procedure in this section to set up your Development Client.

1. On the GH9083 menu, launch the Package Build application.

2. Create an update package by selecting Package Assembly and then Add.

   
   

3. On the Work With Features, select Add.

   
   

4. On Feature Based Deployment Director, click Next.

   
   

5. On Feature Information, complete these fields:

   Field	Description
   Feature Type	Enter a valid value for this feature type.
   Description	Enter a description for the machine.
   Feature Installation Options	Select your feature installation options by checking the appropriate check boxes.
   Components	Verify this check box is selected: Additional Install Processes

   
   

6. Click Next.

   
   

7. On Package Assembly, Additional Install Processes, complete these fields:

   • Feature

     Enter a meaningful name for the feature. For example, if you are using OAS:

     WEBDEVOAS

     If you are using WAS, an example would be

     WEBDEVWAS

     You can specify any name for the feature.

   • Feature Type

     Enter the value1.

   • Description

     Enter a description. For example:

     Web Development Objects (OH4A) for OAS

     or

     Web Development Objects (H4A) for WebSphere Express

     You can specify any name for the description.

   • Required

     Ensure this option is selected.

   • Additional Install Processes

     Ensure this option is selected.

8. Click Save.

9. Click Next.

10. Continue with the rest of the package assembly; there is no need to select any objects.

11. Define the package and, when prompted, make sure to select:

    Build Feature Inf

12. Submit the package, which creates the new feature .inf for Web Development.

    The newly created feature .inf file is located in the package.inf directory.

    Note:

    For any subsequent package builds for the non-default foundation for which you want to include webdev feature, you can use the package that you created with this procedure.

A.5 Editing the Development Client jde.ini File

Note:

If you are using Snapshot, you do not need to manually edit the jde.ini file to manage multiple clients for multiple foundations, as described in this procedure.

This section describes editing the jde.ini file for a Development Client.

In order for the Release 9.1 clients to access the new tools release, you must edit the jde.ini file on each client to point to the new directory.

Complete the following task on all Release 9.1 clients that have path codes that will access the new tools release.

Note:

You will be unable to access multiple tools releases with a single client. To access multiple tools releases, you will need to install a different client for each tools release. This will require using the Snapshot application to save each client before installing the next one.

1. On the Release 9.1 workstation, open Microsoft Windows Explorer, and navigate to your Microsoft Windows directory. For example:

   cd c:\WINDOWS

2. Open the jde.ini file.

3. Locate the [JDENET] section, and edit the port settings for serviceNameListen and serviceNameConnect. Change these entries to match those of the server jde.ini file for the new tools release.

[JDENET]
serviceNameList=portNumber
serviceNameConnect=portNumber

where portNumber is the same port number you entered in the jde.ini file on the Enterprise Server.

A.6 Setting up the Multiple jde.ini Files on the Deployment Server

You may need to set up multiple jde.ini files on the Deployment Server to address the requirement for the Development Client to access different pathcodes and ports for different application releases of JD Edwards EnterpriseOne. For details, refer to the appendix of this guide entitled: Appendix C, "Data by Pathcode".