ArcSDE Administration Command Reference

sdeconfig
Usar o comando para gerenciar seu arquivo de configurao. Usage syntax sdeconfig -o import -f <SERVER_Info file> [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-N] [-q] sdeconfig -o export -f <SERVER_Info file> [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-N] [-q] sdeconfig -o list [-P <Property_Name>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-N] [-q] sdeconfig -o alter -v <Property_Name=Value,...> [-i <service] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-N] [-q] sdeconfig -h sdeconfig -? Operaes import export list alter Options -D -f -i -s -N -o -p -P -q -u -v Database or data source. Not supported by all DBMS. Server configuration file. ArcSDE service name ArcSDE server hostname (default: localhost) No verification is performed. The operation begins immediately after being invoked. Operation ArcSDE administrator DBMS password The name of a server configuration parameter to be listed. Quite, all titles and warnings are suppressed ArcSDE administrator DBMS user The value to assign to a server configuration parameter formatted as a <property name>=<value>. Imports the entire configuraton file into the SDE.SERVER_CONFIG table for the specified database, replacing the existing contents. Exports the entire contents of the SDE.SERVER_CONFIG table to the specified configuration file. Lists the value of a specified server configuration parameter. Alters the value of the specified configuration parameter.

Discussion The sdeconfig command allows you to edit and view the values of the server configuration parameters that are stored in the SDE.SERVER_CONFIG table. The server configuration parameters are read by an ArcSDE client application upon connection to ArcSDE server. They are not reread until the application connects again. Use the export operation to write the parameters to a file. The values of the parameters can be edited using a ASCII text editor. Use the import operation to write the parameters back to the SDE.SERVER_CONFIG table. The alter operation allows you to change a single server configuration parameter value. The list operation displays the value of a specified parameter. export operation
The export operation writes the contents of the SDE.SERVER_CONFIG table to an ASCII file.

$ sdeconfig -o export -u bob -p cat -f config.txt -N -q Successfully exported to file config.txt on server jolex
The following table lists the default values that will be written to the file if you have not altered any of the parameter values. Parameter name ALLOWSESSIONLOGFILE ATTRBUFSIZE AUTOCOMMIT BLOBMEM CONNECTIONS DEFAULTPRECISION DETECT8XNULLSHAPE (ArcSDE for Oracle only) DISABLEAUTOREG ( not for ArcSDE for SQLServer) DISABLEDC HOLDLOGPOOLTABLES LARGEIDBLOCK MAXARRAYBYTES MAXARRAYSIZE MAXBLOBSIZE MAXBUFSIZE MAXDISTINCT MAXINITIALFEATS MAXSTANDALONELOGS MAXSTREAMS MAXTIMEDIFF MINBUFOBJECTS MINBUFSIZE PACKETSIZE (ARCSDE for SQLServer only) PRECISION10 (ArcSDE for Oracle only) PROCSTATS RASTERBUFSIZE Default value TRUE 50000 1000 1000000 48 32 FALSE FALSE FALSE TRUE 0 550000 100 1000000 65536 512 10000 3 25 -1 512 16384 0 FALSE -1 10485760

READONLY SESSIONLOGPOOLSIZE SHAPEPTSBUFSIZE SMALLIDBLOCK STATEAUTOLOCKING STATECACHING STREAMPOOLSIZE TCPKEEPALIVE TEMP THRESHOLD (not for ArcSDE for SQLServer) TIMEOUT TLMINTERVAL Operao Import

FALSE 10 400000 16 FALSE TRUE 3 FALSE Operating system temporary directory 0 0 1

A operao da importao permite que voc importe os parmetros listados de um arquivo de configurao na tabela SDE.SERVER_CONFIG. Os ndices da tabela so substitudos completamente pelos ndices do arquivo. Se o arquivo no contiver um parmetro, ArcSDE introduz um valor padro para o parmetro que no existe. A tabela acima lista os valores de parmetro padro. Ao ler o arquivo, se o ArcSDE encontrar um parmetro que no reconhea, o parmetro ignorado (verificar se o parmetro esta escrito corretamente.) $ sdeconfig -o import -u sde -p sde -f config.txt -N -q Successfully imported SERVER_CONFIG Table.
alter operation Rather than export and import all of the configuration parameter, the alter operation allows you to edit the values of a list of one or more parameters. The -v option requires that the parameter name be followed directly by the equal sign and the value. There must not be any white space surrounding the equals sign; otherwise a syntax error will result.

