Create a Local Server deployment

Local services allow you to deploy services that run locally with your app to provide functionality like geoprocessing, routing, and so on. In ArcGIS Runtime SDK for .NET, local services are only available for Windows Presentation Framework (WPF) apps. An app built for another ArcGIS Runtime for .NET platform can use such functionality from an online service, but not locally.

Deploying Local Server

The first time you build a project that uses Local Server, a deployment manifest file will be created in your project directory (ArcGISLocalServer.AGSDeployment).

Note:

The ArcGISLocalServer.AGSDeployment file is created in your project directory, but is not added to your Visual Studio project. To see it listed in the Solution Explorer window, you will need to choose to Show All Files.

This is an XML-formatted text file that defines the components of Local Server to deploy for your app. By default, only the basic Local Server component is included. To include additional capabilities, you need to edit this file manually. Only those Local Server packages with an enabled value of true will be included in the deployment. The following example shows an edit that adds support for Python scripts and geoprocessing tools.
<!--Provides the ability to use Python scripts.-->
<Package name="Python Scripting" enabled="true">
  <ChildPackages>
    <!--Provides support for Geoprocessing tools that use python-->
    <Package name="Python Geoprocessing tools" enabled="true" />
  </ChildPackages>
</Package>
When you build your project, the components you have enabled in ArcGISLocalServer.AGSDeployment will be included in the output for the platform you're building. If building for 64-bit, for example, the requested Local Server components will be copied to your project's output folder under LocalServer100.1\64\.. If building for Any CPU (and Prefer 32-bit is unchecked in your project build properties), you will have a 32 and a 64 folder under the LocalServer100.1 parent folder.

Local Server deployment folders

Apart from installing the Local Server SDK and ensuring you have edited ArcGISLocalServer.AGSDeployment to include the components you need, there are no additional steps for deploying Local Server capabilities for your ArcGIS Runtime SDK for .NET app.

Caution:

If you run local services based on map documents, and those map documents use third-party fonts, then you must make sure that those third-party fonts are installed on each client machine where those services will run. Otherwise, the corresponding local service may fail to start or may fail to render symbols that use those fonts.

ArcGIS Runtime components

The ArcGIS Runtime components available to include in your Local Server deployment are described in the following table.

OptionDescription

Microsoft C and C++ Runtime Libraries

Including Microsoft C and C++ libraries in the runtime deployment allows for XCopy style deployments. Only include these if your setup is not installing the Microsoft redistribution package.

Local Server

Required if your application uses any local services. This is enabled by default when you initially add the Local Server package to your project.

Geoprocessing

Provides the ability to perform geoprocessing tasks via geoprocessing packages. For a list of supported tools, see Supported geoprocessing tools.

3D Analyst extension

Required for any geoprocessing packages that make use of 3D Analyst tools.

Map packaging

Adds data consolidation, map packaging and create runtime content tools.

Map Server Results

Required to add geoprocessing results as map services.

Network Analyst extension

Required for any geoprocessing packages that make use of Network Analyst tools.

Spatial Analyst extension

Required for any geoprocessing packages that make use of Spatial Analyst tools.

Python Scripting

Provides the ability to use Python scripts.

Python geoprocessing tools

Provides support for geoprocessing tools that use Python.

Additional data formats

Provides additional vector file data format and raster file data format support.

Raster

Provides additional raster file data format support. For a list of supported rasters, see Supported raster dataset file formats.

ECW Rasters

Provides support for ECW format raster.

Mosaic Rasters

Provides support for raster mosaic layers.

Vector

Provides additional vector file data format support such as the ability to use shapefiles.

SDE

Adds support to allow you to connect directly to enterprise geodatabases. This option must be selected in conjunction with at least one of the following DBMSs: Alitbase, Dameng, DB2, Informix, Netezza, Oracle, PostgreSQL, SAP HANA, SQL Server, SQLite, or Teradata. The drivers for the specified database must be present on the target machine.

Additional projection engine transformations

Adds additional projections and geotransformations. For more information on coordinate systems, see Spatial references.

Debug

Supports debugging of your deployed app. Should be used for testing only, and not included in your final app deployment.

Logging

Supports writing log messages from your running app.