Working with Software Masters

This chapter provides an overview of software master creation and discusses how to:

• Prepare for software master creation.

• Create a software master.

• Delete a software master.

• Work with a software master definition.

• Work with software master templates.

Understanding Software Master Creation

This section discusses the software master creation process.

Use this checklist to ensure that you complete all of the processes that are necessary for creating a software master:

• Verify that at least 1 GB of space is available for the TEMP directory of the workstation from which you use JD Edwards EnterpriseOne Product Packaging Tools.

  This memory requirement is the most memory that you might need for a software master. The actual size of the master depends on the size of the package that you create.

• Complete the tasks in this section.

• Define a software master using Oracle's JD Edwards EnterpriseOne CD Configuration Director.

• Provide information about the type of master that you want to create, such as its name, release number, and so on.

• Select the package that you want built into the master.

• Configure change tables using Oracle's JD Edwards EnterpriseOne Change Table Director.

• Provide the target release number for the change tables.

• Provide source environment information about the change tables.

• Select the change tables and their versions.

• Validate the software master definition.

• Create the final software master, which automatically validates the master.

• Use the software master to update JD Edwards EnterpriseOne.

Preparing for Software Master Creation

This section discusses how to:

• Set up the system TEMP directory.

• Set up the UBEs.

• Create pristine control tables.

• Verify the JD Edwards EnterpriseOne Product Packaging data source.

• Create a data dictionary in the pristine data source.

• Create change tables.

• Verify the creation of change tables.

Setting Up the System TEMP Directory

This task creates a temporary directory that will be used to store the Oracle Supported Local Database (in MSDE) for mastering the JD Edwards EnterpriseOne Product Packaging CD.

To set up the System TEMP directory:

1. From the Windows desktop, select Start, Settings, Control Panel.

2. On Windows Control Panel, double-click the System button.

3. On System Properties, click the Advanced tab.

4. Double-click Environment Variables.

5. Set the TEMP and TMP variables for both the User and System settings so that they all access the same directory (for example, c:\TEMP).

   Note. Ensure that the windows temporary directory on the workstation has at least 1 GB free disk space available (the more space the better). If the temp directory has less than 1 GB of free space, you can create a temp directory on another disk drive with adequate space and set the system environment variables TEMP and TMP to point to the new temp folder. Reboot the system for the change to take effect.

   This directory will store the software master that you create in the following tasks.

6. In the temporary directory that you specified in the previous step, create an empty subdirectory called \master.

   Note. The name of this subdirectory is case-sensitive and should be all lowercase.

Setting Up the UBEs

JD Edwards EnterpriseOne is initially configured to accommodate internal Oracle naming conventions that are not relevant to customer installations. Therefore, customers must change the configuration of data source names and paths in the UBEs so that they correspond to the naming conventions that are described in this document.

Note. Unless you check out the versions before making the following changes, these changes will be available only on this workstation until another package is installed.

To set up the UBEs:

1. On the Mastering Workstation, enter BV in the FastPath field to open up Batch Version.

2. For each of the UBEs that are listed, search for the UBE, select the specified version, and change the path or filename to the specified value:

   UBE	Version	Parameter	Value
   R9640H	XJDE0006	Path of file to rename	$TEMP\Data\JDEMasters
   R9640H	XJDE0007	Path of file to rename	$TEMP\Data\JDEMasters
   R9640MF	XJDE0001	MSDE Database path	$TEMP\master
   R9640E	XJDE0002	Component File Specifications	*.*

3. For each of the UBEs listed, search for the UBE, select the specified version, and change the following processing option for the “Data Source Name” to OneWorld - Product Packaging.

   UBE	Version
   R9640MF	XJDE0001
   R9640MG	XJDE0001
   R9640MK	XJDE0001
   R9640ML	XJDE0001
   R9670	XJDE0001
   R9670	XJDE0002
   R9670	XJDE0003
   R96700	XJDE0001
   R9600400C	XJDE0001

4. Create a JD Edwards EnterpriseOne Object Configuration Manager (OCM) mapping to run R9640B locally.

Creating Pristine Control Tables

For control table changes to be included on an update CD, the JD Edwards EnterpriseOne Product Packaging Tool requires a pristine copy of the control tables. If the installation includes the PS812 pristine environment, these tables already exist in the JD Edwards EnterpriseOne instance and you can bypass the following task. If the installation does not include the pristine environment, you can create a set of pristine control tables by copying the Control Table tables from Control Tables Local to a new data source: Control Tables - PS812. You perform this process only once.

To create pristine control tables:

1. On the Deployment Server, sign in to JD Edwards EnterpriseOne in the DEP812 environment.

2. From menu GH9011, select Batch Versions.

3. Type R98403 in the Batch Application field and click Find.

4. On Work With Batch Versions - Available Versions, select version XJDE0501 (Control Tables For Pristine Database), and select Processing Options from the Row menu.

5. Select the Environment tab and change these processing options:

   Target Environment (option 1)	Leave this field blank.
   Target data source (option 2)	Enter Control Tables - PS812.
   Data Load (option 3)	Enter 2 to copy data to the table.
   Source data source (option 4)	Enter Control Tables Local.