$ sdeconfig -o alter -u bob -p cat -N -q -v procstats=5 Successfully altered SERVER_CONFIG Table.

list operation
Using the list operation you either list all of the parameter values of the SDE.SERVER_CONFIG table or just one. If the ArcSDE cannot find the parameter it will warn you that the parameter does not exist and list all of the parameters contained within the table.

$ sdeconfig -o list -u bob -p cat -N -q -P procstats PROCSTATS -1

sdedbtune
Use this command to manage the parameters of the ArcSDE DBTUNE table.

Usage syntax sdedbtune -o import -f <DBTune file> [-i <service>][-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-N] [-q] sdedbtune -o export -f <DBTune file> [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name [-p <DB_User_password] [-N] [-q] sdedbtune -h sdedbtune -? Operations import export Options -? -D -f -h -i -N -o -p -q -s -u Displays the command usage Database or data source name. Not supported by all DBMS dbtune file Displays the command usage ArcSDE service name No verification is performed. The operation begins immediately after being invoked Operation ArcSDE administrator DBMS password Quiet, all titles and warnings are suppressed ArcSDE server hostname (default: localhost) ArcSDE administrator DBMS user Imports the entire dbtune file into the SDE.DBTUNE table for the specified database, replacing the contents of the SDE.DBTUNE table. Exports the entire SDE.DBTUNE table to the specified dbtune file.

Discussion The sdedbtune administration command allows you to export the entire SDE.DBTUNE table to a file for editing. The file can then be edited with a file-based editor such as vi or Microsoft's notepad, and imported back into the SDE.DBTUNE table. Please note that the entire contents of the SDE.DBTUNE table are overwritten with the contents of the edited export file during the import operation. Do not attempt to import the file while tables or layers are being created or altered. For more information regarding the dbtune configuration keywords and parameters for your DBMS, please refer to the ArcSDE Configuration and Tuning Guide for your DBMS.

sdegcdrules
This command manages ArcSDE geocoding rules.

Usage syntax sdegcdrules -o export -f <rule_file> [-N] [-d <directory_name>] [-i <service>] [-s <server_name>] [-D <database>] [-u <DB_User_name>] [-p <DB_User_password>] [-q] sdegcdrules -o import -f <rule_file> [-N] [-i <service>] [-s <server_name>] [-D <database>] [-p <DBA_password>] [-q] sdegcdrules -o delete -f <rule_file> [-N] [-i <service>] [-s <server_name>] [-D <database>] [-p <DBA_password>] [-q] sdegcdrules -o list [{-S <style> | {-T <type>}] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-q] sdegcdrules h sdegcdrules -? Operations export import delete list Options -D -d -f -h -i -N -o -p -q -s -S -T -u -? Database name Directory into which to export the geocoding rule file Geocoding rule file Prints usage and options ArcSDE service name No verification Operation ArcSDE user DBMS password Quiet ArcSDE server hostname (default: localhost) Geocoding rule style name Geocoding rule type ArcSDE user DBMS username Prints usage and options (use "-\?" on C shell) Exports a geocoding file from the ArcSDE database Imports a geocoding rule file to the ArcSDE database Deletes the specified geocoding rule record Lists the geocoding rules stored in the ArcSDE database.

Discussion The sdegcdrules command manages the set of geocoding rules that are stored in an ArcSDE database. Locators use a set of geocoding rules that specify to the geocoding engine how to parse, standardize, and match addresses. Within an ArcSDE database, each geocoding rule file is stored as a record in the GCDRULES table. For more information on geocoding rule file types, refer to the Geocoding Rule Base Developer Guide.

The export operation exports a specified geocoding rule file from the ArcSDE database to a file on disk. The name of the created file is the name of the geocoding rule record stored in the GCDRULES table.

sdecgdrules o export d d:\workspace f us_addr.cls i sde90_geocoding D geocoding

The import operation imports a geocoding rule file stored on disk into the GCDRULES table in the ArcSDE database.

sdegcdrules o import f d:\us_addr.cls i sde90_geocoding D geocoding

The delete option deletes a geocoding rule record from the GCDRULES table in the ArcSDE database.

sdegcdrules o delete f us_addr.cls i sde90_geocoding D geocoding

The list option lists the contents of the GCDRULES table in the ArcSDE database. The listing includes the ID, the geocoding rule style name, and the geocoding rule type.

sdegcdrules o list i sde90_geocoding D geocoding ArcSDE 9.0 for SQL Server Build 1798 Fri Nov 21 11:31:31 PST 2003 Geocoding Rule Table Administration Utility ----------------------------------------------------ID STYLE TYPE ----------------------------------------------------1 city_cty cls 2 city_cty dct 3 city_cty mat 4 city_cty pat 5 city_cty stn 6 city_st cls 7 city_st dct 8 city_st mat 9 city_st pat 10 city_st stn 11 direct tbl 12 expand tbl 13 key_1 cls 14 key_1 dct 15 key_1 mat 16 key_1 pat 17 key_1 stn 18 ny_addr cls 19 ny_addr dct 20 ny_addr pat 21 ny_addr stn 22 ny_addr1 mat 23 ny_addr2 mat 24 prefix tbl 25 spedit tbl 26 stmap cls 27 stmap dct 28 stmap mat

29 30 31 32 33 34 35 36 37 38 39 40 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73

stmap stmap stm_int stm_int stm_int stm_int stm_int suffix us_addc1 us_addc2 us_addc3 us_addc4 us_addr us_addr us_addr us_addr1 us_addr2 us_addrc us_addrc us_addrc us_addrc us_intsc us_intsc us_intsc us_intsc us_intsc1 us_intsc2 us_intsc3 us_snum1 us_snum2 us_srng1 us_srng2 zip zip zip zip zip zip4 zip4 zip4 zip4 zip4 zip4rng us_addr

pat stn cls dct mat pat stn tbl mat mat mat mat dct pat stn mat mat cls dct pat stn cls dct pat stn mat mat mat mat mat mat mat cls dct mat pat stn cls dct mat pat stn mat cls

The S option can be used to restrict the list to a particular geocoding rule style name.

sdegcdrules o list S us_addr i sde90_geocoding D geocoding ArcSDE 9.0 for SQL Server Build 1798 Fri Nov 21 11:31:31 PST 2003 Geocoding Rule Table Administration Utility ----------------------------------------------------ID STYLE TYPE ----------------------------------------------------42 us_addr dct 43 us_addr pat

44 73

us_addr us_addr

stn cls

The T option can be used to restrict the list to a particular geocoding rule type. sdegcdrules o list T cls i sde90_geocoding D geocoding ArcSDE 9.0 for SQL Server Build 1798 Fri Nov 21 11:31:31 PST 2003 Geocoding Rule Table Administration Utility ----------------------------------------------------ID STYLE TYPE ----------------------------------------------------1 city_cty cls 6 city_st cls 13 key_1 cls 18 ny_addr cls 26 stmap cls 31 stm_int cls 47 us_addrc cls 51 us_intsc cls 62 zip cls 67 zip4 cls 73 us_addr cls

sdelocator
This command manages ArcSDE locators. Usage syntax sdelocator -o list [-T <{t|v|d}>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-q] sdelocator -o create -n <locator_name> -f <locator_properties_file> -T <{t|v}> [-S <locator_description>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-q] sdelocator -o delete {-n <locator_name> | -I <locator_id>} [-N] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-q] sdelocator -o describe [-n <locator_name> | <-I locator_id>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-q] sdelocator -o refresh {-n <locator_name> | -I <locator_id>} [-N] [-i <service>] [ -s <server_name>] [-D <database>]-u <DB_User_name> [-p <DB_User_password>] [ -q] sdelocator -h sdelocator -? Operations

