На уроках с 1 по 4 вы настроили сервер приложений Panther, запустили клиент, сохранили компонент службы и экран клиента в нужных библиотеках, обновили файл JIF и протестировали экран клиента. В конце Урока 4 клиент сделал служебные запросы к серверу. На этом уроке вы настроите веб-приложение Panther и протестируете тот же экран клиента в веб-браузере.

Сервер веб-приложений Panther установлен на вашем HTTP-сервере и может работать со следующими веб-архитектурами:

• CGI (общий интерфейс шлюза)
• ISAPI (Internet Server API для Microsoft Internet Information Server)
• NSAPI (API сервера Netscape)

Когда браузер получает запрос на экран Panther, HTTP-сервер передает имя экрана в Panther. Panther открывает экран, выполняет любую обработку на экране, включая вызовы службы, генерирует HTML для отображения экрана, после чего HTTP-сервер передает HTML обратно в запрашивающий его браузер. Для получения дополнительной информации о веб-приложениях см. Руководство веб-разработчика .

В этом уроке показано, как настроить веб-приложение Panther, и он не зависит от всех последующих уроков этого руководства.

В этом уроке вы узнаете, как:

• Запустите диспетчер настройки Panther Web.
• Подключите модуль JPL для обработки процедур запуска и завершения работы сервера веб-приложений Panther.
• Запустите сервер веб-приложений Panther и проверьте соединение.

Дополнительные сведения о процессах сервера веб-приложений

Сервер веб-приложений состоит из трех исполняемых процессов для каждого приложения: реквестера, диспетчера и jserver.

• Requester — принимает запрос CI/ISAP/NSAPI от HTTP-сервера, запрашивает у диспетчера доступный j-сервер, передает запрос j-серверу, ждет ответа и передает его обратно на HTTP-сервер.
• Диспетчер — действует как интерфейс между запрашивающей стороной и jserver. Диспетчер отслеживает доступные и занятые j-серверы и предоставляет доступный j-сервер запрашивающей стороне.
• Jserver — обрабатывает запрос CGI/ISAPI/NSAPI от запрашивающей стороны, выполняя всю обработку приложения.

Перед началом этого урока

Прежде чем приступить к этому уроку, вам необходимо знать следующее:

• Расположение установки вашего сервера веб-приложений Panther:

 ____________________________________________ 

• UNIX: расположение по умолчанию — /usr/prolifics .
• Windows: расположение по умолчанию — C:\Prolifics\Panther .

• Расположение каталога программ вашего HTTP-сервера:

 ____________________________________________ 

Общие имена каталога программы включают cgi-bin и scripts.

• URL-адрес веб-менеджера настройки Panther на вашем HTTP-сервере, например:

 http://hostMachineName/ProgramDirectory/websetup 

 ____________________________________________ 

В этом руководстве предполагается, что сервер приложений Panther и сервер веб-приложений Panther установлены на одном компьютере или доступны через сеть. Чтобы протестировать экран в Интернете, ваш HTTP-сервер должен иметь доступ к каталогу вашего приложения.

Запустите диспетчер веб-установки

Каждое веб-приложение Panther должно иметь файл инициализации, который содержит параметры конфигурации для приложения. Panther Web Setup Manager поможет вам создать новый файл инициализации (или обновить существующий).

1. Запустите веб-браузер (например, Mozilla Firefox или Microsoft Internet Explorer).
2. В окне URL-адреса введите расположение Panther Web Setup Manager.

   HTTP-сервер UNIX:

    http://   hostMachineName   /   ProgramDirectory   /websetup 

   HTTP-сервер Windows:

    http://   hostMachineName   /   ProgramDirectory   /websetup.exe 

3. Убедитесь, что переключатель Создать приложение выбран.
4. Выберите Продолжить.

Введите расположение программ

Вы назначаете каждому веб-приложению уникальное имя, которое используется для имени программы запроса приложения и файла инициализации приложения (. ini ).

5. В поле Имя приложения введите уникальное имя для идентификации веб-приложения этого урока, например tut_webapp .
6. Для SMBASE введите полный путь к установке сервера веб-приложений Panther (который вы записали на стр. 5-2).
7. В поле Program Directory введите путь к каталогу программ вашего HTTP-сервера (который вы записали на стр. 5-2).

   Примечание: Это должен быть путь к каталогу, а не URL-адрес браузера.