6. Run the version locally.

   The report copies the F9000, F9001, F9002, F0004, F0004D, F0005, F0005D, F9005, F9005D, F9006, F9006D, F91100, F91100D, F91400, F91410, F91420, F91430, F91500, F91510, and F951000 tables from the Control Tables Local data source to Control Tables - PS812.

7. Verify the results of the report and the creation of the tables.

8. Quit the Batch Versions application.

9. From menu GH9011, select Object Configuration Manager.

10. On Machine Search and Select, select the machine with the System - 812 data source.

11. For the PS812 environment, add Object Configuration Manager mappings for tables F9000, F9001, F9002, F0004, F0004D, F0005, F0005D, F9005, F9005D, F9006, F9006D, F91100, F91100D, F91400, F91410, F91420, F91430, F91500, F91510, and F951000, and assign these new tables to the Control Tables - PS812 data source.

12. Activate the new mappings.

13. Quit Object Configuration Manager.

Verifying the Product Packaging Data Source

The JD Edwards EnterpriseOne Product Packaging process creates an MSDE database in the TEMP directory on the workstation on which the Product Package CD image is mastered. This database is used to store data that will be mastered on the CD. To copy tables into this database, you must verify that the OneWorld - Product Packaging data source and the Data Dictionary - PS812 data source are properly configured on the deployment server.

To verify the JD Edwards EnterpriseOne Product Packaging data source:

1. From the deployment server, sign in to JD Edwards EnterpriseOne in the DEP812 environment and enter GH9011 in the Fast Path field.

2. Double-click Database Data Sources (P986115).

3. On Machine Search & Select, select the machine with the System - 812 data source.

4. On Work With Data Sources, click Find.

5. Select the OneWorld - Product Packaging data source.

6. On Data Source Revisions, verify that the OneWorld - Product Packaging data source is defined with these values:

   ODBC Data Source Name	OneWorld - Product Packaging
   Data Source Type	N - MSDE/ODBC
   Database Name	JDEMasters

7. Click OK, and quit the Data Source application.

Creating a Data Dictionary in the Pristine Data Source

You must create a data dictionary in the pristine data source.

To create a data dictionary in the pristine data source:

1. From the deployment server, sign in to the JDEPLAN environment.

   Use JDE as the user name and JDE as the password.

2. From the System Administration Tools menu (GH9011), select Batch Versions.

3. On Work With Batch Versions - Available Versions, type R98403 into the Batch Application field and click Find.

4. Select version XJDE0509 and click Copy.

5. On Version Copy, enter a new version name and a new version title, and then click OK.

6. On Work With Batch Versions - Available Versions, select the version that you just created and select Processing Options from the Row menu.

7. Complete these processing options as indicated:

   Target data source (option 2)	DATA DICTIONARY - PS812.
   Source environment (option 5)	Data Dictionary Local Use these processing options to set up the batch process to copy the data dictionary tables from the JDEPLAN environment to the new pristine data dictionary.

8. Set the version that you just created to run in the proof mode first.

9. Run this report locally, not on the enterprise server.

10. Verify the results of this report.

11. When satisfied with the proof mode results, run the version that you just created in final mode.

12. Run OCM from the Fast Path field and select the enterprise server.

13. For the PS812 environment, add OCM mappings for F9200, F9202, F9203, F9207, F9210, F9211, and F9212 that point these tables to Data Dictionary - PS812.

14. Activate the new OCM mappings.

Creating Change Tables

JD Edwards EnterpriseOne Product Packaging requires that a set of tables, called change tables, exist and be mapped to the Control Tables - <environment> data source. A change table is a table that contains the items that have changed between releases or updates. Normally, these tables are generated during the installation process, when you run the environment workbench. If, however, the environment is populated with demo data, these tables will not be generated even though the environment workbench reports that they were created successfully.

Complete this task and the next if you need to create change tables in the mastering environment.

To create change tables:

1. On the deployment server, sign in to the JDEPLAN environment.

2. From menu GH9011, select Batch Versions.

3. Type R98403 in the Batch Application field and click Find.

4. Select version XJDE0507 (Change Table) and click Copy.

5. On Version Copy, complete these fields as directed:

   • New Version

   • Version Title

     Type a name for the new version.

     CREATECT

6. Click OK.

7. On Batch Version Design, click the Processing Options button on the General tab.

8. Edit these processing options for CREATECT as directed:

   Target Environment (option 1)	Type the name of the mastering environment.
   Target Data Source (option 2)	Leave this field blank.
   Data Load (option 3)	1: Load Production to create the table without data.
   Source data source (option 4)	Control Tables Local

9. Click OK.

10. On Batch Version Design, click Run.

11. On Version Prompting, select Data Selection and click Submit.

12. On Data Selection, verify that these tables are listed in the right operand for BC OBNM, and add those that are missing:

    • F960004

    • F960005

    • F967611

    • F969000

    • F969001

    • F969002

    • F969005

    • F969006

    • F9691100

    • F9691400

    • F9691410

    • F9691420

    • F9691430

    • F9691500

    • F9691510

    • F9695100

    • F9698710

    • F9698712

    • F9755

    • F9757

    • F9759

    • F9760

    • F98800DN

    • F98800N

    • F98800TN

    • F98810DN

    • F98810N

    • F98811N

    • F98830N

    • F98840N

    • F98845N

