Microsoft KB Archive/231923

= How To Distribute the Microsoft Data Engine (MSDE) With the Package and Deployment Wizard (PDW) =

Article ID: 231923

Article Last Modified on 7/1/2004

-

APPLIES TO


 * Microsoft Visual Basic 6.0 Professional Edition
 * Microsoft Visual Basic 6.0 Enterprise Edition
 * Microsoft Data Engine 1.0

-



This article was previously published under Q231923



SUMMARY
This article shows how to package and distribute MSDE for Visual Studio using the Package and Deployment Wizard (PDW) tool that ships with Visual Basic 6.0. There are two main steps to perform:

 Create a Standard Setup Package that redistributes necessary MSDE files to target machines along with your Visual Basic application. The MSDE files will be used on target machines to set up MSDE. This could be done in two ways with the PDW:  MSDE manual setup MSDE automatic setup via a Window's Program group icon

 Use a custom database with MSDE on the target machine.



MORE INFORMATION
The following procedure assumes that you have downloaded the MSDE for Visual Studio redistribution package (Msdex86_pkg.exe) and have extracted the redistribution file (Msdex86.exe). The MSDE for Visual Studio CD also has the redistribution files in the MSDE folder.

Manual Setup
In this approach, MSDE setup must be launched manually after redistributing MSDE files to the target machine. This can be accomplished from either the MS-DOS command line or from the Start/Run menu.

 On the original development machine, start the Package and Deployment Wizard. Choose a Visual Basic project and click the Package icon.</li> In the Package and Deployment Wizard - Package Type dialog box, click Standard Setup Package.</li> Click Next; leave the default settings.</li> Click Next. In the Package and Deployment Wizard - Included Files dialog box, click Add. Include the following files within the setup wizard:  Readme.txt</li> Msdex86.exe</li> Unattend.iss</li> License.txt</li> Any custom database (.mdf file) that needs to be used with MSDE on the target machine</li></ul>

</li> Click Next. In the Package and Deployment Wizard - Cab Options dialog box, choose one of the following two options:  Single Cab: This option is useful when distributing the Package on a large media such as a CD-ROM. This option packages all of the files into a single CAB file.</li> Multiple Cab: This option is useful when distributing the package on disks. Choosing this option packages the files into multiple CAB files.</li></ul>

</li> Click Next. In the Package and Deployment Wizard - Installation Title dialog box, choose a setup screen title.</li> Continue through the wizard, selecting the default settings, until you reach the Package and Deployment Wizard - Shared Files dialog box. In this dialog box, mark the components you want shared.</li> <li>Continue through the wizard; click Finish. The package is now complete and can be installed onto target machines.</li> <li>Run the setup program on the target machine.</li> <li>From the Start menu, point to Run (or from the MS-DOS command prompt), type the following, AppPath\msdex86.exe -s -a -f1 "AppPath\unattend.iss" where AppPath is the application directory specified by the user, or the default directory specified in the Setup section. This launches the MSDE setup program.</li></ol>

Automatic Setup via Window's Program Group
This allows the creation of a program group that appears under the Start/Programs menu on Window's desktop. Once clicked, this program group automatically launches the MSDE setup process on the target machine. <ol> <li>On the original development machine, start the Package and Deployment Wizard and repeat steps 1 through 6 in the "Manual Setup" process above.</li> <li>In the Package and Deployment Wizard - Start Menu Items dialog box, click New Item. Then, do the following: <ol style="list-style-type: lower-alpha;"> <li>In the Name box, type Start MSDE Setup .</li> <li>In the Target box, type the following:

msdex86.exe -s -a -f1 "$(AppPath)\unattend.iss" </li> <li>In the Start In box, leave the default macro: $(AppPath).</li></ol>

</li> <li>Repeat steps 7 and 8 above. The package is now complete and can be installed onto target machines.</li></ol>

Step 2: Using a Custom Database with MSDE
When MSDE setup is completed successfully on target machines, only the following databases will be available with MSDE:


 * master
 * model
 * msdb
 * tempdb

Once you have redistributed the custom database (.mdf) file onto the target machine as shown in step 4 of the "Manual Setup" section above, you can then apply any of the following approaches:

<ul> <li> Run the stored procedure "sp_attach_db" to attach your database to MSDE as follows: EXEC sp_attach_db @dbname = N'dbname', @filename = N'filepath\filename.mdf' EXEC sp_attach_db 'Test', 'c:\Mssql7\Data\Test.mdf' </li> <li> Use the Microsoft OLEDB Provider for SQL Server to attach the .mdf database file and connect to the database directly. In this case, the connection string should resemble the following: "Provider = SQLOLEDB.1; User ID = your_user_id; Password = your_password;Initial Catalog = db_name; Data Source = server_name; Initial File Name = db_file_path\db_file_name.mdf" </li> <li> Use the Microsoft OLEDB Provider for SQL Server to point to the local MSDE. In this case, the connection string should resemble the following: "Provider = SQLOLEDB.1; User ID = your_user_id; Password = your_password; Initial Catalog = db_name; Data Source = (local)" </li> <li>Use the Microsoft OLEDB Provider for ODBC drivers (MSDASQL) to connect to MSDE. You can create a DSN on each target machine or use a DSN-less connection

NOTE: The third and fourth approaches above require attaching the database prior to using the connection string(s).</li> <li>You can optionally use SQL-DMO to start MSDE, attach or/and detach your custom database to MSDE.</li></ul>

<div class="references_section">