A guide to ArcGIS Engine Runtime installation

About the ArcGIS Engine Runtime Installation Program

The ArcGIS Engine Runtime installation program, or setup, was created using Windows Installer (MSI) technology from Microsoft. This technology uses a package file (.msi) and a client-side installer service (msiexec.exe). Windows Installer is a service that runs on your operating system. This service enables the operating system to manage the installation and uses the information contained within the package file to install the software.

The msiexec.exe program is a component of Windows Installer. Msiexec.exe uses a Dynamic Link Library, Msi.dll, to read the package files (.msi), apply transforms (. mst), and incorporate command-line options.

An MSI-based setup consists of features. A feature is an individual portion of the application’s total functionality that may be installed independently. The ArcGIS Engine Runtime setup consists of the following installation features:

At 9.0 and 9.1

Feature	Descriptive Feature Name	Description
ArcEngine	ArcGIS Engine	ArcGIS Engine
DotNetRuntime	ArcGIS Engine .NET Runtime	.NET Assemblies
JavaRuntime	ArcGIS Engine Java Runtime	Java Archives

At 9.2

Feature	Descriptive Feature Name	Description
ArcEngine	ArcGIS Engine	ArcGIS Engine
DotNetRuntime	ArcGIS Engine .NET Runtime	.NET Assemblies
JavaRuntime	ArcGIS Engine Java Runtime	Java Archives
Python	Python	Python 2.4.1 required for some Geoprocessing

All ArcGIS Engine-based applications depend on an installation of the ArcEngine feature. Applications built using the Java and .NET APIs for ArcGIS Engine require installations of the JavaRuntime and DotNetRuntime features, respectively, in addition to the ArcEngine feature.

ArcGIS Engine Runtime is supported on Windows 2000, Windows XP Professional, and Windows 2003 Server.

For additional or updated information regarding ArcGIS Engine Runtime system requirements, visit http://support.esri.com.

Installing ArcGIS Engine Runtime

As mentioned above, ArcGIS Engine software-based applications require that ArcGIS Engine Runtime be installed on the end user’s machine. Installation of the runtime can be handled in either of two ways:

Your end user runs the ArcGIS Engine Runtime setup directly from the CD.
You include the ArcGIS Engine Runtime setup within your own application’s installation program.

The following sections document the general requirements for the installation of the ArcGIS Engine Runtime, no matter which of the two types of installation mechanism you choose, and the steps necessary to install the runtime successfully using your chosen mechanism.

More information on Windows Installer can be found in the Windows Installer Software Development Kit. Download the kit at http://www.microsoft.com/msdownload/platformSDK/sdkupdate/.

You cannot redistribute individual ArcGIS Engine Runtime files; the installation mechanisms discussed in this appendix are the only means of installing ArcGIS Engine Runtime files.

General requirements

Irrespective of the installation method you chose for ArcGIS Engine Runtime, you should be aware of the following:

Prerequisites—If your ArcGIS Engine-based application was built using the .NET API, the .NET Framework 1.1 (for 9.0 and 9.1) or .NET Framework 2.0 (for 9.2) must be installed on your user’s machine prior to installing the ArcGIS Engine Runtime.
Older versions of ArcGIS software—ArcGIS Engine Runtime cannot be installed on any machine that already contains versions of ArcGIS products prior to the version you will be installing. This includes ArcIMS, ArcGIS Desktop, ArcGIS Workstation, ArcReader, ArcGIS Engine Runtime, ArcGIS Server, .NET ADF,and Java ADF.
Existing installation of ArcGIS Engine Runtime—If the ArcGIS Engine Runtime setup is launched, and ArcGIS Engine Runtime already exists on the machine, the setup will execute as a maintenance installation.
Installation location—Each of the ArcGIS 9 products (ArcGIS Engine Runtime, ArcGIS Engine Developer Kit, ArcGIS Desktop, ArcReader standalone, and ArcGIS Server) installs to the same installation directory. The first ArcGIS 9 product installed determines the installation location for all subsequent ArcGIS 9 products. For example, if ArcGIS Desktop is installed to C:\Desktop, the installation location for all ArcGIS 9 products is C:\Desktop\ArcGIS. If ArcGIS Engine Runtime is installed after ArcGIS Desktop, the opportunity to browse to an installation location is not provided. The initial ArcGIS Desktop installation has predetermined the installation location for all future ArcGIS 9 products. Therefore, in this example, ArcGIS Engine Runtime will also be installed to C:\Desktop\ArcGIS.
Disk space—If you run out of disk space while installing an ArcGIS 9 product, you must uninstall all ArcGIS 9 products and reinstall them to a location where more disk space is available. ArcGIS 9 products (excluding ArcSDE, ArcIMS, and ArcInfo Workstation) cannot be installed to different locations.