13. Run the version.

    The program creates the change tables in Control Tables - CRP or whichever environment Control Table data source you specified.

Verifying the Creation of Change Tables

For each of the change tables, verify that an OCM mapping exists and points to the appropriate data source for the mastering environment.

To verify the creation of change tables:

1. From menu GH9011, select Object Configuration Manager.

2. On Machine Search and Select, select the machine with the System - 812 data source.

3. For the mastering environment, verify that each of these change tables is mapped to the correct data source and that each mapping is activated:

   Change Table	Data Source
   F960004, F960005, F969000, F969001, F969002, F969005, F969006, F9695100, F98800DN, F98800N, F98800TN, F98810DN, F98811N, F98810N, F98830N, F98840N, F98845N	Control Tables - <environment>
   F9698710, F9698712	Central Objects - <environment>
   F967611, F9691100, F9691400, F9691410, F9691420, F9691430, F9691500, F9691510,	System - 812
   F9755, F9757, F9759, F9760	Data Dictionary - 812

4. Quit OCM.

5. Run Oracle's JD Edwards EnterpriseOne Universal Table Browser (UTB) to verify that the tables were created in the correct location.

Creating a Software Master

This section provides an overview of software master definitions, lists a prerequisite, and discusses how to:

• Define a software master.

• Configure change tables.

• Set the package build application to the mastering mode.

• Validate a software master definition.

• Create a final software master.

• Confirm the software master.

• Move the software master to a CD ROM.

• Update JD Edwards EnterpriseOne with the software master.

Understanding Software Master Definitions

A software master definition provides the structure for the finished software master. It establishes what template and packages to use, what build steps to follow, and the directory structure of the final master. The software master definition is only the structure or outline of the master. After you set up the software master definition, you validate it and then create the actual software master.

Custom Data Inclusions in the Software Definition

The JD Edwards EnterpriseOne Product Packaging application enables you to include custom data on the software master. Read the following tips for including custom tables and custom media objects on the software image.

Custom Table Inclusions

If the customer creates a new, customized table that is to be delivered with pristine data, the mastering process should automatically handle this procedure if these conditions are met:

• The table is included in the update package.

• The table is in the environment of the update package.

• The table is not included in the target environment.

• The table and index change table exist.

After the mastering process is complete, the table should be in the JDEMasters database that is referenced by the OneWorld - Product Packaging data source that you set up earlier. In addition, records should exist in the table and index change table for the new custom table.

Custom Media Object Inclusions

To include custom media objects in the product package, add these build steps to the ASU template:

1. Add a build step to copy table records from the F00165 to the JDEMasters database.

2. Add a build step to copy the media object files from the deployment server to the image path directory.

Change Table Configuration

This example illustrates why change table configurations are needed:

Create change table configurations to indicate to the JD Edwards EnterpriseOne Product Packaging Tools the change tables that you want included with the software master. When you install the finished software master, the installation process will update the control tables of the enterprise with the change tables that you indicate.

Assume that the home office in Denver, USA, makes software changes and wants to update an enterprise that is not networked to the Denver enterprise. The other enterprise, which has its own set of JD Edwards EnterpriseOne software and control tables, is in Paris, France. The Denver enterprise creates a software master that includes the package containing the software changes, as well as the change tables that contain data dictionary and user-defined codes changes, which, for this example, are the only control table changes since the Paris enterprise was last updated. The Denver enterprise writes the software master to a CD and ships it to Paris. When the Paris enterprise installs the software master, the change tables update the Paris control tables, making the tables concurrent with the Denver control tables.

Final Master Creation

This task explains how to create the final software master image from a definition that you previously created. You can master a single definition or master all definitions of a specific JD Edwards EnterpriseOne release.

The report that accomplishes this task is Oracle's JD Edwards EnterpriseOne Master CD (R9640B) report. This report controls the execution of all of the build steps and the UBEs that are associated with the build steps. This report also changes the status of each build step from 30 - Validated to a new status of 60 - Built or 50 - Failed.

With an average workstation, network, and ERP environment, the mastering process should take about one hour. However, the software includes many variables that can affect the time that is necessary to build a product package CD. These variables are:

• Status and level of debugging.

• Number of objects in the update package.

• Size of the objects in the update package.

• Overall size of the parent package.

• Number of change tables to define.

• Network speed.

• Type of database.

• Build machine speed.

• Build machine memory.

• Number of other processes running on the enterprise server, deployment server, and build machine.

Prerequisite

Ensure that at least 1 GB of space is available for the TEMP directory of the workstation from which you use the JD Edwards EnterpriseOne Product Packaging Tools. This memory requirement is the most memory that you might need for a software master. The actual size of the master depends upon the size of the package that you create.

See Also

Working with Software Master Templates

Defining a Software Master

To define a software master:

1. Sign in to a JD Edwards EnterpriseOne workstation using the development environment where the modifications exist, such as DV812.

2. From Product Packaging (GH962), select Product Packages (P9640).

