安装和配置独立服务

同时参考：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，并确认user和group在你的系统上存在。如果不是的话，把它们设置为已存在的用户（对于网络服务来说）。如果有必要，把你的维基目录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