End user installs ArcGIS Engine Runtime on their system

In this case, your user installs the ArcGIS Engine Runtime either directly from the CD ESRI provided with the ArcGIS Engine product or from a CD that you created by copying the contents of the ArcGIS Engine Runtime CD image to it. You should distribute the following steps or similar instructions to your users:

Confirm that any currently installed ArcGIS products are the same version as the Engine Runtime setup to be installed. To check if any of these products are installed on the machine and verify the version number:

Click Start, Control Panel, and open the Add/Remove Programs dialog box.
If ArcGIS Engine Runtime is listed in the programs list, it has been installed on the machine. Confirm that ArcGIS Engine Runtime is the correct version. Click Support Information to determine the product version number. Close the window and proceed to the installation steps for <your application name here> if needed.
If no ArcGIS products are shown in the programs list, proceed to Step 2. If ArcGIS products are shown in the programs list, click Support Information to view the version of the product.
If the versions displayed are the same, proceed to Step 2. If the versions displayed are not the same, the products need to be removed before installing ArcGIS Engine Runtime. Do not proceed to Step 2 until these products have been uninstalled.

Launch the ArcGIS Engine Runtime installation program by navigating to the CD drive location and double-clicking the setup.exe file.
In the installation, click Next if all Windows applications are closed.
Review and accept the license agreement and click Next to proceed with the installation.
Choose the installation type and click Next to continue.

If the ArcGIS Engine-based application to be installed requires Java, choose Custom to manually select the JavaRuntime feature or choose Complete to install all ArcGIS Engine Runtime installation features.
Follow any further instructions of the ArcGIS Engine Runtime installation until it indicates that the installation is complete. If you installed, and intend to use, the Java feature, proceed to Step 7. If not, the installation of ArcGIS Engine Runtime is now complete. Proceed to the installation steps for <your application name here> if needed.
The JavaRuntime feature of ArcGIS Engine Runtime requires some additional postinstallation steps to be performed.

Click Start, Control Panel, and System. Double-click System Properties to open its dialog box.
Click Environment Variables on the Advanced tab.
In the System variables window, click the Path variable and click Edit.
Scroll to the end of the Variable value text box, and add the path to the ArcGIS\Bin directory. Separate it from previous entries with a semicolon.
Continuing on at the end of the same text box, use a semicolon separator and add in the path to the ArcGIS\Java\jre\bin directory.

The installation of ArcGIS Engine Runtime is now complete. Proceed to the nstallation steps for <your application name here> if needed.

Installing an ArcGIS Engine Runtime service pack

If your application also requires an ArcGIS Engine service pack, you can either instruct your user to download the service pack from http:\\support.esri.com, or you can provide the service pack (.msp file) on the ArcGIS Engine Runtime CD that you provided.

You should distribute the following steps or similar instructions to your users (the steps assume ArcGIS Engine Runtime is already on the target machine.):

Check whether the ArcGIS Engine Runtime service pack required has been installed to the target machine by doing the following:

Click Start > Run. Type “Regedit” to open the Registry Editor.
Check for the SPNumber registry key under the following registry hive:

HKEY_LOCAL_MACHINE\SOFTWARE\ESRI\

The SPNumber value reflects the service pack number installed.

Install the service pack using the following command line:

msiexec.exe /p <location of msp file>\ArcGIS<Product>.msp REINSTALL=ALL REINSTALLMODE=omus

