E Working With SnapShot on the Development Client (Base Release of Tools Release 9.1)

Note:

Tools Release 9.1 Update 2. This appendix is applicable to the version of SnapShot that was included with the base release of JD Edwards EnterpriseOne Tools Release 9.1.

This section discusses these topics:

E.1 Understanding SnapShot

The SnapShot program manages multiple instances of the JD Edwards EnterpriseOne Development Client on a single machine. Using this program you can save and restore copies of an installed Development Client.

Below is an example of SnapShot managing multiple tools releases including Xe, 8.11 SP1, and 9.0 (B9PD).

Description of snapshot_example.gif follows
Description of the illustration ''snapshot_example.gif''

The above image shows the JD Edwards | SnapShot window. The main features of this window, from top to bottom, include:

  • A close button in the upper-right corner.

  • The Existing Version area, which contains these fields and buttons:

    • Version field that lists the existing installed Development Client with the Save button adjacent to this field.

    • Location field with the Rename Environment button adjacent to this field.

  • The Saved Versions area, which contains a field that lists saved versions. The example in this image shows the following versions: B733xe, B8111, and B9PD.

  • The Restore and Delete buttons are adjacent to this field.

  • The bottom of the form contains a Close button.

E.2 Prerequisites

This is a list of general considerations for using SnapShot:

  • Make sure that you do not have a JDE.INI file open when you save or restore SnapShot.

  • Make sure that you do not have the ODBC Data Source Administrator open when restoring a SnapShot.

  • Make sure before installing a new Development Client into a new Oracle Home, you do not have any previous versions in the Existing Version field of SnapShot. All versions must be saved and should appear in the Saved Versions field.

E.3 Using Snapshot on the Development Client

Caution:

Before using SnapShot on the Development Client, ensure that JDeveloper is not running.

To use SnapShot with multiple releases of the JD Edwards EnterpriseOne applications, you must use the most current version of SnapShot when switching between different releases of JD Edwards EnterpriseOne. For example, if you install the foundation code for both JD Edwards EnterpriseOne Applications Release 9.1 and Applications Release 8.12, you must use the version of SnapShot corresponding to the most current JD Edwards EnterpriseOne tools release, in this case, Tools Release 9.1.

This section describes these tasks:

E.3.1 Starting SnapShot

Caution:

Be sure to follow the guidelines in the preceding sections of this guide entitled:

The SnapShot utility is delivered with the installation of the JD Edwards EnterpriseOne Development Client. It is located in this directory:

<dev_client_installation_directory>\System\Bin32

To run the most current version of SnapShot for multiple releases, you must copy the SnapShot.exe program to a directory outside the Development Client installation directory. For example, the installation directory might be c:\E910. If you attempt to run SnapShot from within the Development Client installation directory (for example, c:\E910), Snapshot will fail to rename the installation directory.

Tip:

You can create a shortcut to SnapShot.exe, but you still must copy SnapShot.exe to a location outside the original installation directory where it was delivered.

E.3.2 Saving a SnapShot

To save a SnapShot:

Description of snapshot_save_version.gif follows
Description of the illustration ''snapshot_save_version.gif''

  1. On JD Edwards | SnapShot, click the Save button.

    This image is described in surrounding text.

  2. On Make a New SnapShot, complete these fields:

    • SnapShot Name

      Enter a name for the SnapShot that will be saved. You may choose any name, but a recommended scheme is to make it release specific, for example, Xe, B9, or E910.

    • New Folder Name

      Provide a directory in which the snapshot will be saved. The directory should start with a backslash and will be on the indicated drive.

  3. Click the OK button.

    SnapShot saves a snapshot of the Development Client.

E.3.3 Restoring a SnapShot

To restore a SnapShot:

Description of snapshot_example.gif follows
Description of the illustration ''snapshot_example.gif''

  1. On JD Edwards | SnapShot, in the Saved Versions section, highlight the saved instance you want to restore.

  2. Click the Restore button.

    SnapShot makes the selected instance active.

E.3.4 Deleting a SnapShot

To delete a SnapShot:

This image is described in surrounding text.

  1. On JD Edwards | SnapShot, in the Saved Versions section, highlight the saved instance you want to delete.

  2. Click the Delete button.

    SnapShot completely removes the instance from the Development Client.

E.4 Manually Backing Up Files and Settings

Once you have saved a SnapShot for the Development Client, it is a good idea to manually backup the files to ensure that your settings for that Development Client are secure.

The files that need to be backed up are found in the root folder of each saved snapshot. You should backup these files only while the SnapShot.exe program is not active. These files contain the information necessary to restore registry values and settings for each SnapShot.

The files to backup are listed below:

  • jde.ini

  • regkeys*.dat

  • package.inf

E.5 Set Logging for SnapShot Using the Registry

Logging is controlled by adjusting registry settings that control SnapShot.

Caution:

Changes made to the Microsoft Windows registry happen immediately, and no backup is automatically made. Do not edit the Windows registry unless you are confident about doing so.

Microsoft has issued the following warning with respect to the Registry Editor:

"Using Registry Editor incorrectly can cause serious, system-wide problems that may require you to re-install Windows to correct them. Microsoft cannot guarantee that any problems resulting from the use of Registry Editor can be solved. Use this tool at your own risk."

To set the logging for SnapShot using the registry:

  1. Open the Registry by navigating to Run > Regedit.

  2. Navigate to this node:

    \HKEY_LOCAL_MACHINE\Software\Wow6432Node\JDEdwards\Snapshot

  3. To enable logging, change the LoggingEnabled key value to 1 (where a value of 0 is off). If this key does not exist, create it as a REG_SZ type.

  4. Change the LoggingLevel to a value between 1 and 5, where 1 provides the least amount and 5 provides the most amount of logging details. If this key does not exist, create it as a REG_SZ type.

  5. Save the changes and exit the Registry.

    Logs will be located in the directory from which the SnapShot.exe program is being executed.