Архивы списков рассылки это очень хорошо, потому что позволяют
внимательным людям с Часто Задаваемыми Вопросами найти на них
немедленно ответы, не беспокоя при этом других людей. К сожалению ответы в
списках рассылки через некоторое время устаревают, дезорганизованы и
приходится интенсивно поработать, чтобы отсеять их от разного "мусора".
Список Часто Задаваемых Вопросов (FAQ) лучше, потому, что даже ленивые
люди могут легко находить в них ответы. К сожалению, поддержка списка FAQ
требует усилий; если им не заниматься, то информация в нем устаревает.
Faq-O-Matic - это система, базирующаяся на CGI, автоматизирующая процесс
поддержки FAQ (списка Часто Задаваемых Вопросов). Она позволяет
пользователям вашего FAQ принимать участие в его формировании. Система
разрешений также делает FAQ-O-Matic полезным как приложение
"справочный стол", база отслеживания ошибок и документационная система.
Эти инструкции предполагают.
Unix-совместимые команды.
Путь к исходным кодам "/var/tmp" (возможны другие варианты).
Инсталляция была проверена на Red Hat Linux 6.1 и 6.2.
Все шаги инсталляции осуществляются суперпользователем "root".
FAQ-O-Matic версии 2.709
Веб сервер должен быть уже установлен до начала использования FAQ-O-Matic.
Система контроля версий (RCS) должна быть также уже установлена до использования FAQ-O-Matic.
Чтобы проверить, установлен ли пакет RCS на вашей системе используйте
команду:
[root@deep /]# rpm -qi rcs
package rcs is not installed
Для инсталляции RCS используйте следующую команду:
[root@deep /]# mount /dev/cdrom /mnt/cdrom/
[root@deep /]# cd /mnt/cdrom/RedHat/RPMS/
[root@deep RPMS]# rpm -Uvh rcs-version.i386.rpm
rcs ##################################################
[root@deep RPMS]# cd /; umount /mnt/cdrom/
Раскройте тарбол:
[root@deep /]# cp FAQ-O-Matic-version.tar.gz /var/tmp/
[root@deep /]# cd /var/tmp/
[root@deep tmp]# tar xzpf FAQ-O-Matic-version.tar.gz
Компиляция
Для инсталляции программы Faq-O-Matic на вашем компьютере переместитесь
в каталог FAQ-O-Matic и введите следующие команды:
[root@deep FAQ-OMatic-2.709]# perl Makefile.PL
[root@deep FAQ-OMatic-2.709]# make
[root@deep FAQ-OMatic-2.709]# make install
[root@deep FAQ-OMatic-2.709]# mv fom /home/httpd/cgi-bin/
(или туда, где находится ваш CGI).
[root@deep FAQ-OMatic-2.709]# mkdir -p /home/httpd/cgi-bin/fom-meta
[root@deep FAQ-OMatic-2.709]# mkdir -p /home/httpd/faqomatic
[root@deep FAQ-OMatic-2.709]# chown root.www /home/httpd/cgi-bin/fom
[root@deep FAQ-OMatic-2.709]# chown -R www.www /home/httpd/cgi-bin/fom-meta/
[root@deep FAQ-OMatic-2.709]# chown -R www.www /home/httpd/faqomatic/
Команда "make" компилирует все файлы с исходными кодами в исполняемые
двоичные, команда "make install" будет инсталлировать Perl программы и
сопутствующие им файлы в нужные каталоги. Команда "mv" переместит CGI
программу "fom" в каталог "cgi-bin" вашего веб сервера. "mkdir" создаст новый
каталоги "fom-meta" и "faqomatic" в каталоге "/home/httpd/" где будут
храниться все связанные с FAQ-O-Matic файлы. В заключении, команда
"chown" установит владельца CGI программы "fom" пользователя "root" и
группу под которым запускается веб сервер "www", и устанавливает владельца
и группу "www" на каталоги "fom-meta" и "faqomatic".
ЗАМЕЧАНИЕ. Вы получите временный пароль по электронной почте во время
компиляции программы. Этот пароль будет нужен для окончания процесса
инсталляции Faq-O-Matic через веб интерфейс.
После инсталляции Faq-O-Matic, мы должны добавить следующие строки в
файл "httpd.conf".
Шаг 1
Редактируйте файлы httpd.conf (vi /etc/httpd/conf/httpd.conf) и добавьте
следующие строки между тэгами секции <IfModule mod_alias.c> и </IfModule>:
Alias /faqomatic/ "/home/httpd/faqomatic/"
<Directory "/home/httpd/faqomatic">
Options None
AllowOverride None
Order allow,deny
Allow from all
</Directory>
Alias /bags/ "/home/httpd/faqomatic/bags/"
<Directory "/home/httpd/faqomatic/bags">
Options None
AllowOverride None
Order allow,deny
Allow from all
</Directory>
Alias /cache/ "/home/httpd/faqomatic/cache/"
<Directory "/home/httpd/faqomatic/cache">
Options None
AllowOverride None
Order allow,deny
Allow from all
</Directory>
Alias /item/ "/home/httpd/faqomatic/item/"
<Directory "/home/httpd/faqomatic/item">
Options None
AllowOverride None
Order allow,deny
Allow from all
</Directory> Шаг 2
Не забудьте перезапустить веб сервер Apache, чтобы внесенные изменения
вступили в силу:
[root@deep /]# /etc/rc.d/init.d/httpd restart
Shutting down http: [ OK ]
Starting httpd: [ OK ]
Настройте "Define configuration parameters" как вам нужно. После окончания
установки всех параметров нажмите на кнопку "Define" для подтверждения
выбора.
ЗАМЕЧАНИЕ. <my-web-server> - это адрес вашего веб сервера Apache, а
временный пароль должен был вам прислан по электронной почте во время
компиляции.
Шаг 2
После окончания конфигурирования "Define configuration parameters", вы
должны закончить настройку остальной части FAQ-O-Matic, чтобы
иметь возможность использовать его так, как описано в главном меню.
Очистка после работы
[root@deep /]# cd /var/tmp
[root@deep tmp]# rm -rf FAQ-OMatic-version/ FAQ-O-Matic-version.tar.gz
Команды "rm" будет удалять все файлы с исходными кодами, которые мы
использовали при компиляции и инсталляции FAQ-O-Matic. Также будет удален
сжатый архив FAQ-O-Matic.