ArcGIS Engine Runtime setup is included in your application’s installation program

The second way to distribute the ArcGIS Engine Runtime is for you to incorporate its setup into your own ArcGIS Engine software-based application’s installation program. This is possible because ArcGIS Engine Runtime can be installed without a graphical user interface by running the setup using Windows Installer command-line parameters. This process utilizes the .msi file and client-side installer service (msiexec.exe) command-line parameters.

The table below illustrates some available msiexec.exe command-line parameters:

Option	Parameters	Description
/I	Package \| ProductCode	Installs or configures a product.
/a	Package	Administrative installation option. Installs a product on the network.
/x	Package \| ProductCode	Uninstalls a product.
/q	n \| b \| r \| f	Sets user interface level. q No UI qn No UI qb Basic UI. Use qb! to hide the Cancel button. qr Reduces UI with no modal dialog box displayed at the end of the installation. qf Full UI and any authored FatalError, UserExit, or Exit modal dialog boxes at the end. qn+ No UI except for a modal dialog box displayed at the end. qb+ Basic UI with a modal dialog box displayed at the end. The modal box is not displayed if the user cancels the installation. Use qb+! or qb!+ to hide the Cancel button. qb- Basic UI with no modal dialog boxes. Please note that /qb+- is not a supported UI level. Use qb-! or qb!- to hide the Cancel button. Note that the ! option is available with Windows Installer 2.0 and works only with basic UI. It is not valid with full UI.
/? or /h		Displays copyright information for Windows Installer.

These commands can be used to perform various installation functions. The features available to install are specified with the ADDLOCAL parameter. As shown earlier, ArcGIS Engine has the following installation features:

Feature	Descriptive Feature Name	Description
ArcEngine	ArcGIS Engine	ArcGIS Engine
DotNetRuntime	ArcGIS Engine .NET Runtime	.NET Assemblies
JavaRuntime	ArcGIS Engine Java Runtime	Java Archives
Python	Python	Python 2.4.1 required for some Geoprocessing

Some example functions and the commands used to achieve them follow:

A typical installation to a nondefault location without a user interface
Msiexec.exe /i <setup location>\setup.msi /qn InstallDir=C:\Mysetup
A typical installation to a nondefault installation location with a basic user interface (progress bar)
Msiexec.exe /i <setup location>\setup.msi /qb InstallDir=C:\Mysetup
A complete installation to the default installation location without a user interface
Msiexec.exe /i <setup location>\setup.msi /qn ADDLOCAL=All
A custom installation without a user interface consisting of the ArcGIS Engine and .NET installation features
Msiexec.exe /i <setup location>\setup.msi /qn ADDLOCAL=ArcEngine, DotNetRuntime

These command-line parameters can be used to include the ArcGIS Engine Runtime setup in your application’s setup in any of the following three methods— at the end of an MSI-based setup, within a batch file, or within a scripted setup. Each will be discussed in more detail later in this section.

If your application requires an ArcGIS Engine Runtime service pack, the following standard command lines can be used to apply a service pack (these examples are for installing ArcGIS Engine Runtime 9.0 service pack 1):

To apply a service pack to an existing ArcGIS Engine Runtime installation on a local machine:
msiexec.exe /p <msp file location>\ArcGISEngine90sp1.msp REINSTALL=ALL REINSTALLMODE=omus
To apply a service pack to an admin installation of ArcGIS Engine Runtime:
msiexec.exe /a <location of admin installation>\setup.msi /p <msp location >\ArcGISEngine90sp1.msp

In addition to the general requirements listed earlier that apply to any installation of ArcGIS Engine Runtime, the following are applicable to installs that are incorporated within other applications:

