ArcGIS Server Banner

Publishing geoprocessing services

Publishing geoprocessing services

Release 9.3 E-mail This TopicPrintable VersionGive Us feedback

To publish any kind of service, you must have administrator access to ArcGIS Server, as illustrated below. Your server administrator—the person in charge of setting up and maintaining accounts for your ArcGIS Server installation—is responsible for setting up an account for you and granting you administrator privileges.

Administrator access

Learn more about connecting to an ArcGIS Server.

Two methods

There are two ways you can create services, as illustrated below.

  1. Publish to ArcGIS Server: Right-click the resource (map document or toolbox) and click Publish to ArcGIS Server.
  2. Add new service: Right-click a server and click Add New Service.

The first method creates the service with the default properties while the second allows you to configure all properties.

Two ways to publish

You can always change service properties after publishing, as follows:

  1. In ArcCatalog, navigate to the server.
  2. Right-click the service and click Stop.
  3. Right-click the service and click Service Properties.
  4. Change properties.
  5. Right-click the service and click Start.

Three service configurations

There are three ways to configure your geoprocessing service, as illustrated below.

Three configurations

NOTE: If you are publishing a geoprocessing service with a source map document, you cannot use the Publish to ArcGIS Server method. Instead, use the Add new service method.

Geoprocessing service

Publish to ArcGIS Server

In ArcCatalog or ArcToolbox, right-click the toolbox and choose Publish to ArcGIS Server. This opens the Publish to ArcGIS Server wizard, as illustrated below.

Publish to ArcGIS Server wizard

Add New Service

  1. In ArcCatalog, right-click an ArcGIS Server and choose Add New Service, as illustrated above. This opens the Add New Service wizard.
  2. Enter a name for the service. The name should not contain spaces.
  3. For Type, choose Geoprocessing Service.
  4. Click Next.
  5. Enter the name of the toolbox, as illustrated below.
  6. Other options on this panel are discussed in the Service properties section below.
  7. Add New Service panel two

  8. Click Next.
  9. If desired, you can disable Web access. Enabling Web access means that clients can connect to your service via a displayed URL.
  10. Click Next.
  11. If needed, you can change pooling and time–out options.
  12. Learn more about pooling and timeout options.

  13. Click Next.
  14. If desired, change how service instances run.
  15. Learn more about isolation and recycling options.

  16. Click Next. This opens the summary panel. You can choose to start the service immediately or start it later.
  17. Click Finish.

Geoprocessing service with a source map document

Publishing to ArcGIS Server

You cannot use this method to publish a geoprocessing service with a source map document. Instead, use the Add New Service method described below.

Add New Service

  1. In ArcCatalog, right-click an ArcGIS Server and choose Add New Service, as illustrated above. This opens the Add New Service wizard.
  2. Enter a name for the service. The name should not contain spaces.
  3. For Type, choose Geoprocessing Service.
  4. Click Next.
  5. Since the tools to be exposed by the geoprocessing service (the tasks) are tool layers in a map document, enable the map option and enter the name of the map document, as illustrated below.
  6. Geoprocessing service with source map document

    Other options on this panel are discussed in the Service properties section below.

  7. Click Next.
  8. If desired, you can disable Web access. Enabling Web access means that clients can connect to your service via a displayed URL.
  9. Click Next.
  10. If needed, you can change pooling and time-out options.
  11. Learn more about pooling and time-out options.

  12. Click Next.
  13. If desired, change how service instances run.
  14. Learn more about isolation and recycling options.

  15. Click Next. This opens the summary panel. You can choose to start the service immediately or start it later.
  16. Click Finish.

Geoprocessing service with result map service

Publishing to ArcGIS Server

  1. In ArcCatalog, right-click the map document and choose Publish to ArcGIS Server. This opens the Publish to ArcGIS Server wizard, as illustrated below.
  2. Publish to ArcGIS Server wizard

  3. Click Next. This opens the capabilities panel, as illustrated below.
  4. Capabilities

    Since you are publishing a map document, the Mapping capability is always enabled—you cannot disable it. Since the map document contains tool layers, the Geoprocessing capability is enabled by default. Because you want to publish a geoprocessing service with a result map service, both Mapping and Geoprocessing must be enabled. All other capabilities are optional.

  5. Click Next.
  6. The next panel of the wizard contains a summary. After clicking Finish, both the geoprocessing service and the result map service are created.

Add New Service

Using the Add New Service method, you can create a geoprocessing service with a result map service by

Although it is possible to create the services in this manner, it is far easier (and less prone to error) to right-click the map document and click Publish to ArcGIS Server, as described above.

Service properties

There are four parameters particular to geoprocessing services:

  1. Execution type—synchronous versus a synchronous
  2. The jobs and output directory
  3. Maximum number of records
  4. Show messages

These parameters can be modified as follows:

  1. Navigate to the server.
  2. Right-click and choose Stop to stop the geoprocessing service.
  3. Right-click the service and click Service Properties.
  4. Click the Parameters tab, as shown below.
  5. Change the desired parameters and click OK.
  6. Right-click the geoprocessing service and click Start.

Geoprocessing service parameters

Execution type

Synchronous means that the client waits until the server has finished executing the task. Asynchronous means that the client is free to do other work while the server executes the task.

NOTE: A geoprocessing service with a result map service cannot be synchronous.

If you change a geoprocessing service to synchronous, the result map service will be set to None.

NOTE: You should choose synchronous only for tasks that execute quickly and will not be subject to any time-outs set by the ArcGIS service or your Internet service.

Learn more about time–outs.

Jobs and output directory

The jobs directory is where ArcGIS Server creates a scratch workspace for your tools. The output directory is where result map service images are created.

Learn more about managing the jobs directory.

Maximum Number of Records Returned by Server

Clients such as ArcGIS Desktop allow users to copy data from the server to their local machine. The number you enter is the maximum number of records or features that can be transferred from the server to the client. A value of zero means no records can be transferred. Be aware that transferring a large number of records can clog the network.

Copying data from the server is allowed even if there is a result map service that draws the data.

Show Messages

Geoprocessing models write messages during the execution of model processes. These messages include warnings, errors, and informational messages. These messages can contain pathnames to data residing on your server or local area network, and you may not want the pathnames to these data to be viewed by users. You can hide these messages by unchecking the Show Messages parameter. When you uncheck Show Messages, all messages are hidden, including warnings and errors.

Modifying a published service

After publishing your service, you may need to make changes to your model or script. After making changes, you need to restart the service—it is not necessary to delete and republish the service. To restart a service

  1. In ArcCatalog, navigate to the server containing your service.
  2. Right-click the service and click Restart.

Restarting is the same as stopping the service and then starting the service.

The only time you need to delete and republish a service is when you want to change the name of the service.

If you are using a tool layer to define tasks in your service and you change any of the parameters of the corresponding model or script, you should re-create the tool layer, as follows:

Changes you make to your tool or tool layer do not take effect until you restart the service. (Note that services have a recycling schedule for automatically restarting services. By default, restarting occurs every 24 hours at midnight. If you make changes but do not restart the service, the changes will be applied when the service is recycled.)

Learn more about starting, stopping, and pausing services.