ArcGIS Server Banner

Starting an ArcSDE service

Starting an ArcSDE service

Release 9.3 E-mail This TopicPrintable VersionGive Us feedback

About starting an ArcSDE service

NOTE: Applies to geodatabases created with an ArcGIS Server Enterprise license only

When you start an ArcSDE service, the following steps take place:

  1. ArcSDE starts the giomgr process.
  2. This is the ArcSDE service monitor. Each ArcSDE service has one giomgr process.

  3. The giomgr reads the system environment variables from the dbinit.sde file.
  4. The SDEHOME\dbinit.sde file contains settings for system environment variables that override those set in the system environment for either UNIX or Windows systems. On UNIX systems, if the dbinit.sde file does not exist, the sdemon command displays a warning message during startup.

  5. The giomgr determines if an ArcGIS server license has been installed.
  6. Each server on which the ArcSDE component of ArcGIS Server is installed must have a valid license.

  7. The giomgr reads the Transmission Control Protocol/Internet Protocol (TCP/IP) service name.
  8. On Windows platforms, the service name is read from the registry if the ArcSDE service is started from the Services menu. However, when debugging a startup problem by using the sdemon –o start command, the service name is read from the services.sde file.

    On UNIX platforms, the service name is always read from the $SDEHOME/etc/services.sde file.

  9. The giomgr attaches to the TCP/IP port assigned to the service name.
  10. The service name must be in the system's services file. On Windows, the ArcSDE installation program adds the service name to the system service file automatically. On UNIX platforms, the services file must be updated manually.

    On Windows, the system service file is located at <drive>:\winnt\system32\drivers\etc\services, but on UNIX systems, the file is located at /etc/services.

  11. The giomgr connects to the DBMS using connection information from dbinit.sde and operating system environment variables.
  12. The DBMS connection parameters set in the dbinit.sde file have precedence over any parameters that are set in the system environment.

    If the dbinit.sde file does not exist or is empty, the DBMS connection parameters of the system environment are used.

  13. The giomgr flushes the lock tables.
  14. The giomgr process flushes the locks of any process information orphaned by a chaotic shutdown of the application server.

    NOTE: The locks of direct connections are not flushed when the ArcSDE service starts.

  15. The giomgr listens for connections on its TCP/IP port.
  16. At this point, the ArcSDE service has started.

How you start an ArcSDE service depends on whether it has been installed on a Windows or a UNIX system and whether it is local or remote (on another machine). The procedures you should follow for each type of installation are described below.

Tips

How to start an ArcSDE service

Register an ArcSDE service on UNIX

  1. Edit the $SDEHOME/etc/services.sde file.
  2. #
    # ESRI ArcSDE service name and port number
    #
    esri_sde 5151/tcp

  3. Add the same service name and port number to the operating system/etc/services file.
  4. nfsd 2049/udp # NFS server daemon (clts)
    nfsd 2049/tcp # NFS server daemon (cots)
    lockd 4045/udp # NFS lock daemon/manager
    lockd 4045/tcp
    esri_sde 5151/tcp # ArcSDE service

Tip

  • Some UNIX systems cause applications to search the Network Information Service (NIS) file rather than the local services file. If you want to have the operating system search the local services file instead, you must force it to do so. For information on how to do this, see Forcing a search of the local services file on UNIX systems.

Start a local ArcSDE service on UNIX

The sdemon command manages ArcSDE services configured on UNIX systems.

  1. Type the command "sdemon" with the "–o start" operation to start the ArcSDE service.
  2. sdemon –o start

  3. You will be prompted to type a password. Type the password of the ArcSDE administrative user. The password will not be displayed on the screen for system security.
  4. Please enter the ArcSDE DBA password:

Tip

    You must be logged in as either the owner of the ArcSDE service's home directory, $SDEHOME, or as the root user to start an ArcSDE service.

  • For details on the use of sdemon and other administration commands, consult the Administration Command Reference that is provided with ArcGIS Server Enterprise. You can also download a PDF version of the file from the Geodatabase Resource Center.

Start a remote ArcSDE service on UNIX

NOTE: Not supported on Linux platforms

Before an ArcSDE service on a UNIX system can be started from a remote UNIX or Windows machine, you must complete four configuration steps.

