White Tiger WWW Board — Установка на домашнем компьютере

White Tiger
WWW Board — система поддержки WWW-конференции

Установка программы на домашнем компьютере

[English version here] [Документация] [Демонстрация] [Тестирование] [Обновление] [Разработка]

1. Введение

Для очевидных и неочевидных нужд может возникнуть надобность предварительно установить поддержку WWW-конференции на собственном компьютере, не подсоединенном к сети Internet. (Например, чтобы посмотреть, что происходит во время работы программы. Или проверить, действительно ли она работает... хотя это уже излишне — существует несколько работающих на основе White Tiger WWW Board форумов, а также демонстрационный форум WTiger Support на которых и можно убедиться в функционировании программы.) Здесь описаны действия, позволяющие установить и протестировать форум под управлением Windows 95 (и, вероятно, также Windows 98/NT).

Кроме того, данное описание может послужить руководством к настройке «местной интрасети» (по терминологии Windows 98) — то есть возможности доступа к определенным каталогам на домашнем (офисном) компьютере как к ресурсам, находящимся в Internet. Это бывает полезным при разработке, отладке и настройке cgi-программ, а также доведении до ума работы в локальной сети с использованием протокола HTTP.

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

2. Необходимые программы

Для того, чтобы форум работал на вашем компьютере, необходимо установить на него следующие программы:

Perl 5.0x — интерпретатор языка Perl, найти последнюю версию можно по ссылкам с ресурса www.perl.org. Предпочтителен файл с названием наподобие pw32i316.exe, размер ~1,5 Mb. Также можно использовать ActivePerl, но при тех же возможностях он занимает больше места.
TinyWeb или Small HTTP server — персональный web-сервер очень малого размера (~40 Kb первый, ~17 Kb второй; при использовании второго рекомендуется установить ActivePerl), обеспечивающий максимум необходимых функций, за исключением SSI и cookie (во втором случае и SSI, и cookie поддерживаются). Взять TinyWeb можно на сайте компании RitLabs, Small HTTP server — на странице автора.
Internet-браузер.

(Вместо связки двух первых программ можно использовать другие, например, Sambar Server, который уже включает в себя интерпретатор Perl. Кроме того, в этом сервере имеется поддержка SSI, cookie, ftp и прочих протоколов. Однако разработчику так и не удалось запустить форум под управлением этого сервера. Видимо, ума не хватило...)

(К сожалению, при использовании Apache + mod_perl программа White Tiger WWW Board не работает. Это связано с динамическим способом создания переменных, используемым в WTBoard, который не поддерживает mod_perl.)

3. Подготовка и установка

Необходимо установить Perl и зарегистрировать его в системе запуском файла perlw32-install.bat из директории bin. ActivePerl снабжен собственной программой инсталляции.

Для запуска TinyWeb создайте ярлык со следующими параметрами. В поле «Файл» впишите командную строку типа: c:\WWW\bin\TINY.EXE c:\www\root, где первый параметр — путь к исполнимому файлу tiny.exe, второй — каталог, предназначенный пониматься вашим браузером как корневой на вашем хосте. В этом каталоге создайте файл index.html с любым содержимым. В поле «Рабочий каталог» впишите значение типа c:\WWW\log, это будет каталог, в который предстоит записываться log-данным TinyWeb.

Что значит «корневой каталог на хосте»? При запущенном TinyWeb вы сможете обращаться к этому каталогу на своем компьютере как к ресурсу в Internet. Для этого запустите браузер и в строке адреса впишите следующее значение: http://localhost/. Будет отображено содержимое файла index.html из «корневого» каталога. Если на localhost браузер станет выдавать ошибку, попробуйте http://127.0.0.1/ — это зарезервированный адрес системы, обращается только к локальному ресурсу.

Вместо TinyWeb можно установить Small HTTP Server. Данная программа имеет собственную систему установки, в которой необходимо указать определенные параметры запуска. Подробное описание установки и настройки вы можете найти на странице автора. При использовании Small HTTP Server будут работать практически все функции форума, включая SSI-команды и cookie. Для наиболее быстрой работы форума рекомендую использовать возможность запуска скриптов посредством файла perlis.dll (соответственно, должен быть установлен ActivePerl).

Для чего все это нужно? Запуск cgi-скриптов из браузера просто так невозможен. Наличие персонального web-сервера обеспечивает их выполнение и передачу данных браузеру. Заметим, что cgi-скрипты (cgi-программы) под TinyWeb могут выполняться только в том случае, если они находятся в каталоге cgi-bin корневого; иначе говоря — в пути http://localhost/cgi-bin, Small HTTP Server позволяет переопределить каталог, содержащий скрипты.

После всего этого создайте в каталоге cgi-bin файл test.pl со следующим содержимым: -------------------------cut---------------------------- #!/usr/bin/perl print "Content-type: text/html\n\n"; print "<html><title>TEST</title><h1>TEST</h1></html>"; exit; -----------------------end-cut--------------------------

Запустите его через путь http://localhost/cgi-bin/test.pl. Результатом должно стать сообщение в браузере: «TEST».

Если все получилось, то при использовании TinyWeb следующим шагом нужно зарегистрировать для выполнения скрипты с расширением .cgi (в Small HTTP Server определенные расширения понимаются без лишних телодвижений, поэтому при его использовании регистрацию расширений можно и не производить). Для этого создайте файл cgi.reg и перенесите в него строки: -------------------------cut---------------------------- REGEDIT4 [HKEY_CLASSES_ROOT\.cgi] @="cgifile" "Content Type"="application/x-perl" [HKEY_CLASSES_ROOT\.pl] @="plfile" "Content Type"="application/x-perl" [HKEY_CLASSES_ROOT\.shtml] @="NetscapeMarkup" "Content Type"="text/html" -----------------------end-cut--------------------------

Запустите этот файл, дважды щелкнув по нему мышкой в Проводнике.

Теперь переименуйте ранее созданный файл test.pl в test.cgi и проверьте его работу. Если все нормально, то вы можете установить скрипты и файлы форума, руководствуясь инструкцией.

4. Некоторые замечания

Под управлением TinyWeb не будут работать «Новостная строка», извещение участника форума о появлении новых сообщений, а также автоматическое добавление значений в поля в форме поиска, так как эти вещи обеспечиваются выполнением инструкций SSI (Server Side Includes), пока, к сожалению, не поддерживаемых этим web-сервером. И SSI, и cookie поддерживаются Small HTTP Server by Max Feoktistov. После установки скриптов на сервер в Internet, поддерживающий эту технологию, упомянутые функции должны нормально функционировать.

Внимание! Возможно, при вызове cgi-программ у вас надолго застынет сообщение ожидания ответа от сервера. Это нормально, если продолжается не более полуминуты. Если же в течение долгого времени не возвращается никакой ответ от виртуального сервера, то существует определенная вероятность, что в данной конфигурации системы некоторые файлы работают некорректно. Подобное может быть после добавления в OSR2 поддержки USB (USB Support). В таком случае рекомендуется либо переустановить Windows 95 без установки USB Support, либо перейти на Windows 98.

назад