在 Tomcat 中安装 Continuum

介绍如何在Tomcat Web 容器上安装,部署,配置 Continuum。
+ 基本原理和原则
对于每一个版本的Tomcat,在你部署Continuum之前,都需要做下面的一些事情:
1. 使用Java JDK > 1.5.0_11
2. 增加一个 <Context> XML  段来定义 JNDI资源
3. JavaMail / Activation JAR 文件s
4. Apache Derby JAR 文件s
5. 配置 ${appserver.base} java 属性
首先定义JNDI资源
Continuuum 启动时,要求从web容器那里获得一些JNDI配置好的资源,两个JDBC数据源和一个JavaMail会话。
有三种方法定义这些资源:
1. 创建 $CATALINA_HOME/webapps/continuum/META-INF/context.xml,内含<Context>段
3. 创建 $CATALINA_HOME/conf/Catalina/localhost/continuum.xml,内含 <Context>段
3. 增加 <Context> 段到 $CATALINA_HOME/conf/server.xml 文件
下面是需要你提供的JNDI名字:
mail/Session
jdbc/continuum
jdbc/users
假定:
1. 你是Apache tomcat 管理员
2. 你本地25端口有SMTP服务器,无须登录/密码
3. 你使用的是嵌入的Apache Derby 数据库(没有外部数据库,否则过程很不一样 )
4. 对于 Tomcat, JavaMail 或者 Derby 的详细描述,请参考个字的项目网站
JavaMail / Activation JAR 文件s
注意: Continuum 需要 JavaMail 1.4 (或者更新的)
Tomcat 缺省不会包含任何版本的 JavaMail 或者 Activation JAR 文件s。作为 Tomcat 的管理员, 需要你去下载和把他们放置在lib目录下。
lib目录可以根据自己的情况进行选择,不强制指定。这里,我们把他们放在  $CATALINA_HOME/common/lib/ 目录。
直接下载 JAR 文件:
• JavaMail 1.4 – http://repo1.maven.org/maven2/javax/mail/mail/1.4/mail-1.4.jar
• Java Activation Framework 1.1 – http://repo1.maven.org/maven2/javax/activation/activation/1.1/activation-1.1.jar
Apache Derby JAR 文件s
注意: Continuum 1.2 和 Apache Derby 10.1.3.1 做过测试
Continuum缺省使用Derby维护Continuum指定的信息和用户/安全数据库。
你需要获得 derby.jar 和 derbytools.jar ,把他们放在你选择的 lib 目录下。
这里,我们放在 $CATALINA_HOME/common/lib/ 目录。
直接下载:
• derby-10.1.3.1.jar – http://repo1.maven.org/maven2/org/apache/derby/derby/10.1.3.1/derby-10.1.3.1.jar
• derbytools-10.1.3.1.jar – http://repo1.maven.org/maven2/org/apache/derby/derbytools/10.1.3.1/derbytools-10.1.3.1.jar
配置 appserver.base java 属性
Continuum 使用这个java 属性来决定他的日志输出位置。
具体格式是: -Dappserver.base=<SOMEWHERE>
利用 $CATALINA_HOME/bin/setenv.sh 脚本进行设置:
#!/bin/bash
# Keep the appserver.home and appserver.base values the same when running under Tomcat
export CATALINA_OPTS=”-Dappserver.home=$CATALINA_HOME -Dappserver.base=$CATALINA_HOME”
Tomcat 6.0.x
<Context path=”/continuum”
docBase=”/path/to/continuum-webapp-1.2.war”>
<Resource name=”jdbc/users”
auth=”Container”
type=”javax.sql.DataSource”
username=”sa”
password=”"
driverClassName=”org.apache.derby.jdbc.EmbeddedDriver”
url=”jdbc:derby:database/users;create=true” />
<Resource name=”jdbc/continuum”
auth=”Container”
type=”javax.sql.DataSource”
username=”sa”
password=”"
driverClassName=”org.apache.derby.jdbc.EmbeddedDriver”
url=”jdbc:derby:database/continuum;create=true” />
<Resource name=”mail/Session”
auth=”Container”
type=”javax.mail.Session”
mail.smtp.host=”localhost”/>
</Context>
This entry was posted in Continuum. Bookmark the permalink.

Leave a Reply