8. В качестве типа приложения выберите CGI.

   (Существует три типа программ запроса. В зависимости от вашей платформы ваши варианты могут включать CGI, NSAPI и ISAPI. )

9. Выберите Продолжить.

   Теперь программа создаст файл .ini и исполняемый файл для вашего приложения (например, tut_webapp .ini и исполняемый файл tut_webapp ). Следующий экран сообщит вам, что оба файла созданы; следующие шаги будут заключаться в обновлении файла инициализации с правильными настройками.

10. Выберите ОК.

Проверьте настройки вашего сервера веб-приложений

В левом фрейме вы увидите значки для настроек инициализации, специфичных для сервера веб-приложений Panther. Когда вы нажимаете на каждую настройку, появляется сопровождающее объяснение того, как установить эту переменную. Большинство настроек пока можно оставить по умолчанию; однако следующие шаги проведут вас через настройки, которые необходимо отредактировать или перепроверить:

11. В Application Directory введите путь, по которому вы создали свой proltut 9Каталог 0089 в Уроке 1.
12. Выберите «Исполняемые файлы сервера», чтобы указать расположение исполняемых файлов диспетчера и jserver. Как правило, это путь к каталогу util установки сервера веб-приложений.
13. В диспетчере задайте или проверьте полный путь к исполняемому файлу диспетчера.
14. На сервере задайте или проверьте полный путь к исполняемому файлу jserver.
15. Выберите переменные сервера.
16. В поле Количество серверов установите значение 5. Это количество одновременных пользователей. Поскольку этот параметр сильно влияет на производительность, его необходимо установить для каждого веб-приложения.
17. Выберите Лицензирование.
18. В файле лицензии укажите или проверьте путь к файлу license.dat.
19. Выберите Продолжить.

Общие параметры среды

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

20. В SMBASE задайте или проверьте параметр установки сервера веб-приложений.
21. Выберите Initial JPL.
22. В SMINITJPL введите initial.jpl .

    Это имя файла JPL, который будет запускаться при запуске сервера веб-приложений. (Позже в этом уроке вы добавите этот файл JPL в клиентскую библиотеку.)

23. Выберите библиотеки начальной разработки.
24. В SMFLIBS установите или проверьте настройки клиентских библиотек:

     client.lib|com mon.lib. 

25. ( только для UNIX ) Выберите путь к общей библиотеке.
26. ( UNIX только ) В зависимости от операционной системы введите один из следующих:
    • Задайте для LD_LIBRARY_PATH полное имя пути WebInstallDir/lib .
    • (AIX) Задайте для LIBPATH полный путь WebInstallDir/lib .
    • (HPUX) Задайте для SHLIB_PATH полное имя пути WebInstallDir/lib .

Трехуровневая конфигурация

В зависимости от того, используете ли вы сервер веб-приложений Panther на компьютере, отдельном от вашего сервера приложений Panther, вам потребуется установить этот параметр одним из двух способов, как описано ниже.

27. Выберите 3-уровневую конфигурацию в меню слева.
    • ( Если сервер приложений Panther и сервер веб-приложений Panther запущены на одном компьютере ): В файле конфигурации JetNet ( SMRBCONFIG ) введите путь к каталогу, в котором вы создали файл broker.bin в Уроке 2. Оставьте строки для SMRBHOST и SMRBPORT пустой.
    • ( Если серверы работают на разных машинах ): оставьте строку для файла конфигурации JetNet ( SMRBCONFIG ) пустой. Введите информацию для SMRBHOST (см. Шаг 18 на стр. 1-9 в Уроке 1 для UNIX и Шаг 11 на стр. 1-21 для Windows) и SMRBPORT (см. Шаг 22 на стр. 1-10 в Уроке 1 для UNIX и Шаг 17 на стр. 1-23 для Windows).

28. Если вы используете сервер веб-приложений Panther на компьютере, отличном от сервера приложений Panther, вам необходимо установить значение для определенных платформ. В нем нет необходимости, если вы используете JetNet или Oracle Tuxedo 6.4 или более позднюю версию. Выберите одно из значений ниже и введите его в поле «Устройство рабочей станции»:
    • Для платформ Oracle Solaris введите:

     /dev/tcp. 

    • Для платформы SCO введите:

     /dev/inet/tcp. 

