JspRun6.0 开源JAVA论坛安装图文教程

一、所需环境要求：

操作系统要求

JspRun! 具备跨平台特性，可以运行于 Linux/FreeBSD/Unix 及微软 Windows 2000/2003 等各种操作系统环境下。我们已在软件中针对上述操作系统做了大量的测试和实地检验，保证 JspRun! 可以在上述系统中安全稳定的运行，但您仍然需要做好服务器操作系统级的安全防备措施，例如 Windows 用户需更改 MySQL for Windows 的初始 root 密码，避免跨目录的文件读写；类Unix 用户需避免使用过于简单的密码，避免跨用户目录的文件读写，做好服务器上其他相关软件（如 Sendmail, ftpd, httpd）等的安全防范，使用较新的软件版本等。如果您租用虚拟主机，一般正规和技术力量较强的虚拟主机提供商会已经做好操作系统的各项准备，用户可不必关注此部分。

推荐使用 Linux/FreeBSD 操作系统，不仅完全免费，而且可以获得更好的稳定性和负载能力。

语言及数据库支撑环境要求

可用的 httpd 服务器（如 Apache、tomcat5.0以上等）

jdk 1.5 及以上

MySQL 3.23 及以上（仅针对 MySQL 版 JspRun!）

以上软件均为跨平台的免费软件，推荐使用以上软件的最新稳定版本，不仅拥有更多的功能，而且通常已修复了已知老版本的安全漏洞。

推荐环境软件版本：

推荐使用Apache2.2.x tomcat5.x mod_jk-1.2.x的环境来安装JspRun!论坛。

jdk 1.5(或 1.6)

tomcat 5.5 及以上（tomcat6.0以上的某些版本对某些EL表达式不兼容）

MySQL 5.0.45或者(4.0以上)

如果您租用虚拟主机，请咨询虚拟主机提供商，您的空间服务器是否已安装了上述软件。一般的JSP虚拟主机商都会提供2个版本的环境软件供您选择。

您的 MySQL 数据库账号应当拥有 CREATE、DROP、ALTER 等执行权限，同时文件空间需不低于 30M，数据库空间不低于 5M，通常您的虚拟空间都会满足这个条件，以满足包括 JspRun! 在内的绝大多数网络软件的正常运行。如果您不了解具体情况，请咨询您的空间提供商。

二、安装可能用到的工具软件：

JspRun! 开发组尽量使得安装步骤简单方便，但仍然可能会用到一些常用的工具软件。如果您通过网络将 JspRun! 软件上传到服务器上，您将可能需要一个 FTP 客户端软件。通过您的服务器 FTP 账号，使用该 FTP 客户端软件将相关文件上传到服务器上。同时您可能需要一个简单的文本文件编辑软件，用以对配置文件进行参数修改，一般操作系统自带的如 Windows 的“记事本”或第三方软件如 UltraEdit 等都能胜任。

JspRun! 要求使用 FTP 软件上传 jsp 文件时，使用二进制（BINARY）方式进行，否则将无法正常使用。

三、JspRun!6.0安装详细步骤：（以虚拟空间上安装 JspRun!6.0 为例演示）

第一步：在JspRun!的官方论坛上下载适合自己的版本。

首先到 http://www.jsprun.net 下载所需版本的 JspRun!6.0 到本地或服务器。

在这里要说明一下：我们提供了 4 种不同的编码。包括 GBK 简体中文版(推荐)、UTF-8 简体中文版、BIG5 繁体中文版(推荐)、UTF-8 繁体中文版，请根据服务器 MySQL 的版本，选择相应版本的论坛程序下载。同时，我们还提供不同编码版本的WAR包下载，您可以根据虚拟主机商项目部署相应的要求下载。

注：MySQL4.0 及以下版本没有字符集这个概念。

第二步：解压并上传论坛程序到服务器上并且修改相应目录权限。

1、上传论坛程序到服务器上

本次演示以 GBK 版本为例下载到本地，解压缩得到如图 1 所示的文件：

此时得到的war包您可以根据虚拟主机商指定的war包名称重命名，例如有些需要指定war包的名称为ROOT.war(区分大小写)

那么此时您需要把upload.war重命名为ROOT.war后上传到空间指定的目录，如图4所示；（war包上传服务器后，服务器会自动解压，对于不会自动解压的虚拟主机商一般会提供在线解压的工具）

2、设置相关的目录属性，以便数据文件可以被程序正确读写

使用 FTP 软件登录您的服务器，将服务器上以下目录、以及该目录下面的所有文件的属性设置为 777，Win 主机请设置 internet 来宾帐户可读写属性。如果下面目录中含有您没有的目录，就不用设置了。

onfig.properties

./templates

./attachments

./customavatars

./forumdata

./forumdata/templates

./forumdata/cache

./forumdata/threadcaches

./forumdata/logs

第三步：安装过程

上传完毕后，在浏览器中运行安装程序(在浏览器地址栏敲入install.jsp，即访问 http://您的域名/论坛目录/install.jsp)进入准备安装页面，如图 5 所示：

上图中阅读许可协议后点击“我同意”就进入到下面的检查配置文件页面，如图 4 所示：

(有些虚拟主机没有足够的权限获取分配的磁盘空间大小，可以跟虚拟主机的管理员确认分配的磁盘空间超过30m足够安装JspRun即可)检查配置过关后点击“下一步”进入数据库信息配置页面，如图 5 所示：

注：如果是虚拟主机用户，数据库端口号，数据库用户名和密码一般是由虚拟主机空间商提供；如果是独立主机，数据库用户名和密码就是你安装 MySQL 时填写的用户名（一般为root）和密码（建议新建个数据库用户安装，使用 root 会有安全问题）。

有些情况下,使用locahost的数据库服务器地址会提示连接不上数据库，这时可以尝试将数据库服务器地址改为127.0.0.1。

“系统Email”是指论坛系统用户可以联系到的 Email，一般都填写站长的 Email 地址。在前台显示为“联系我们”这个链接。

填写好“数据库用户名”和“数据库密码”后，点击“下一步”进入如图 6 所示页面：填写管理员帐号密码。

上图中填写好管理员帐号密码后，点击“下一步”进入安装页面，如图 7 所示：

安装完毕点击“恭喜您论坛安装成功，点击进入论坛首页”则进入安装好的论坛首页，如图 8 所示：

自此，JspRun!6.0 论坛安装成功！您可以使用了！