18.04.2015 Views

ArcGIS Engine Developer Guide

ArcGIS Engine Developer Guide

ArcGIS Engine Developer Guide

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

INSTALLING ARCGIS ENGINE RUNTIME ON WINDOWS<br />

Later sections provide examples illustrating each<br />

of these methods of installing the <strong>ArcGIS</strong> <strong>Engine</strong><br />

Runtime.<br />

The later section, ‘Launching the <strong>ArcGIS</strong> <strong>Engine</strong><br />

Runtime installation within a batch file,’ illustrates<br />

the usage of these commands.<br />

If .NET Framework 1.1 is not detected on the<br />

machine, the DotNetRuntime feature will not be<br />

installed.<br />

2. Launch the <strong>ArcGIS</strong> <strong>Engine</strong> Runtime setup at the end of an MSI-based setup,<br />

within a batch file, or within a scripted setup.<br />

If your application requires the Java Runtime or DotNetRuntime features of<br />

the <strong>ArcGIS</strong> <strong>Engine</strong> Runtime, you will need to install them using the<br />

ADDLOCAL Windows Installer command within your script. For example:<br />

ADDLOCAL=DotNetRuntime<br />

or<br />

ADDLOCAL=JavaRuntime<br />

If you choose to install only the DotNetRuntime or JavaRuntime feature, and<br />

the core <strong>ArcGIS</strong> <strong>Engine</strong> Runtime (Arc<strong>Engine</strong> feature) does not exist on the<br />

target machine, the setup will automatically install the Arc<strong>Engine</strong> feature as<br />

well as the selected optional feature. Java is an optional installation feature<br />

and is not installed with a typical <strong>ArcGIS</strong> <strong>Engine</strong> Runtime installation. The<br />

.NET feature, on the other hand, is included in the typical install if the .NET<br />

Framework is detected on the target machine.<br />

Launching the <strong>ArcGIS</strong> <strong>Engine</strong> Runtime installation at the end of an MSI-based<br />

setup<br />

Launching the <strong>ArcGIS</strong> <strong>Engine</strong> Runtime installation program at the end of an<br />

MSI-based setup is an example of installing the necessary <strong>ArcGIS</strong> <strong>Engine</strong> runtime<br />

features without having your user perform the installation themselves directly<br />

from the ESRI-provided <strong>ArcGIS</strong> <strong>Engine</strong> Runtime CD. The following example<br />

illustrates this particular installation mechanism.<br />

In example 1, the <strong>ArcGIS</strong> <strong>Engine</strong> Runtime setup launches once your end user<br />

clicks Finish to complete the installation of your application. The MSI authoring<br />

tools included with Wise for Windows Installer are used to add custom actions<br />

behind the Finish button. This example assumes that the <strong>ArcGIS</strong> <strong>Engine</strong><br />

Runtime setup resides in the same location as your application’s setup program.<br />

In this case, setup.exe resides in a folder named Arc<strong>Engine</strong>.<br />

Example 1 (<strong>ArcGIS</strong> <strong>Engine</strong> Runtime 9.0 or 9.1 is required.)<br />

Follow these steps to launch the setup.exe file for <strong>ArcGIS</strong> <strong>Engine</strong> Runtime<br />

when it’s located in an Arc<strong>Engine</strong> folder on your application’s media:<br />

1. Create Properties MSI_PATH and Arc<strong>Engine</strong>Exists and initialize them to 1 in<br />

the Property table.<br />

2. Perform a system check for <strong>ArcGIS</strong> <strong>Engine</strong> Runtime at the beginning of your<br />

setup program. The system check should search for the RealVersion registry<br />

key and set the property Arc<strong>Engine</strong>Exists to True if the registry value returned<br />

is 9.0 (for applications built on 9.0) or 9.1 (for applications built on<br />

9.1).<br />

HKEY_LOCAL_MACHINE\Software\ESRI\<strong>ArcGIS</strong> <strong>Engine</strong> Runtime<br />

Appendix D • Installing <strong>ArcGIS</strong> <strong>Engine</strong> Runtime on Windows, Solaris, and Linux • 471

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!