Managing the jobs directory

One of the properties of a geoprocessing service is the Jobs Directory. You can create multiple job directories and use different ones for different services.

Choosing a jobs directory

When a task within the service is executed, ArcGIS Server creates a folder for the task within the jobs directory, shown as <unique job id> in the illustration below. Within this task folder is a scratch folder and a scratch file geodatabase. The geoprocessing scratch workspace environment is set to the location of the scratch folder. You write your intermediate and output data to the scratch folder or the scratch geodatabase.

  • If your server configuration includes multiple computers on your local area network (LAN), the jobs directory for a service must be a shared directory accessible by all computers in your configuration. This means that when you publish your service, the jobs directory for your service will be the UNC path to this shared jobs directory.
  • If your server configuration includes multiple computers on your LAN, you will want to check Local Jobs Directory to improve performance.

    Learn more about the local jobs directory

Intermediate and output data location

Job directories have a cleaning mode and schedule

Each job directory has a cleaning mode and schedule. The schedule is in minutes. The cleaning mode can be one of the following:

The mode and schedule are the instructions ArcGIS Server uses to delete the task folder created for each task execution. It is up to you to determine an appropriate cleaning mode and schedule. For example:

Creating and editing job directories

Setting up job directories is a server administrator task. However, as the creator of a service, you may need to know how to set up a new job directory. The basic steps are as follows:

  1. Create a directory in the file system and configure its sharing and permissions. If you want the contents accessible via the Web, you will need to create a virtual directory as well.

    Learn more about creating a server directory

  2. In the Catalog window or ArcCatalog, navigate to your server and stop all services.
  3. In the Catalog tree, right-click the server and click Server Properties.
  4. On the ArcGIS Server Properties dialog box, choose Jobs Directory as the directory type, as illustrated below.
  5. Click Add.

    Server Directories

  6. In the Add Server Directory dialog box, do the following:
    1. Enter the name of the file system directory.
    2. Enter the name of the virtual directory, if any.
    3. Add a description if desired.
    4. Choose a cleaning mode (described above).
    5. Choose a maximum file age.
    6. Click OK.
    Add job directory dialog box
  7. After adding a new job directory, you can edit any of the geoprocessing services and change their job directories.

Related Topics