3. On Work With Software Mastering, click Add.

4. On CD Configuration Director, click Next.

5. On CD Information, complete these fields:

   Name	Enter a unique name for the software master definition that you are adding, such as E812UPDATE. This name must exactly match the name of the package to be included, and it must be in all uppercase letters.
   Release	Enter the release for the software master definition, such as E812. This is the release that is currently installed on the client workstation that you are using.
   Type	Specify the type of CD that you want to master. In this case, it is an ASU CD (option 09) which is the default. If you select an option other than 09, the software displays an error message when you press Next. This field indicates which software template to use when you further define the master. Templates include the build steps and directory structure that is necessary to create a software master.
   Build Phase	Enter the development phase that the software master definition represents, such as alpha, beta, or general availability.
   Description	(Optional) Enter a description of the software master definition.
   Image Path	Enter the directory path where you want the software master definition to reside on the JD Edwards EnterpriseOne Product Packaging build machine (for example, d:\E812\PP). The directory that you indicate will be the root directory for the software master that you create. It will contain the contents of the master. After you create the image, the CD can be burned through the CD burner software.

6. Click Next.

   If you chose a template that appears on the list of values when you click the Search button for the Type field, but the template is not on the enterprise, the CD Template Does Not Exist form appears. You have probably entered the incorrect release number. Click OK to continue adding the software master definition, or click Cancel to stop adding the definition.

   If the template that you chose using the Type field was set up to include packages, the CD Packages form appears.

7. Select the update package that includes the objects for the update disk.

   You can either select an existing update package or create a new one. To ensure that the update package is defined correctly, note that:

   • You can use only update packages for this process.

   • The package name must be the same name as the product package that was previously defined, and it must be in all uppercase letters.

   • The package should be created from its very beginning.

   • The update package must always include specifications, build specifications, build business functions, and compression.

     If the package is not compressed, then product packaging will not work correctly because JD Edwards EnterpriseOne Product Packaging looks only for cab files to copy to the image.

8. If the package is undefined, the Select Package Build form automatically appears; otherwise, click Select Package.

   You can also add packages by clicking New Package Build or Package Assembly.

9. On Select Package Build, if you need to assemble or define a package or both, select one of these from the Form menu:

   • Pkg Assembly

   • Pkg Build

     Note. Make sure that you compress any packages that you build.

     See Setting the Package Build Application to the Mastering Mode.

10. On the Select Package Build form, find and select a package, and then click Select.

11. On CD Packages, select the package marker that appears.

    For an ASU CD, only one package is required. For other types of software masters, more than one package might be required.

12. Click Next.

    If the template that you chose was set up to include change table configurations, after you click Next,the JD Edwards EnterpriseOne Change Table Director form appears.

13. Continue to the next task, which explains how to configure the change tables.

Configuring Change Tables

To configure change tables:

1. On the JD Edwards EnterpriseOne Change Table Director, which appears automatically during the mastering process if required by the template, click Next.

   Alternatively, from Product Packaging (GH962), select Change Table Configurations (P9642) and then click Add.

2. On the JD Edwards EnterpriseOne Change Table Director, click Next.

3. On the Target Release Selection form, complete the Target Release field.

   Change the target release to a custom user-defined code (UDC) name that you are mastering. This name needs to be unique, such as E812TAX for the 1099 tax update. Select the release name using the visual assist button.

   Note. The software will not function correctly if these tables have the same value for the source and target release. To add the custom UDC, press the visual assist and then click Revisions. This action displays the Work with User Defined Codes form. Work with User Defined Codes, click Add. Scroll to the bottom of the grid and add the new value in the last line of the grid. After you have created the UDC, select the new UDC on the Work with User Defined Codes form, and click Select. This action will populate the Target Release field with the new value.

4. Click Next.

5. On Source Environment Selection, complete these fields:

   Source Environment	Enter the name of the environment that includes the control tables that are used as the baseline for the changes. The source is typically the pristine environment (PS812). The software builds the change table records by comparing the target environment to this baseline.
   Source Release	Verify that the source release matches the release and the cumulative update level, such as E812, of the source environment that you want. The software automatically populates this field based upon the source environment.

6. Click Next.

   The Batch Application Selection form appears. This form lists the available change tables along with the batch application and version that will create the change table.

7. To select the default change tables that you want with the software master, double-click the gray button to the left of the change table row.

   A check mark appears on the button.

   Select any or all of these change tables where you made additions, deletions, or changes. The batch process compares the source and target tables in each selected category and creates a change table that contains all changes.

   • Data Dictionary

   • User Defined Codes

     This batch application should always be chosen because changes always occur to the UDC that defines the release.

   • Workflow.

   • Favorites.

   • Templates and Smart Fields.

   • Tips of the Day.

   • Table and Index Changes.

   • Solution Explorer.

   • Service Constants. (8.97 only)

     You can double-click a check mark to remove it.

8. To select a different version or to select multiple versions, select a change table row, and then select Version Selection from the Row menu.

9. On Version Selection, select one or more versions and click Select or double-click the gray button to the left of a version.

   A check mark appears to the left of the versions that you chose.

