View
125
Download
1
Category
Preview:
Citation preview
ArcSDE Administration Command Reference
sdeconfig
Usar o comando para gerenciar seu arquivo de configuração.
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 -? Operações
import Imports the entire configuraton file into the SDE.SERVER_CONFIG table for the specified database, replacing the existing contents.
export Exports the entire contents of the SDE.SERVER_CONFIG table to the specified configuration file.
list Lists the value of a specified server configuration parameter.alter Alters the value of the specified configuration parameter.
Options
-D Database or data source. Not supported by all DBMS.-f Server configuration file.-i ArcSDE service name-s ArcSDE server hostname (default: localhost)-N No verification is performed. The operation begins immediately
after being invoked.-o Operation-p ArcSDE administrator DBMS password-P The name of a server configuration parameter to be listed.-q Quite, all titles and warnings are suppressed-u ArcSDE administrator DBMS user-v The value to assign to a server configuration parameter
formatted as a <property name>=<value>. 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 operationThe 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.txton 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 Default value
ALLOWSESSIONLOGFILE TRUEATTRBUFSIZE 50000AUTOCOMMIT 1000BLOBMEM 1000000CONNECTIONS 48DEFAULTPRECISION 32DETECT8XNULLSHAPE (ArcSDE for Oracle only) FALSEDISABLEAUTOREG ( not for ArcSDE for SQLServer) FALSEDISABLEDC FALSEHOLDLOGPOOLTABLES TRUELARGEIDBLOCK 0MAXARRAYBYTES 550000MAXARRAYSIZE 100MAXBLOBSIZE 1000000MAXBUFSIZE 65536MAXDISTINCT 512MAXINITIALFEATS 10000MAXSTANDALONELOGS 3MAXSTREAMS 25MAXTIMEDIFF -1MINBUFOBJECTS 512MINBUFSIZE 16384PACKETSIZE (ARCSDE for SQLServer only) 0PRECISION10 (ArcSDE for Oracle only) FALSEPROCSTATS -1RASTERBUFSIZE 10485760READONLY FALSESESSIONLOGPOOLSIZE 10SHAPEPTSBUFSIZE 400000
SMALLIDBLOCK 16STATEAUTOLOCKING FALSESTATECACHING TRUESTREAMPOOLSIZE 3TCPKEEPALIVE FALSETEMP Operating system temporary directoryTHRESHOLD (not for ArcSDE for SQLServer) 0TIMEOUT 0TLMINTERVAL 1 Operação Import
A operação da importação permite que você importe os parâmetros listados de um arquivo de configuração na tabela SDE.SERVER_CONFIG. Os índices da tabela são substituídos completamente pelos índices do arquivo. Se o arquivo não contiver um parâmetro, ArcSDE introduz um valor padrão para o parâmetro que não existe. A tabela acima lista os valores de parâmetro padrão. Ao ler o arquivo, se o ArcSDE encontrar um parâmetro que não reconheça, o parâmetro é ignorado (verificar se o parâmetro esta escrito corretamente.)
$ sdeconfig -o import -u sde -p sde -f config.txt -N -q
Successfully imported SERVER_CONFIG Table.
alter operationRather 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 operationUsing 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 procstatsPROCSTATS -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 Imports the entire dbtune file into the SDE.DBTUNE table for the specified database, replacing the contents of the SDE.DBTUNE table.
export Exports the entire SDE.DBTUNE table to the specified dbtune file. Options
-? Displays the command usage-D Database or data source name. Not supported by all DBMS-f dbtune file-h Displays the command usage-i ArcSDE service name-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 ArcSDE server hostname (default: localhost)-u ArcSDE administrator DBMS user
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 Exports a geocoding file from the ArcSDE databaseimport Imports a geocoding rule file to the ArcSDE databasedelete Deletes the specified geocoding rule recordlist Lists the geocoding rules stored in the ArcSDE database.
Options
-D Database name-d Directory into which to export the geocoding rule file-f Geocoding rule file-h Prints usage and options-i ArcSDE service name-N No verification-o Operation-p ArcSDE user DBMS password-q Quiet-s ArcSDE server hostname (default: localhost)-S Geocoding rule style name-T Geocoding rule type-u ArcSDE user DBMS username-? Prints usage and options (use "-\?" on C shell)
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 2003Geocoding Rule Table Administration Utility-----------------------------------------------------ID STYLE TYPE-----------------------------------------------------1 city_cty cls2 city_cty dct3 city_cty mat4 city_cty pat5 city_cty stn6 city_st cls7 city_st dct8 city_st mat9 city_st pat10 city_st stn11 direct tbl12 expand tbl13 key_1 cls14 key_1 dct15 key_1 mat16 key_1 pat17 key_1 stn18 ny_addr cls19 ny_addr dct20 ny_addr pat21 ny_addr stn22 ny_addr1 mat23 ny_addr2 mat24 prefix tbl25 spedit tbl26 stmap cls27 stmap dct28 stmap mat29 stmap pat30 stmap stn31 stm_int cls32 stm_int dct
33 stm_int mat34 stm_int pat35 stm_int stn36 suffix tbl37 us_addc1 mat38 us_addc2 mat39 us_addc3 mat40 us_addc4 mat42 us_addr dct43 us_addr pat44 us_addr stn45 us_addr1 mat46 us_addr2 mat47 us_addrc cls48 us_addrc dct49 us_addrc pat50 us_addrc stn51 us_intsc cls52 us_intsc dct53 us_intsc pat54 us_intsc stn55 us_intsc1 mat56 us_intsc2 mat57 us_intsc3 mat58 us_snum1 mat59 us_snum2 mat60 us_srng1 mat61 us_srng2 mat62 zip cls63 zip dct64 zip mat65 zip pat66 zip stn67 zip4 cls68 zip4 dct69 zip4 mat70 zip4 pat71 zip4 stn72 zip4rng mat73 us_addr 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 2003Geocoding Rule Table Administration Utility-----------------------------------------------------ID STYLE TYPE-----------------------------------------------------42 us_addr dct43 us_addr pat44 us_addr stn73 us_addr 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 2003Geocoding Rule Table Administration Utility-----------------------------------------------------ID STYLE TYPE-----------------------------------------------------1 city_cty cls6 city_st cls13 key_1 cls18 ny_addr cls26 stmap cls31 stm_int cls47 us_addrc cls51 us_intsc cls62 zip cls67 zip4 cls73 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 List the locators for the servicecreate Create a locator from the property filedelete Delete the specified locatordescribe Describe the locator properties. If no locator is specified, all
locators are described
refresh Refresh the geocoding indexes Options
-D
Database name
-f Locator properties file-h Prints usage and options-I Locator ID-i ArcSDE service name-N No verification-n Locator name-o Operation-p ArcSDE user DBMS password-q Quiet-s ArcSDE server hostname (default: localhost)-S Locator description string-T Locator type (t: template, d: system defined, v: validated)-u ArcSDE user DBMS username-? Prints usage and options (use "-\?" on C shell)
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 2003Locator Administration Utility------------------------------------------------------------------------------ ID T Name Owner Category
Description------------------------------------------------------------------------------2 t StreetMap USA SDE Address StreetMap USA36 v Redlands_Streets SDE Address US Streets60 d SDE_Redlands_Location SDE Address US Streets62 t Single Field SDE Address Single Field 63 t US Alphanumeric Ranges SDE Address US Alphanumeric Ranges64 t US Alphanumeric Ranges (A) SDE Address US Alphanumeric Ranges (Alternate Names)65 t US Alphanumeric Ranges Zone SDE Address US Alphanumeric Ranges with Zone66 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 State68 t US Hyphenated Ranges SDE Address US Hyphenated Ranges69 t US Hyphenated Ranges (A) SDE Address US Hyphenated Ranges (Alternate Names)70 t US Hyphenated Ranges Zone SDE Address US Hyphenated Ranges with Zone71 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 US Streets with Zone (A) SDE Address US Streets with Zone (Alternate Names) 84 t World Cities with Country SDE Address World Cities with Country85 t ZIP+4 SDE Address ZIP+4 86 t ZIP+4 Range SDE Address ZIP+4 Range
87 t ZIP (5-Digit) SDE Address ZIP (5-
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 2003Locator 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 Modify log file's persistenceclean Delete all temporary log filesdelete Delete a single log filedisplay Print the contents of a log filegrant Grant access to the owner's log file for a userlist List a user's log filesrevoke Revoke access from the owner's logfiles for a usertruncate Delete the contents of a log file Options
-A
Deletes all log files temporary, persistent, and old format log files
-D Database name-h Prints usage and options-i ArcSDE service name-k Configuration keyword, either TEMPORARY or PERSISTENT-l Layer table and spatial column name
-L Log file name (not containing user)-N No verification is performedthe operation begins immediately after
being invoked-o Operation-O Owner of the log file-p ArcSDE user RDBMS password-q Quiet; all titles and warnings are suppressed-s ArcSDE server hostname (default: localhost)-T Table name-u ArcSDE user RDBMS username-U 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 2000Logfile Administration Utility-------------------------------------------------------------Name Layer State Records Time Last Modified-------------------------------------------------------------colog 9 UP 29 1998-10-14 12:42:30citylog 5 SP 65 1998-10-14 12:42:32ci_log 5 UT 11 1998-10-14 12:58:34ci_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, persistentSPsorted, persistentUTunsorted, temporarySTsorted, 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 2000Logfile Administration Utility-------------------------------------------------------------Printing the contents of logfile ci_log on layer 5FID--------------34133146158211221276277294546549
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 Reports the service statusstart Starts the ArcSDE service if it's not running. Only the ArcSDE
administrator can use this operation.shutdown 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.
pause Disallows further client connection requests to be processed. No client tasks are allowed to connect to ArcSDE servers through this ArcSDE service.
resume Allows client connection requests to be processed again. Client tasks are allowed to connect to ArcSDE servers through this ArcSDE service.
info Displays information about users, configuration, statistics, locks, or environment variables
kill Kills all connections or a specified connection to the service Options
-h
Prints usage and options
-H ArcSDE home directory (SDEHOME)-i ArcSDE service name.-I Inquire about configuration, locks, statistics, users, or environment
variablesconfig 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
-N No verification is performed. The operation begins immediately after being invoked.
-o Operation-p ArcSDE administrator RDBMS password-q Quiet; all titles and warnings are suppressed-s ArcSDE server hostname (default: localhost)-t Kills server tasks:
all Forcefully removes all server taskspid Removes the task identified by the process identifier
-? Prints usage and options (use "-\?" in C shell) 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 servicedelete Deletes a serviceregister Adds a registry keyword to the windows registryunregister
Removes a registry keyword to the windows registry
modify Modifies an existing registry keywordlist 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 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: DB2-0). SQLSERVERINSTANCE Sqlserver named instance or data source (default: MSSQLServer).
-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.
-i ArcSDE service name; required if the service is not called "esri_sde"
-n Exclude database service from ArcSDE dependent services list.
-N No verification is performed; the operation begins
immediately after being invoked-o Operation (eg -o create)-p ArcSDE administrator DBMS password. ArcSDE for
Coverages password syntax: password ;; layer_admin_password.
-r 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.
-P ArcSDE service user password (Windows service "log on" account password).
-u 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.
-v Registry value-? Prints usage and options
Discussion
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 geodatabasesdesetupmssql - Used for a SQL Server geodatabasesdesetupora8i - Used for a Oracle8i geodatabasesdesetupora9i - 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 -hsdesetup -?
Operationsinstall Create or update the ArcSDE and Geodatabase system tables
and stored procedureslist List the installed ArcSDE versionupgrade updates the ArcSDE and Geodatabase system tables and stored
proceduresupdate_key updates the license for ArcSDE
Options
-D
Database name (not supported on all DBMS)
-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)
DiscussionThe 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 sdesetupora8iArcSDE for Oracle 9i sdesetupora9iArcSDE for SqlServer sdesetupmssqlArcSDE for Informix sdesetupinfxArcSDE 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 frederictonUse the update operation to bring an existing database up-to-date with the latest additions or changes to a new ArcSDE installation.
sdesetupmssql -o upgrade -p halifaxThe list operation returns the current version of an ArcSDE installation.
sdesetupinfx -o list -p charlottetownThe 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
Recommended