29. Выберите путь.
30. Убедитесь, что путь указан в каталоге util установки сервера веб-приложений. Если исполняемый файл jserver отсутствует в каталоге Panther webutil , необходимо указать правильный путь к jserver 9Каталог 0089 здесь.
31. Выберите Продолжить.

Укажите параметры базы данных и рабочей станции jserver

На следующем экране можно ввести дополнительные переменные среды для таких приложений, как базы данных. Например, если вы устанавливали переменные для базы данных Oracle, введите переменную в разделе «Настройки» (например, ORACLE_HOME ) и имя пути в разделе «Значение» (например, /usr/oracle ). Вы также будете устанавливать доступ к файлу JIF.

32. В разделе «Настройка» введите SMTPJIF , переменную Panther, которая идентифицирует файл JIF.

    Примечание: Если отображается параметр EnableWebId, обратите внимание, что он не будет использоваться в руководстве.

33. В поле Значение введите jif.bin .
34. Выберите Продолжить. Экран информирует вас о том, что ваше веб-приложение Panther создано.
35. Выберите Запустить приложение.

Добавить подпрограммы JPL в клиентскую библиотеку

Когда сервер веб-приложений Panther запускается, он ищет процедуру JPL web_startup для обработки любой необходимой обработки запуска, открытия и закрытия соединений с API промежуточного программного обеспечения (и, следовательно, с базой данных) и создания глобальных переменных. Точно так же, когда сервер выключен, он ищет подпрограмму web_shutdown , к которой обращаются все пользователи веб-приложения, для выполнения такой обработки, как очистка. Обе процедуры находятся в модуле JPL initial.jpl, который находится в учебной библиотеке. Скопировав initial.jpl в вашу клиентскую библиотеку и установив SMINITJPL в proweb.ini, эти подпрограммы автоматически запускаются при инициализации сервера веб-приложений.

Подробнее о JPL

JPL — это мощный язык сценариев с синтаксисом, подобным C. Вы можете писать и редактировать модули JPL непосредственно в среде редактора, используя редактор JPL или предпочитаемый редактор тестов. Вы также можете писать процедуры JPL непосредственно в библиотеку и вызывать эти процедуры из объектов на ваших экранах.

Вы попрактикуетесь в написании и выполнении JPL на уроке 13 этого руководства. Дополнительные сведения о командах и синтаксисе JPL см. в интерактивном Руководстве по программированию.

36. Для клиента UNIX:
    • Войдите на сервер приложений Panther и перейдите в каталог приложений:

     cd имя пользователя/пролтут 

    • Повторно применить настройки:

     . setup.sh 

    • Вызвать редактор, запустив исполняемый файл клиента, производитель . В командной строке введите:

     производитель 

37. Для клиента Windows:
    • В меню «Пуск» выберите ProgramsPanther ClientTutorial (папка)Tutorial.
    • Когда откроется экран «Подключение», проверьте настройки хоста и порта для сеанса промежуточного ПО и нажмите «ОК».

38. Выберите FileOpenJPL.

    Откроется диалоговое окно "Открыть модуль JPL".

    • Если tutorial.lib не открыт, выберите «Открыть» и выберите его в диалоговом окне «Открыть библиотеку». (Вам нужно указать путь к каталогу /prolifics/samples/tutorial/, чтобы найти этот файл).
39. Выберите tutorial.lib из списка открытых библиотек и дважды щелкните initial.jpl в списке участников, чтобы открыть его.

    Файл initial.jpl открывается в диалоговом окне Текст программы JPL.

40. Выберите «Сохранить как». Диалоговое окно сохранения JPL открывается с initial.jpl в поле Участник.
41. Выберите client. lib в списке библиотек. Выберите ОК.

    Файл initial.jpl сохраняется в client.lib .

42. Нажмите OK.
43. Выберите Закрыть.
44. Выберите FileExit, чтобы завершить сеанс редактирования.

Изменить права доступа к общим файлам (только для UNIX)

Сервер веб-приложений Panther должен иметь доступ к некоторым файлам в каталоге приложений в UNIX. Поскольку учетная запись пользователя для HTTP-сервера отличается от вашей учетной записи пользователя, серверу веб-приложений обычно не разрешается записывать в ваш каталог.

45. Перейти в каталог / proltut .

    Если error.log не существует, создайте файл журнала ошибок и установите его разрешения, чтобы сервер веб-приложений имел доступ для чтения и записи к файлу : touch error.log

     chmod 666 error.log 

