Утилиты

В этой главе описаны утилиты, включенные в MetaFrame XP, которые вы можете использовать для настройки, управления, выявления неисправностей.

В этой главе описаны следующие утилиты:
DRIVEREMAP
DSVIEW
IMAPORT
MSGHOOK
QPRINTER
QUERYDC
QUERYDS
QUERYHR
SCCONFIG


DRIVEREMAP

Эта утилита используется для изменения букв драйвов сервера MetaFrame XP. Ранние версии MetaFrame XP запрашивали у вас изменение букв дисков во время инсталляции MetaFrame. С выпуском Feature Release 2 вы теперь можете использовать driveremap как отдельную программу. В ранних версиях она называлась drvremap.exe.

После установки MetaFrame XP, driveremap находится в c:\Program Files\Citrix\System32. При переходе от FR1 к FR2 утилита помещается в каталог %systemroot%\system32.

Важно. Если вы устанавливаете MetaFrame XP Feature Release 2 на сервер, не содержащий ранней версии установленного MetaFrame, запустите driveremap до установки MetaFrame XP Feature Release 2. Citrix рекомендует не менять буквы драйвов сервера после установки MetaFrame XP и любых приложений, предназначенных для публичного доступа.

Синтаксис

driveremap /?
driveremap /drive:M
driveremap /u
driveremap /noreboot
driveremap /IME

Опции
/?
Выводит диалоговое окно со списком доступных опций. Этот эже диалог показывается при неверном использовании параметров.
/drive:M
Указывает букву для первого переназначенного драйва. Буква должна быть в верхнем регистре.
/u
Тихая автоматическая установка. Эта опция должна использоваться совместно с опцией /drive:.
/noreboot
Подавляет диалог “Restart Computer” и не перезагружает систему. Сitrix настоятельно рекомендует перезагрузиться после запуска этой утилиты
/ime[filename]
Изменяет букву, указанную в
Software\Microsoft\Windows\CurrentVersion\Ime\Japan\IMEJP\Dictionaries
для всех ветвей вr HKEY_USERS.
 

Пример

driveremap /u /drive:M /noreboot

Аспекты применения


DSVIEW

Эта утилита отображает содержимое хранилища данных, локального хоста, локального кеша и ищет ContextId и UID. Она имеет интерфейс пользователя, показанный ниже.

Dsview заменяет IMATester, входившую в состав ранних версий MetaFrame.

Только локальный администратор может запустить dsview.


IMAPORT

Используйте эту утилиту для изменения порта TCP, используемого службой IMA - например, для коммуникации между серверами, разделенными серверами. Утилитой imaport вы можете изменить порт TCP, на котором служба IMA слушает входящие и исходящие данные, используя до трех портов TCP.

Следующая таблица показывает, какие номера портов по умолчаию использует IMA:

Порт Назначение Направление
2512 Межсерверные коммуникации в ферме Входящее
2513 Связь от CMC к серверу Входящее
2512 В непрямом режиме - от сервера к хранилищу данных Исходящее

После изменения портов вы должны перезапустить службу IMA


Синтаксис


imaport /query
imaport /set [ ima:num | ds:num | cmc:num ]
imaport /reset [ ima | ds | cmc | all ]

Параметры

num
Номер порта
/query
Запрос текущих установок
/set
Установка указанного номера порта
ima:num
Установка номера порта для IMA
cmc:num
Установка номера порта для Citrix Management Console
ds:num
Установка номера порта хранилища данных (только для непрямых серверов)
/reset
Сброс номеров в значения по умолчанию
ima
Установка номера порта IMA в 2512.
cmc
Установка номера порта для Citrix Management Console в 2513.
ds
Установка порта хранилища данных в 2512
all
Сброс всех номеров портов в значения по умолчанию


Imaport меняет номера портов TCP только для локального сервера. Каждый сервер может иметь порты IMA, назначенные на разные порты TCP. Citrix рекомендует использовать одинаковые номера на всех серверах.

Перед переназначением портов выполните команду netstat -a для вывода списка испльзуемых портов TCP и UDP. Citrix рекомендует не использовать порты, уже занятые другими приложениями или службами. Imaport не может обнаружить, что порт уже используется другим приложеием.