list create delete describe refresh Options -

List the locators for the service Create a locator from the property file Delete the specified locator Describe the locator properties. If no locator is specified, all locators are described Refresh the geocoding indexes

Database name Locator properties file Prints usage and options Locator ID ArcSDE service name No verification Locator name Operation ArcSDE user DBMS password Quiet ArcSDE server hostname (default: localhost) Locator description string Locator type (t: template, d: system defined, v: validated) ArcSDE user DBMS username Prints usage and options (use "-\?" on C shell)

D -f -h -I -i -N -n -o -p -q -s -S -T -u -?

Discussion The sdelocator command manages the set of locators and locator styles stored in the ArcSDE database. For information on the format and contents of locator and locator style files, refer to Geocoding in ArcGIS in the ArcGIS user documentation set. The "create" operation reads the locator's properties from a property file and, if the locator does not already exist in the SDE_locators table, adds an entry. The locator's properties are stored in the SDE_metadata table. The -T option specifies which type of locator is being created. Most typically, you will only use the create operation to load locator styles into the ArcSDE database (using the T t option), and create new locators based on this style using ArcCatalog.

sdelocator -o create -n "Custom Locator Style" -f d:\custom.lot -T t -S Custom locator style -i sde90_geocoding D geocoding -u sde -p sde
The "delete" operation removes a locator's entries from the SDE_locators and SDE_metadata tables.

