Testing the installation process

At this point, you’re ready to test the installation procedure. Make copies of the runtime engine, the DEX.DIC file, necessary DLLs, your dictionary chunks, the empty launch file, and any other necessary files (such as online documentation files or sample data files) and place them in a folder or directory.

As an example, the files necessary to install the Real Estate Sales Manager application are shown in the following illustration.

When all of the files are in place, start the installation process by starting the application as you normally would. In a few moments, you should see a dialog box indicating that the dictionary chunks are being included and the application dictionary is being synchronized. Any installation scripts will be run. When these processes are complete, your application should be running.

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 name of the chunk file is no more than 13 characters long, including the .cnk extension. If the name is longer than 13 characters, the chunk cannot be unchunked.
• Be sure the name of the launch file you are using is the same as the launch file name you specified in the product information for the dictionary.
• Verify that the version numbers and build number you applied to the dictionary chunk are correct. They must follow the rules described earlier.
• If you’re using installation scripts, test them individually in your application.
• Before installing, be sure the empty launch file has 0 as the number of dictionaries operating and contains the correct launch (product) ID.
• If you’re using multiple dictionary chunks, be sure the Dictionary name you’ve indicated for each dictionary chunk is exactly the same for each chunk. Also, be sure the sequence numbers are correct.
• Be sure your chunk dictionaries each contain the [Core] System Core Tables and the [Core] System Install resources.
• If you receive permissions errors, be sure the dictionary chunk file isn’t locked. Also verify that no other process (such as an instance of the runtime engine) is accessing the dictionary to be updated.

After installation, a single application dictionary will have replaced the chunk dictionary or dictionaries. The launch file will have been updated to contain the correct location of the application dictionary.

Documentation Feedback

---