46. Изменить разрешения, чтобы сервер веб-приложений Panther имел доступ на чтение и запись к файлу конфигурации сервера, broker. bin:

     chmod 666 broker.bin 

Проверить соединение

Теперь вы можете запустить сервер веб-приложений Panther и протестировать соединение клиент/сервер, попытавшись вызвать подпрограмму службы с экрана клиента с помощью веб-браузера.

47. Если ваш сервер приложений Panther не работает, повторно активируйте его сейчас с сервера (см. шаги с 27 по 31 на стр. 1-11 в уроке 1 для UNIX или см. шаги с 22 по 26 на стр. 1-25 в уроке 1 для Windows). Кроме того, запустите веб-браузер, если он еще не запущен.
48. Поскольку сервер веб-приложений Panther был запущен при запуске менеджера веб-настройки, его необходимо перезапустить, чтобы он прочитал новый файл JPL:

     WebInstallDir/util/monitor -stop webAppname 
     WebInstallDir/util/monitor -start webAppname 

    Примечание: В Windows, если ваше веб-приложение было установлено как служба, вы можете использовать следующую команду для запуска веб-приложения:

     WebInstallDir/util/net start webAppname 

49. Запросите тестовый экран с этим URL:

     http://hostName/ProgramDirectory/webAppname/test 

    Появится экран клиента.

50. Нажмите кнопку Test Service.

    Фраза "Сработало!" отображается в текстовом поле.

Если у вас возникли проблемы с запуском сервера веб-приложений или просмотром сообщения, возвращаемого сервером, см. Приложение B на странице B-1.

Остановить и перезапустить сервер после внесения любых изменений

Если вы вносите какие-либо изменения в файл веб-инициализации ( webAppname.ini ) или если вы видите какие-либо сообщения об ошибках, указывающие на то, что вам не удалось подключиться к серверу, вы должны остановить и перезапустить сервер веб-приложений, чтобы изменения вступили в силу. Выключите сервер, перейдя в окно UNIX и набрав в командной строке:

 $SMBASE/util/monitor -stop имя веб-приложения 

Отредактируйте файл инициализации так же, как вы его создали, набрав в браузере:

 http://hostMachineName/ProgramDirectory/websetup 

и выбрав обновление приложения.

Затем вы можете перезапустить сервер, повторив процедуру, описанную в шаге 47 выше.

Выключить сервер

После успешного запуска сервера веб-приложений его можно закрыть. Следующие уроки не требуют его использования.

51. Завершение работы сервера веб-приложений:

     $SMBASE/util/monitor -stop имя веб-приложения 

    ---

Что ты сделал?

На этом уроке вы выполнили следующие задачи:

• Использовал Panther Web Setup Manager для создания копии программы CGI/ISAPI/NSAPI, чтобы ваше приложение было доступно на вашем HTTP-сервере.
• Используйте Panther Web Setup Manager для создания файла инициализации сервера веб-приложений, webAppname.ini , который имеет то же имя, что и ваше веб-приложение. и отредактировал его, чтобы отразить переменные настройки для вашего приложения.
• Использовал Panther Web Setup Manager для указания настроек приложения для ваших приложений.
• Сохранена копия модуля JPL, initial.jpl , в вашей клиентской библиотеке. Этот файл содержит процедуры запуска и завершения работы, которые запускаются при инициализации сервера веб-приложений.
• Изменены права доступа к файлу журнала ошибок и файлу конфигурации broker.bin , поэтому сервер веб-приложений имеет к ним доступ для чтения и записи.
• Запустил сервер веб-приложений, проверил соединение и выключил сервер.

Чему ты научился?

Вы узнали:

• Веб-приложение Panther доступно на HTTP-сервере только в том случае, если в программном каталоге сервера имеется ссылка или копия исполняемого файла запрашивающей программы.
• Каждое приложение должно иметь файл инициализации, который содержит переменные, определяющие поведение веб-приложения, среду Panther, используемую программа jserver и среда базы данных.
• Определенная обработка, например открытие сеанса промежуточного программного обеспечения или установка глобальных переменных, выполняется каждый раз при запуске сервера веб-приложений. Создав подпрограммы JPL для обработки этой обработки, а затем задав переменные в файле инициализации веб-приложения, вы можете настроить обработку по умолчанию, которая будет выполняться каждый раз при инициализации сервера веб-приложений.