sdelocator -o delete -n "Custom Locator Style" -i sde90_geocoding D geocoding -u sde -p sde

The "list" operation provides a list of the locators in the ArcSDE database. The listing includes the locator ID, type, name, owner, category, and description.

sdelocator -o list -i sde90_geocoding D geocoding -u sde -p sde ArcSDE 9.0 (Pre-Release) for SQL Server Build 1799 Mon Nov 24 11:31:39 PST 2003 Locator Administration Utility ----------------------------------------------------------------------------ID T Name Owner Category Description ----------------------------------------------------------------------------2 t StreetMap USA SDE Address StreetMap USA 36 v Redlands_Streets SDE Address US Streets 60 d SDE_Redlands_Location SDE Address US Streets 62 t Single Field SDE Address Single Field 63 t US Alphanumeric Ranges SDE Address US Alphanumeric Ranges 64 t US Alphanumeric Ranges (A) SDE Address US Alphanumeric Ranges (Alternate Names) 65 t US Alphanumeric Ranges Zone SDE Address US Alphanumeric Ranges with Zone 66 t US Alphanumeric Ranges Zone(A) SDE Address US Alphanumeric Ranges with Zone (Alternate Names) 67 t US Cities with State SDE Address US Cities with State 68 t US Hyphenated Ranges SDE Address US Hyphenated Ranges 69 t US Hyphenated Ranges (A) SDE Address US Hyphenated Ranges (Alternate Names) 70 t US Hyphenated Ranges Zone SDE Address US Hyphenated Ranges with Zone 71 t US Hyphenated Ranges Zone(A) SDE Address US Hyphenated Ranges with Zone (Alternate Names) 72 t US One Address SDE Address US One Address 73 t US One Address (A) SDE Address US One Address (Alternate Names) 74 t US One Address with Zone SDE Address US One Address with Zone 75 t US One Address with Zone (A) SDE Address US One Address with Zone (Alternate Names) 76 t US One Range SDE Address US One Range 77 t US One Range (A) SDE Address US One Range (Alternate Names) 78 t US One Range with Zone SDE Address US One Range with Zone 79 t US One Range with Zone (A) SDE Address US One Range with Zone (Alternate Names) 80 t US Streets SDE Address US Streets 81 t US Streets (A) SDE Address US Streets (Alternate Names) 82 t US Streets with Zone SDE Address US Streets with Zone

83 t with 84 t with 85 t 86 t

US Streets with Zone (A) Zone (Alternate Names) World Cities with Country Country ZIP+4 ZIP+4 Range

SDE SDE SDE SDE SDE

Address Address

US Streets World Cities

Address ZIP+4 Address ZIP+4 Range Address ZIP (5-

87 t ZIP (5-Digit) Digit)

The list operation can be qualified with the locator type option -T to list only those locators of a certain type. There are three main types of locators stored in an ArcSDE database: locator styles (specified using the -T t option) are used as templates for creating new locators; locators that are created based on a locator style are designated by the -T v option; other locators, called attached locators (specified using the -T d option), are copies of a locator, including runtime options, used to geocode a feature class, and are used when the feature class is rematched.

sdelocator -o list -T v -i sde90_geocoding D geocoding -u sde -p sde ArcSDE 9.0 for SQL Server Build 1798 Fri Nov 21 11:31:31 PST 2003 Locator Administration Utility ------------------------------------------------------ID T Name Owner Category Description ----------------------------------------------------------------------------------36 v Redlands_Streets SDE Address US Streets
The "describe" operation displays the properties of a locator.

sdelocator -o describe -n "US Streets" -i sde90_geocoding D geocoding -u sde -p sde

The refresh option rebuilds the geocoding indexes for a locator. The geocoding indexes for a locator should be rebuilt after the reference data for the locator has been edited.

sdelocator o refresh I 29 i sde90_geocoding D geocoding u sde -p sde

