IBM Cognos 最佳实践

xiaoerp

将 IBM Cognos Lifecycle Manager Tomcat Application Server 安装为 Windows 服务

简介
目的
Lifecycle Manager 目前是在命令提示窗口中运行，这意味着将 Lifecycle Manager 安装在服务器上容易出现问题。经常保持登录服务器或其他远程系统是不允许的，因此用户必须退出。这在试图将 Lifecycle Manager 作为命令窗口运行时会出现一个问题：只要用户退出远程服务器，Lifecycle Manager 就会关闭。
实现将 Lifecycle Manager 注册为一个 Windows 服务的技术。
将此技术与 “Lifecycle Manager Web URI 保护技术” 相结合以开始锁定 Lifecycle Manager。

适用范围
本技术是使用 Lifecycle Manager 10.1 和 Mirosoft Windows 7 创建的，但能够在 Lifecycle Manager 支持的所有 Microsoft Windows 操作系统上工作。

例外情况
要成功实现该技术，还需要本文附带的下列两个文件。

• common.xsl
• service.bat
  

实现该技术的步骤
备份 Lifecycle Manager 目录结构
实现该技术之前，强烈建议停止 Lifecycle Manager 并进行备份。

可以通过压缩或复制 Lifecycle Manager 目录来备份整个 Lifecycle Manager 目录。要确认备份是否可靠，在另一个位置恢复压缩文件或复制的文件，检查它们是否能够运行。

复制 server.xml 文件
在 Windows Explorer 中，导航到 LIFECYCLE MANAGER_install_location\tomcat\conf 目录，将文件 "server.xml" 重命名为 "server.xml.original"。

现在导航到 LIFECYCLE MANAGER_install_location\webapps\LifecycleManager\WEB-INF 目录，将 "server.xml" 文件复制到 LIFECYCLE MANAGER_install_location\tomcat\conf 位置。

更新 "log4j.um.server.xml" 文件
导航到 LIFECYCLE MANAGER_install_location\webapps\LifecycleManager\WEB-INF\configuration 目录，制作一个 "log4j.um.server.xml" 文件副本。然后，使用一个文本编辑器编辑文件。

在文件中，查找以下部分：

• <appender name="logfile" class="org.apache.log4j.RollingFileAppender">
•                 <param name="MaxFileSize" value="10MB"/>
•                 <param name="File" value=".. /logs/lifecycleManager.log"/>
•                 <param name="Append" value="true"/>
•                 <layout class="org.apache.log4j.PatternLayout">
•                 <param name="ConversionPattern" value="%d{ISO8601} %-5p [%-30.30c]
•                                  %t: %m %n"/>
•                 </layout>
• </appender>
  

复制代码


下面的行：

• <param name="File" value=".. /logs/lifecycleManager.log"/>
  

复制代码


需要指定 "lifecycleManager.log" 文件的完全限定路径，如下所示：

• <param name="File" value="C:/apps/LifecycleManager/logs/lifecycleManager.log"/>
  

复制代码


上述部分现在应该如下所示：

• <appender name="logfile" class="org.apache.log4j.RollingFileAppender">
•                 <param name="MaxFileSize" value="10MB"/>
•                 <param name="File"
•                           value="C:/apps/LifecycleManager/logs/lifecycleManager.log"/>
•                 <param name="Append" value="true"/>
•                 <layout class="org.apache.log4j.PatternLayout">
•                 <param name="ConversionPattern" value="%d{ISO8601} %-5p [%-30.30c]
•                                  %t: %m %n"/>
•                 </layout>
• </appender>
  

复制代码


注意：务必如上所

示保留路径中的 “斜线”。

将本文附带的 "common.xsl" 文件复制到适当的目录
导航到 LIFECYCLE MANAGER_INSTALL_LOCATION\webapps\LifecycleManager\xsl 目录，将 "common.xsl" 文件重命名为 "common.xsl.original"。复制本文附带的 "common.xsl" 文件并将其粘贴到相同的目录：LIFECYCLE MANAGER_INSTALL_LOCATION\webapps\LifecycleManager\xsl。

复制本文附带的 "service.bat" 文件
将本文附带的 "service.bat" 文件复制到 LIFECYCLE MANAGER_INSTALL_LOCATION\bin 目录。

将 Lifecycle Manager Tomcat 安装为一个 Windows 服务
启动一个命令窗口并将目录切换到 LIFECYCLE MANAGER_install_location\bin 位置以运行 service.bat 文件。

服务命令的用法如下：

• service.bat install/uninstall service_name
  

复制代码


install：安装服务
uninstall：移除服务
service_name：服务名称
运行以下命令：

• service.bat install LifecycleManager
  

复制代码


注意：service_name 当前不是必要的，但还是应该指定，因为 service_name 参数留空可能会导致问题。

结果如下所示：

• Installing the service 'LifecycleManager' ...
• Using CURRENT_DIR:      C:\apps\LIFECYCLE MANAGER\LifecycleManager\bin
• Using CATALINA_HOME:    C:\apps\LIFECYCLE MANAGER\LifecycleManager\bin\..\tomcat
• Using CATALINA_BASE:    C:\apps\LIFECYCLE MANAGER\LifecycleManager\bin\..\tomcat
• Using JAVA_HOME:
• The service 'LifecycleManager' has been installed.
  

复制代码


现在检查名为 "Apache Tomcat LifecycleManager" 的新 Windows 服务。需要注意的是，"Apache Tomcat" 将自动添加到 Windows 名称的开头。

现在可以启动服务了。在默认情况下，服务的启动类型设置为 Manual。如果要在系统重启/关闭/启动后自动启动 Lifecycle Manager，则应该将服务启动类型设置为 Automatic。

如何卸载 Lifecycle Manager Windows 服务

启动一个命令窗口并切换到 LIFECYCLE MANAGER_install_location\bin 目录。

运行命令：

• service.bat uninstall LifecycleManager
  

复制代码


结果如下所示：

• The service 'LifecycleManager' has been removed
  

复制代码


现在检查 Windows 服务，名为 "Apache Tomcat LifecycleManager" 的服务应该已被移除。

测试 Lifecycle Manager

成功安装 LIFECYCLE MANAGER 服务后，通过访问 LIFECYCLE MANAGER url 来测试应用程序。

示例：http://localhost:4797/LifecycleManager
关闭并保存文件。

该贴已经同步到 xiaoerp的微博