Установка FosWiki (вики-движок для корпоративного использования, написанный на Perl) - CentOS Wiki
Для установки wiki-системы потребуется веб-сервер apache, perl, rcs (Система управления версиями).
В нашей тестовой установке воспользуемся виртуальной машиной компании Селектел (selectel.ru).
Создадим виртуальную машину - образ Centos 5.
Установка необходимых компонент
Установка веб сервера апач
выполните в консоли:
# yum install httpd
# chkconfig httpd on
# service httpd start
установка системы версий rcs:
yum install rcs
установка mc и gcc:
yum install mc yum install gss
Теперь давайте откроем 80 порт для доступа к нашему веб-серверу, запустим конфигуратор файрвола:
system-config-securitylevel-tui
и в псевдографическом интерфейсе разрешим доступ к www серверу.
Установка Foswiki
С сайта Foswiki.org скачиваем пакет Foswiki-1.*.*.tar.gz
По умолчанию директория веб сервера находится в /var/www/html
Давайте в ней и будет распологаться наша wiki. При обращении по адресу http://<адрес вашего сайта> будет находится ваша wiki.
Распакуем скачанный пакет в директорию /var/www/html. Зайдем по адресу: http://<адрес вашего сайта>.
Нам будет предложена статичная страничка с информацией о самой FosWiki и информацией по ее установке и конфигурированию.
Далее в соответствии с мануалом начнем выполнять все необходимые действия.
Выполним команду:
chown -R apache:apache /var/www/html/
тем самым назначив владельца и группу apache каталогу /html
Создадим необходимый конфигурационный файл и отредактируем его:
cp /var/www/html/bin/LocalLib.cfg.txt /var/www/html/bin/LocalLib.cfg
необходимо в нем прописать правильный путь: $foswikiLibPath = " /var/www/html/lib
В директории /etc/httpd/conf.d создадим настроечный файл:
# touch /etc/httpd/conf.d/foswiki.conf
содержимое этого файла возьмем из онлайн генератора ApacheConfigGenerator .
В форме необходимо указать ip адрес или доменное имя, ip адрес компьютера с которого позволено будет проводить настройку foswiki и несколько других необходимых параметров.
Перезапустим сервис апач:
# service httpd restart
В браузере перейдите по ссылке: http://<адрес вашего сервера>/bin/configure - вы попадете на страницу конфигурирования системы foswiki.
Стоит отметить, что система конфигурирования достаточна понятна и сложности английского языка облегчит google translate.
Кликая по значкам предупреждений можно увидеть какие настройки необходимо провести и каких компонент не хватает.
В нашем примере это модули perl:
- HTML::Entities
- HTML::Parserquit
- HTML::Tree
Установить их можно как с помощью пакетного менеджера yum, так и с помощью CPAN (всеобъемлющая сеть архивов Perl).
Например модулю HTML::Entities будет соответствовать пакет - perl-HTML-Entities. Но в базовых репозитариях есть не все модули. Подключив репозитарий RpmForge можно исправить этот недостаток.
Мы пойдем по другому пути. Запустим команду в консоли:
# perl -e shell -MCPAN
При первом запуске придется долго вводить слово yes и другую информацию, такую как сервера с которых будет происходить скачивание пакетов.
Но потом появится приглашение: cpan[1]>
и далее можно вводить различные команды, такие как установить модуль:
cpan[1]> install HTML::Entities
Далее - quit для выхода.
Примечание: возникают ситуации когда модуль не проходит тестирование и система, по умолчанию, не хочет его устанавливать. Поэтому используйте дополнительную команду - force ("установка принудительно")
cpan[1]> force install HTML::Entities
Установку можно выполнить короче, набрав в консоли:
# perl -MCPAN -e 'install HTML::Entities'
# perl -MCPAN -e 'install HTML::Tree'
После довольно увлекательного конфигурирования, вы перейдя по адресу http://<адрес вашего сервера> попадаете на главную страницу foswiki.
Тут может быть случится небольшой подвох, но очистив кеш браузера ctr+F5 - все должно получиться!
Русификация FosWiki
По умолчанию стоит английский язык.
Но данная вики поддерживает и другие языки.
Выполняя конфигурирование foswiki (напомню сылку - http://<адрес вашего сервера>/bin/configure) происходит редактирование файла по адресу: /var/www/html/bin/LocalLib.cfg
Вот строки этого файла для настройки поддержки русского языка:
- $Foswiki::cfg{UserInterfaceInternationalisation} = 1;
- $Foswiki::cfg{UseLocale} = 1;
- $Foswiki::cfg{Site}{Locale} = 'ru_RU.UTF-8';
- $Foswiki::cfg{JSCalendarContrib}{lang} = 'ru';
- $Foswiki::cfg{Site}{CharSet} = 'utf-8';
Эти строки можно изменить вручную или выполняя конфигурирование foswiki:
В секции Languages
выставить галочку - {UserInterfaceInternationalisation}
В секции Locale
выставить галочку - {UseLocale}
прописать в {Site}{Locale} ru_RU.UTF-8
прописать в {Site}{CharSet} utf-8
В секции JSCalendarContrib
{JSCalendarContrib}{lang} прописать ru
Пример файла LocalLib.cfg
Обновление FosWiki
Для обновления FosWiki необходимо:
- С официального сайта http://foswiki.org/Download/FoswikiRelease01x01x05?redirectedfrom=Download.WebHome, из раздела Upgrade version, скачать пакет обновления. Для примера Foswiki-upgrade-1.1.5.tgz;
- Поместить данный пакет в директорию, в которой у нас распологаются файлы foswiki. В нашем примере это: /var/www/html;
- Распоковать его с помощью следующей команды:
tar --strip-components=1 -xvzpf Foswiki-upgrade-1.1.5.tgz--strip-components это операнд который удаляет каталог верхнего уровня, в котором помещены файлы архива. В результате этого, файлы из архива, органично совместятся с базовыми файлами старой foswiki и выполнят обновление. Вся ваша накопленная информация останется на месте.
- На последнем шаге необходимо директории и файлам foswiki назначим владельца и группу: apache
chown -R apache:apache /var/www/html/Примечание: все вышеизложенные действия проводятся под суперпользователем.