安装和配置独立服务

同时参考:HelpOnConfiguration/IntegratingWithApache

独立服务专门用于本地维基,因为它不需要安装网络服务器,需要的仅仅是Python和Moin。

要安装并运行独立服务:

  1. 如果MoinMoin还没有安装,请先进行 ../基本安装

  2. 按照[../创建维基例程]里面所叙述的,创建一个维基实例。
  3. moin.py 拷贝到你的维基目录, 即wikiconfig.py所在的地方。

  4. 如果你使用--prefix选项进行安装,必须编辑moin.py并正确设置docs的路径。

  5. 运行moin.py

  6. 通过 http://localhost:8000/ 访问你的维基。

大多数情况下,默认的设置就可以正常工作。你可以按照后面一节描述的内容来编辑moin.py,改动其中一些选项。

配置 moin.py

系统路径配置

如果你进行了标准安装,而且你不是开发者,那么你可以跳过这一节。如果不是那样,你可以把路径加入moin和配置文件,就像这样:

import sys
sys.path.insert(0, '/path/to/moin')
sys.path.insert(0, '/path/to/wikiconfig')

配置类选项

选项

默认值

注释

name

'moin'

服务器名称,默认用于日志和pid文件。 (!) New in 1.5

docs

'/usr/share/moin/wiki/htdocs'

moin共享文件路径。如果你使用 --prefix 安装,那么默认路径不能正常工作,你必须把路径设置成'PREFIX/share/moin/wiki/htdocs'

user

'www-data'

如果你以根用户运行,则服务会按照该用户的设置来运行。

group

'www-data'

如果你以根用户运行,则服去会按照该用户组的设置来运行。

port

8000

服务端口。如要想在1024端口之内运行,你必须是根用户才可以 。

interface

'localhost'

服务监听接口。默认情况下只监听localhost。设置为 '' 就可以监听所有的。

logPath

name + '.log'

日志文件。推荐使用默认设置。

serverClass

'ThreadPoolServer', 'ThreadingServer', 'ForkingServer', 'SimpleServer'

使用的服务类型,请参考moin.py中的注释。 默认类型是 'ThreadPoolServer',它创建线程池,并且在有新连接时重复使用它们。 (!) New in 1.3.5

threadLimit

10

创建多少线程。 (!) New in 1.3.5

requestQueueSize

50

被操作系统缓冲的socket连接请求数目。 (!) New in 1.3.5

properties

 {} 

在该字典中设置键值,允许不顾其任意请求性质,比如properties = {'script_name': '/mywiki'}. (!) New in 1.5

配置 wikiconfig.py

给定的配置文件范例应该可以正常工作。

选项

默认值

注释

url_prefix

'/wiki'

你不应该改变这一项,否则image和css文件都不能使用了!

启动服务

从命令行运行 moin.py

$ ./moin.py
Serving on localhost:8000

通过 http://localhost:8000/ 测试维基

在Windows上,你可以双击moin.py来启动服务。新的终端窗口会打开。关闭该窗口或者按下Control+Pause来停止服务。

在Unix上,使用Control+C来关闭服务。

在Unix上使用80端口

在GNU/Linxu, Mac OS X 或者其他Posix类操作系统,你可以使用标准的80端口服务,但是你必须作为根用户运行才可以。

port设置为80,并确认usergroup在你的系统上存在。如果不是的话,把它们设置为已存在的用户(对于网络服务来说)。如果有必要,把你的维基目录chown到该用户和用户组。

使用根用户运行moin.py

$ sudo moin.py
Password:
Serving on localhost:8000
Running as uid/gid 70/70

通过 http://localhost:8000/ 测试维基

在后台运行

如果运行在Unix上,你可以把moin.py运行在后台:

  1. 有用一个正常工作的 moin.py (像上面所描述的那样)。

  2. prefix/share/moin/server/moin拷贝到维基目录。

  3. 运行moin服务:

./moin start

要停止服务:

./moin stop

直接运行moin不加任何参数,可以得到更多信息。

如果想从系统启动脚本中启动moin,你需要把路径添加到moin.py的顶端:

# Add the path to moin.py directory 
import sys
sys.path.insert(0, '/path/to/moin')

此页的英文版本:HelpOnInstalling/StandaloneServer