ArcSDE 10.1 for PostgreSQL Install Guide - Команда sdeservice

Утилита администрирования sdeservice используется на платформе Windows для управления сервисами ArcSDE и внесения изменений в реестр. При создании сервиса в реестр Windows вносятся записи.

Используйте опцию modify для изменения записей реестра, таких как SDEHOME или SDE_DBA_PASSWORD. Используйте опцию register для внесения новых записей, которые не создаются по умолчанию, например ADMIN_DATABASE. Опция unregister удаляет записи из реестра сервиса.

Опция delete используется для удаления сервиса ArcSDE и всех связанных с ним записей в реестре.

Синтаксис

Инструменты командной строки для администрирования ArcSDE используют синтаксис в стиле UNIX и представление в соответствие со следующими соглашениями:

- <буква> или - <слово>: задает опцию команды, например, -o, -a или -interleave
Регистр символов также учитывается, будьте внимательны при выборе регистра.
Текст, расположенный между знаками < и >: обязательный аргумент; замещается соответствующим значением.
Например, -u <DB_user_name> может иметь вид -u mlogin.
Черта ( | ): список взаимоисключающих аргументов; необходимо выбрать один из списка.
Квадратные скобки ([ ]) : дополнительный параметр; если значение не указано, используется значение по умолчанию.
Фигурные скобки ({ }): содержит список возможных вариантов, разделенных символом черты

sdeservice -o create -p <ArcSDE_admin_password> [-n] [-H <sde_directory>]
[-d {ORACLE,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX | POSTGRESQL,PGINSTANCE}]
[-i <service>] [-u <service_user>] [-P <service_user_password>] [-s <data_source>]

sdeservice -o delete [-d {ORACLE,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX | POSTGRESQL}]
[-i <service>] [-N]

sdeservice -o list [-i <service>]

sdeservice -o modify -r <registry_keyword> -p <ArcSDE_admin_password> -v <new_value> [-i <service>]
[-d {ORACLE,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX | POSTGRESQL}]

sdeservice -o register -r <registry_keyword> -v <value> -p <ArcSDE_admin_password> [-i <service>]
[-d <ORACLE,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX | POSTGRESQL>]

sdeservice -o unregister -r <registry_keyword> -p <ArcSDE_admin_password> [-i <service>]
[-d {ORACLE,SID | SQLSERVER,SQLSERVERINSTANCE | DB2,DB2INSTANCE | INFORMIX | POSTGRESQL}]

sdeservice -h

sdeservice -?

Операции

Операция выполняет определенную задачу, связанную с командой, и задается опцией -o. С помощью команды sdeservice можно выполнить следующие операции:

Операция	Описание
создание	Создание сервиса ArcSDE на сервере Windows.
delete	Удаление сервиса ArcSDE с сервера Windows. Необходимо остановить сервис перед его удалением. Это можно сделать из списка сервисов Windows или с помощью команды sdemon.
список	Отображение информации о сервисе, для всех или только выбранных сервисов ArcSDE.
modify	Изменение строки реестра.
регистрация	Добавление строки в реестр Windows.
unregister	Удаление строки из реестра Windows.

Опции

Каждая операция имеет набор опций. Поскольку опция предваряется определенной буквой, их можно указывать в любом порядке. Опции чувствительны к регистру, будьте внимательны.

В зависимости от операции, некоторые опции являются обязательными, а некоторые - нет, как показано в квадратных скобках ([ ]). С командой sdeservice доступны следующие опции:

Опция	Описание
-d	Задает СУБД, к которой подключается сервис и зависимости сервиса. Зависимости сервиса позволяют задать другие сервисы, которые должны быть запущены до начала работы сервиса ArcSDE. DB2INSTANCE, SQLSERVERINSTANCE, SID и PGINSTANCE являются дополнительными параметрами и используются для определения экземпляра базы данных, удаленной или локальной. SID (по умолчанию: ORCL) DB2INSTANCE (по умолчанию: DB2-0) SQLSERVERINSTANCE: именованный экземпляр SQL Server или источник данных (по умолчанию: MSSQLServer) PGINSTANCE (по умолчанию: postgresql-x64-9.0)
-h или -?	Используйте любую из этих опций, чтобы узнать о синтаксисе команды. Если команда запускается из оболочки С (C shell), используйте -h или "-\?".
-H	Домашняя директория ArcSDE (SDEHOME); требуется, только если не задана переменная SDEHOME или используется несколько сервисов.
-i	Имя сервиса ArcSDE; требуется, если не используется имя по умолчанию, esri_sde.
-n	Исключить сервис базы данных из списка сервисов, зависящих от ArcSDE.
-N	Не выполнять проверку; операция начинается немедленно после получения команды
-o	Задание операции.
-p	Пароль СУБД для администратора базы геоданных
-P	Пароль пользователя сервиса ArcSDE (пароль учетной записи входа в сервис Windows)
-r	Зарегистрировать/отменить регистрацию/изменить следующие записи в реестре Windows: ADMIN_DATABASE: База данных, использующая сервис ArcSDE SDEHOME: Местонахождение программного обеспечения ArcSDE SDE_DBA_USER: Имя пользователя администратора базы геоданных SDE_DBA_PASSWORD: Пароль пользователя-администратора базы геоданных ArcSDE
-s	Имя экземпляра СУБД, к которому подключается сервис ArcSDE
-u	Пользователь учетной записи Windows сервиса ArcSDE Пользователь должен быть пользователем Windows с правами администратора на сервере или ему должны быть предоставлены права входа как привилегированного сервиса. Включает имя домена, если необходимо. Например, если вы входите в домен LAMBERT под именем joe, введите LAMBERT\joe. При создании сервиса, необходимо подключаться этим пользователем. При использовании аутентификации Windows для входа в СУБД, пользователь сервиса должен также иметь разрешение Replace a process уровня токена, что дает возможность переключать безопасное содержание процесса gsrvr.exe на подключающегося пользователя.
-v	Устанавливаемое или изменяемое значение реестра

