Testing the installation process

Once you’ve created a chunk dictionary, test the installation process. Be sure to complete the installation using an unmodified Microsoft Dynamics GP system that’s set up the same as the one your customers use. To complete the installation process, perform the following steps:

1. Make a backup of tables that will be updated.

Make a backup of all tables you’re updating during installation, as well as the launch file (DYNAMICS.SET). To test the installation multiple times, you’ll need to restore any tables updated during the installation, as well as the launch file, with backups you make here.

2. Install the chunk.

Place a copy of the chunk dictionary in the same location as the Dynamics.dic dictionary and launch the accounting system. A dialog box appears asking whether you’d like to include new code. Click Yes. The runtime engine will “unchunk,” then synchronize your application dictionary. Any installation scripts will then run. When the installation is complete, the login window will appear.

3. Check installation items.

Log into the sample company. If you used an installation script, examine whether the script was run correctly. If the installation wrote records to multiple companies or for multiple users, be sure those records appear properly for each company and user.

4. Make any necessary changes.

If your application doesn’t install properly, check the following:

• Be sure your application dictionary has product information before you create chunk dictionaries.
• Be sure the names of the dictionary chunks don’t exceed 13 characters (including the .cnk extension).
• Verify that the version numbers and build number you applied to the dictionary chunk are correct. They must follow the rules described in Using the Auto-Chunk utility. Check the InstallErrors.txt file in the Microsoft Dynamics GP installation folder for any errors reported during the unchunking process.
• If you’re using installation scripts, be sure each works in your development dictionary using test mode.
• Before installing, be sure the launch file contains the correct information for Microsoft Dynamics GP to launch without your integrating product.
• If you’re using multiple dictionary chunks, be sure the Dictionary name you’ve specified is exactly the same for each chunk, and the dictionary name is not DYNAMICS.DIC. Also, be sure the sequence numbers are correct.
• Be sure each chunk dictionary contains the [Core] System Core Tables and the [Core] System Install resources.
• If you receive permission errors, be sure the dictionary chunk file isn’t locked. Also verify that another instance Microsoft Dynamics GP isn’t already running, accessing the dictionary being updated.

After installation, a single application dictionary will have replaced the chunk dictionary or dictionaries. The chunk also will have updated the launch file with the correct location of the integrating dictionary.

Documentation Feedback

---