sdelog
This command administers log files. Usage syntax sdelog -o alter -L <logfile> -k <PERSISTENT,TEMPORARY> [-O <Owner>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-N] [-q] sdelog -o clean [-O <Owner>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-N] [-A] [-q] sdelog -o delete -L <logfile> [-O <Owner>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-N] [-q] sdelog -o display -L <logfile> [-O <Owner>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-q] sdelog -o grant -U <user> [-O <Owner>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-q] sdelog -o list [{-O <Owner> | -l <table,column> | -T <table>}] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-q] sdelog -o revoke -U <user> [-O <Owner>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-q] sdelog -o truncate -L <logfile> [-O <Owner>] [-i <service>] [-s <server_name>] [-D <database>] -u <DB_User_name> [-p <DB_User_password>] [-N] [-q]
sdelog -h

sdelog -? Operations alter clean delete display grant list revoke truncate Options Modify log file's persistence Delete all temporary log files Delete a single log file Print the contents of a log file Grant access to the owner's log file for a user List a user's log files Revoke access from the owner's logfiles for a user Delete the contents of a log file

A -D -h -i -k -l -L -N -o -O -p -q -s -T -u -U -?

Deletes all log files temporary, persistent, and old format log files Database name Prints usage and options ArcSDE service name Configuration keyword, either TEMPORARY or PERSISTENT Layer table and spatial column name Log file name (not containing user) No verification is performedthe operation begins immediately after being invoked Operation Owner of the log file ArcSDE user RDBMS password Quiet; all titles and warnings are suppressed ArcSDE server hostname (default: localhost) Table name ArcSDE user RDBMS username ArcSDE user RDBMS usernamethe user who will be granted access to a log file or who will have access permissions to a log file revoked Prints usage and options (use "-\?" on C shell)

Discussion ArcSDE logs are stored in the DBMS tables SDE_LOGFILES and SDE_LOGFILE_DATA. Prior to version 8, they were stored on disk as files. Some of the usage syntax still reflects that old style of use. During the migration to ArcSDE version 8, the files on disk became DBMS table records. A log file is represented as a single row in the SDE_LOGFILES table. The records of the log file are stored in the SDE_LOGFILE_DATA table, and are referenced by the foreign key LOGFILE_ID, which is also the primary key of the SDE_LOGFILES table. Both the "delete" and "clean" operations of sdelog will remove log files. The "clean" operation by default removes a user's temporary log files. Essentially all rows are truncated from SDE_LOGFILES and SDE_LOGFILE_DATA tables for the user specified by the -u flag.

$ sdelog -o clean -u av
Specify the "-N" option if you don't want to be prompted.

$ sdelog -o clean -u av -N
Specify the "-A" option to delete all of a user's logs: temporary, persistent, and pre-SDE 3.x style.

$ sdelog -o clean -u av -N -A
The "delete" operation of the sdelog administration command removes a single log file. Again you may enter the "-N" option to suppress the verification prompt. In this case the single record in the SDE_LOGFILES table containing the LOGFILE_NAME column value of 'logBCAa06599' is deleted. From the SDE_LOGFILE_DATA table all records whose

LOGFILE_ID foreign key matched the SDE_LOGFILES table's primary key LOGFILE_ID value are deleted as well.

$ sdelog -o delete -L logBCAa06599 -u av -N

You can list the log tables with the log file utility "list" operation. The list includes the name of the log file, the feature class internal ID, the current state of the log file, the number of shape records referenced, and the date and time the log file was last modified.

$ sdelog -o list -u av ArcSDE 8.1 Wed Oct 14 14:20:44 2000 Logfile Administration Utility ------------------------------------------------------------Name Layer State Records Time Last Modified ------------------------------------------------------------colog 9 UP 29 1998-10-14 12:42:30 citylog 5 SP 65 1998-10-14 12:42:32 ci_log 5 UT 11 1998-10-14 12:58:34 ci_log 5 ST 11 1998-10-14 12:58:34 ------------------------------------------------------------The state column whether the log file is unsorted, sorted, temporary, or persistent. The codes are:

UPunsorted, persistent SPsorted, persistent UTunsorted, temporary STsorted, temporary

The log file utility "display" operation provides a list of shape IDs contained in the log file. The header of the output displays the log filename and the feature class internal ID number. The shape IDs are displayed in a column below the Feature ID (FID) heading.