После изменения номера порта для Citrix Management Console вы должны установить в ней этот эе номер порта для исходящих соединений командой
ctxload -port:num


MSGHOOK

Эта утилита отображает весь траффик IMA на сервере-члене.

Синтаксис

msghook

Запускайте msghook только если об этом вас попросит служба технической поддержки или инженер Citrix. При запуске эта утилита сильно снижает производительность сервера MetaFrame XP.

По умолчанию Msghook не устанавливается. Вы можете найти ее на CD-ROM в каталоге \W2K\support\debug\i386

Только администратор может запустить эту команду.


QPRINTER

Используйте эту утилиту для наблюдения очередью процесса репликации драйвера принтера и для импорта параметров переназначения имени принтера в хранилище данных.

Синтаксис

qprinter [/replica]
qprinter [/imprmapping mappingfilename]

Параметры


mappingfilename
Определяет полный путь к текстовому файлу, содержащих импортируемые параметры переназначния. Имя файла не должно превышать 256 символов и не должно содержать кавычки.

Опции

/replica
Отображение всех элементо в очереди, которые еще не завершены
/imprmapping mappingfilename
Импорт переназначений принтеров из тектового файла в хранилище данных. Файл может быть в формате Wtsprnt.inf или Wtsuprn.txt.

Замечания

Опция /replica отображает все элементы очереди, включая испорченные и неудавшиеся события.

Опция /imprmapping позволяет централизованное управление переназначением имен принтеров. Можно один раз импортировать файл на любой сервер фермы, чтобы он стал доступным для всех серверов в ферме. /imprmapping не обрабатывает неверно сформатированные файлы. Для проверки правильности импорта используйте Citrix Management Console.

Инсталляция MetaFrame XP в првую очередь пробует импортировать файл Wtsuprn.txt, а затем Wtsprnt.inf. Если оба этих файлов не удалось загрузить, ошибка не возвращается. Используйте опцию /imprmapping для ручного имполрта каждого файла.


QUERYDC

Используйте эту утилиту для определения коллектора данных в указанной зонею. Без параметров эта утилита выводит зону по умолчанию для текущего хост-сервра и имя коллектора текущей зоны.

Синтаксис


querydc [-a]
querydc [-e]
querydc [-z zonename]
querydc [-?]

zonename опредеяет имя запрашиваемой зоны. Если имя содержит пробелы, заключите его в кавычки.

Опции

-a
Отображение всех зон в ферме и их текущие коллекторы для каждой из них.
-e
Принудить выборы нового коллектора данных в текущей зоне
-z zonename
Отобразить коллектор для указанной зоны zonename.
-?
Вывод подсказки по утилите

Замечания
Querydc использует службу IMA для запроса локального коллектора данных. Следовательно, для работы querydc необходима запущенная служба IMA.
По умолчанию Querydc не устанавливается. Утилита находится на CD-ROM в каталоге
\W2K\support\debug\i386

Только администратор может запустить эту команду.


QUERYDS

Поскольку вся динамическая информация хранится в таблицах в RAM коллектора данных, эта утилита исползуется для запроса текщей информации.

Синтаксис

queryds tables
queryds /table:tablename
queryds /query:querystring
(Строка запроса не обязательна, но вы должны указать имя таблицы)

Параметры

tablename
Имя таблицы коллектора данных. Имена таблиц чувствительны к регистру.

Опции

tables
Вывод полного списка всех таблиц, доступных для запроса
/table:tablename
Выводит на экран все содержимое таблицы tablename.


Замечание. Вы можете использовать queryds для определения доступных серверов в ферме.
queryds получает информацию из таблиц локального коллектора. Например, таблица PN_Table содержит информацию о всех доступных серверах, которые принимают соединения Program Neighborhood. Для просмотра содержимого таблицы введите команду:
queryds /table:PN_Table
На экран будет выведено приблизительно следующее:

   [PN_Table]: 1 records.
   name:588f
   host:XPSERVER1
   zone:Zone1
   Version:1
   Tcp:enabled
   Ipx:enabled
   Netbios:disabled


