instruction_iis

Настройка web-сервисов под IIS
Настройка web-сервисов под IIS состоит из нескольких этапов:
Настройка web-сервера под IIS;
Настройка параметров строки соединения клиентского приложения.
Если соединение выполняется через протокол https, необходимо также выполнить настройку SSLсоединения.
Настройка web-сервера под IIS
Terrasoft CRM поддерживает web-сервисы. Для настройки web-сервера под Internet Information
Services (IIS) необходимо выполнить следующие действия:
1. При установке Terrasoft CRM в окне выбора компонентов установить опцию [Web Services
Сервер].
2. Настроить Internet Information Services. Для этого необходимо:
Выполнить команду контекстного меню [Мой компьютер] -> [Управление].
В дереве управления компьютером выбрать [Службы и приложения] -> [Internet Information
Services].
Создать виртуальный каталог, воспользовавшись контекстным меню IIS. Нужно указать
псевдоним – имя, которое будет использоваться в url для доступа к Terrasoft CRM через web, и путь к
каталогу «Bin» инсталляционной директории приложения (по умолчанию <C:\Program Files\<Название
продукта>\Bin>).
Убедитесь, что пользователю, обращающемуся к виртуальной директории, разрешено
выполнение сценариев и других приложений.
Если у Вас ОС Windows Server 2003, то Вам обязательно необходимо предоставить доступ на
TSWebServicesServerLibrary.dll в Web Service Extensions:
3. Настроить параметры соединения с БД локально, используя соединение MS SQL или Firebird
4. При настройке веб-сервисов версии 3.1.1 и новее необходимо:
скопировать файл «Configs.xml» из пользовательской директории (пусть по умолчанию
«%appdata%\Terrasoft CRM\3.2\Settings\») в директорию Settings (рабочего каталога Terrasoft);
в файле RunSettings.xml (находится в папке Settings, рабочего каталога Terrasoft) добавить
(изменить, если он есть) параметр:
<RunSettings UserSettingsDirectory="C:\Program Files\Terrasoft CRM X25 3.2\Settings"
SessionUserName="" SessionPassword="" />
где «UserSettingsDirectory» - путь к папке Settings (рабочего каталога Terrasoft).
5. Указать параметры проверки сессий (в секундах) в файле WebServerSettings.ini, расположенном
в папке «Settings» инсталляционной директории приложения:
TimeoutInterval – интервал ожидания обращений от пользовательской сессии. По истечению
этого времени, если обращений от сессии не было – она уничтожается.
TimerInterval – интервал проверки старых сессий. С этой периодичностью сервер проверяет
сессий на предмет превышения интервала ожидания.
Если при работе системы возникает ошибка: HTTP 413 Request Entity too Large,
необходимо на сервере в командной строке выполнить команды:
cd C:\Inetpub\AdminScripts
cscript adsutil.vbs set w3svc/1/uploadreadaheadsize 26240000
или
!
cd C:\Inetpub\AdminScripts
cscript adsutil.vbs set w3svc/uploadreadaheadsize 26240000
и перезапустить IIS.
Это увеличит максимально возможный размер обращения, принимаемого от клиента.
Для того, что бы проверить, корректно ли отрабатывает IIS, Вы можете ввести в адресную строку
браузера строку вида:
http://имя_сервера/алиас_виртуальной_директории/TSWebServicesServerLibrary.dll/soap/IServer
Если в браузере отобразится xml нижеуказанного вида – это будет означать корректность настроек
и работы IIS.
Если же Вы используете настройку веб-сервисов через определенный порт, то строка соединения
будет иметь вид:
http://имя_сервера:порт/алиас_виртуальной_директории/TSWebServicesServerLibrary.dll/soap/IServer
Если же возвращается ошибка — проверьте, доступен ли в IIS сайт по умолчанию.
Для этого на сервере, в строке браузера введите: http://localhost/
При корректной работе IIS вы увидите список файлов и виртуальных директорий доступных в
корневом каталоге:
Настройка параметров строки
использованием web-сервисов
соединения
с
БД
клиентского
приложения
с
После того, как выполнены настройки web-сервера, нужно настроить соединение с БД на
локальном компьютере. Для этого:
1. В окне создания / редактирования соединения необходимо в поле [Тип БД] выбрать [Web
Services].
2. В окне редактирования соединения (Рис. 3.32) заполнить необходимые поля:
Рис. Error! No text of specified style in document..1 – Настройка соединения клиентского
приложения (web-сервисы)
[URL] – адрес для доступа к БД с клиентского компьютера следующего вида:
http://имя_сервера/алиас_виртуальной_директории/TSWebServicesServerLibrary.dll/soap/IServer
Если же Вы используете настройку веб-сервисов через определенный порт, то строка соединения
будет иметь вид:
http://имя_сервера:порт/алиас_виртуальной_директории/TSWebServicesServerLibrary.dll/soap/IServer
При использовании протокола https в окне редактирования соединения появится кнопка
[Параметры SSL], позволяющая настроить SSL соединение. Подробнее о настройке SSL-соединения
можно прочитать в следующей главе.
[Параметры прокси] нужно активизировать в случае, если соединение устанавливается через proxyсервер. Для proxy-сервера необходимо указать IP-адрес и порт. Если proxy-сервер требует
авторизации, необходимо установить опцию [Использовать авторизацию] и указать имя пользователя
и пароль.
[Конфигурация] – название конфигурации, установленной на сервере.
[Уровень сжатия] – уровень сжатия данных. Для слабых каналов рекомендуется использовать
максимальный уровень сжатия данных – 9.
Завершение настройки строки соединения с БД под Web-сервер осуществляется по стандартной
схеме описанной выше.
P.S. Если у Вас возникает сообщения вида:
Попробуйте, пожалуйста, настроить соединение клиентского приложения на другом ПК (не на
сервере IIS или БД).