Prerequisites—The ArcGIS Engine Runtime setup uses Windows Installer 3.1. To utilize command-line parameters to install ArcGIS Engine Runtime, Windows Installer 2.0 must be installed and running on the target machine. The setup.msi file automatically checks for Windows Installer 3.1; if it is not detected a message box is displayed. Even if you are including the ArcGIS Engine Runtime setup in a non-MSI-based setup, Windows Installer 3.1 must be installed on the machine. The ArcGIS Engine Runtime setup uses the Windows Installer technology.
Compatible setup programs—If the ArcGIS Engine Runtime setup will be launched at the end of an MSI-based setup, you must create your MSI setup using Windows Installer 3.1 or higher to be compatible with the ArcGIS Engine Runtime setup.
Nested MSIs—The ArcGIS Engine Runtime MSI cannot be nested within an MSI. Each product, including ArcGIS Engine Runtime, must be listed individually in Add/Remove Programs.

Your setup process should follow these steps:

Before launching the ArcGIS Engine Runtime setup, you need to check whether ArcGIS Engine Runtime and any needed optional features— Java and DotNetRuntime—have already been installed to the target machine. If your application also requires an ArcGIS Engine Runtime service pack, you need to check that the current service pack is on the user’s machine.

For ArcGIS Engine Runtime, check for the following registry key:
     HKEY_LOCAL_MACHINE\Software\ESRI\ArcGIS Engine Runtime
If the key exists, then ArcGIS Engine Runtime has already been installed on the target machine and you may not need to launch the ArcGIS Engine Runtime setup. Continue to Step 1b if your application requires the Java feature or Step 1c if your application requires the .NET feature; otherwise, proceed with the installation of your application.

If the key does not exist, then ArcGIS Engine Runtime has not been installed. Continue to Step 1b if your application requires the Python feature or Step 1c if your application requires the .NET feature; otherwise, proceed to Step 2.

If ArcGIS Engine Runtime 9.0 is required, the RealVersion registry key under
     HKEY_LOCAL_MACHINE\Software\ESRI\ArcGIS Engine Runtime\
will have a value of 9.0.

If ArcGIS Engine Runtime 9.1 is required, the RealVersion registry key under
     HKEY_LOCAL_MACHINE\Software\ESRI\ArcGIS Engine Runtime\
will have a value of 9.1.

If ArcGIS Engine Runtime 9.2 is required, the RealVersion registry key under
     HKEY_LOCAL_MACHINE\Software\ESRI\ArcGIS Engine Runtime\
will have a value of 9.2.
For Java, check the following registry entry:

For 9.0: HKEY_CLASSES_ROOT\Installer\Features\7A1A3A9178A2BC74EB114EA6B5DB1C1B

For 9.1: HKEY_CLASSES_ROOT\Installer\Features\BE4BB2A7FG2185944AB7F1350406D01A

For 9.2: HKEY_CLASSES_ROOT\Installer\Features\63B931B9FF1F8BD4989FD43A5D1CB28E

The JavaRuntime string value represents the Java installation feature of ArcGIS Engine Runtime.

If the value displayed is "JavaRuntime"="ArcEngine" then JavaRuntime is installed. Proceed to Step 1c if your application requires the .NET feature; otherwise, proceed with the installation of your application.

If the value displayed is "JavaRuntime"="|ArcEngine" or "JavaRuntime"="ArcEngine" then JavaRuntime is not installed. Proceed to Step 1c if your application requires the .NET feature; otherwise, proceed to Step 2.
For .NET, check the following registry entry:

For 9.0: HKEY_CLASSES_ROOT\Installer\Features\7A1A3A9178A2BC74EB114EA6B5DB1C1B

For 9.1: HKEY_CLASSES_ROOT\Installer\Features\BE4BB2A7FG2185944AB7F1350406D01A

For 9.2: HKEY_CLASSES_ROOT\Installer\Features\63B931B9FF1F8BD4989FD43A5D1CB28E

The DotNetRuntime string value represents the .NET installation feature of ArcGIS Engine Runtime.

If a DotNetRuntime string value is not displayed under this registry key, then the prerequisite—.NET Framework 2.0—was not installed on the machine at the time the ArcGIS Engine Runtime setup was originally run.

If the value displayed is "DotNetRuntime"="ArcEngine" then DotNetRuntime is installed. Proceed with the installation of your application.

If the value displayed is "DotNetRuntime"="|ArcEngine" or "DotNetRuntime"="ArcEngine" then DotNetRuntime is not installed. Proceed to Step 2.

