Windows下的10分钟Foswiki手动安装教程

Windows下的自动安装

你可以从foswiki.org官方网站直接下载Windows安装包，这个安装包会为你自动安装Strawberry Perl和Apache。

• Strawberry Perl : Foswiki采用Perl脚本语言开发，Strawberry Perl是Perl在Windows下的打包版本，有了它我们才能在Windows下运行Foswiki程序；
• Apache : Apache是最受欢迎的开源Web服务器软件；

Windows下的10分钟Foswiki手动安装教程

安装前言

这个step-by-step的安装教程力求简单易懂，目的是让你在最短时间内安装、配置Windows环境下最基本的Foswiki服务，因此并没有涉及到很多必要的安全问题和高级设置，但并不意味着这些可以忽略，恰恰相反，如果你要正式部署一个Fowsiki服务器，请务必参考System.InstallationGuide以了解更多、更全面的安装和设置细节。另外需要注意的几点是：

• 该10分钟安装教程可能会涉及到一些最基本的Apache服务器知识。
• 该教程至少在x86上的windows xp SP2上测试通过，相信对于windows 2003 server, windows 2000 和windows NT也适用（但你可能需要禁用IIS，因为我们使用了apache）；
• 方便起见，我们假设Foswiki在windows下的安装目录为“D:\www\htdocs\foswiki”，当然你可以选择其他任何一个目录；
• 不要安装在有空格的Windows目录下（例如c:\program files）。如果必须如此，你必须使用8个字符的短目录名，比如c:\program files的短目录名是c:\program~1。（在命令行下用dir /x 命令可以帮你看到该目录下的短目录名）
• 在安装完成后配置foswiki时，我们需要更新一些文件目录，请在目录名中使用"/"，而不要使用windows习惯的"\"。

安装文件下载

• Apache下载： latest Apache2 release。该教程中我们使用了Apache 2.2.17: httpd-2.2.17-win32-x86-openssl-0.9.8o.msi，并将主机名设为“localhost”。
• Perl下载： ActivePerl。该教程中我们使用ActivePerl 5.12.2.1202。
• Foswiki下载： http://foswiki.org/Download。我们使用Foswiki Release 1.1.2作为示例。

第一步：安装Apache

双击运行前面下载到的MSI安装包即可。在选择Apache安装目录时，我们选择了“D:\www”，如果你选择了其他目录，务必保证使用没有空格的目录名。

第二步：安装ActivePerl

同样双击运行下载到的MSI安装包，在选择安装目录时，我们选择了“D:\Perl”。

第三步：安装Foswiki

将 “Foswiki-1.1.2.zip” 解压缩到 “D:\www\htdocs” 下即可，并将文件夹重命名为 “foswiki” 。现在在 “D:\www\htdocs\foswiki” 你可以看到如下目录以及一些其他文件：

• • bin
  • data
  • lib
  • locale
  • pub
  • templates
  • tools
  • working

第四步：配置Foswiki

• 为Foswiki配置Perl library。在 “D:\www\htdocs\foswiki\bin” 下找到sample文件“LocalLib.cfg.txt”，去掉文件扩展名“txt”将其另存为 LocalLib.cfg ，然后将该文件中第16行的 $foswikiLibPath = "/absolute/path/to/your/lib"; 改为 $foswikiLibPath = "D:/www/htdocs/foswiki/lib"; ，注意要使用正斜杠“/”，而不是Windows管用的反斜杠“\”。如下图所示：

• 去掉bin目录下所有文件的只读属性。通过“开始-->运行-->cmd”打开命令行并进入 “D:\www\htdocs\foswiki\bin”，执行 “attrib -r *” 命令将bin目录下所有文件属性设置为可写，否则下一步可能会出错。

• 更新perl可执行程序的路径。在命令行窗口下进入“D:\www\htdocs\foswiki\tools”目录，输入如下perl命令并回车：“perl rewriteshbang.pl”（你可以通过执行“perl -v”命令查看perl是否安装成功），该命令会提示你输入并确认 Perl 主程序的完整路径 (例如 D:\Perl\perl.exe)，输入“y”确认后，该perl脚本会更新目录“bin”和“tools”下所有perl脚本中的perl.exe路径，即把默认路径“/usr/bin/perl”改为windows下的perl路径“D:\Perl\perl.exe”，以保证Foswiki的Perl程序可以顺利执行。如下图所示：

• 为Foswiki配置Apache。这一步我们要为Foswiki配置Apache Web服务，其实很简单，我们需要的是一个“foswiki.conf”文件，将该文件置于Apache的配置目录“D:\www\conf”下即可，这样在重启Apache服务器后Apache就可以“识别”Foswiki了。如何得到“foswiki.conf”呢？最简单的办法就是使用foswiki.org提供的“Apache配置文件生成器”，打开 Foswiki:Support:ApacheConfigGenerator，按步骤填入一些基本信息后，点击“Update config file”按钮，然后将生成的代码复制粘贴到一个txt文件中，并将其命名为“foswiki.conf“即可。另外不要忘了打开Apache的配置文件，在最后一行加上 Include conf/foswiki.conf 保存。

• 重启Apache服务器。如果重启失败，你可能需要修改Apache的httpd.conf文件中的一些设置。在“开始-->程序”菜单中找到Apache Http Server，选择"Edit the Apache httpd.conf Configuration file"，删除第118行“LoadModule rewrite_module modules/mod_rewrite.so”前面的“#”，保存即可。如果遇到其他问题，可以查看"Review Error Log"查看错误日志。

最后一步：Foswiki基本配置

在浏览器中打开http://localhost/foswiki/bin/configure，如果你能得到下面的页面，恭喜你，大功即将告成！然后你只需要修正一下标记为”Error“的选项即可。最后，在浏览器中打开http://localhost/foswiki/System/WebHome，Congratulations! Happy Foswiki!