В ферме из 100 серверов список займет 702 строки. Используйте утилиты findstr и sort для фильтрации вывода.
В первой строке показано общее число записей в PN_Table. Это чесло соответствует числу серверов в PN_Table. Для определения количества работающих серверов выполните команду:

queryds /table:PN_Table | findstr /r PN_Table

Нижеприведенная команда отфильтровывает строки со словом “host” и выводит список работающих серверов в алфавитном порядке:

queryds /table:PN_Table | findstr /r host | sort

Queryds по умолчанию не инсталлируется. Она находится в каталоге \W2K\support\debug\i386 на CD-ROM MetaFrame XP, Feature Release 2 CD.


QUERYHR

Вывод информации о серверах-членах в ферме. Запуск без параметров выводит полный список всех серверов в ферме.

Синтаксис

queryhr [-z]
queryhr [-h zonename]
queryhr [-l]
queryhr [-n hostname]
queryhr [-i hostid]
queryhr [-N]
queryhr [-d hostid]
queryhr [-?]

Параметры

zonename
Имя запрашиваемой зоны. Если имя содержит пробелы, заключите его в кавычки.
hostname
Имя сервера-члена
hostid
Идентифкатор (host ID) сервера-члена.

Опции

-z
Вывод всех доступных зон
-h zonename
Вывод всех серверов-членов в указанной зоне zonename.
-l
Вывод записи host локального сервера
-n hostname
Вывод записи host для указанного сервера-члена hostname (регистр не важен)
-i hostid
Вывод записи для сервера-члена, определяемого идентификатором
-N
Вывод имени фермы
-d hostid
Удаляет запись IMA о хосте из коллектора данных, хранилища данных и локального кеша.
-?
Вывод подсказки

Замечания

Queryhr получает информацию из локального кеша.

Queryhr лучше всего использовать для вывода информации о серверах фермы - о ранжировании коллекторов данных, идентификаторах хостов, именах зон и именах хостов.

Предупреждение. Не используйте опцию -d на правильно работающих серверах. После запуска утилиты с ключом -d сервер перестает быть членом фермы и служба IMA больше не запустится. Для возобновления функционирования сервера вам следует его переинсталлировать.
Ключ -d имеет особое назначение. См. раздел "Восстановление после сбоя инсталляции"


SCCONFIG

По умолчанию процессы, необходимые для правильного функционирования смарт-карт (Winlogon.exe и Lsass.exe) включены только в MetaFrame XP Feature Release 2. Утилита Scconfig.exe устанавливается во время инсталляции Feature Release 2 и может использоваться для разрешения/запрещения использования функциональности смарт-карт.

Синтаксис

scconfig [/?]
scconfig [/server:sss] [/q]
scconfig [/farm] [/q]
scconfig [/server:sss] [/query]
scconfig [/farm] [/query]
scconfig [/server:sss] [/logon:on|off]
scconfig [/farm] [/logon:on|off]
scconfig [/server:sss] [/enable_process:ppp]
scconfig [/farm] [/enable_process:ppp]
scconfig [/server:sss] [/disable_process:ppp]
scconfig [/farm] [/disable_process:ppp]
scconfig [/server:sss] [/inherit:on|off]

где sss - имя сервера, ppp - имя процесса (например, Outlook.exe).

Опции

/farm
Просмотр или модификация на уровне фермы
/q, /query
Запрос текущих установок
/logon:on|off
Включение/выключение регистрации с использованием смарт-карты на сервере в ферме
/enable_process:ppp
Разрешить поддержку смарт-карт для указанного процесса
/disable_process:ppp
Запретить поддержку самрт-карт для указанного процесса
/inherit:on|off
Унаследовать настройки из фермы
/server:sss
Имя сервера для просмотра или модификации. По умолчанию это локальный сервер.

Пример.
Чтобы использовать цифровую подпись и шифрование, используя смарт-карту, в Microsoft Outlook, вы должны разрешиь процесс Outlook.exe. На удаленном сервере подсистема MetaFrame перехватывает событие обновления хранилища данных и делает необходимые изменения в реестре для включения или выключения этой особенности.
Используйте опцию /farm для запроса или установки настроек во всей ферме.
Используйте опцию /inherit для определения, должен ли сервер унаслеовать настройки фермы.


Возврат