Launch the ArcGIS Engine Runtime setup at the end of an MSI-based setup, within a batch file, or within a scripted setup.

If your application requires the Java Runtime or DotNetRuntime features of the ArcGIS Engine Runtime, you will need to install them using the ADDLOCAL Windows Installer command within your script. For example:

ADDLOCAL=DotNetRuntime
or
ADDLOCAL=JavaRuntime

If you choose to install only the DotNetRuntime or JavaRuntime feature, and the core ArcGIS Engine Runtime ( ArcEngine feature) does not exist on the target machine, the setup will automatically install the ArcEngine feature as well as the Java and .NET features. The .NET feature, is included in the complete install if the .NET Framework is detected on the target machine.

Launching the ArcGIS Engine Runtime installation at the end of an MSI-based setup

Launching the ArcGIS Engine Runtime installation program at the end of an MSI-based setup is an example of installing the necessary ArcGIS Engine runtime features without having your user perform the installation themselves directly from the ESRI-provided ArcGIS Engine Runtime CD. The following example illustrates this particular installation mechanism.

In example 1, the ArcGIS Engine Runtime setup launches once your end user clicks Finish to complete the installation of your application. The MSI authoring tools included with Wise for Windows Installer are used to add custom actions behind the Finish button. This example assumes that the ArcGIS Engine Runtime setup resides in the same location as your application’s setup program. In this case, setup.exe resides in a folder named ArcEngine

Example 1 (ArcGIS Engine Runtime 9.x is required.)

Follow these steps to launch the setup.exe file for ArcGIS Engine Runtime when it’s located in an ArcEngine folder on your application’s media:

Create Properties MSI_PATH and ArcEngineExists and initialize them to 1 in the Property table.
Perform a system check for ArcGIS Engine Runtime at the beginning of your setup program. The system check should search for the RealVersion registry key and set the property ArcEngineExists to True if the registry value returned is 9.x (for applications built on 9.x).

HKEY_LOCAL_MACHINE\Software\ESRI\ArcGIS Engine Runtime
Create a Custom action called Launch_Engine_MSI. Use the Execute Program From Path type of custom action. Set the Property in this custom action to MSI_PATH. The path to execute the program from is the path specified in the Property field—in this case, MSI_PATH. Leave Command Line blank, as setup.exe is being launched.
In the Exit dialog box of your application’s setup program, add two actions behind the Finish button control.

The first action sets the MSI_PATH property to [ SourceDir ]ArcEngine\setup.exe. This will change depending on where the ArcGIS Engine Runtime setup is located on the media. In this example, setup.exe is located on the CD in a folder named ArcEngine.

The second action calls the Launch_Engine_MSI that you previously created.

Both of these custom actions should execute only if the property ArcEngineExists does not equal True.

MSI_PATH will change depending on where the ArcGIS Engine Runtime setup is located on the media. In this example, Setup.msi is located on the CD in a folder named ArcEngine.

Example 2 (ArcGIS Engine Runtime 9.0 or 9.1 and a service pack are required.)

In this example, ArcGIS Engine Runtime and a service pack are required by your application. This example results in two scenarios. Scenario 1 takes into account the users that do not have ArcGIS Engine Runtime and the service pack installed. Scenario 2 takes into account the users that have ArcGIS Engine Runtime installed but do not have the service pack installed. Both these scenarios will require the following on your CD:

An admin installation that has been patched with the service pack.
The required ArcGIS Engine Runtime service pack ( msp file). The custom actions for scenarios 1 and 2 (described in the steps below) can be combined in the Finish button of your application’s setup program. The Finish button of your application’s setup program can then deal with both of these scenarios.

For scenario 1, you will have to provide an admin installation on the CD that consists of the original .msi file that has been patched with the required service pack. When deploying ArcGIS Engine Runtime in this particular deployment method, you cannot launch the original setup.msi file followed by a .msp file (service pack file).

