Утилита webinst

Печать (Ctrl+P)

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). Остальные параметры определяются автоматически по этому имени.

Previous Article
Next Article

Добавить комментарий

Ваш адрес email не будет опубликован.

Этот сайт использует Akismet для борьбы со спамом. Узнайте, как обрабатываются ваши данные комментариев.