Adding a new service

ArcGIS Server 9.3 offers seven service types: map, geocode, geodata, geometry, geoprocessing, globe, and image. Before you can create a service, you must create the GIS resource that it will access. For example, a map service uses a map document, so you must create the map document before creating the service.

This chart summarizes the GIS resource required for each type of service.

Choosing how you will publish the service

There are two ways to create services in ArcGIS Server. In Manager, these options are Publish a GIS Resource and Add New Service. Choosing Add New Service allows you to set all the service properties at the time you create the service. In contrast, Publish a GIS Resource only prompts you for the minimum required information.

When you choose Add New Service you can only create one type of service at a time. For example, if you have a map document with a tool layer that you want to use to publish both a map service and a geoprocessing service, you must create the services individually if you use Add New Service. If you choose Publish a GIS Resource, you have the option to create the two services at the same time.

The following instructions explain how to use the Add New Service option. For help with using Publish a GIS Resource see Publishing a GIS resource to the server.

Note: When you choose Publish a map, globe, or other GIS resource as a service on the Home tab in Manager, this opens the Publish a GIS Resource wizard.

How to add a new service using Manager

1. In Manager, click the Services tab.

2. Click Add New Service.

   Note: If this is the first time you're accessing the server, you'll need to add one or more server object container (SOC) machines to it before you can add a service.

   Learn more about adding SOC machines.

3. Type the name of the service. This is the name people will see and use to identify the service. Be descriptive. The name can only contain alphanumeric characters and underscores. No spaces or special characters are allowed. The name cannot be more than 120 characters in length.
4. Click the Type drop-down arrow, click the service type, then click Next.
5. Set the initialization parameters by following the instructions below that pertain to the type of service you're creating:
   • If you're creating a map service, browse to the map document and choose the data frame to display. Optionally, specify an output directory and a cache directory.
   • If you're creating a geocode service, browse to the locator and set the batch size. Click Next.

   • If you're creating a geodata service, choose whether you want to create the service directly from a geodatabase or from a map document containing a layer from a geodatabase. If you are creating the service from the geodatabase directly, browse to the file geodatabase, personal geodatabase, or database connection file you'll be using. When you make a database connection in ArcCatalog, the connection information is stored in your profile directory (Example: C:\Documents and Settings\<username>\Application Data\ESRI\ArcCatalog\Connection to myServer.sde). It's a good idea to copy this file into a shared network directory to which all your container machines have read access. When creating the service, browse to this shared directory and choose the connection file.

     If you're publishing the service from a map document containing a geodatabase layer, browse to that map document.

     Once you've browsed to the database or map document, specify an output directory.

   • If you're creating a geometry service, there is no GIS resource to specify, so the second page of the wizard is skipped.

   • If you're creating a geoprocessing service, first choose whether the job will be performed synchronously (optimal for short jobs) or asynchronously (optimal for long jobs, and the results are stored on the server for future retrieval). Then, browse to either the toolbox or the map document containing the tool layer you want to publish. The results of the service can optionally be returned to the client as a map service, which you can choose from the Result Map Service drop-down list.

     A geoprocessing service uses a jobs directory, which you must specify, as well as an associated virtual directory. For the jobs directory to be available, you must have specifically created it as a jobs directory using the Directories tab on the Server Properties dialog box. You'll also need to specify a server output directory in the same way.

   • If you're creating a globe service, browse to the globe document you want to use, then specify the precreated globe cache location and virtual directory.
   • If you're creating an image service, browse to the raster dataset, layer file referencing a raster dataset, or compiled image service definition (.ISCdef) file that you want to publish. Optionally, choose an output directory.

6. If the type of service you chose has any available capabilities, a new page will appear where you can choose the capabilities you want to enable and set their properties. On this page, you can also choose whether Web access will be available for the service and the allowed operations for that Web access.

   Learn more about operations (See the section "Limiting what users can do with a service")

7. Click Pooled or Not Pooled and optionally change the maximum usage and wait times. Click Next.
8. Set the process isolation level and the recycling parameters. Click Next.
9. Review the information about the service that will be created and click Finish.
10. Verify that your service is working properly. If the service is started and working correctly, you should be able to see a thumbnail image on the Services tab in Manager when you click the plus (+) button next to the service name. If, for some reason, your service is not working as expected, you can review the log files for errors. Note that log files refer to services as server objects.

How to add a new service using ArcCatalog

1. Create an administrative connection to the GIS server on which you want to add a service.

2. Right-click the server or folder to which you want to add the service and click Add New Service.

   Note: If this is the first time you're accessing the server, you'll need to add one or more server object container (SOC) machines to it before you can add a service.

   Learn more about adding SOC machines.

3. Type the name of the service. This is the name people will see and use to identify the service. Be descriptive. The name can only contain alphanumeric characters and underscores. No spaces or special characters are allowed. The name cannot be more than 120 characters in length.
4. Click the Type drop-down arrow, click the service type, then click Next.
5. Set the initialization parameters by following the instructions below that pertain to the type of service you're creating:
   • If you're creating a map service, browse to the map document and choose the data frame to display. Optionally, specify an output directory and a cache directory.
   • If you're creating a geocode service, browse to the locator and set the batch size. Click Next.

   • If you're creating a geodata service, choose whether you want to create the service directly from a geodatabase or from a map document containing a layer from a geodatabase. If you are creating the service from the geodatabase directly, browse to the file geodatabase, personal geodatabase, or database connection file you'll be using. When you make a database connection in ArcCatalog, the connection information is stored in your profile directory (Example: C:\Documents and Settings\<username>\Application Data\ESRI\ArcCatalog\Connection to myServer.sde). It's a good idea to copy this file into a shared network directory to which all your container machines have read access. When creating the service, browse to this shared directory and choose the connection file.

     If you're publishing the service from a map document containing a geodatabase layer, browse to that map document.

     Once you've browsed to the database or map document, specify an output directory.

   • If you're creating a geometry service, there is no GIS resource to specify, so the second panel of the wizard is skipped.

   • If you're creating a geoprocessing service, first choose whether the job will be performed synchronously (optimal for short jobs) or asynchronously (optimal for long jobs, and the results are stored on the server for future retrieval). Then, browse to either the toolbox or the map document containing the tool layer you want to publish. The results of the service can optionally be returned to the client as a map service, which you can choose from the Result Map Service drop-down list.

     A geoprocessing service use a jobs directory, which you must specify, as well as an associated virtual directory. For the jobs directory to be available, you must have specifically created it as a jobs directory using the Directories tab on the Server Properties dialog box. You'll also need to specify a server output directory in the same way.

   • If you're creating a globe service, browse to the globe document you want to use, then specify the precreated globe cache location and virtual directory.
   • If you're creating an image service, browse to the raster dataset, layer file referencing a raster dataset, or compiled image service definition (.ISCdef) file that you want to publish. Optionally, choose an output directory.

6. If the type of service you chose has any available capabilities, a new page will appear where you can choose the capabilities you want to enable and set their properties. On this page, you can also choose whether Web access will be available for the service and the allowed operations for that Web access.

   Learn more about operations (See the section "Limiting what users can do with a service")

7. Click Pooled or Not Pooled and optionally change the maximum usage and wait times. Click Next.
8. Set the process isolation level and the recycling parameters. Click Next.
9. Click Yes to start the server object now and click Finish.
10. Verify that your service is working properly. You can preview or display the properties of a service in ArcCatalog to ensure that the service is correctly configured. If, for some reason, your service is not working as expected, you can review the log files for errors. Note that log files refer to services as server objects.