ArcGIS 10.1 Engine Developer Kit and ArcGIS 10.1 Engine Quick Start Guide

Table of Contents

System requirements

Download, extract, and install ArcGIS 10.1 Engine Developer Kit and Engine

Upgrade ArcGIS 10.0 licenses to 10.1

Authorize ArcGIS 10.1 Engine Developer Kit and Engine

Authorize ArcGIS 10.1 Engine Developer Kit and Engine Single Use

Authorize ArcGIS 10.1 Engine Concurrent Use

Borrowing and returning licenses

More information about ArcGIS

Getting support

System requirements

• Prior to installing, please review the ArcGIS Engine system requirements
• Note: The Microsoft .NET Framework 3.5 SP1 is required to install ArcGIS 10.1 Engine on Windows. The Microsoft .NET Framework 3.5 SP1 setup can be downloaded from Microsoft.

Download, extract, and install ArcGIS 10.1 Engine Developer Kit and Engine

Windows

1. To begin development of ArcGIS Engine-based applications for Windows, you will need to install the following:
   • ArcGIS Engine—This will install the necessary ArcObjects libraries for the development of custom solutions with .NET, Java, and/or C++.
   • An ArcObjects SDK—There are three choices for ArcObjects development in Windows. You can install the .NET, Java, and/or C++ SDKs. The different SDKs provide the necessary API reference, documentation, and samples to help you get started with ArcGIS Engine development.
2. Make sure you have write access to your download directory location as well as your ArcGIS installation directory location, and that no one is accessing it.
3. Existing users previous to ArcGIS 10.1: Use the ArcGIS Uninstall Utility, available on the Esri Customer Care Portal, to locate and automatically remove previous ArcGIS 9.x or 10.x products that are installed on your machine.
4. Click on the product's download link on Esri's Customer Care Portal. Recommended: Use the Esri Download Manager to manage your 10.1 downloads.
   Caution:

   When downloading with the Esri Download Manager, you can select and download multiple products. However, only one product should be started at a time when the downloads are complete.

5. The first panel of the extraction wizard will allow you to indicate the location on your computer to which you would like the installation files extracted. When satisfied, click OK.
   Note:

   If you choose to change the destination location when starting the .exe (either from the Launch option in the Esri Download Manager or running the downloaded self-extracting .exe manually), be sure to choose a unique location to extract the files.

6. You will be notified when the file extraction is complete. To automatically install the software, leave the Launch the setup program check box on the final panel of the extraction wizard checked. To install the software at a later time, uncheck the check box. You can install the software at any time by browsing to the product's extracted location and running the setup.exe. The setup program will guide you through the installation process.
   Note:

   Administrative privileges will be required for installing the ArcGIS software product. If you do not have the necessary privileges, an administrator on your system can install the software by running the setup.exe at the product's extracted location.

Linux

1. To begin development of ArcGIS Engine-based applications for Linux, you will need to install the following:
   • ArcGIS Engine—This will install the necessary ArcObjects libraries for the development of custom solutions with Java and/or C++.
   • An ArcObjects SDK—There are two choices for ArcObjects development on Linux. You can install the Java and/or C++ SDKs. Each SDK provides the necessary API reference, documentation, and samples to help you get started with ArcGIS Engine development.
2. Click on the product's download link on Esri's Customer Care Portal.
3. Save the file to a disk location large enough to hold both the gzip file and the tar file.
   Note:

   If you are installing more than one ArcGIS 10.1 product, please place each gzip file in a separate directory before expanding and extracting the tar file; otherwise, the Documentation directory, support directory, Setup script, and install.htm files will be overwritten.

4. Make sure you have read-write-execute (rwx) access to your intended ArcGIS installation location.
5. gunzip the ArcGIS 10.1 file for your platform to get the tar file. At the prompt, type % gunzip <file_name>.tar.gz.
6. Extract the product tar file to create the installation directory: % tar xvf <file_name>.tar.
7. Change to the extracted installation directory (cd) and run the provided ./Setup script to install the ArcGIS 10.1 product. The setup program will guide you through the installation process.

Upgrade ArcGIS 10.0 licenses to 10.1

For existing ArcGIS 10.0 users, automatic license upgrade functionality has been introduced at ArcGIS 10.1 which allows for a much easier license upgrade process. Instead of deauthorizing older licenses and authorizing the latest version, users can convert their existing 10.0 licenses to 10.1 using the one-step upgrade option.

1. Uninstall the ArcGIS 10.0 product without deauthorizing your existing licenses.
2. Install ArcGIS 10.1.
3. On completion of the ArcGIS 10.1 Engine Developer Kit installation, click Authorize. This will prompt you to upgrade your licenses if 10.0 licenses are already present. For ArcGIS 10.1 Engine, you will need to launch the ArcGIS Administrator manually either from the Start menu or from the command line as indicated in the section below. Follow the instructions to complete the upgrade process.

Authorizing ArcGIS 10.1 Engine Developer Kit and Engine

Note:

