resin2.1配置详解

概述
本文介绍RESIN2.1的配置方法和建议配置值。

2 安装
RESIN是一个WEB服务器软件，类似于IIS、TOMCAT等，在公司的一些产品中有应用，安装很简单，取到RESIN压缩包后，解压到指定的目录即 安装成功，进入安装目录的BIN文件夹，双击httpd.exe启动RESIN服务器。此时可以通过浏览器（Internet Explorer）访问http://localhost:8080取得RESIN的默认主页，如果以上全部正常，说明安装成功。

3 配置
RESIN的配置文件只有一个，在安装目录的conf文件夹内，文件名为resin.conf，该文件是一个xml结构的文件，可用notepad或其他文本编辑器打开编辑。下面针对常用的配置项进行说明。

3.1 数据库连接池配置
如果应用使用数据库连接池，查找，在其后加入数据库连接池的配置信息如下：
SQL SERVER
==================================================================

jdbc/job36_use
javax.sql.DataSource








ORACLE
==================================================================

jdbc/job36
javax.sql.DataSource







注意：如果要访问数据库，请先确认RESIN安装目录下lib文件夹有相应数据库的JDBC驱动，如mssqlserver.jar或oracle_jdbc.jar等，否则请先将驱动文件拷贝到该目录，不然无法访问数据库。
字段为连接池名字，要与业务应用配置相同；
字段为数据库连接字符串，蓝色部分为数据库服务器IP:PORT、数据库名或SID。数据库用户名。
密码。
字段为连接池最大连接个数，这个数据对基于WEB的数据库应用性能有一定影响，建议配置数为10~40（数据库应用较多时配置应偏小，网页应用较多时应偏大）。

3.2 服务端口配置
查找，蓝色字符串即为端口号，根据实际应用修改。
如果需要在一台服务器上启动多个resin服务，请按相应规划各应用端口号在每个resin安装目录的配置文件中配置该项，不可重复。

3.3 更新类间隔时间
60s，蓝色字符为配置项，单位为秒。
Class-update-interval字段对RESIN服务性能影响较大，请根据需求更改，建议配置原则为：在开发环境，设为2或更小，这样有利于 及时反映程序的修改对应用造成的改变；生产环境建议配置最小60，根据生产环境的特点，不可能有频繁的类改动或是JAVA脚本改变，或者根本不会有改动， 所以依据实际情况，设置为60~3600。

3.4 最大进程数
20，蓝色字符为配置项。
Thread-max字段为RESIN服务最大接收处理的进程个数，为了达到较好的性能输出，建议该项配置值为3.1连接池中max-connections参数的1倍。即，如果连接池max-connections设为10，那么就将thread-max设为20。

3.5 保持活动进程数
，蓝色字符为配置项。
Thread-keepalive字段为RESIN服务保持链接活动性的最大个数，它的值一定要小于3.4节中thread-max的值，否则RESIN无法启动。该项无建议值。

3.6 请求超时时长
，蓝色字符为配置项，单位为秒。
Request-timeout字段为RESIN服务返回请求链接超时的时间，默认即可。

3.7 接收链接缓冲大小
，蓝色字符为配置项。
Accept-buffer-size id字段为RESIN服务在满进程数下接收等待进程缓冲的个数，根据服务器、网络情况而定，无建议值。

3.8 缓存文件过期时间
，蓝色字符为配置项。
RESIN运行中把被访问文件数据进行缓存（默认缓存目录为RESIN安装目录下的cache目录，可在字段修改为指定路径），以便更加有效率的工作，Cache-mapping url-pattern字段为RESIN服务保持缓存文件有效性的时间，开发环境推荐配置为默认值2，生产环境建议配置较大值，比如15或30。本配置基 于应用，增加缓存有效时间，在有较多相同页面服务时减少了服务器的业务逻辑，转而利用磁盘缓冲文件提供数据；但是如果在固定时间长度里（比如10分钟）相 同页面的请求率很小或甚至没有相同的请求时，会增加一次缓存文件匹配动作，反而降低了服务器效率。因此，在特殊的应用中，可以将本配置项设为2，或注 释，取消缓存功能。

3.9 虚拟主机设置

3.9.1 默认文档设置
index.xtp, index.jsp, index.html.
Wecome-file-list字段为默认文档的文件列表。默认文档是在客户端访问Web服务器，比如RESIN，时如果没有制定要访问的文件（即输入 URL为目录名而不是具体的文件名，如：http://localhost:8080/），此时RESIN会根据该字段的值来搜索URL访问目录查找匹配 文件，如果找到文件则返回给用户而不需用户输入全部的URL，比如：http://localhost:8080/index.html。
该配置项一般用来设置默认主页。

3.9.2 主机ID
.
Host id字段在单主机环境、一台服务器需要启动多个不同的RESIN服务时不用配置，请保持默认的空值。只有当与其他web服务器，比如apache等，同时使用时，考虑改配置项。

3.9.3 日志

format='%h %l %u %t "%r" %s %b "%{Referer}i" "%{User-Agent}i"'

，蓝色字符为配置项。
? access-log id字段为RESIN记录运行时访问日志，该日志在单独服务器情况下不推荐使用，就算在混合服务器情况下（比如IIS、APACHE等）也不推荐，除非要分析个服务器的访问情况。如果不使用注释该段即可（加入红色部分代码）。
? error-log id字段为RESIN错误日志，建议使用默认值。日志保存在RESIN安装目录的logs文件夹里。

3.9.4 虚拟目录
在字段中加入，蓝色字符为配置项。
Web-app id字段为RESIN虚拟目录名，app-dir字段为本地路径值。
例如：上面的配置实现了将http://localhost:8080/test/ 映射到了服务器本地的c:\webapp目录，该目录内容应为web应用的代码或脚本。

4 单服务器多resin服务的配置
在某些应用中，会用到单服务器多resin服务的配置，也就是在一台服务器上需要使用多个不同的resin服务，比如一个WEB网站的resin，一个语音IVR或短信SM的resin，此时的配置除了第三章所讲的，还要注意以下几点：
1． Host id字段保留默认配置。
2． 各resin配置文件的http port值不可相同，请按照系统规划的端口号进行相应配置。
3． 各resin配置文件的中的port值不可相同，该值可以任意配置，但要保持与其他端口没有冲突，推荐递增配置，比如6802、6803等，因为一般680x不会被使用。
4． 在配置完成后，观察resin启动界面(dos界面)，确认以下两项没有出现：
? http can’t bind to *:8080 （提示中的8080可能是别的数字，该提示说明http端口号有冲突，请检查http port字段的值）
? srun can’t bind to port 127.0.0.1:6802 （提示中的6802可能是别的数字，该提示说明127.0.0.1的端口有冲突，请检查srun字段的port值）
5． 手工输入地址测试是否正常。
配置完成。

转发至微博