Примеры

Создание сервиса ArcSDE

Операция create используется для создания нового сервиса ArcSDE на компьютере с ОС Windows. Во всех примерах этой операции, необходимо вручную отредактировать %windir%\system32\drivers\etc\services и %SDEHOME%\etc\services.sde, чтобы добавить имя сервиса и номер порта.

В этом примере создается сервис ArcSDE для Informix:

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

В этом примере создается сервис ArcSDE для Microsoft SQL Server:

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

В этом примере создается сервис ArcSDE, esri_psql, для базы геоданных PostgreSQL на компьютере с названием server4. Имя экземпляра PostgreSQL - postgresql-x64-9.0.

sdeservice -o create -d POSTGRESQL,postgresql-x64-9.0 
-i esri_psql -s server4

Please enter SDE DBA password:

Successfully created and registered esri_psql

Обратите внимание, что в предыдущем примере пароль администратора ArcSDE не был включен в команду с помощью опции -p. Если пароль не указан, вам будет предложено ввести его.

В этом примере создается сервис ArcSDE для SQL Server, указывающий на именованный экземпляр Oceans\GIS1:

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

Имя экземпляра в предыдущем выражении можно было бы задать с помощью опцией -s, поскольку для SQL Server имя экземпляра и источник данных – одно и то же. Например:

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

Примечание:

Предполагается, что администратор ArcSDE, для которого задается пароль (-p), использует имя SDE. Также предполагается, что база данных, к которой применяется сервис, имеет имя SDE. Если администратор ArcSDE не SDE, например, как при использовании схемы DBO в SQL Server, необходимо задать ключ реестра SDE_DBA_USER в имени пользователя DBO, используя sdeservice -o. Если имя базы данных не SDE, необходимо задать ключ реестра ADMIN_DATABASE в соответствии с именем базы данных, используя команду регистрации sdeservice -o.

Удаление сервиса ArcSDE

Операция delete используется для удаления сервиса ArcSDE с сервера Windows.

В этом примере сервис ArcSDE удаляется из PostgreSQL:

sdeservice -o delete -i esri_pgs -d POSTGRESQL

Отображение информации о сервисе

Операция list отображает информацию обо всех сервисах ArcSDE или только об указанных в команде. Ниже приведен пример информации по сервису miss:

sdeservice –o list –i miss

SDE service Information
----------------------------------
RDBMS: SQLServer
Name: ArcSde Services(miss)
SDEHOME: C:\ArcGIS\ArcSDE\sqlexe
Datasource: MOOSE
Admin_database: gisdb
Version: 10.0.0
Status: SERVICE_RUNNING

Подсказка:

Если имя сервиса esri_sde, опцию -i задавать не нужно; можно ввести просто sdeservice -o list.

Добавление ключа в реестр Windows

В этом примере происходит регистрация ADMIN_DATABASE (базы данных с системными таблицами) с именем Seamounts:

sdeservice -o register -d SQLSERVER -r ADMIN_DATABASE 
-v Seamounts -i sde2 -p spatial.dat

Изменение ключа реестра

Используйте операцию modify для изменения записи реестра Windows. В этом примере меняется ключ реестра, задающий местоположение SDEHOME:

sdeservice -o modify -r SDEHOME -p spatial.data 
-v c:\ArcSDE2\ora10gexe -d ORACLE,ORCL

Удаление строки ключа из реестра Windows

Операция unregister удаляет запись из реестра Windows. Здесь удаляется ключ реестра, добавленный в предыдущем примере:

sdeservice -o unregister -r ADMIN_DATABASE -d SQLSERVER 
-i sde2 -p spatial.data

9/10/2013