• Immutable Page
  • Info
  • Attachments

Установка и настройка standalone-сервера

См. также: КакУправлять/Интеграция с Apache

Standalone-сервер создан специально для локальных wiki, поэтому он не нуждается в установленном веб-сервере. Необходимы только Python и Moin!

Чтобы установить и запустить standalone-сервер:

  1. Если MoinMoin ещё не установлен, выполните ../Базовую установку

  2. Создайте экземпляр wiki, как описано в ../Создание экземпляра wiki

  3. Скопируйте moin.py в тот каталог вашей wiki, где уже находится wikiconfig.py

  4. Если вы устанавливали MoinMoin с опцией --prefix, то вам нужно отредактировать moin.py и выставить в docs правильный путь.

  5. Запустите moin.py

  6. Обратитесь к вашей 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. (!) New in 1.5

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', который создаёт пул тредов и использует их для новых подключений. (!) New in 1.3.5

threadLimit

10

Сколько тредов создаётся. (!) New in 1.3.5

requestQueueSize

50

Количество запросов на подключение к сокету, которые буферизируются операционной системой. (!) New in 1.3.5

properties

 {} 

позволяет перекрыть любые свойства запроса, путём добавления значений в этот словарь, например properties = {'script_name': '/mywiki'}. (!) New in 1.5

  • (!) Опций, полезных для разработчиков 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 в качестве фонового процесса:

  1. Получите работающий moin.py как описано выше.

  2. Скопируйте файл prefix/share/moin/server/moin в каталог вашей wiki.

  3. Запустите сервер 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