Ac t i x MSDE

Dat abase Engi ne

I nst al l at i on Gui de


May 2005

Actix Software MSDE Installation May 2005 2

Actix MSDE Database Engine Installation Guide
Copyright Actix 2005.
All rights reserved. All trademarks are hereby acknowledged.
Actix and the Actix logo are the trademarks of Actix Limited. Similar restrictions to use of our
company and product names may apply elsewhere.
The content of this manual is provided for information only, is subject to change without notice, and
should not be construed as a commitment by Actix. Actix assumes no responsibility or liability for
any errors or inaccuracies that appear in this documentation.
Microsoft, MSDE and SQL Server are either registered trademarks or trademarks of Microsoft
Corporation in the United States and/or other countries.

Actix Software MSDE Installation May 2005 3
Contents

1 ABOUT MSDE.......................................................................................................4
1.1 OVERVIEW......................................................................................................................... 4
1.2 SYSTEM REQUIREMENTS.................................................................................................... 5
1.3 FEATURES......................................................................................................................... 5
2 INSTALLING MSDE..............................................................................................7
2.1 PREPARATION.................................................................................................................... 7
2.2 INSTALLING THE ACTIXDATABASE ENGINE............................................................................ 8
3 TROUBLESHOOTING THE INSTALLATION.....................................................11
3.1 FORWARDING LOGS TO ACTIX TECHNICAL SUPPORT............................................................11
3.2 ADDING AND REMOVING PROGRAMS....................................................................................12
4 ADVANCED OPTIONS.......................................................................................13
4.1 COMMAND LINE INSTALLATION............................................................................................13


Actix Software MSDE Installation May 2005 4
1 About MSDE
1.1 Overview
The Microsoft SQL Server 2000 Desktop
Engine (MSDE 2000) is a data engine built and
based on core SQL Server technology. With
support for single- and dual-processor desktop
computers, MSDE 2000 is a reliable storage
engine and query processor for desktop
extensions of enterprise applications. The
common technology base shared between SQL
Server and MSDE 2000 enables developers to
build applications that can scale seamlessly from
portable computers to multiprocessor clusters.
Designed to run in the background, supporting transactional desktop
applications, MSDE 2000 does not have its own user interface (UI) or
tools. Users interact with MSDE 2000 through the application in which it
is embedded. MSDE 2000 is packaged in a self-extracting archive for ease
of distribution and embedding.
In addition, MSDE 2000 can be built into applications and redistributed
royalty-free with Microsoft development tools, such as Microsoft Visual
Studio.NET and Microsoft Office XP Developer Edition. This allows
developers to build enterprise-class reliability and advanced database
features into their desktop applications.
Portable and Compatible
MSDE 2000 is a royalty-free, redistributable database engine that is fully
compatible with SQL Server. MSDE 2000 is designed to run on Microsoft
Windows98, Windows Millennium Edition (Windows Me), Microsoft
Windows NTWorkstation version 4.0 (with Service Pack 5 or later),
and Windows 2000 Professional as an embedded database for custom
applications that require a local database engine.
An attractive alternative to using the Microsoft J et database, MSDE 2000
is designed primarily to provide a low-cost option for developers who
need a database server that can be easily distributed and installed with a
value-added business solution. Because it is fully compatible with other
editions of SQL Server, developers can easily target both SQL Server and
MSDE 2000 with the same core code base. This provides a seamless
upgrade path from MSDE 2000 to SQL Server if an application grows
beyond the storage and scalability limits of MSDE 2000

Actix Software MSDE Installation May 2005 5
1.2 System Requirements
Review the table below to determine the minimum system requirements
needed to run Microsoft SQL Server 2000 Desktop Engine (MSDE 2000).
To use MSDE 2000, you need:
Minimum Requirements
Processor Intel Pentium or compatible 166-megahertz (MHz) or higher processor
Operating System MSDE 2000 can run on the following Microsoft Windows operating
systems:

