DOCUMENT:Q190046 18-JUL-2001 [vbwin]
TITLE :INFO: VB6 Readme: Part 6 Wizard Issues
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER::6.0
OPER/SYS:
KEYWORDS:kbreadme kbwizard kbtophit kbActiveX kbAppSetup kbInternet kbMDAC kbVBp kbVS600 kbWebSe
======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:
- Microsoft Visual Basic Learning Edition for Windows, version 6.0
- Microsoft Visual Basic Professional Edition for Windows, version 6.0
- Microsoft Visual Basic Enterprise Edition for Windows, version 6.0
-------------------------------------------------------------------------------
SUMMARY
=======
The information below includes the documentation and workarounds for Visual
Basic 6.0. This information can also be found in the README.htm file that ships
with Visual Basic 6.0 on the Visual Basic 6.0 CD-ROM. Please see the REFERENCES
section of this article for a list of the Microsoft Knowledge Base articles
relating to the Visual Basic 6.0 readme.
Following is a list of all parts of the readme file:
Part 1. Important Issues Please Read First!
Part 2. Data Access Issues and DataBinding Tips.
Part 3. Control Issues.
Part 4. Language Issues.
Part 5. Samples Issues.
Part 6. Wizard Issues.
Part 7. Error Message Issues.
Part 8. WebClass Designer Issues.
Part 9. DHTML Page Designer Issues.
Part 10. Extensibility Issues.
Part 11. Miscellaneous Issues.
Part 12. Microsoft Transaction Server (MTS) Issues.
Part 13. Dictionary Object.
Part 14. Visual Component Manager.
Part 15. Application Performance Manager.
MORE INFORMATION
================
Package and Deployment Wizard (PDW):
Automatically Picks Up Files From Redist Directory
----------------------------------------------------------------------------------------
A new feature of the Package and Deployment Wizard is its ability pick up files
from the Redist folder. An example of how the feature is used would follow the
steps below:
1. You have created an application that is ready for packaging.
2. The application depends on a certain system file "MySysFile.dll" which, until
recently, has been a stand-alone file. But now a recent system update has
made that file dependent on other files to function properly.
3. However, a stand-alone version of the system file is also supplied.
4. To simplify setups, you place that stand-alone version into the Redist
folder.
5. When creating your deployment package, you navigate to the system file to
instruct the wizard that the system file should be included.
6. Instead of picking up the system file (which is dependent on other files),
the Package and Deployment Wizard will pick up the stand-alone version that
is in the Redist directory.
By default, no files are placed in the redist folder.
Package and Deployment Wizard Has [Do Not Redist] Section
---------------------------------------------------------
A new section has been added to the Package and Deployment VB6Dep.ini file: [Do
Not Redist]
Two kinds of files are listed under the new section:
1. Files that are not needed at run-time. For example, ActiveX designers often
require two file references, one for design-time, and one for run- time.
Since the design-time reference is not needed, it is listed in the section
and is not included in the package.
2. Files that cannot be redistributed by the Package and Deployment Wizard. Some
dependent files are not installed by Visual Basic, but must be installed by
another component. For example, the following files are installed by Internet
Explorer 4.x: Shdocvw.dll and Mshtml.dll.
Package and Deployment Wizard: In Silent Mode the Notification
Window May Not Be First in the Window Z-order
------------------------------------------------------------------------------------------------------------
With Visual Basic, it is possible to run the Package and Deployment Wizard in
silent mode from a command prompt. When doing so, you can also set a path for
logging the wizard's output (/l ). With the path set, the wizard will create a
log of events. If you do not use the argument, the wizard will instead display a
dialog box to notify you of the wizard's completion. However, the window is not
always obvious because it may be underneath other windows. In order to see it,
you may need to close or minimize all other windows.
For more information, search online for "running as a stand-alone" in Visual
Basic Concepts in the MSDN Library Visual Studio 6.0 documentation.
Package and Deployment Wizard: Command Line Mode Argument Added for
Specifying Executable Path
----------------------------------------------------------------------------------------------
An argument has been added to the command line mode of the Package and Deployment
Wizard. The argument is shown in the table below:
Argument Description
/e path Use the argument to set the path for the project's
executable file if it is different from the project's
path.
The argument allows the command line mode to be used in a multi-developer
environment where a computer is dedicated to compiling the project and creating
the package.
For more information, search online with Package and Deployment Wizard selected,
for running as a stand-alone in the MSDN Library Visual Studio 6.0
documentation.
Package and Deployment Wizard: Manually Add User Control License Files
----------------------------------------------------------------------
When creating a package for a user control that requires a license key, the
license file (.vbl) is not automatically included. Instead, you must add the
file manually.
When you are at the dialog titled "Package and Deployment Wizard Included Files,"
click the Add button and search for the appropriate .vbl file.
Package and Deployment Wizard: Steps in the Web Deployment Process
------------------------------------------------------------------
When you post an Internet package to a Web server using the Package and
Deployment Wizard, the wizard uses a technology known as WebPost to copy your
package to the server and process it appropriately. These are the steps that the
WebPost process goes through when processing your .cab:
1. It extracts the .cab file into a temporary directory.
2. It locates the .inf file for the .cab file.
3. Based on the contents of the .inf file, the WebPost process installs
application files (based on the RInstallApplicationFiles section of the .inf
file), installs system files (based on the RiinstallSystemFiles section), and
installs shared files (based on the RInstallSharedFiles section). In the
process, it registers any necessary files.
NOTE: The DefaultInstall section of the .inf file is not run, because the
instructions it contains often require user input. The WebPost process also does
not create a virtual directory for your application, if one is required;
directories must be set up in advance.
Package and Deployment Wizard: Web Deployment Tips for HTTP or FTP Protocol
---------------------------------------------------------------------------
- If the .cab file you are attempting to deploy to a Web server is copied to
the server but is not unpacked, make sure you included the .cab file on the
Items to Deploy screen, and that you used HTTP Post as the protocol on the
Web Publishing Site screen. In addition, you must have checked the Unpack and
Install Server-Side Cab check box on the Web Publishing Site screen. If you
did not, try re-deploying your package again with this option selected.
NOTE: Cab unpacking is supported by Posting Acceptor 2.0 running on IIS 4.0.
If you receive an error saying that the Web server you selected does not
support the service provider you selected, there are several things you can
do to try to fix this problem:
- If you are using the HTTP Post protocol, make sure that Posting Acceptor
is installed on your Web server. If you are running IIS 4.0, install
Posting Acceptor 2.0. If you are running IIS 3.0, install Posting Acceptor
1.0. Cab unpacking is not supported by Posting Acceptor 1.0.
- Ensure that your URL is correct. If you are using HTTP Post, ensure that
your URL begins with "http://". If you are using FTP, ensure that your URL
begins with "ftp://".
- If you are uploading to a server location that has Posting Acceptor 1.0
installed, you cannot select the option to unpack and install your cabinet
files when you deploy your package using the wizard. If you receive an
error C0042115 that the query string INSTALL is invalid, check your server
configuration to determine what version of posting acceptor is installed.
If it is version 1.x, deploy your cab again, making sure to deselect the
Unpack and Install Server-Side Cab option.
- If you need to use the FTP protocol to post to a URL beginning with
"http://", you may be able to resolve this error by adding the following
entry to the end of your Web server's postinfo.asp file, usually located
in the scripts directory on the Web server:
[{02B5E1D1-8B7C-11D0-AD45-00AA00A219AA}] ServerName=" <%=
Request.ServerVariables("SERVER_NAME") %>"
- MDAC installation requires DCOM95 to be installed. Setup programs created
with the Package and Deployment Wizard install the Microsoft Data Access
Components (MDAC), which includes OLE DB, ADO and Jet, via the MDAC installer
program: Mdac_typ.exe. This EXE requires that the machine being installed to
have DCOM95 (or the newer DCOM98) installed on it.
If the MDAC intaller fails with a "DLL registration failed" message, this is
because DCOM was not found on the machine. To restore functionality of
existing data components, install DCOM95 and run the installer again.
- If you use the HTTP Post protocol and receive an error that you do not have
write access for the Web server, open the Internet Service Manager on the
server computer, access the node for your Default Web Site (Console Root \
Internet Information Server \ machinename \ Default Web Site), choose
Properties, select the Home Directory tab, and check the Write check box.
- If your files are read-only when you try to post, you will receive an error
C0042116 announcing that processing has stopped. Change your file attributes
to proceed.
- Be aware that if you post a file to a directory where the same file already
exists, the file on the server will be overwritten and no warning message
will be displayed.
- If you use the FTP protocol and receive an error that access is denied, open
the Internet Service Manager on the server computer, access the node for your
Default FTP Site (Console Root \ Internet Information Server \ machinename \
Default FTP Site), choose Properties, select the Home Directory tab, and
check the Write check box.
- If you use the FTP protocol and receive additional errors besides the one
described in the previous bullet, make sure that you have properly configured
your FTP service on the Web server. To do so, start the Microsoft Management
Console (MMC), then follow these steps:
1. Right-click on Default FTP Site and choose New Virtual Directory.
2. Enter an alias to be used to access the virtual directory, then click Next.
3. Enter the physical path of the directory to which to map the virtual
directory (for example, c:\inetpub\ftproot) then click Next.
4. Select the appropriate access permissions, making sure to allow write access
so that your deployments can proceed without errors, then click Finish.
5. Right-click on Default FTP Site and choose Stop.
6. Right-click on Default FTP Site and choose Start.
When you deploy to the FTP server using the Package and Deployment Wizard, use
the site FTP://servername/alias where alias is the alias you assigned in step
2. Use the username "anonymous" and the password "me@somewhere" for anonymous
login.
Package and Deployment Wizard: Start Menu Items: Run Option Not Supported
-------------------------------------------------------------------------
When creating a package for deployment, you can also create a Start menu item.
Although it is mentioned in the Help topic for the dialog box, the Run option is
not supported.
System Configurations for WebPost's Posting Acceptor
----------------------------------------------------
When you deploy your packages to a Web server, the Package and Deployment Wizard
uses a technology known as WebPost to move your files to the desired location.
WebPost consists of two main components:
- The Package and Deployment Wizard, which sends your content to a qualified
site.
- A Posting Acceptor, located on the Web server, that enables the posting of
content to an IIS server.
There are multiple versions of Posting Acceptor available. You must make sure you
install the correct version on your Web server based on your machine
configuration. The following table lists the appropriate configurations:
Use this if you are running Comments
--------------------------------------------------------------------------
Posting Acceptor 2.0 Windows NT 4.0 with SP3 Posting Acceptor 2.0
IIS 4.0 supports both content
posting and the
unpacking of cabinet
(.cab) files on the
server.
Posting Acceptor 1.0 Windows NT 4.0 You cannot unpack .cab
with SP3 with this version
IIS 3.0 files of posting
acceptor. Use this for
content posting only.
You can move your
files to the server
and then manually
register any necessary
files that would have
been registered by the
.cab process.
NOTE: Posting Acceptor does not work on any platforms that are using Personal Web
Server or Peer Web Server. You must use IIS. Steps for installing Microsoft
Posting Acceptor 2.0 if you have Visual Studio or Visual Basic Enterprise
Editions.
1. Launch Visual Studio or Visual Basic setup from your installation CDs.
2. When prompted to choose options to install, click Install Server Applications
and Tools, then click Next.
3. Click Launch the BackOffice Installation Wizard, then click Install.
4. Now select the radio button for Custom, then click Next. You will see the
options to install and their sizes. Click Next.
5. Select Microsoft Posting Acceptor 2.0.
You can install Posting Acceptor 2.0 from the Deploy folder of Visual Studio
installation CD number 2. Posting Acceptor 1.0 can be installed from the
Microsoft Posting Acceptor Information Website. If you want to install Posting
Acceptor 2.0 on a computer that already has the Windows NT Option Pack, you
should first check to see if version 1.0 of the Posting Acceptor is already
installed. If so, remove it before installing version 2.0. To determine if 1.0
is installed, select the NT Option Pack on the Add/Remove Programs mechanism of
the Control Panel. Click Add/Remove, then look for Posting Acceptor 1.0 among
the components listed. You may find it under Microsoft Site Server. If it is
installed, remove it. You can then install version 2.0 by running PASetup.exe.
Package and Deployment Wizard: Edit Setup.lst File If You
Rebuild Cabs From Batch File
--------------------------------------------------------------------------------------
After creating a standard setup package using the Package and Deployment Wizard,
you can manually recreate the setup files (Setup.exe, Setup.lst, and all .cab
files) by running the batch file found in the in the Support folder. Doing this
allows you to manually customize the package or to recreate a package without
running the wizard again. Running the batch file will copy setup.exe and
setup.lst from the Support folder to the Package folder and will generate the
cab file(s) in the Package folder. However, once the batch file is finished,
setup.lst will not know how many .cab files were generated. Unless this problem
is remedied, the setup program will fail.
To remedy this situation, do the following:
1. Before running the batch file, delete all .cab files in the Package folder.
2. After running the batch file, count the number of cabs produced by the batch
operation.
3. Open the Setup.lst file in the Package folder with a text editor. NOTE: There
are two Setup.lst files. One is found in the Support folder. The second is
found outside the Support folder, in the Package folder where the .cab files
are created. Be sure to open the Setup.lst file in the Package folder.
4. In the text editor, look for the following lines, which are at the top of the
file):
[Bootstrap]
SetupTitle=Install
SetupText=Copying Files, please stand by.
CabFile=Projec1.CAB
Spawn=Setup1.exe
Uninstal=st6unst.exe
TmpDir=msftqws.pdw
5. After the last line (TmpDir=msftqws.pdw), insert the following line where N
equals the number of cabs generated:
Cabs=N
The Setup.lst should now be up to date, and the setup won't fail.
Package And Deployment Wizard: Error 80042114
---------------------------------------------
If you are creating a package for Internet deployment and you get the following
error:
"Unexpected error 80042114 has occurred: The Web server you selected does not
indicate support for the service provider you selected. Do you want to
proceed anyway?"
This error occurs because you have specified that your package should be posted
to an FTP site using an HTTP URL. If you are certain that you have access
privileges to the web server, you can click "Yes" and the deployment will
proceed.
To avoid this error in the future, when creating a package for deployment on the
same server, specify the site and its protocol. When you do so, the following
dialog box will appear:
"The specified URL and publishing method can be saved in the registry as a Web
publishing site. This ensures that the URL and publishing method are valid and
saves you time in future deployments to this site. Do you want to store this
information as a Web publishing site?"
If you select "yes," this saves the site information and you will no longer
receive the 80042114 error.
Package and Deployment Wizard: Use Mdac_typ.Cab and Mdac20.Cab to
Distribute Data Access Components
---------------------------------------------------------------------------------------------------
When your Internet Package includes any of the following four files, the wizard
will by default set these files to be downloaded from:
http://activex.microsoft.com/controls/vb6/mdac_typ.cab
MSDAOSP.dll
MSADO15.dll
MSADCF.dll
ODBC32.dll
Similarly, the wizard will, by default, set the following files to be downloaded
from:
http://activex.microsoft.com/controls/vb6/mdac20.cab
MSADOR15.dll
MSADCO.dll
In both cases, these defaults are indicated as the "Download from Microsoft Web
site" option on the File Source screen. These cab files (mdac_typ.cab and
mdac20.cab) perform special handling that should not be attempted manually. In
order to ensure that the proper handling takes place, your Internet cab should
not include these files but rather should reference the cabs. Therefore, you
should never choose the "Include in this cab" option for any of these files. In
addition, if you choose the "Download from alternate Web site" option, you
should be careful to specify cabs that are copies of these cabs to ensure that
the proper handling takes place.
Do not change the default settings for these files.
Package and Deployment Wizard: Manually Include .ASP and .HTM Files
For IIS Applications When Using Standard Setup
------------------------------------------------------------------------------------------------------------------
If you use the Package and Deployment Wizard's standard setup to deploy an IIS
application, you must manually include any .asp or .htm files with the package.
Add the files using the Include Files dialog box.
Package and Deployment Wizard: Bad Date and Time Formats
--------------------------------------------------------
In certain situations, the Package and Deployment Wizard will incorrectly write
time and date information to the Setup.lst file. When this occurs, the setup
will fail because the dates will be written in a form that the setup.exe can't
read. The problem occurs when you create a deployment package using the US
version of Visual Basic on:
- A computer using the German version of Windows (NOTE: the German version of
Visual Basic will work correctly.)
- Any computer where the date separator isn't either a forward slash ("/") or a
dash ("-").
To fix the bad formats:
1. From the Start menu, open Control Panel.
2. Click the Regional Settings icon.
3. On the Date tab, change the Date separator to "/".
4. On the Time tab, change the Time separator to ":".
5. Run the Package and Deployment Wizard.
6. Restore the date and time settings.
Package and Deployment Wizard: Unable to Run Setup.exe on
First Windows 95 Version
----------------------------------------------------------------------------------
Any setup package built with the wizard will not launch on certain installations
of Windows 95 due to lack of support for an API in the original version of the
Oleaut32.dll. This failure will not occur on OS release 2 of Windows 95 or any
versions of Windows NT 4.0 and later, and will not occur if Microsoft Office 97
or Internet Explorer 3.0 or 4.0 has been installed. Any installation of a Visual
Basic 5.0 application will also remedy the situation. You can also work around
this failure by first overwriting the older version of Oleaut32.dll with the
latest version. Be sure to shut down all applications before attempting to
manually update Oleaut32.dll.
Package and Deployment Wizard: Packaging ActiveX Documents
----------------------------------------------------------
The Visual Basic 6.0 Package and Deployment Wizard can insert CODEBASE= and
VERSION= information directly embedded into the .vbd file for your ActiveX
Document project. This eliminates the need for having the extra .htm file
previously used to launch ActiveX Documents. The embedded information allows
Internet Explorer to read the .cab file name for your ActiveX Document code and
version information from the .vbd file and carry out the installation. You can
now navigate directly to the .VBD file and your User document code will download
if necessary.
The same functionality was available for Visual Basic 5.0 setup using the
SetCodeBase utility found on the Visual Basic Owners Area.
The following are some issues with Visual Basic 6.0 Package and Deployment Wizard
generated setups for User documents:
- Internet Explorer 3.x. 4.0, and 4.01 cannot read the embedded information in
the VBD file. The wizard also generates an old (VB5) style .htm file. This
.htm file can be used to launch ActiveX Documents. You must first modify the
.htm file, however, since most of the code is commented out. After removing
the comments and an extra tag (xxxxx.VBD) from the top, from the top, the file
will only be an OBJECT tag with the CLSID of your User document and some
script code for Window_OnLoad event.
- Internet Explorer 4.01 with Service Pack 1 and later will read this
information correctly from the .vbd file.
REFERENCES
==========
For additional information, please see the following articles in the Microsoft
Knowledge Base:
Q170164 INFO: VB 6.0 Readme Part 1: Important Issues Read First!
Q170163 INFO: VB 6.0 Readme Part 2: Data Access/Databinding Issues
Q170162 INFO: VB 6.0 Readme Part 3: Control Issues
Q170161 INFO: VB 6.0 Readme Part 4: Language Issues
Q170160 INFO: VB 6.0 Readme Part 5: Samples Issues
Q170158 INFO: VB 6.0 Readme Part 7: Error Message Issues
Q189539 INFO: VB 6.0 Readme Part 8: WebClass Designer Issues
Q190249 INFO: VB 6.0 Readme Part 9: DHTML Page Designer Issues
Q170154 INFO: VB 6.0 Readme Part 10: Extensibility Issues
Q170157 INFO: VB 6.0 Readme Part 11: Miscellaneous Issues
Q170156 INFO: VB 6.0 Readme Part 12: Transaction Server (MTS) Issues
Q191792 INFO: VB 6.0 Readme Part 13: Dictionary Object
Q191791 INFO: VB 6.0 Readme Part 14: Visual Component Manager
Q191790 INFO: VB 6.0 Readme Part 15: Application Performance Explorer
Additional query words:
======================================================================
Keywords : kbreadme kbwizard kbtophit kbActiveX kbAppSetup kbInternet kbMDAC kbVBp kbVS600 kbWebServer kbFAQ kbVBp600FAQ
Technology : kbVBSearch kbAudDeveloper kbZNotKeyword6 kbZNotKeyword2 kbVB600Search kbVB600
Version : :6.0
Issue type : kbinfo
=============================================================================
THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.
Copyright Microsoft Corporation 2001.