Установка и настройка standalone-сервера
См. также: КакУправлять/Интеграция с Apache
Standalone-сервер создан специально для локальных wiki, поэтому он не нуждается в установленном веб-сервере. Необходимы только Python и Moin!
Чтобы установить и запустить standalone-сервер:
Если MoinMoin ещё не установлен, выполните ../Базовую установку
Создайте экземпляр wiki, как описано в ../Создание экземпляра wiki
Скопируйте moin.py в тот каталог вашей wiki, где уже находится wikiconfig.py
Если вы устанавливали MoinMoin с опцией --prefix, то вам нужно отредактировать moin.py и выставить в docs правильный путь.
Запустите moin.py
Обратитесь к вашей wiki по адресу http://localhost:8000/
В большинстве случаев установки по умолчанию работают хорошо. Если хотите, можете отредактировать moin.py и изменить некоторые настройки, как описано в следующем разделе.
Настройка moin.py
Настройка системных путей
Если вы произвели стандартную установку и вы не разработчик, то вам можно по желанию и пропустить этот раздел. Если нет, то вы можете добавить пути к файлам конфигурации и moin, как здесь:
import sys sys.path.insert(0, '/path/to/moin') sys.path.insert(0, '/path/to/wikiconfig')
Опции класса Config
Опция |
Значение по умолчанию |
Комментарий |
name |
'moin' |
Имя сервера, используемое по умолчанию для файлов log и pid. |
docs |
'/usr/share/moin/wiki/htdocs' |
Путь к разделяемым файлам moin. Если вы использовали --prefix при установке, то путь по умолчанию работать не будет, и нужно выставить его значение в 'PREFIX/share/moin/wiki/htdocs'. |
user |
'www-data' |
Если вы работаете как root, то сервер запустится под этим пользователем |
group |
'www-data' |
Если вы работаете как root, то сервер запустится под этой группой |
port |
8000 |
Рабочий порт. Чтобы работать с привилегированным портом, имеющим номер меньше 1024, вам нужно быть root'ом |
interface |
'localhost' |
Интерфейс, который прослушивается сервером. По умолчанию слушается только localhost. Установите в '' для прослушивания всех интерфейсов. |
logPath |
name + '.log' |
Log-файл. По умолчанию закомментирован. |
serverClass |
'ThreadPoolServer', 'ThreadingServer', 'ForkingServer', 'SimpleServer' |
Используемый тип сервера (см. комментарии в moin.py). По умолчанию 'ThreadPoolServer', который создаёт пул тредов и использует их для новых подключений. |
threadLimit |
10 |
Сколько тредов создаётся. |
requestQueueSize |
50 |
Количество запросов на подключение к сокету, которые буферизируются операционной системой. |
properties |
{} |
позволяет перекрыть любые свойства запроса, путём добавления значений в этот словарь, например properties = {'script_name': '/mywiki'}. |
Опций, полезных для разработчиков moin, может быть больше (см. комментарии в moin.py)
Настройка wikiconfig.py
Файл конфигурации из примера вполне должен подойти.
Опция |
Значение по умолчанию |
Комментарий |
url_prefix |
'/wiki' |
Вы не должны изменять это, иначе файлы картинок и css не будут доступны wiki! |
Запуск сервера
Запустите moin.py из командной строки:
$ ./moin.py Serving on localhost:8000
Проверьте вашу wiki по адресу http://localhost:8000/
В Windows вы можете дважды щёлкнуть по moin.py, чтобы запустить сервер. Откроется новое окно консоли. Чтобы остановить сервер закройте это окно или нажмите Control + Pause.
В Unix для прерывания работы сервера нужно нажать Control + C.
Работа через порт номер 80 на Unix
На GNU/Linux, Mac OS X или других Posix-совместимых ОС вы можете работать через стандартный порт номер 80, использующийся для обслуживания веб-сервера, но для этого нужно запускаться как root.
Выставьте значение port в 80, и убедитесь, что пользователь user и группа group существуют в вашей системе. Если нет, то выставьте их значение соответственно существующим пользователю и группе, назначенным для веб-сервера. Если необходимо, воспользуйтесь chown для выдачи прав на каталог вашей wiki этим пользователю и группе.
Запустите moin.py как root:
$ sudo moin.py Password: Serving on localhost:8000 Running as uid/gid 70/70
Проверьте вашу wiki по адресу http://localhost/
Запуск в качестве демона
Если вы работаете в Unix, то можете запустить moin.py в качестве фонового процесса:
Получите работающий moin.py как описано выше.
Скопируйте файл prefix/share/moin/server/moin в каталог вашей wiki.
- Запустите сервер moin:
./moin start
Чтобы остановить сервер выполните:
./moin stop
Чтобы получить больше информации, запустите moin без параметров.
Если вы хотите запускать moin автоматически при старте системы, то вам может понадобиться добавить путь к moin.py в начало скрипта:
# Добавление пути к каталогу с moin.py import sys sys.path.insert(0, '/path/to/moin')
- New in release 1.5