tomcat集成版

前提条件

Java开发环境

Magnolia CMS需要一个在Windows上的Java开发工具箱（Java Development Kit，JDK）。使用Java测试器来检查系统是否已经安装了Java。Java实时环境（Java Runtime Environment，JRE）由于不能被Tomcat应用程序服务器识别而无法使用。

区别在哪？

• JRE是Java虚拟机的实现方式，用来实际上执行Java程序。
• JDK是一个软件包，您可以用来开发基于Java的应用程序。

如果您还没有JDK，从http://java.sun.com/javase/downloads/index.jsp上下载并安装它。默认情况下，JDK被安装在C:\Program Files (x86)\java\jdk<version>路径下。您也可以选择其他位置。

检查JAVA_HOME环境变量

1. 打开一个命令提示符窗口。
2. 在这个命令提示符窗口，输入set并按回车键。
3. 在显示的结果中找到JAVA_HOME，并验证它与您的JRE安装目录相匹配，如C:\Program Files (x86)\java\jre6。
4. 如果找不到JAVA_HOME，或指向错误的目录，参看设置JAVA_HOME环境变量。如果一切正常，则转到下载Magnolia CMS。
   

设置JAVA_HOME环境变量

1. 右击我的电脑并选择属性。
2. 打开高级标签。 
   （在Windows 7里，右击电脑并选择高级系统设置，然后选择环境变量。）
3. 如果JAVA_HOME环境变量在用户变量或系统变量里不存在，那么可以这样创建它：
   • 用户变量只适用于当前已登录用户。 如果您想要JAVA_HOME只适用于当前已登录用户，那么在这里创建。这些变量优先于系统变量。
   • 系统变量适用于所有用户。如果您想要JAVA_HOME适用于所有用户，那么在这里创建。您必须是以一个管理员身份来修改系统环境变量。
     
4. 设置JAVA_HOME的值为您的JDK安装路径，如C:\Program Files (x86)\java\jdk1.7.0_11。
5. 可选步骤：为了您能够方便启动Magnolia CMS的start和stop命令（无需进入到安装目录下），您可以在PATH变量里添加Magnolia CMS的bin目录，如C:\Program Files\magnolia\apache-tomcat-5.5.27\bin，使用英文分号（;）将该路径与已有路径分隔开。同时，您也需要在环境变量中添加CATALINA_HOME，并将它的值设置为Tomcat安装目录，如C:\Program Files\magnolia\apache-tomcat-5.5.27。

6. 点击确定。
7. 打开一个新的命令提示符窗口（这是因为每个对话都有特定的环境变量），来测试系统能够找到环境变量并设置了正确的值。

您也可以用批处理文件设置JAVA_HOME。将以下这行代码添加进/apache-tomcat/bin/magnolia_control.bat。set命令在Magnolia启动时自动运行，创建JAVA_HOME环境变量并将其值设置为JDK目录。

下载

从Nexus里下载Magnolia CMS Tomcat压缩文件包。文件名取决于发布的版本，例如magnolia-tomcat-bundle-5.0-tomcat-bundle.zip。取最新的版本。

安装

解压缩zip文件到C:\Program Files或您电脑上的其他目录。

导出的文件夹结构如下所示：

启动

1. 打开一个命令提示符窗口并转到Magnolia CMS安装目录下。要做到这点，在命令提示符窗口里输入：

   cd C:\Program Files\magnolia-4.2.3\apache-tomcat-5.5.27\bin

2. 输入magnolia_control.bat start并按回车键。Magnolia在一个新的Tomcat窗口里报告启动消息。如果启动失败，可以在报告里找原因。参考故障处理来解决问题。在一个成功的启动中，最后一行会显示：
   INFO: Server startup in 12345 ms

更新

运行网络更新：

1. 在浏览器里打开http://localhost:8080。
2. 点击Run the Web update on the author instance链接。
   需要更新的模块列表就显示了。
3. 点击Start install. 
   模块被更新了。
4. 点击Start up Magnolia.

在公共实例上重复这项更新。

1. 在浏览器里打开http://localhost:8080。
2. 点击Run the Web update on the public instance链接。 
   需要更新的模块列表就显示了。
3. 点击Start install. 
   模块被更新了。
4. 点击Start up Magnolia。

登录

1. 在浏览器里打开http://localhost:8080/magnoliaAuthor/.magnolia/admincentral。
2. 在登录页面，用以下用户名和密码登录：
   • 用户名：superuser
   • 密码：superuser

应用启动器就显示了。

故障处理

有问题？参看已知问题。