10. After choosing the versions that you want, click Close.

    The Batch Application Selection form reappears.

    A check mark appears to the left of the change table row that you chose. The change tables that you want to be built for the software master must have check marks next to them or the software will ignore them. If you chose more than one version, the word <MULTIPLE> appears under the Version column for that change table.

11. Either select another change table row and select Version Selection from the Row menu, or click Next.

    If you click Next, the Additional Change Table Definitions form appears.

12. On Additional Change Table Definitions, perform one of these actions:

    • To define additional change table configurations for a new source and target release combination, select Continue and click OK.

      The program displays the Target Release Selection form. Return to the beginning of this task and repeat the steps for a different source and target combination.

    • Select Quit and click OK.

      This action stops the change table configuration director and displays the final revisions screen for mastering the defined CD.

      If you select Quit, the CD Revisions form appears. Use this form to revise the software master definition.

13. On CD Revisions, click OK.

    the software master definition is saved, and the CD Revisions form closes.

14. Continue to the next task, which explains how to validate the definition that you just created.

Setting the Package Build Application to the Mastering Mode

To compress an update package, you must set the package build application to the mastering mode.

To set Oracle's JD Edwards EnterpriseOne Package Build Application to the mastering mode:

1. On the Deployment server, log on to the DEP812 environment.

2. From the Package and Deployment Tools menu (GH9083), right-click Package Build, and select Prompt For Values.

3. On Processing Options, type 1 in option 2 to set up the mastering mode.

4. Click OK.

5. Quit the package build application.

Validating a Software Master Definition

This task explains how to run Oracle's JD Edwards EnterpriseOne Pre-Mastering CD Validation report (R9640A) to validate the software master definition that you set up and what to review in the report to help with the validation. The report runs in final mode. The report lists whether the build step is validated. The report will change the status of build steps that do not have errors.

To validate a software master definition:

1. From the Product Packaging menu (GH962), select Product Packages (P9640).

2. On Work With Software Mastering, click Find.

   The existing software master definitions appear.

3. Select the master that you want to validate, and then select Validate from the Row menu.

4. On Report Output Destination, select to view the report on screen and click OK.

   The report runs. All steps without errors whose statuses were In Definition (10) or Defined (20) are promoted to the status of Validated (30); they will work properly during the software mastering process. Otherwise, the build step will have either a warning or an error message. Error messages will stop the creation of a software master. You must fix any build steps that contain error messages. The message specifies the error.

   Warning messages will not stop the creation of a software master. If a build step has a warning message, you should verify that the build step is as you want it before proceeding.

   Note. The report will always include a warning stating that the build step is different from the template. This warning is always true because the process uses a custom package build.

5. Continue to the next task, which explains how to create the final software master.

Creating a Final Software Master

To create a final software master:

1. From Product Packaging (GH962), select Product Packages (P9640).

2. On Work With Software Mastering, perform one of these actions:

   • To create a software master from one specific definition, click Find, select the definition that you want to create, and then select Master CD from the Row menu.

   • To create software masters for all definitions of a specific release, select Master Release from the Row menu.

     A form appears in which you enter the release number of the definitions that you want to master.

     Either choice runs a batch process (R9640B) that creates the software master based upon the definition that you chose. Run the report locally and select the option to display the results on screen. Depending on the build steps that are necessary to complete, the report launches several other reports, each corresponding to a particular build step.

     The software mastering process stops when it encounters a manual build step.

3. To complete the manual build step, select that build step, and select Execute Step from the View menu.

   The status of that step is advanced to 60 (Built). Click Master CD or Master Release to continue the software master process. The progress of the build can be monitored from the CD Revisions screen.

4. From the View menu, select Refresh.

   As each step is processed and completed, the icons change color and style. The last build step automatically validates the software master and generates a final report (R9840B) This report includes a comprehensive status of the product package build.

5. Review this report for errors.

   If the validation report does not indicate any errors, you have successfully created a software master. This report validates that the number of directories match between the software master definition and the final software master. It also provides details about the file counts and the total size of the master in megabytes.

   This process automatically creates a self-extracting executable file and a CAB file and places them in the $TEMP/final directory using the name of the software master followed by the .exe and .cab extensions. Use the executable (.exe) file to update JD Edwards EnterpriseOne. Both files include the full software master with all of its directories. If you have a size restriction, such as when downloading from the internet, you can use the CAB file (which is always smaller than the executable file), but you will need to use a third-party application to uncompress the CAB file.

Confirming the Software Master

After you create the software master image, you should visually check the directory structure and JDEMasters database to verify that the image is complete.

To confirm the software master:

1. In Windows Explorer, open the image path directory.

2. Verify that the package directory includes these objects:

   • Install manager files.

   • Planner directory.

   • A data cab in the planner directory.

   • A directory that is named the same as the package.

   • Cab files in the package directory.

3. Verify that the $TEMP\final directory includes these two files:

   • packagename.cab

   • packagename.exe

4. Open the JDEMasters database in the $TEMP\master directory, and verify that this database is populated with tables.

   Note. If the package includes new custom tables, verify that they are in the JDEMasters database and that they and their associated index change tables have records.

Moving the Software Master to a CD ROM