On your CD you must provide an admin installation of ArcGIS Engine Runtime with the service pack applied. This will create a patched setup.msi file that you can install on your user’s machine. The patched setup.msi file will contain both the entire ArcGIS Engine Runtime files and those files updated by the service pack. This is required for those users that do not have ArcGIS Engine Runtime and the required service pack on their machine.

To create an admin installation:

Install ArcGIS Engine Runtime using the following command line:
msiexec /a <Engine Runtime CD>\ setup.msi
Apply the service pack to this admin location using the command line (in the following example, Engine 9.0 service pack 1 is applied):
msiexec /a <location of admin installation>\setup.msi /p <location of msp file>ArcGISEngine90sp1.msp REINSTALL=ALL REINSTALLMODE= omus
Copy the entire contents of your admin installation—which will now have the service pack applied—to your application’s CD for redistribution.

Follow these steps to launch the setup.exe file for ArcGIS Engine Runtime when it’s located in an ArcEngine folder on your application’s media:

Create Properties MSI_PATH and ArcEngineExists and initialize them to 1 in the Property table.
Perform a system check for ArcGIS Engine Runtime at the beginning of your setup program. The system check should search for the RealVersion and SPNumber registry key and set the property ArcEngineExists to True if the registry values returned match your requirement.
Create a custom action called Launch_Engine_MSI. Use the Execute Program From Path type of custom action. Set the Property in this custom action to MSI_PATH. The path to execute the program from is the path specified in the Property field—in this case, MSI_PATH. Leave Command Line blank, as setup.exe is being launched. In the Exit dialog box of your application’s setup program, add two actions behind the Finish button control.

In the Exit dialog box of your application’s setup program, add two actions behind the Finish button control.

The first action sets the MSI_PATH property to [ SourceDir ]ArcEngine\Setup.exe. This will change depending on where the ArcGIS Engine Runtime setup is located on the media. In this example, Setup.exe is located on the CD in a folder named ArcEngine. The setup.exe file will be the admin installation with the required service pack applied.

The second action calls the Launch_Engine_MSI that you previously created.

Both these custom actions should execute only if the property ArcEngineExists does not equal True. ArcEngineExists should equal True only if ArcGIS Engine Runtime and the service pack are detected on the target machine.

For scenario 2, you will have to provide the required ArcGIS Engine Runtime service pack (. msp file) on the CD. When deploying ArcGIS Engine Runtime in this particular deployment method, your user will have ArcGIS Engine Runtime already on the target machine, and only the service pack is required.

Follow these steps to launch the ArcGIS Engine Runtime service pack when it’s on your application’s media:

Create Properties MSP_PATH, MSIEXEC_PATH, and InstallSP and initialize them to 1 in the Property table.
Perform a system check for ArcGIS Engine Runtime and the service pack at the beginning of your setup program. The system check should search for the ArcGIS Engine Runtime RealVersion registry key and SPNumber registry key. The InstallSP property should be set to True if the RealVersion registry key value matches your requirement, but the SPNumber registry key value does not match your requirement. In this case, the machine has the ArcGIS Engine Runtime product installed but does not have the required service pack.
Create a custom action called Launch_Engine_SP_1. You can change the number to whichever version of the ArcGIS Engine Runtime service pack your application requires. This example is installing ArcGIS Engine Runtime service pack 1. This custom action will launch the service pack (. msp file) using the following syntax:

msiexec.exe /p <location of service pack>\ArcGISEngine90sp1.msp /qn
Use the Execute Program from Path type of custom action. Set the Property in this custom action to MSIEXEC_PATH. The path to execute the program from is the path specified in the Property field, in this case MSIEXEC_PATH. The command line will be [MSP_PATH]. MSP_PATH is the path to the ArcGIS Engine Runtime service pack 1 . msp file that will be available on the media. Using the above syntax, MSIEXEC_PATH will be [ SystemFolder ]msiexec.exe. MSP_PATH will be /p <location of service pack>\ArcGISEngine90sp1.msp /qn. These two properties will be defined in the Exit dialog box’s Finish button.
In the Exit dialog box of your application’s setup program, add three actions behind the Finish button control.
The first action sets the MSIEXEC_PATH property to [ SystemFolder ]msiexec.exe.
The second action sets the MSP_PATH to /p [ SourceDir ]ArcEngine\ArcGISEngine90sp1.msp /qn. MSP_PATH will change depending on where the ArcGIS Engine Runtime service pack is located on the media. In this example, ArcGISEngine90sp1.msp is located on the CD in a folder named ArcEngine.
The third action calls the Launch_Engine_SP_1 that you previously created.

