Установка 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/

Примечание: все вышеизложенные действия проводятся под суперпользователем.

 

Автор: Александр