ArcGIS 10.1 software requires 10.1 authorization numbers which can be obtained from the Authorization and Provisioning page on the Esri Customer Care Portal. The copy protection mechanism for ArcGIS 10.1 for Desktop and ArcGIS 10.1 Engine Concurrent Use product lines has been updated to use the FlexNet Publisher v11.10 software. This update requires that ArcGIS 10.1 License Manager is installed for Concurrent Use licenses.

ArcGIS 10.1 Engine can be authorized by Single Use licenses, or by connecting to a License Manager which is authorized with 10.1 Concurrent Use licenses. Please see the ArcGIS 10.1 License Manager Quick Start Guide for more information on setting up a License Manager.

Authorize ArcGIS 10.1 Engine Developer Kit and Engine Single Use

Note:

• Recommended: Use an Internet connection to complete the authorization steps below.
• If you do not have an Internet connection for the machine on which you intend to install the software, you can authorize the software via e-mail or via the Esri Customer Care Web site.
• If you want to facilitate the authorization process or authorize silently, a provisioning file generated from the Authorizing and Provisioning portal on the Esri Customer Care site can be used.

1. After the installation, open the ArcGIS Administrator wizard.
   • Windows: Click Start > Programs > ArcGIS > ArcGIS Administrator.
   • Linux: Open the Software Authorization wizard for ArcGIS Engine from the following product installation location:

     <install path>/arcgis/engine10.1/./authorizeSoftware

2. Select the desired Single Use product in the ArcGIS Administrator wizard.
   • Select the ArcGIS Engine (Single Use) option if you only need to run Engine applications.
   • Select the ArcGIS Engine and ArcGIS Engine Developer Kit (Single Use) option if you need to develop and run Engine applications.
3. Click Authorize Now
4. Select the default option I have installed my software and need to authorize it.
5. Select Authorize with ESRI now using the Internet. If using a provisioning file, select the option I have received an authorization file from ESRI and browse to the file.
6. Enter your personal information where applicable.
7. Enter your core product authorization number (ESUxxxxxxxxx). See the Authorization and Provisioning page on the Esri Customer Care Portal to obtain this if you do not have this number available to you.
8. Enter the authorization numbers for extensions if applicable.
9. Click Finish after the authorization process is complete.
10. Click OK to close the ArcGIS Administrator. Your software is now ready for use.

Authorizing additional extensions for ArcGIS 10.1 Engine Single Use

This applies if you have already authorized your ArcGIS 10.1 Engine Single Use software and wish to authorize additional extensions later. Follow the steps for Authorizing ArcGIS 10.1 Engine Developer Kit and Engine Single Use, and at step 3 select I have already authorized the software and need to authorize additional extensions. Step 6 will not be applicable. At step 7, you will be given the opportunity to enter your authorization numbers for the applicable extensions.

Authorize ArcGIS 10.1 Engine Concurrent Use

Defining the license manager

1. After the installation, open the ArcGIS Administrator wizard.
   • Windows: Click Start > Programs > ArcGIS > ArcGIS Administrator.
   • Linux: Run the authorization wizard from the following product installation location: <install path>/arcgis/engine10.1 ./authorizeSoftware.
2. Select ArcGIS Engine Runtime (Concurrent Use) in the ArcGIS Administrator wizard and specify the name of your license manager.
3. Once you have set your license manager, click OK to close the ArcGIS Administrator wizard. Your software is now ready for use.

Borrowing and returning licenses

Borrowing licenses

If you need to work while away from your network, you can borrow the core product and any necessary extensions currently available on your license manager. The default borrow time-out is 30 days. Contact your license administrator to modify this time-out date.

1. After installing the software and defining the license manager, open the ArcGIS Administrator.
   • Windows: Click Start > Programs > ArcGIS > ArcGIS Administrator.
   • Linux: Run the authorization wizard from the following product installation location: <install path>/arcgis/engine10.1/./authorizeSoftware.
2. Select the Engine product folder from the table of contents.
3. Select the Borrow/Return folder, check the boxes next to the features you want to borrow, then click Apply.
4. Once the features have been borrowed, click OK to close the ArcGIS Administrator.

Returning licenses

1. Open the ArcGIS Administrator.
   • Windows: Click Start > Programs > ArcGIS > ArcGIS Administrator.
   • Linux: Run the authorization wizard from the following product installation location: <install path>/arcgis/engine10.1/./authorizeSoftware.
2. Click the Borrow/Return folder.
3. Uncheck the boxes next to the features you have borrowed and click Apply.
4. Click OK to close the ArcGIS Administrator.

If you have not returned your licenses before they expire, they will automatically be disabled on your machine after the expiration date and returned to the license manager.

More information about ArcGIS

More information and assistance for ArcGIS products are available via the ArcGIS Resource Center. Use the Resource Centers website as your portal to ArcGIS resources, such as finding out what's new at the ArcGIS 10.1 release, help, forums, blogs, downloads, samples, and knowledge base articles.

Getting support

Your Esri office or distributor provides support of ArcGIS 10.1. For your Esri office or distributor's contact information, please visit http://support.esri.com/en/phoneSupport.