After the software master process has been completed and confirmed, the image can be burned onto a CD.

To move the software master to a CD ROM:

Using a CD burner and CD burner software, copy the packagename.cab or packagename.exe file from the $TEMP/final directory on to the CD ROM.

Updating JD Edwards EnterpriseOne with the Software Master

This task explains how to update JD Edwards EnterpriseOne using the software master that you created. To perform this update, access the Work with Updates (P96470) application from the System Installation Tools (GH961) menu. This process includes setting merge flags, running the self-extracting executable (package_name.exe), running software updates, and executing the installation workbench.

To update JD Edwards EnterpriseOne using a software master:

1. Run the package_name.exe executable file from the CD.

   This process installs the package into the Planner\Package directory on the deployment server, and extracts the package_name.mdf and package_name.ldf files into the Planner\Data directory. The process also creates the software master image in the PLANNER directory.

   Note. You can also use the CAB file to create the software master image on the deployment server, but you need to use a third-party application to uncompress the file.

2. If InstallManager.exe exists on the CD, start the installation by double-clicking it.

   If this file is not on the CD, double-click the package_name.exe file to self-extract and uncompress the CAB file. After it is uncompressed, Install Manager will automatically launch.

3. On Installation Setup Screen, click Next.

4. On Installation Setup Type, verify that the machine has the necessary disk space and that the install path is correct, and then click Finish.

   When the installation is complete, the Install Manager displays the "Installation Complete" window.

5. Click OK.

6. On the Deployment Server, sign in to the Planner environment (JDEPLAN).

7. Type GH9612 in the Fast Path field.

8. Select Application Software Updates (P96470).

9. On Work with Software Updates, click Find.

10. Select the product package to install, and click Next.

11. On Software Update Environment Selection, select the path code on which to install the package, and click Next.

    If you select unattended mode, the Installation Workbench will automatically perform all the workbench tasks to complete the installation. If you do not select unattended mode, the Installation Workbench tasks must be done manually. If you select backup, the process will create an MSDE database (OWBAK_packagename_pathcode) and its corresponding files called OWBAK_packagename_pathcode.mdf and OWBAK_packagename_pathcode.ldf in the Planner\Package\Package_Name\PathCode.bak\data directory. Only the tables and objects that are affected by the update will be backed up in the database.

    The Installation Workbench should stop after the Table Conversion workbench process is complete.

12. Review the PDFs and the log files that were created by the table conversions, and then continue with Installation Workbench.

    When Installation Workbench is complete, the system returns to the Work with Software Updates screen, and the selected software update should have the Completed Normally install status.

13. Click Close to quit Work with Software Updates.

14. Review all PDFs that were generated on the deployment server by the software update process, and verify that each of report is free of errors.

    If a report has errors or does not appear to have run, review the jde.log file to determine the source of the problem. This table provides descriptions of the Software Update reports.

    Report	Version	Description
    R98405 - Application	XJDE0001	Table Conversion/Merge Driver for Application Tables: Master UBE for creating and regenerating application tables. This report should have only one record—Table and Index Creation (F984072). The status of the record should be, “Completed Normally.”
    R98407	XJDE0001	Table and Index Creation: Launched by R98405 UBE, which creates or regenerates all tables that are specified in the table change table. Page one of the report includes source, target, and environment information. Page two includes the overall status of the table creation in green or red text. Subsequent pages list the status of each table and index to be created or regenerated.
    R98405 - Control	XJDE0001	Table Conversion/Merge Driver for Control Tables: The master UBE that specifies the control table merge UBEs to launch. It should list the Data Dictionary UBE (R989200P), and the User Defined Codes UBE (R9600042). The status on all should be, “Completed Normally.”
    R989200P	XJDE0001	Data Dictionary Merge: Launched by R98405. This UBE merges all data dictionary changes that are specified in the data dictionary change tables into the existing data dictionary. Page one of the report has source, target, and environment information. Subsequent pages list the status of each data dictionary addition or change. At the end of the individual listings, the overall status of the data dictionary merge is listed in green or red text. The final page has detailed summary information.
    R9600042	XJDE0001	User Defined Code Merge: Launched by R98405. This UBE merges all user-defined code changes that are specified in the UDC change tables into the existing UDC tables. Page one of the report lists source, target, and environment information. Subsequent pages list the status of each UDC addition or change. The final page has detailed summary information.
    R9690002	XJDE0001	JD Edwards EnterpriseOne Solution Explorer Merge: Launched by R98405. This UBE merges all JD Edwards EnterpriseOne Solution Explorer changes that are specified in the SE change tables into the existing SE tables. Page one of the report lists source, target, and environment information. Subsequent pages list each addition, change, or deletion in the change tables. The final page has detailed summary information.
    R96911002	XJDE0001	Favorites Merge: Launched by R98405. This UBE merges all Favorites changes that are specified in the Favorites change tables into the existing Favorites tables. Page one of the report lists the source, target, and environment information. Subsequent pages list the status of each Favorites addition or change. The final page has detailed summary information.
    R96914002	XJDE0001	Report Director Templates Merge: Launched by R98405. This UBE merges all changes that are specified in the Report Director Templates change tables into the existing Report Director Templates tables. Page one of the report lists the source, target, and environment information. Subsequent pages list the status of each addition or change. The final page has detailed summary information.
    R96915002	XJDE0001	Tips Merge: Launched by R98405. This UBE merges all Tips changes that are specified in the Tips change tables into the existing Tips tables. Page one of the report lists the source, target, and environment information. Subsequent pages list the status of each addition or change. The final page has detailed summary information.
    R96951002	XJDE0001	Service Constant Merge: Launched by R98405. This UBE merges all service constant data that is specified in the change table into the existing Service Constant table. Page one of the report lists source, target, and environment information. Subsequent pages list the status of each service constant addition. This merge is only used for release 8.97.
    R98405 - Spec	XJDE0001	Table Conversion/Merge Driver for specification tables: Master UBE for specification table merge. This report should have only one record—Specification Merge (F98710). The status of this record should be, “Completed Normally.”
    R98700	ZJDE0002	Specification Merge: Launched by R98405. This UBE adds, replaces, and merges all specified object specifications into the selected Central Objects path code. This report is the standard specification merge report. Page one of the report lists the source, target, and environment information. Page two summarizes information about the merge status. The remaining pages include the individual object action and status.