These three custom actions should execute only if the property LaunchSP does not equal True.

Launching the ArcGIS Engine Runtime installation within a scripted setup

A second way you can install ArcGIS Engine Runtime within your own application is via a scripted setup that utilizes the available command-line parameters. The example script below was created using the Wise InstallMaster setup authoring software. It includes the installation of ArcGIS Engine Runtime and service pack 1.

Rem Set variable
Set variable MSI_PATH to <CDROM>\ArcEngine\setup.msi
Set variable MSP_PATH to <CDROM>\ArcGISEngine90sp1.msp
Rem launch ArcGIS Engine Runtime setup program silently – No UI
Execute %SYS32%\msiexec.exe /i %MSI_PATH% /qn (Wait)
Rem launch ArcGIS Engine Runtime service pack silently – No UI
Execute %SYS32%\msiexec.exe /p %MSP_PATH% /qn (Wait)
Launching the ArcGIS Engine Runtime installation within a batch file

Yet another way that the ArcGIS Engine Runtime setup can be combined with your application’s installation program is within batch files. The following example again takes advantage of the available command-line parameters and implements them within a batch file rather than a scripted setup. This example includes the installation of ArcGIS Engine Runtime and service pack 1.

REM ############################
REM Set variables
SET MSI_PATH=<CDROM>\ArcEngine\Setup.msi
SET MSP_PATH=<CDROM>\ArcGISEngine90sp1.msp
REM ############################
REM Launch MSI Silently - NO UI
msiexec.exe /i "%MSI_PATH%" /qn
msiexec.exe /p "%MSP_PATH%" /qn
REM Launch MSI Silently - Reduced UI
msiexec.exe /i "%MSI_PATH%" /qb
msiexec.exe /p "%MSP_PATH%" /qb
REM Launch MSI Silently - No UI except for a modal dialog box displayed at the end.
>msiexec.exe /i "%MSI_PATH%" /qn+
msiexec.exe /p "%MSP_PATH%" /qn+

The following examples also show the use of a batch file; however, these illustrate the command-line parameters that should be used to install the ArcGIS Engine Runtime Java or .NET features, respectively:

JavaRuntime:
      REM ############################
      REM Set variables
      SET MSI_PATH=<CDROM>\Setup.msi
      REM ############################
      REM Launch MSI Silently - NO UI msiexec.exe /i "%MSI_PATH%" /qn ADDLOCAL= JavaRuntime
DotNetRuntime:
      REM ############################
      REM Set variables
      SET MSI_PATH=<CDROM>\Setup.msi
      REM ############################
      REM Launch MSI Silently - NO UI
      msiexec.exe /i "%MSI_PATH%" /qn ADDLOCAL= DotNetRuntime

ArcGIS Engine Runtime Start Menu Shortcuts

By default, a complete installation of ArcGIS Engine Runtime 9.1 or later will create the following shortcuts on the ArcGIS start menu:

Software authorization
Authorization summary

The following command-line parameters provide options to not display these shortcuts on the start menu.

SHORTCUTS = YES This option will install the shortcuts.

SHORTCUTS = NO This option will not install the shortcuts.

In the following example, ArcGIS Engine Runtime is installed silently without shortcuts:

msiexec.exe / i <location of setup>\ setup.msi /qn SHORTCUTS=NO

Uninstalling ArcGIS Engine Runtime

These are some points to consider before uninstalling ArcGIS Engine Runtime:

ArcGIS Engine Runtime should be uninstalled using the Control Panel, not by deleting files from disk.
Do not uninstall ArcGIS Engine Runtime during the uninstallation of your developed application.
You should recommend strongly to your users that they manually uninstall ArcGIS Engine Runtime only when they know there are no third-party applications using it.