$ sdelog -o display -L ci_log -u av ArcSDE 8.1 Wed Oct 14 14:20:44 2000 Logfile Administration Utility ------------------------------------------------------------Printing the contents of logfile ci_log on layer 5 FID -------------34 133 146 158 211 221 276 277 294 546 549

sdemon
This command is used to monitor and manage the ArcSDE service. You can use sdemon to start up, pause, resume, and shut down all connection activity and display current configuration parameters and server task information. Individual server tasks can also be managed. Security: Execution privileges are granted exclusively to the ArcSDE administrator for the start operation. All other operations may be executed by any user who knows the password. Usage syntax sdemon -o status {[-i <service>] [-s <server_name>] | [-H <sde_directory>]} [-q] sdemon -o start {[-i <service>] [-s <server_name>] | [-H <sde_directory>]} [-p <DB_Admin_password>] sdemon -o shutdown {[-i <service>] [-s <server_name>] | [-H <sde_directory>]} [-p <DB_Admin_password>] [-N] sdemon -o pause {[-i <service>] [-s <server_name>] | [-H <sde_directory>]} [-p <DB_Admin_password>] sdemon -o resume {[-i <service>] [-s <server_name>] | [-H <sde_directory>]} [-p <DB_Admin_password>] sdemon -o info -I <{users | config | stats | locks | vars }> [-q] {[-i <service>] [-s <server_name>] | [-H <sde_directory>]} sdemon -o kill -t <{ all | pid }> [-p <DB_Admin_password>] [-N] {[-i <service>] [-s <server_name>] | [-H <sde_directory>]} sdemon -h sdemon -? Operations status start shutdown Reports the service status Starts the ArcSDE service if it's not running. Only the ArcSDE administrator can use this operation. Shuts down the ArcSDE service immediately if no server tasks are running. If server tasks are running, you're prompted to remove the running tasks before the shutdown takes place. If you use the "-N" option when shutting down, all server tasks stop and the system shuts down immediately. Disallows further client connection requests to be processed. No client tasks are allowed to connect to ArcSDE servers through this ArcSDE service. Allows client connection requests to be processed again. Client tasks are allowed to connect to ArcSDE servers through this ArcSDE service. Displays information about users, configuration, statistics, locks, or

pause

resume

info

kill Options h -H -i -I

environment variables Kills all connections or a specified connection to the service

Prints usage and options ArcSDE home directory (SDEHOME) ArcSDE service name. Inquire about configuration, locks, statistics, users, or environment variables config Displays current configuration variables locks Displays lock information about processes that are holding locks stats Displays process statistics for each ArcSDE client/server connection users Lists users' connections to ArcSDE and associated process identifiers vars Displays ArcSDE service environment variables No verification is performed. The operation begins immediately after being invoked. Operation ArcSDE administrator RDBMS password Quiet; all titles and warnings are suppressed ArcSDE server hostname (default: localhost) Kills server tasks: all Forcefully removes all server tasks pid Removes the task identified by the process identifier Prints usage and options (use "-\?" in C shell)

-N -o -p -q -s -t

-?

Discussion The sdemon command allows you to manage and monitor ArcSDE services. Use it to start, stop and view the current properties of an ArcSDE service. The start, stop, pause and resume operations normally manage ArcSDE services installed on UNIX systems. For ArcSDE services installed on Microsoft Windows systems are managed via the Services window. However, the sdemon command may be used from a Microsoft command prompt but only after the ArcSDE Microsoft Window's service has been created with the sdeservice command. The ArcSDE service may be managed remotely by including the server -s and service -i options on the command line. UNIX operating system ArcSDE services can be remotely managed by a sdemon operation executed on a Windows operating system, however Windows operating system ArcSDE services can only be remotely managed by an sdemon operation executed from another Windows operating system. To remotely manage an ArcSDE service installed on a UNIX system additional steps are required. Refer to Managing ArcSDE Application Servers for a detailed discussion. Note that the SDESERVER and SDEINSTANCE environment variables are used if they are set. However the command server and service options will override the settings when specified.

For a detailed discussion of the management of an ArcSDE service refer to Managing ArcSDE Application Servers.

sdeservice (Windows only)