Windows Server 2003, Standard Edition*
Windows Server 2003, Enterprise Edition*
Windows Server 2003, Datacenter Edition*
Windows Server 2003, Web Edition*
Windows 2000 Server
Windows 2000 Advanced Server
Windows 2000 Datacenter Server
Windows NT Server 4.0 with Service Pack 5 (SP5) or later
Windows NT Server 4.0, Enterprise Edition, with SP5 or later
Windows NT Workstation 4.0 with SP5 or later
Windows XP Professional
Windows XP Home Edition
Windows 2000 Professional
Windows 98
Windows Millennium Edition
Memory Windows XP: 128 megabytes (MB) of RAM
Windows 2000: 64 MB of RAM
All other operating systems: 32 MB of RAM
Hard Disk 44 MB of available hard disk space
Drive CD-ROM drive

* Windows Server 2003 requires SQL Server 2000 Service Pack 3 or later to be applied.
1.3 Features
Microsoft SQL Server 2000 Desktop Engine (MSDE 2000) helps you
build custom solutions by offering the features described below.
Multi-Instance Support
MSDE 2000 supports up to 16 database server instances on a single PC.
MSDE 2000 Utilities
MSDE 2000 includes several command prompt utilities that can be used to
administer instances of MSDE 2000. The most important of these is
Osql.exe, which allows you to interactively enter Transact-SQL statements
in a command prompt environment. You can use the Transact-SQL
Actix Software MSDE Installation May 2005 6
administration statements, such as BACKUP and RESTORE, to
administer an instance of MSDE 2000. Other utilities included with
MSDE 2000 are Bcp.exe, which allows you to bulk copy large amounts of
data into or out of MSDE 2000 databases, and Dtsrun.exe which executes
Data Transformation Services packages. The remaining utilities included
with MSDE 2000 are Cnfgsvr.exe, Dcomscm.exe, Sqlmangr.exe,
Sqladhlp.exe, and Svrnetcn.exe.
Replication
MSDE 2000 fully supports both merge and snapshot replication both as a
publisher and as a subscriber, allowing you to keep copies of the same
data on multiple sites, sometimes covering hundreds of sites. MSDE 2000
also supports other forms of replication, but only in a limited capacity.
MSDE 2000 can participate in transactional replication in a subscriber
capacity only.
Performance
MSDE 2000 is a local data engine that can be shared. It has a managed
concurrency workload governor that limits up to five concurrent batch
workloads for optimal performance. Commands and log entries are
available to monitor instances where more than five workloads are
executed concurrently, a situation that can cause slower performance even
on well-tuned systems. As more batch workloads are submitted beyond
the five-workload limit, the concurrency governor continues to slow down
the system. These workloads are not dropped or lost; they are still
processed, but in an increasingly degraded performance mode. If your
solution must support more than five concurrent workloads, it is highly
recommended that you migrate to SQL Server 2000 or SQL Server 2000
Enterprise Edition for optimal performance at this higher level of
scalability.
Maximum Database Size
MSDE 2000 supports up to 2 gigabytes (GB) per database. This limitation
is per database, not per server. A single computer can support multiple
MSDE 2000 instances, each with databases of up to 2 GB in capacity.
Data Transformation Services
MSDE 2000 is capable of running Data Transformation Services (DTS)
packages. However, it cannot design DTS packages, because it is not
equipped with a DTS Designer.
Remote Administration
It is possible to administer MSDE 2000 both locally and remotely.
However, MSDE 2000 cannot be remotely administered in a multi-server
environment where transactions occur across servers.
Actix Software MSDE Installation May 2005 7
2 Installing MSDE
2.1 Preparation
Before proceeding with the MSDE installation, ensure that:
you have administrator rights
the target PC meets the minimum specification for Actix Software.
Install the Actix Software on the target PC. If you have not already
installed the Actix Software, you will see this message when you try to
install MSDE:

Examine the folder structure on the installation CD. You should see the
folder db in the same folder as the Actix Software installation folder.
Within the db folder are two files of note:
Setup.exe
ActixDatabase.msi (for advanced users; see later in this guide)
Note that the folder MSDERelA is the complete, freely available
Microsoft database installation, and may be used to install the Microsoft
database software if required on another PC in a non-Actix context.
Actix Software MSDE Installation May 2005 8
2.2 Installing the ActixDatabase Engine
Copy the db folder to a local drive on your target PC, as the installation
will not work correctly if run from a network location. Note that you also
cannot install to network locations.
Run the file Setup.exe.
You should now see the following screen:

Click Next.
Actix Software MSDE Installation May 2005 9
Now you can specify the location for the database files.

To specify a new location, click the Change button .
You are now ready to install ActixDatabase. Click Install to continue.

Actix Software MSDE Installation May 2005 10
When the installation has completed successfully, you will see this screen:

Actix Software MSDE Installation May 2005 11
3 Troubleshooting the installation
3.1 Forwarding logs to Actix Technical Support
If you have difficulties with installing the database:

or with the operation of the database, please can you email Actix
Technical Support. From the folder:
\ Act i x\ Anal yzer \ Dat abase\ Scr i pt s\
include these files:
RunSQL. l og
msdei nst al l . l og
and also logfiles from this folder:
C: \ Document s and Set t i ngs\ Al l User s\ Appl i cat i on
Dat a\ Act i x\ Anal yzer \ MSSQL$ACTI XMSDE\ Log\
Actix Software MSDE Installation May 2005 12
3.2 Adding and removing programs
Note that, in the Add/Remove Programs dialog, it is displayed as two
separate programs, ActixDatabase and MSDE:

This makes it easier for Microsoft updates to work for MSDE.
If you want to remove the database engine, you will need to remove both
these programs. Using the ActixDatabase uninstall routine by running
setup again will only remove ActixDatabase, so you will need to remove
MSDE manually.
Actix Software MSDE Installation May 2005 13
4 Advanced options
4.1 Command line installation
Note that the D:\ drive is taken to be your CD drive in the examples given
below.

Without options
msi exec / i <filename>
<filename>includes the full path as well as the filename. For example:
msi exec / i D: \ db\ Act i xDat abase. msi

Logging
msi exec / i <filename> / l *v <logfilename>
For example:
msi exec / i D: \ db\ Act i xDat abase. msi / l *v
c: \ msdei nst al l . l og

Set path for database file
msi exec / i <filename> DATADI R=<path>
DATADIR is where the database files will be created.
For example:
msi exec / i D: \ db\ Act i xDat abase. msi DATADI R=
C: \ Document s and Set t i ngs\ Al l User s\ Appl i cat i on
Dat a\ Act i x\ Anal yzer \

Actix Software MSDE Installation May 2005 14
Silent installation
Before running a silent install, if MSDE and the ActixDatabase have
previously been installed, ensure that you delete the files:
act i xdb. mdf
act i xdb_l og. l df
at x_*
from:
<DATADI R>\ MSSQL$ACTI XMSDE\ Dat a

Installing MSDE from the root of the Actix CD
. . \ MSDERel A\ set up. exe / set t i ngs . . \ act i xsql . i ni "
DATADI R= C: \ Document s and Set t i ngs\ Al l
User s\ Appl i cat i on Dat a\ Act i x\ Anal yzer \ / l *v
C: \ msdei nst al l . l og / qb!
The path to the appropriate file is represented by ... As an example:
D: \ db\ MSDERel A\ set up. exe / set t i ngs D: \ db\ pr ogr am
f i l es\ Act i x\ Anal yzer \ dat abase\ MSDE
sour ce\ act i xsql . i ni " DATADI R= C: \ Document s and
Set t i ngs\ Al l User s\ Appl i cat i on
Dat a\ Act i x\ Anal yzer \ / l *v C: \ msdei nst al l . l og
/ qb!
Restart your PC before next installing the ActixDatabase.
If the silent option is switched on, install MSDE before running this
install. The install will then install the ActixDatabase.
msi exec / i <filename> SI LENT=1 / qn
For example:
msi exec / i D: \ db\ Act i xDat abase. msi SI LENT=1 / qn
The /qn option is used as example but all other types are possible.

Uninstall
msi exec / x <filename>
For example:
msi exec / x D: \ db\ Act i xDat abase. msi