English

How To: Install and start the geoprocessing server

Summary

This document shows how to install and start the geoprocessing server on Windows and UNIX machines.

Procedure

It is imperative that the user performing the installation has 1)administrative privileges and 2) ownership of the ARCHOME directory.

  1. Installing the Service

    On Windows:

    a. At the DOS prompt, run the command line utility
    %ARCHOME%\bin\gpservice.exe.

    b. Specify the create option and a new password. The default name for the instance is esri_gps(esri_gpsvr for pre-8.1 installations).

    Code:
    C:\arcgis\arcexe82\bin>gpservice -o create -p gps -H C:\arcgis\arcexe82 -i esri_gps


    On UNIX:

    You do not need to install the geoprocessing server on UNIX, you only need to start it. On IBM servers, you must create a link for the server to work:

    Code:
    % su
    #cd /usr/lib
    #ln -s /lib/libgpsvr80.sp libgpsvr80.so

  2. Starting the Service

    On Windows:

    - Make sure the %ARCHOME%\gpserver\services.rqm file contains only one service name. If more than one exists, the Geoprocessing Server will use the first one it encounters.

    - The system services file must have a service name entry that matches the first service name in the %ARCHOME%\gpserver\services.rqm file.

    The system services file is found under:
    C:\WINNT\system32\drivers\etc

    1. Open the Services dialog box from the Windows Control Panel.
    2. Select the Geoprocessing Server service and click Start.
    3. Click Close when the status of the Geoprocessing Server is started.

    On UNIX:

    - Make sure the $ARCHOME\gpserver\services.rqm file contains only one service name. If more than one exists, the Geoprocessing Server will use the first one it encounters.

    - The system services file must have a service name entry that matches the first service name in the %ARCHOME%\gpserver\services.rqm file.

    The system services file is found under:
    UNIX - /etc

    1. Make sure ROOT owns the arcrqmgr executable located in
    %ARCHOME%\bin
    2. Set the permissions for this executable to 6755.
    3. Set ROOT to have write access to $ARCHOME
    4. Start the server from the same login account that installed it.
    5. Run the command line utility $ARCHOME/bin/gpmon with the start option and an administrator password.

    Code:
    $ARCHOME/bin/gpmon -o start -p gps


    Note:
    Additional UNIX notes:

    Some systems direct applications to search the NIS services file rather than the hosts. You can force a search of the local services file on these systems so you can properly administer the Geoprocessing Server.

    Updating service access on HP-UX:

    Copy the nsswitch.conf file from the /usr/newconfig/etc directory to the /etc directory. Edit the file and change the line 'services:nis files' to 'services:files nis'.

    Updating service access on IBM AIX:

    Create the file netsvc.conf in the /etc directory. Add the line 'services=local,nis' and save the file.


    Note:
    Additional documentation resources:

    - Appendix B, Using ArcToolbox

    - ARCDOC > Contents > System Administration > System Setup > Setting up a Geoprocessing Server