This command manages the ArcSDE service on Windows. Usage syntax sdeservice -o create -p <DB_Admin_password> [-n] [-H <sde_directory>] [-d <ORACLE9I,SID | ORACLE8I,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX>] [-i <service>] [-u <service_user>] [-P <service_user_password>] sdeservice -o delete [-d <ORACLE9I,SID | ORACLE8I,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX>] [-i <service>] [-N] sdeservice -o register -r <registry_keyword> -v <value> -p <DB_Admin_password> [-i <service>] [-d <ORACLE9I,SID | ORACLE8I,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX>] sdeservice -o unregister -r <registry_keyword> -p <DB_Admin_password> [-i <service>] [-d <ORACLE9I,SID | ORACLE8I,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX>] sdeservice -o modify -r <registry_keyword> -p <old_DB_Admin_password> -v <new_value> [-i <service>] -d <ORACLE9I,SID | ORACLE8I,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX>] sdeservice -o list [-i <service>] sdeservice -h Operations
create Creates a service delete Deletes a service register Adds a registry keyword to the windows registry unregister Removes a registry keyword to the windows registry modify Modifies an existing registry keyword list Displays service information for all or a specified service

Options -d Used to identify which RDBMS the service connects to and service dependency. A service dependency identifies a

-h -H

-i -n -N -o -p

-r

-P -u

-v -? Discussion