15. On the Deployment Server, sign in to the DEP812 environment.

16. Find the package in Oracle's JD Edwards EnterpriseOne Package Assembly (P9601), and build and deploy the update package to a client workstation.

Deleting a Software Master

This section lists the form that is used to delete software masters. All records that are associated with the definition, such as the change table configurations and repair director records, will be deleted when you delete the software master.

Form Used to Delete Software Masters

Working with a Software Master Definition

This section provides overviews of software master revisions and software master validation and discusses how to:

• Revise a software master definition.

• Load a subdirectory from an enterprise network directory.

• Copy a software master definition.

• Proof a software master definition.

Understanding Software Master Revisions

After you have completed the definition of a software master, you can revise any of the information, including the build steps and directory structure. You also can copy the definition information to a new software master definition, delete the definition, and proof and validate it.

You can revise a software master definition that you have created. This revision enables you to modify the information that you entered into the JD Edwards EnterpriseOne CD Configuration Director, as well as the build steps and directory structure that is included with the template that you chose.

The system uses icons to indicate the status of a software master. The icons have these meanings:

Understanding Software Master Validation

You run a report to validate the software master definition that you created. The report runs in final mode, and it changes the status of the build steps that do not have errors. All steps without errors whose status was In Definition or Defined are promoted to the status of Validated. The report lists each build step that will run when you create the master. The report lists whether the build step is validated. If it is validated, the build step will work properly when you are creating the software master. Otherwise, the build step will have either a warning or error message.

Warning messages will not stop the creation of a software master. The message specifies what the warning is. If a build step has a warning message, you should verify that the build step is as you want it before proceeding.

Error messages will stop the creation of a software master. You must fix any build steps that contain error messages. The message specifies the error.

Forms Used to Revise Software Masters

Revising a Software Master Definition

Access the Work With Software Mastering form.

CD Information

Select the CD Information tab.

Build Steps

Select the Build Steps tab.

Directory Structure

Select the Directory Structure tab.

Task List

This table provides information for building the task list:

Loading a Subdirectory from an Enterprise Network Directory

Access the CD Revisions form.

1. Select the Directory Structure tab.

2. Select the directory that will be the root of the subdirectory that you want to load, which must already exist on the enterprise, and click Load.

   This feature copies any enterprise directory structure into the software master definition.

3. On the Load Folders From Directory form, click Windows Folder.

4. On the Select Directory form, find and select a directory that you want to load into the software master, and then click OK.

5. On the Load Folders From Directory form, select one of these options:

   • Re-create subfolders

     This option deletes the existing subdirectories and replaces them with the subdirectories that you want to load into the software master.

   • Append to existing

     This option appends to the existing subdirectories the subdirectories that you want to load into the software master.

6. If necessary, select the Setup Source Directories check box.

   During software master creation, by having this option enabled, the system automatically creates the structure of the source directories and copies all files within the source directories to the software master.

   If you do not select Setup Source Directories, the software will create the source directory structure within the software master and the directories will be empty.

7. Click OK.

Copying a Software Master Definition

Access the Copy CD Configuration form.

You can copy a software master definition that you already created, which enables you to copy the information that you entered into the CD Configuration Director, the build steps, and the directory structure.

Proofing a Software Master Definition

Access the Work With Software Mastering form.

You can proof software master definitions. To do so, you create a report, which details each build step in the definition and lists the sequence of steps and processes that each step will run when creating the actual master.

Proofing a software master definition does not change any part of the status of a software master.

To proof a software master definition, perform one of these actions:

• To proof one software master definition, select the definition that you want to create, and then select Proof CD from the View menu.

• To proof all software master definitions for a specific release, select Proof Release from the View menu.

  On the form that appears, enter the release number of the definitions that you want to proof.

Working with Software Master Templates

This section provides overviews of software master templates, the all build step processes, the ASU CD template, and the custom CD, and lists the forms used to work with software master templates.

Understanding Software Master Templates

