Утилита webinst

1. Общее описание

Утилита предназначена для настройки веб-серверов с целью поддержки работы веб-клиента. Утилита работает в среде ОС Windows и Linux, и входит в состав дистрибутива системы.

webinst [-publish] | -delete <веб-сервер>  -wsdir <виртуальный каталог>
-dir <физический каталог>
-connstr <строка соединения>
-confpath <путь к файлу httpd.conf>
-descriptor <путь к файлу default.vrd>
[-osauth]

ВНИМАНИЕ! Название и значение параметра должны разделяться символом пробел. Если параметр содержит пробелы, он должен быть заключен в кавычки (“). Если внутри параметра есть символ кавычки, то внутренние кавычки должны быть удвоены.
ВНИМАНИЕ! При запуске утилиты допустимо указание только одного из параметров: iis, apache2, apache22 или apache24.
ВНИМАНИЕ! Для выполнения публикации утилита должна запускаться от имени администратора. При работе в ОС Windows будет выполняться запрос на повышение привилегий.
-publish  Выполняется публикация веб-клиента на веб-сервер.
-delete  Выполняется удаление публикации из указанного каталога (включая удаление физического каталога с публикацией).
ПРИМЕЧАНИЕ. При удалении публикации достаточно указания только параметра -wsdir. Остальные параметры могут указываться для контроля работы.
Указывает, для какого веб-сервера будет выполняться действие (публикация или удаление публикации):
● -iis – веб-сервер семейства Microsoft Internet Information Services версий 5.1, 6.0, 7.x, 8.x, 10.0 (только при использовании с ОС Windows).
● -apache2 – веб-сервер Apache 2.0.
● -apache22 – веб-сервер Apache 2.2.
● -apache24 – веб-сервер Apache 2.4.
При использовании веб-сервера Apache 2.4 можно не указывать путь к конфигурационному файлу с помощью параметра -confpath.
Следует учитывать, что для веб-сервера Apache версии 2.2 и 2.4 различаются изменения, выполняемые в конфигурационном файле веб-сервера.
Поэтому неверное указание версии веб-сервера приведет к неработоспособности публикации.
-wsdir  Имя виртуального каталога.
-dir  Имя физического каталога, куда будет отображен виртуальный каталог веб-сервера. Каталог должен существовать.
Для веб-сервера IIS 7.x и старше не поддерживается публикация в том случае, если значение этого параметра указывает на каталог %SYSTEMDRIVE%
\Inetpub\wwwroot.
ПРИМЕЧАНИЕ. Имя каталога не должно завершаться символом «\», если оно заключено в кавычки. Правильно: “c:\my path”, неправильно: “c:\mypath\”.
-connstr  Строка соединения с информационной базой. Подробности см. описание строки соединения встроенной справки конфигуратора.
-confpath Полный путь к конфигурационному файлу (httpd.conf) веб-сервера Apache. Данный параметр применяется только при использовании веб-серверов
Apache.
-descriptor Позволяет выполнить публикацию по шаблону, заданному существующим файлом, который задается в данном параметре (включая путь к файлу). Имя
файла-шаблона не обязательно должно быть default.vrd. При выполнении публикации существующий файл default.vrd полностью замещается файлом-шаблоном. Если одновременно с данным параметром указаны параметры -wsdir или -connstr, то значения этих параметров замещают собой значения атрибутов base и ib (соответственно) элемента point.
В том случае, если параметр -descriptor указывается одновременно с параметром -delete, то из файла-шаблона используется имя виртуального каталога (атрибут base элемента point) и строка соединения информационной базы (атрибут ib элемента point). Публикация будет удалена только в случае совпадения обоих значений у удаляемой публикации и файла-шаблона.
-osauth только для IIS  При публикации настраивает использование аутентификации ОС на веб-сервере. Данный параметр применяется только при использовании веб-серверов IIS.

2. Примеры публикации

Пример команды публикации для IIS 7.0 и старше:

webinst –publish -iis -wsdir demo -dir "c:\inetpub\demo" -connstr "Srvr=server:1741;Ref=demo;"

В данном примере выполняется публикация веб-клиента со следующими параметрами:
● Виртуальный каталог: demo (параметр -wsdir demo);
● Физический каталог, в который отображается виртуальный каталог: C:\inetpub\demo (параметр -dir “c:\inetpub\demo”);
● Строка соединения с информационной базой: Srvr=server:1741;Ref=demo; (параметр -connstr “Srvr=server:1741;Ref=demo;”, клиент-серверный вариант информационной базы).
Пример команды публикации для Apache 2.2:

webinst –publish -apache22 -wsdir DemoWS -dir "c:\apache.www\demows"
 -connstr "File=""c:\my db\demows"";" -confpath "C:\Program Files\Apache
 Software Foundation\Apache2.2\conf\httpd.conf

В данном примере выполняется публикация веб-клиента со следующими параметрами:

• Виртуальный каталог: DemoWS (параметр -wsdir demoWS);
• Физический каталог, в который отображается виртуальный каталог: C:\apache.www\demows (параметр -dir “c:\apache.www\demows”);
• Строка соединения с информационной базой: File=”c:\my db\demows”; (параметр -connstr “File=””c:\my db\demows””;” , файловый вариант информационной базы);
• Конфигурационный файл веб-сервера Apache: C:\Program Files\Apache Software Foundation\Apache2.2\conf\httpd.conf (параметр -confpath
• “C:\Program Files\Apache Software Foundation\Apache2.2\conf\httpd.conf”).

Пример публикации с использование файла-шаблона:

webinst -publish -iis -wsdir demoMA -dir "c:\inetpub\wwwroot\demoMA" 
-connstr "Srvr=server:1741;Ref=demo;" -descriptor template.vrd

В данном примере:
● Выполняется публикация на веб-сервере IIS (параметры -publish -iis);
● Виртуальный каталог: demoMA (параметр -wsdir demoMA);
● Физический каталог, в который отображается виртуальный каталог: c:\inetpub\wwwroot\demoMA (параметр -dir “c:\inetpub\wwwroot\demoMA”);
● Строка соединения с информационной базой Srvr=server:1741;Ref=demo; (параметр -connstr “Srvr=server:1741;Ref=demo;”);
● Остальные параметры публикации будут получены из файла-шаблона template.vrd (параметр -descriptor template.vrd).

Пример команды удаления публикации для IIS:

webinst –delete –iis –wsdir DemoWS

В данном примере выполняется удаление публикации, сделанной в виртуальном каталоге:
● Виртуальный каталог: DemoWS (параметр –wsdir DemoWS). Остальные параметры определяются автоматически по этому имени.