Install and set up

Install on Windows

1. Ensure that your development machine meets the system requirements. Development and deployment machines must also have

   Microsoft Visual C++ 2015-2022 Redistributable version 14.33.31629 or higher

   installed or deployed.

2. Download the ArcGIS Maps SDK for Local Server Windows setup from your ArcGIS Developer dashboard and save the file to a location on your development machine. You will need to sign in to your dashboard or create an ArcGIS Developer account.

3. Double-click the executable (.exe) file in the location where you downloaded the installer to extract the installation files.

4. Click Next to accept the default destination folder where the installation files will be extracted or click Browse to select a different destination folder then click Next.

5. When the file extraction completes ensure the Launch the setup program check box is checked then click Close to continue the installation process.

6. Click Next on the Welcome to the ArcGIS Maps SDK for Local Server Setup program window.

7. Review the license agreement and choose an option:

   • If you agree to the terms, select the option to accept the agreement and click Next.
   • If you do not agree to the terms, click Cancel to exit the installation.

8. Click Next to accept the default location of <System Drive>\Program Files\ArcGIS SDKs\LocalServer<version>\ or click Change to specify a different destination folder then click Next.

9. Click Install.

10. Click Finish. The Local Server SDK installation is complete.

Install on Linux

1. Ensure that your development machine meets the system requirements.

2. Download the ArcGIS Maps SDK for Local Server Linux setup from your ArcGIS Developer dashboard and save the file to a location on your development machine. You will need to sign in to your dashboard or create an ArcGIS Developer account.

3. Using an archive manager extract the arcgis_maps_sdk_local_server_200_x_x.tar.gz (where x is the current release number) gzip file to access the tar installer file. Alternatively use the terminal and extract the .tar.gz file with the following example command tar -xvzf arcgis_maps_sdk_local_server_200_1_0.tar.gz.

4. Navigate to arcgis_maps_sdk_local_server_200_x_x and run ./Setup.

5. Click Next on the Introduction dialog of the ArcGIS Maps SDK for Local Server 200.x Setup program to continue the installation.

6. Review the license agreement and choose an option:

   • If you agree to the terms, select the option to accept the agreement and click Next.
   • If you do not agree to the terms, click Cancel to exit the installation.

7. When prompted to Choose Install Folder dialog, click Next accept the default installation location or click the Choose button to select a different destination folder. Make sure this directory is on your development machine and that you have write permissions to this directory. Ensure no other users are using the directory.

8. Review the Pre-Installation Summary then click Install. The installer will now unpack and install Local Server and create Menu shortcuts.

9. Click Done on the Install Complete dialog to finish the Local Server installation.

Local Server environment variable

On your development machine, applications can use the Local Server instance in the installation directory as defined by the RUNTIMELOCALSERVER_200_x environment variable (where x is the current release number). Feel free to set the path location to match the installation's destination folder.

Install database client software for enterprise geodatabase connections

If the geoprocessing or map packages (.gpkx or .mpkx files) used by your application reference enterprise geodatabase connections, then you may need to install client software for the RDBMS (Relational Database Management System) on your development and deployment machines. For more information on supported database types, database versions, and client software required, refer to the ArcGIS Pro documentation topic Supported databases.

If you are using an Enterprise Geodatabase connection which uses ODBC you must modify init_user_params.sh to uncomment the following line:

1
2
3
4
5
#
# Enable this section to point to the native ODBC driver.  Note the path
# may be different on your system.
#
#export LIB_ODBC_DRIVER_MANAGER=/usr/lib64/libodbc.so.2

The exact path may differ depending on your installation. You may need to install the library unixODBC-utf16-2.3.1-1.x86_64 (or a later version).

Include a Local Server deployment with your application

If your application uses Local Server functionality, you must also create a Local Server deployment to include with your deployed application. Refer to Deploy Local Server for more information about deploying Local Server with your Windows and Linux applications.

Next steps

• Introduction

  Learn about Local Server.

• Install and set up

  Install and setup the Local Server SDK.

• Create geoprocessing and map packages

  Create .gpkx and .mpkx files for use with Local Server.

• Use Local Server

  Learn how to use Local Server services.

• Supported geoprocessing tools

  Check the tools you need are supported.