The JD Edwards EnterpriseOne Product Packaging Tool uses software master templates. These templates provide default information when you are creating a new software master. For example, to distribute objects to a disconnected enterprise, you would build a master based on the ASU (Application Software Update) CD template. Oracle's JD Edwards EnterpriseOne Mastering Director would use the ASU CD template to determine which director steps, build steps, and directory structure to use when creating the software master. You can configure the default information that is provided by the templates.

You use build steps to build a template. Build steps are the processes that are used to create a software master. You also can add, revise, copy, and delete software master templates. After you add a template, you can use the JD Edwards EnterpriseOne Mastering Director to create a software master definition using that template.

The processes for revising, copying, proofing, and deleting software master templates are identical to those for the software masters themselves.

Understanding the All Build Step Processes

A template can offer all of the following software mastering build step processes. Not all of these processes appear on every template.

Undefined

Type = 00

Performed Automatically = Not applicable

This build step is the default process when you are adding a new build step to a software master or template. After you add this build step, you need to define it for the master or template.

Create CD File Structure

Type = 01

Performed Automatically = Yes

This build step creates the physical directory structure at the image-path location that you specified when creating the software master definition.

Package Build

Type = 02

Performed Automatically = Yes

This build step builds the assigned package based upon the package assembly and build definitions.

Manual Build Step

Type = 03

Performed Automatically = No (See the specific template definition for complete information about the performance of this build step.)

This build step enables the administrator to instruct the user how to perform a process that has not yet been automated. You should verify the mastering steps and options of this step before beginning the master.

Note. The software mastering batch process stops when it encounters this build step. After you complete this build step, change its status to Succeeded (status code 60), and restart the software mastering batch process.

Pre-Build Package

Type = 04

Performed Automatically = Yes

For Oracle internal use only.

Pre-Build Pristine

Type = 05

Performed Automatically = Yes

For Oracle internal use only.

Build Cross-Reference

Type = 06

Performed Automatically = Yes

For Oracle internal use only.

Build Data Dictionary

Type = 07

Performed Automatically = Yes

For Oracle internal use only.

Build In-House Package Database

Type = 08

Performed Automatically = Yes

For Oracle internal use only.

Build Planner Database

Type = 09

Performed Automatically = Yes

For Oracle internal use only.

Build Pristine Database

Type = 10

Performed Automatically = Partial (See the specific template definition for complete information about the performance of this build step.)

This build step creates the pristine data tables in the final pristine database that corresponds to the given set of modules.

Build Store & Forward Database

Type = 11

Performed Automatically = Yes

For Oracle internal use only.

Build Standalone Database

Type = 12

Performed Automatically = Yes

For Oracle internal use only.

Build Change Tables

Type = 13

Performed Automatically = Yes

This build step builds the change tables based on the change table configuration that was set up as part of the software master definition.

Master Central Objects

Type = 14

Performed Automatically = No

For Oracle internal use only.

Compress

Type = 15

Performed Automatically = Partial (See the specific template definition for complete information about the performance of this build step.)

This build step compresses the final pristine JDE Masters database into the data.cab file in the final image path.

Create INF

Type = 16

Performed Automatically = Yes

Do not modify this file manually. This build step updates the deployment.inf file that the installation applications use during the update installation.

Copy CD Directory Files

Type = 17

Performed Automatically = Yes

This build step copies the built package to the target image path. This step also copies any additional files that are defined in the software master directory structure to the target image path.

Note. If you have already built the package and do not want the mastering process to build the package again, set the status of the Package Build step to 60. When you create the software master, the process bypasses the package build and, when it runs this Copy CD Directory Files step, copies the package.

Virus Check

Type = 18

Performed Automatically = Partial

For Oracle internal use only.

Windows Executable

Type = 19

Performed Automatically = Partial (See the specific template definition for complete information about the performance of this build step.)

This build step enables you to specify a Microsoft Windows executable or batch file as part of the mastering process.

Data Cleanup

Type = 20

Performed Automatically = No

For Oracle internal use only.

Build Package Database

Type = 21

Performed Automatically = Yes

For Oracle internal use only.

Batch Process

Type = 22

Performed Automatically = Yes

This build step enables you to define a batch process to run as part of the software master definition.

Understanding the ASU CD Template

The ASU CD is the main template that is used with the JD Edwards EnterpriseOne Product Packaging Tools. This template is the basis for delivering objects to distributed enterprises. This table shows the build steps and their sequence for an ASU CD:

This table provides additional information pertaining to a particular build step within the ASU CD template:

Working with Custom CD Templates

The Custom CD is for general use; this CD type has no template. A JD Edwards EnterpriseOne administrator uses this CD type primarily to create backups of source code, documents, and so forth, while still using the JD Edwards EnterpriseOne Product Packaging Tools. This CD type enables you to enter a directory structure that contains all of the files that you want loaded on to a custom CD image. After the process is completed, the administrator can move that image to a CD burner to create the actual CD.

Forms Used to Work with Software Master Templates

See Also

Revising a Software Master Definition

Loading a Subdirectory from an Enterprise Network Directory

Copying a Software Master Definition

Proofing a Software Master Definition