## Please edit system and help pages ONLY in the moinmaster wiki! For more
## information, please see MoinMaster:MoinPagesEditorGroup.
##master-page:HelpOnInstalling/StandaloneServer
##master-date:2005-12-11 20:26:202
#acl MoinPagesEditorGroup:read,write,delete,revert All:read
#format wiki
#language zh


'''安装和配置独立服务'''

同时参考：HelpOnConfiguration/IntegratingWithApache

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

要安装并运行独立服务：
 1. 如果MoinMoin还没有安装，请先进行 ["../基本安装"]。
 1. 按照[../创建维基例程]里面所叙述的，创建一个维基实例。
 1. 将 {{{moin.py}}} 拷贝到你的维基目录, 即{{{wikiconfig.py}}}所在的地方。
 1. 如果你使用`--prefix`选项进行安装，必须编辑moin.py并正确设置`docs`的路径。
 1. 运行{{{moin.py}}}。
 1. 通过 http://localhost:8000/ 访问你的维基。

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

= 配置 moin.py =

== 系统路径配置 ==

如果你进行了标准安装，而且你不是开发者，那么你可以跳过这一节。如果不是那样，你可以把路径加入moin和配置文件，就像这样：
{{{
import sys
sys.path.insert(0, '/path/to/moin')
sys.path.insert(0, '/path/to/wikiconfig')
}}}

[[Anchor(options)]]
== 配置类选项 ==

|| '''选项''' || '''默认值''' || '''注释''' ||
|| 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 ||

  (!) 对于moin开发者来说，还有其他有用的选项，请看{{{moin.py}}}中的注释

= 配置 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}}} （像上面所描述的那样）。
 1. 把 {{{prefix/share/moin/server/moin}}}拷贝到维基目录。
 1. 运行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')
}}}

 (!) New in release 1.5

此页的英文版本：HelpOnInstalling/StandaloneServer
