
#######################################################################
# 如果需要其他支持文件，请注意查看 readme.txt 文档，谢谢！
#######################################################################
#
################### LyBBS 『凌云论坛』搭建服务器 ######################
-----------------------------------------------------------------------
本论坛在如下平台和服务器环境中测试通过(加*的为我的开发环境，加#的我的调试环境)：
平台：
　　Solaris 8.0
　　Red Hat Enterprise Linux 3.0 AS
　　Red Hat Linux 7.1/7.2/8.0/9.0(#)
    Windows 2003 Server
    Windows Xp series(Professional(*)/Home Edition)
　　Windows 2000 series(Advanced Server/Server/Professional)
    *********************************************注意*********************************************
    **这里的环境已经不支持Win 9X(包括ME)版本**
　　**如果需要请搭建以前的服务器版本，请自行到网上查找相关的资料。
    **********************************************End*********************************************
服务器：
    Apache 1.3.x/2.0.43(#)/2.0.48(*)
　　Tomcat 4.0.x/4.1.30-LE-jdk14(#*)/5.0.x/5.5.x
　　Resin 2.1.2
    WebLogic 7.1/8.1
    MySQL 4.0.1/4.0.8/4.0.17(#*)/4.1.x/5.0.x
>>>>>>>>>>>>>>>>>>>>>以上环境可以放心使用<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
-----------------------------------------------------------------------
在Win2000/XP下配置Apache2.0.48+Tomcat4.1.30-LE-jdk14+Ajp (顺带部分linux平台上的安装)
-----------------------------------------------------------------------
其他服务器、其他平台请自行上网查找资料，如果无法解决，请到论坛发帖！
如果是Tomcat5平台请先查阅<关于Tomcat 5.0.X的乱码问题.txt>
-----------------------------------------------------------------------
   本文档由teddy编写(Powered by teddy)！有问题请与horseye@sina.com联系。
-----------------------------------------------------------------------
   如果你不喜欢Apache，那么可以省去查看Apache和Mod_jk部分，直接看tomcat
   的搭建就可以了。
   说明：省去Apache对lybbs论坛没有任何影响！
   注：下面所说的各种程序均可在我们的官方站点(http://www.lybbs.net/)下载到。
   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-----------------------------------------------------------------------
　　Tomcat是种非常优秀的JSP容器，我们一直把它当作调试开发环境，而且受到SUN的官方支持。把它和
APACHE配合会是优秀站点的首选环境。下面我就将这两者怎样结合写出来。 
   一、需要的软件： 
   1、Jdk1.4.2.03，这是所有Java程序必须的软件包 下载网址：http://java.sun.com/j2se/index.html
   2、Apache Web Server 1.3以上，在http://www.apache.org/dist/httpd/可以下载 2.0.43，笔者就用它。 
   3、Mod_jk，这是Jakarta组织开发的使Apache支持Tomcat的插件，比ApacheJserv更强大，因为ApacheJserv
只能用在Apache上，而不能用在别的WebServer 上，Mod_jk可以和很多服务器搭配起来用。我已经在lybbs文件夹
中包括了这个文件，请查看[%lybbs_home%]\package文件夹。(dll是for windows、so是for linux)
   4、Jakarta Tomcat4.1.30，这是Jakarta组织最新开发的JSP服务器。大家可以到http://www.apache.org/dist/jakarta/tomcat-4处下载。 
   二、安装： 
   1、安装J2SDK，我将它安装到D:\server\jdk下 
   2、安装Apache,安装它没有什么可说的，一路回车，不要忘了记住它的安装路径，我安装在D:\server\Apache2下。
   3、安装Mod_jk，只要将[%lybbs_home%]\package\mod_jk2-2.0.43.dll copy到安装Apache目录下的modules下就可以了。 
                  linux用户请把mod_jk2-2.0.43.so cp到安装Apache目录下的modules下。
   4、安装Tomcat,下载的Win32版本是一个exe文件，没什么可说的，我将它安装在D:\server\Tomcat这个目录下。
   三、 配置 
   1、 首先，配置Jdk1.4.2,在你的环境变量里将JAVA_HOME设为D:\server\jdk,具体做法为，
       --------------------------------------------------------------------------
       ***如果直接用Tomcat的快捷启动方式，那么无需设JAVA_HOME。
       --------------------------------------------------------------------------
       WinXP/2000/NT: 我的电脑>属性>高级>环境变量，增加一个JAVA_HOME，值设为D:\server\jdk。
       Win9X/ME: 手动修改C:\Autoexec.bat增加Set JAVA_HOME=D:\server\jdk，重启机器使设置生效。如果不想使电脑重启，
双击这个文件，让它执行一下就好了。:)
       Linux/Unix: root用户，vi /etc/profile，在最末行插入（假如你把jdk装在/usr/local/jdk目录下）:
                   JAVA_HOME=/usr/local/jdk
                   export JAVA_HOME
                   PATH=$PATH:/usr/local/jdk/bin
   2、 配置tomcat 4.1.30。
　　tomcat的具体配置文件是conf\server.xml。关键是这里：
      如果使用默认的webappps目录，则下面的修改部分可以略过。
      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
　　　Host部分修改为  <Host name="localhost" debug="0" appBase="D:/web" unpackWARs="true">
　　　<host>与</host>之间加入<Context path="/lybbs" docBase="lybbs" debug="0" reloadable="true" />
　　　这样http://localhost:8080/lybbs将访问到D:\web\lybbs文件夹
      -----------------------------------------------------------------------------
      启动tomcat，在浏览器中输入http://localhost:8080/lybbs/test.jsp
　　　如果可以看到中英文的“你的服务器已经工作了”就代表你的tomcat服务器已经建好了。
      -----------------------------------------------------------------------------
      -----------------------------------------------------------------------------
      **实际上，lybbs的服务器只需要Tomcat，如果你不想搭apache也没关系，到这里就够了。
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      -----------------------------------------------------------------------------
   3、 配置Apache，修改Httpd.conf，关键的有这几个地方：
　　ServerName localhost 　#你的服务器名称
　　DocumentRoot "D:/web"　#浏览器的请求将被解析到D:\web下
    DirectoryIndex index.html index.jsp #添加index.jsp，这样就可以自动找index.jsp的主页了。

　　下面介绍整合apache和tomcat的配置。
　　httpd.conf增加的内容如下：
 
#Support for jsp
LoadModule jk2_module modules/mod_jk2-2.0.43.dll

<VirtualHost *>
    ServerName localhost
	ServerAlias www
	ServerAlias localhost
    ServerAdmin horseye@sina.com
    DocumentRoot D:/web

    ErrorLog logs/localhost-errorlog
	CustomLog logs/localhost-access.log common

    <Location "/*.jsp">
        JkUriSet worker ajp13:localhost:8009 
    </Location>
</VirtualHost>

　　我在[%lybbs_home%]\package下面附了一份我在win32平台配置成功的httpd.conf配置文件，如果您无法
　　配成功，可以参考这个配置文件。

　　接下来，在[%apache_home%]\conf中新建一个workers2.properties文件，内容如下：

# only at beginnin. In production uncomment it out
[logger.apache2]
level=DEBUG

[shm]
file=D:/server/apache2/logs/shm.file
size=1048576

# Example socket channel, override port and host.
[channel.socket:localhost:8009]
port=8009
host=127.0.0.1

# define the worker
[ajp13:localhost:8009]
channel=channel.socket:localhost:8009

# Uri mapping
[uri:127.0.0.1/*.jsp]
worker=ajp13:localhost:8009

#[uri:www.home.net/*.jsp]
#worker=ajp13:localhost:8009

#[uri:www.customer1.it/*.jsp]
#worker=ajp13:localhost:8009

#[uri:www.customer2.net/*.jsp]
#worker=ajp13:localhost:8009

　　或直接把[%lybbs_home%]\package\worders2.properties复制到[%apache_home%]\conf中。
　　启动Apache，如果可以正常工作，说明配置就结束了。

   4、 配置Tomcat，这可是比较重要的一步，成败在此一举。 
大家打开Tomcat的核心配置文件D:\server\Tomcat\conf\server.xml 
找到下面这句话：
    <Connector className="org.apache.coyote.tomcat5.CoyoteConnector"
               port="8009" minProcessors="5" maxProcessors="75"
               enableLookups="true" redirectPort="8443"
               acceptCount="10" debug="0" connectionTimeout="20000"
               useURIValidationHack="false"
               protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>
默认是没有注释的，如果你下载的tomcat安装后，这里是注释掉的，就把注释语言<!--和-->去掉。
然后保存，现在你的Tomcat和Apache的配置基本完成了。下面我们开始测试。 
   四、 测试: 
大家首先启动Apache，在D:\web下建个新文件index.html
内容：
  <html>
  <head>
  <title>测试Apache是否工作</title>
  </head>
  <body>
  <br><br><br>
  <center><h1>
  你的Apache服务器已经工作啦！
  </h1></center>
  </body>
  </html>
然后在浏览器里输入http://localhost，如果能看到"你的Apache服务器已经工作啦！"的字样，那么恭喜您，
第一步成功了。然后，把LyBBS『凌云论坛』全部程序解压到D:\web\lybbs中，回到Tomcat目录下的bin文件夹
运行启动Catalina run或者是startup.bat，再打开浏览器输入：http://localhost:8080/lybbs/test.jsp
如果看到"Tomcat服务器已经工作"，那么恭喜您，Tomcat也没有问题，最后最重要的是Apache下可以解释jsp和
Servlet,伟大的时刻到了，在浏览器里输入http://localhost/lybbs/test.jsp 
如果看到了"Tomcat服务器已经工作",那么您的确成功了，您已经完成了Apache和Tomcat的融合。
-----------------------------------------------------------------------------------------------
官方JK/JK2配置文档请阅览http://jakarta.apache.org/tomcat/tomcat-4.1-doc/jk2/jk2/vhosthowto.html
-----------------------------------------------------------------------------------------------
Apache+Tomcat安全性说明：
　　如果您选择了Apache+Tomcat+Ajp的安装，请注意安全，如果apache和tomcat在同一个目录中，
apache可能默认把tomcat的目录全部显示出来，比如，[lybbs_home]\WEB-INF，您可以在浏览器输入
http://localhost/lybbs/WEB-INF
如果此时apache把classes、lib、web.xml解析出来，就说明你的apache没有屏蔽掉这个目录。
因为里面存放着您的数据库用户等重要的信息，
所以，请务必在apache的httpd.conf中增加下面这些信息：
#linux is: <Directory "/var/www/html/lybbs/WEB-INF">
<Directory "D:/web/lybbs/WEB-INF">
    Deny from all
</Directory>
-----------------------------------------------------------------------------------------------
Linux环境特别说明
-----------------------------------------------------------------------------------------------
因为Linux系统默认只能同时打开1024个文件句柄，而lucene搜索引擎很容易就会超过1024个文件，
所以，在Linux下会出现Too many open files的Exception，解决办法是：
先su root
然后关闭Tomcat服务器，命令是shutdown.sh
再执行命令ulimit -n 65535，这样就把同时打开的句柄设成65535，一般情况下是足够了。
最后再启动Tomcat服务器，命令是startup.sh
另一篇文档[Linux平台安装需知.txt]也有这方面的说明。

另外，关于Linux平台的Locale请详细查阅文档[Linux平台安装需知.txt]
------------------------------------------------------------------------------------
***本论坛不需要Apache和Tomcat的融合也可以非常好的工作，但融合是站长长久形成的一个习惯。
所以，如果你的Apache和Tomcat融合失败，不用担心，只要搭好Tomcat，直接用http://localhost:8080/lybbs。

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
http://www.lybbs.net teddy 凌云创作室
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=