Examples shown in the steps below are for an Oracle database and Solaris platform.

  1. The dbinit.sde file must contain the database connection and the library path to the ArcSDE and DBMS dynamic libraries.
  2. Create the $SDEHOME/etc/ dbinit.sde file.
    set ORACLE_HOME=/bula/oracle
    set ORACLE_SID=ora
    set LD_LIBRARY_PATH=/usr/lib:/bula/oracle/lib:/bula/oraexe/sdeexe92/lib
    unset TWO_TASK

    If you are running AIX, substitute LIBPATH for LD_LIBRARY_PATH. If you are running HP-UX, substitute SHLIB_PATH for LD_LIBRARY_PATH.

  3. You must add additional one-line entries to the /etc/services and the /etc/inetd.conf files on both the local and remote servers, then reinitialize the inetd daemon.
  4. As the root user, duplicate the service name in the /etc/services file as a User Datagram Protocol (UDP) entry that uses the same port number.

    # \etc\services
    esri_sde 5151/tcp
    esri_sde 5151/udp

  5. As the root user, update the /etc/inetd.conf file. Add this line to the bottom of the file.
  6. <ArcSDE instance> dgram udp wait <owner of ArcSDE home> 
    <$SDEHOME>/bin/sderemote iomgr_inetd
    <$SDEHOME><ArcSDE instance>

  7. As the root user, identify the relevant process using the UNIX command ps -u piped through grep. Reinitialize the inetd daemon by sending it a signal hang-up (SIGHUP).
  8. As the ArcSDE administrator, make sure the ArcSDE service is not started.

    $ ps –u root | grep inetd
    root 112 1 0 Jun 28 ? 0:08 /usr/sbin/inetd –s
    $ kill –HUP 112
    $ sdemon –o status
    ArcSDE Instance esri_sde Status on bula at
    Tue Jun 28 07:38:59 2005
    ____________________________________
    ArcSDE instance esri_sde is not available on bula.

After you have completed the four configuration steps, you can test the remote startup procedure from either a UNIX or a Windows computer using the sdemon command with the –s and –i options.

From either a UNIX or Windows computer, type the sdemon command with the start operation to remotely start an ArcSDE service. Include the server (–s) and service (–i) options.

$ sdemon –o start –p password –s bula –i esri_sde

ArcSDE Instance esri_sde started Fri Oct 26 07:42:02 2007

Start a local ArcSDE service on Windows

You can start or restart an ArcSDE service on Windows from the Services menu.

  1. Open the Administrative Tools menu from the Control Panel.
  2. Open the Services menu.
  3. Highlight the ArcSDE service. The name of the service always begins with ArcSde Service, and the service name itself is enclosed in parentheses—for example: ArcSde Service(arcsde).
  4. Right-click the ArcSDE service and choose Start from the context menu, click the Start Service button on the toolbar, or click the Action menu and choose Start.

Tip

Start a remote ArcSDE service on Windows

You can start a remote Windows ArcSDE service from another Windows machine.

  1. Be sure the ArcSDE administrator belongs to the Windows administrator or power user group on the remote machine and has access via the system's environment variables to the sdemon command.
  2. To determine that the remote ArcSDE service host is accessible over the network, use the ping command from an MS-DOS prompt.
  3. At the MS-DOS command prompt, type the command "ping" followed by the name or TCP/IP address of the remote computer.

    ping muybridge
    Pinging muybridge.esri.com [198.3.6.69] with 32 bytes of data:
    Reply from 198.3.6.69: bytes=32 time<10ms TTL=128
    Reply from 198.3.6.69: bytes=32 time<10ms TTL=128
    Reply from 198.3.6.69: bytes=32 time<10ms TTL=128
    Reply from 198.3.6.69: bytes=32 time<10ms TTL=128

  4. You must add additional one-line entries to the Windows services file of both the local and remote servers. Duplicate the service name in the Windows services file as a User Datagram Protocol (UDP) entry that uses the same port number. For example:
  5. esri_sde 5151/tcp
    esri_sde 5151/udp

  6. Initiate remote startup of the ArcSDE service using the sdemon command from an MS-DOS command prompt. The –s <server> and –i <service> options identify the remote host computer and the remote ArcSDE service.
  7. For example, to start the remote ArcSDE service, arcsde, on host computer muybridge, type the sdemon command and include the –s muybridge –i arcsde options.

    sdemon –o start –i arcsde –s muybridge
    Please enter ArcSDE DBA password:
    ArcSDE Instance arcsde started Thu Feb 07 11:24:26 2008

Tip

  • You must specify the service name to start the remote application server—in this case, arcsde. Using the port number will result in an error and the service will not be started. The service name is the name of the service as it appears in the Windows Services dialog box.

See Also

  • Stopping an ArcSDE service
  • Troubleshooting the ArcSDE service