service that should start before ArcSDE. DB2INSTANCE, SQLSERVERINSTANCE, or SID are optional and are used to identify an instance of a database, either remote or local. SID (default: ORCL). DB2INSTANCE (default: DB20). SQLSERVERINSTANCE Sqlserver named instance or data source (default: MSSQLServer). Prints usage and options ArcSDE home directory (SDEHOME). Only needed if the SDEHOME variable isn't set or multiple services are in use. ArcSDE service name; required if the service is not called "esri_sde" Exclude database service from ArcSDE dependent services list. No verification is performed; the operation begins immediately after being invoked Operation (eg -o create) ArcSDE administrator DBMS password. ArcSDE for Coverages password syntax: password ;; layer_admin_password. Registers/Unregisters/Modify following windows registry keywords: SDEHOME - ArcSDE software location. SDE_DBA_PASSWORD - ArcSDE DBA password. ADMIN_DATABASE (DB2/INFORMIX/SQLSERVER only) database with ArcSDE system tables. NLS_LANG (ORACLE only) - ArcSDE server codepage. NET_SERVICE_NAME (ORACLE only) - Oracle TWO_TASK or LOCAL environment variable. ArcSDE service user password (Windows service "log on" account password). ArcSDE service account. User must be a Windows user who has "administrator" permissions on the server computer. Include the domain name if needed. For example, if you're logged into the "LAMBERT" domain and your username is `joe', enter "LAMBERT\joe". You should be logged in as this user when you create the service. Registry value Prints usage and options

The sdeservice administration utility manages the ArcSDE services and registry entries on Windows platforms. Services are created with either this tool or with the Post-Installer. Creating a service will add several registry entries, which can include SDE_DBA_PASSWORD, SDEHOME, and ADMIN_DATABASE. The "delete" operation will delete the ArcSDE service and all related registry entries. Use the "modify" option to modify existing registry entries like SDEHOME or SDE_DBA_PASSWORD. Use the "register" option to register new entries not provided by default like ADMIN_DATABASE. The "unregister" option removes the entry. Examples

The following example will create a new ArcSDE service for MS SQL Server.

sdeservice -o create -d SQLSERVER -p spatial.data -i esri_sde -H z:\arcgis\arcsde\sqlexe

This example modifies the previous example to register an ADMIN_DATABASE (database with system tables) named "Seamounts."

sdeservice -o register -d SQLSERVER -r ADMIN_DATABASE -v Seamounts -i esri_sde -p spatial.data

This example creates a new ArcSDE service for Informix:

sdeservice -o create -d INFORMIX -p sde.space -i esri_inf -u informix -P sde.inf

This example creates a new SQL Server ArcSDE service pointing to a named instance called "Oceans\GIS1."

sdeservice -o create -d SQLSERVER,Oceans\GIS1 -p spatial.data -i esri_sde01 -H z:\arcgis\arcsde\sqlexe

This example deletes an ArcSDE service on Informix.

sdeservice -o delete -i esri_inf -d INFORMIX

In all create examples, you have to manually edit %windir %\system32\drivers\etc\services and %SDEHOME%\etc\services.sde to add the service name and port number.

sdesetup

including sdesetupdb2, sdesetupinfx, sdesetupmssql, sdesetupora8i, sdesetupora9i This database specific command does the initial meta data setup so that the service can start and/or direct connections will work. sdesetupinfx - Used for a ArcSDE Informix geodatabase sdesetupdb2 - Used for a ArcSDE for DB2 geodatabase sdesetupmssql - Used for a SQL Server geodatabase sdesetupora8i - Used for a Oracle8i geodatabase sdesetupora9i - Used for a Oracle9i geodatabase Note: Oracle8i and Oracle9i setup programs have significant differences. It is important to run the sdesetup command built for the version of Oracle that you are using. The usage below is abbreviated to sdesetup. The usage syntax is the same for all implementations. Usage syntax sdesetup -o upgrade [-H <sde_directory>] [-u <DB_Admin_user>] [-p <SDE_Admin_password>] [-D <database>] [-s <data source>] [-l <key>] [-N] [-q] sdesetup -o list [-H <sde_directory>] [-u <DB_Admin_user>] [-p <SDE_Admin_password>] [-D <database>] [-s <data source>][-q] sdesetup -o install [-H <sde_directory>] [-u <DB_Admin_user>] [-p <SDE_Admin_password>] [-D <database>] [-s <data source>] [-l <key>] [-N] [-q] sdesetup -o update_key -l <key> [-u <DB_Admin_user>] [-p <DB_Admin_password>] [-D <database>] [-s <data source>][-H <sde_directory>] [-N] [-q] sdesetup -h sdesetup -? Operations install Create or update the ArcSDE and Geodatabase system tables and stored procedures list List the installed ArcSDE version upgrade updates the ArcSDE and Geodatabase system tables and stored procedures update_key updates the license for ArcSDE Options - Database name (not supported on all DBMS) D -h Prints usage and options -H ArcSDE home directory (SDEHOME). Only needed if the SDEHOME variable isn't set or multiple services are in use. -l ArcSDE authorization key or location of the authorization file -N No verification is performed the operation begins immediately after being invoked -o Operation -p ArcSDE administrator DBMS password -q Quiet: all titles and warnings are suppressed -s OLE DB datasource -u DBMS DBA user name

Prints usage and options (use "-\?" on C shell) Discussion The sdesetup administration utility manages the creation and maintenance of the ArcSDE geodatabase system tables, indexes, stored procedures and triggers. These database objects are owned by the ArcSDE administrator. You must supply the ArcSDE administrator password in order to create these tables. The actual name of the command varies according to the implementation of ArcSDE as follows: ArcSDE for Oracle 8i sdesetupora8i ArcSDE for Oracle 9i sdesetupora9i ArcSDE for SqlServer sdesetupmssql ArcSDE for Informix sdesetupinfx ArcSDE for DB2 sdesetupdb2 The ArcSDE system tables and stored procedures can be created or updated using the install operation. For new installs of ArcSDE the install operation will create the tables and stored procedures for the first time. For subsequent executions of the install operation on an existing database, the system table checked to ensure that it is current. If it is not, the install operation will bring it up-to-date. The ArcSDE client applications are not upward compatible with a new versions of an ArcSDE geodatabase. Therefore before you update your ArcSDE geodatabase make sure all of your ArcSDE client programs have been updated to a compatible release. Check the install guide of your ArcSDE client application or contact ESRI technical support for compatibility information. If you are using a custom built application that was created with the ArcSDE CAPI or the ArcSDE JAVA API you must rebuild the application using the new ArcSDE client API libraries before it can connect to an updated ArcSDE geodatabase.

-?

sdesetupora9i -o install -p fredericton sdesetupmssql -o upgrade -p halifax

Use the update operation to bring an existing database up-to-date with the latest additions or changes to a new ArcSDE installation. The list operation returns the current version of an ArcSDE installation.

sdesetupinfx -o list -p charlottetown

The update_key operation copies the supplied license key into the server configuration table SDE.SERVER_CONFIG. The license key allows you to use the ArcSDE software. The license string can also be included with both the install and update operations. The -l argument will accept either a file containing the license key or the license key itself. In the first example, the license key is entered directly after the -l option (note: you will need to enclose it in quotes). In the second example, the license key is contained within a text file, and the file is supplied as an argument to the -l option.

sdesetupora8i -o update_key -p quebec \ -l 'arcsdeserver,9,0002a56451f8,31-dec-2003,TRA4CAZYXMM00TEJH192' sdesetupora8i -o update_key -p quebec -l license.dat