INFO: Troubleshooting Visual Basic Setup Wizard Issues

• Microsoft Visual Basic Professional and Enterprise Editions for Windows, version 5.0
• Microsoft Visual Basic Standard, Professional, and Enterprise Editions for Windows, version 4.0

SUMMARY

The information included in this article provides some insight into preventing errors resulting from installing a Microsoft Visual Basic program using the Application Setup Wizard. The information in this article is divided into different areas that need to be considered before deploying an application: Environment, Operating System, Installed Applications of the Development Machine, and Third-Party Controls.

NOTE: This article does not cover specific issues using the Application Setup Wizard to create Internet Component Download distribution sets. Although the information may be helpful in the creation of such distribution sets, this article is intended for standard application deployment.

MORE INFORMATION

Environment

When developing an application, the development machine needs to stay free of any external applications or Internet downloaded components that are not specifically necessary for the development of the application. For example, beta software should not be used because it is possible that beta components may be included when you create the application distribution set.

Another area that can affect the development environment is the browsing of the Internet on the development machine. Depending on the security level of your browser software, some sites can download new components and install them. This may not affect the development of the application but, when creating the application distribution set, may cause unknown file versions and/or non-redistributable files to be included with your application. The preferred method of avoiding this problem is to not use your development machine for browsing the Internet. If this is not possible, consult your Internet browser's documentation for instructions on how to avoid downloading components or how to successfully uninstall components after they have been installed.

Please refer to the "Application Distribution Set Methodology" section later in this article before using the Setup Wizard to build the application distribution set.

Operating System

If possible, develop the application on the same operating system the target machine will use. This will ensure that operating specific versions of the supporting files are similar in the development and target environment. Also, service packs often fix many known problems with the operating systems and, with some operating systems, a certain Service Pack release is required to install a Visual Basic application. The latest Service Packs can be found at the following location:

   http://support.microsoft.com/support/downloads/default.asp

Applications Installed on Development Machine

Applications installed on the development machine may affect the Setup Wizard in many ways. For instance, the presence of Microsoft Office 97 may have newer versions of some files and have additional controls that did not ship with Visual Basic. Once again, it is best to keep the development machine as clean as possible so as not to introduce any component that can alter the Visual Basic environment.

For the most part, having multiple versions of Visual Basic on the same machine does not alter the development environment. With the Setup Wizard, however, having multiple versions can cause the application to not install correctly due to newer versions of components and the inability of the Setup Wizard to correctly determine dependency information and/or register these components. To ensure a good distribution of the application, the development machine should have only one version of Visual Basic installed.

Again, please refer to the "Application Distribution Set Methodology" section of this article before using the Setup Wizard to build the application distribution set.

Third-party Controls

Third-party controls are controls that do not ship with Visual Basic and are supplied by a third-party vendor. These controls can be incompatible with other pieces of the application or even the operating system itself. If you suspect a third-party control may be causing a problem with your distribution set, you should create a test setup using the Setup Wizard for a very simple application (the Calc.vbp sample project that comes with Visual Basic is a good sample application). Create a distribution set using the Setup Wizard for a sample application such as Calc.vbp. If this setup is successful, begin eliminating the third-party controls from the original setup one-by-one and re-test. This helps you decide if a control is causing the problem. If you identify a control that is causing the problem, contact the vendor to for additional information regarding the control.

Application Distribution Set Methodology

The information below lists the ideal way to create a setup routine for your Visual Basic application. It is meant to be used as a guideline for setting up a clean environment for creating trouble-free application distribution sets and is not intended to be used as a step-by-step example.

1. Use a clean development machine that has as little as possible installed. A clean installation of the Windows operating system plus Visual Basic and AntiVirus software would be the ideal environment.

2. In an ideal environment, the development machine should have the same version of Windows (95 or NT) as the target machines. This may not be possible due to differences on the target machines. Use the operating system that is the most common among your target machines.

3. Install the latest Service Pack updates for both the operating system and for Visual Basic to ensure you are using the most up to date files available.

4. Using AntiVirus software, check the machine for all known viruses. This ensures that you will not be distributing a virus to your target users.

5. Test the application using the Visual Basic IDE, ensuring all components of the application work as designed.

6. Run the Setup Wizard on your project to create the necessary distribution files.

7. Test the application on the development machine by installing the application and ensuring all components of the application work as intended.

8. Again, use AntiVirus software to check the machine.

9. Test the installation on a target machine. Testing on more than one target machine can also help identify issues before the application is deployed to clients.

   This should lead to a resolution of most issues dealing with the installation of a custom application using the Setup Wizard. If the above information does not lead to a resolution, please check the Microsoft Knowledge Base for any known issues or contact Microsoft Technical Support for help resolving the issue. The Microsoft Knowledge base can be accessed directly from the Internet using the following URL:

         http://support.microsoft.com/support
   

REFERENCES

For additional information, please see the following articles in the Microsoft Knowledge Base:

   ARTICLE-ID: Q161344
   TITLE     : INFO: Visual Basic 4.0 and Visual Basic 5.0 Compatibility

   ARTICLE-ID: Q174135
   TITLE     : INFO: Setup Cannot Continue...System Files Are Out of Date

   ARTICLE-ID: Q162518
   TITLE     : PRB: "Unexpected error; quitting" Installing VB4 Application

   ARTICLE-ID: Q178354
   TITLE     : HOWTO: Setup Wizard Dependency Files

   ARTICLE-ID: Q164529
   TITLE     : FILE: Updated Automation System Files

   ARTICLE-ID: Q180071
   TITLE     : FILE: MSVBVM50.EXE Installs Visual Basic 5.0 Run-time Files

Keywords          : VB4ALL VB4WIN vb5all vb5howto
Version           : WINDOWS:4.0,5.0
Platform          : WINDOWS
Issue type        : kbinfo