Page tree
Skip to end of metadata
Go to start of metadata

中文标题【在 Windows 中以服务方式自动重启 Confluence】

针对长时间使用的 Confluence,我们推荐你配置 Confluence 自动随操作系统重启而启动。针对一些 Windows 的服务器,这意味着需要让 Confluence 以服务的方式运行。

有下面 2 种方式来以服务的方式安装 Confluence:使用 Confluence installer 进行安装或者使用下面描述得方式手动进行安装。


Problem with 64-bit Windows

如果你现在运行的是 64 位的 Windows 操作系统,你可能在为 Tomcat 安装为服务的时候遇到问题,如果你现在也同时使用的是 64 位的 JDK 的话。请参考我们 knowledge base article 中的内容来获得更多的信息。

本页中的内容:


以 Confluence 服务方式启用的原因

安装以 Windows 服务方式启动 Confluence 主要有下面 3 个好处:

  • 减少因为意外关闭 Confluence 的可能性(如果你以手动方式启动 Confluence,一个控制台窗口是会打开的,这个将会增加意外关闭 Confluence 的可能性。因为你很有可能不小心关闭了这个窗口)。
  • 在服务器重启后能够自动恢复 Confluence。
  • 通过登录服务器的日志文件,能够增加问题解决的可能性。

有关 Window 服务的相关信息,请参考 Microsoft Developer Network 页面中的内容。

修改运行服务的用户

基于安全的考虑,如果你希望你的 Confluence 不是在系统中以管理员的身份运行或者你使用网络驱动器来存储备份,附件和索引的话,你可以以其他用户来运行 Confluence。

希望修改用户,打开 Apache Tomcat Confluence 属性文件,进入 'Log On' 标签页,然后输入需要要的用户名和密码。

进入你的 Windows 控制面板(Control Panel)  ->  用户账户(User Accounts)同时确定用户具有写入权限,针对<CONFLUENCE-INSTALL> 和 <CONFLUENCE-HOME> 目录和所有的子目录。请注意,任何网络驱动器必须通过 UNC 指定同时在影射中没有字母(例如, \\backupserver\confluence 不是 z:\confluence)。

有关更多的信息,请参考页面 Creating a Dedicated User Account on the Operating System to Run Confluence

为服务手动安装 Confluence 分发包

在 Windows:

  1. 打开一个命令输入框,然后修改目录到 <CONFLUENCE-INSTALL>/bin 目录中。
    你需要以管理员权限运行这个命令行输入框(Run as administrator),这样你才能够完成下面的步骤:
  2. 使用下面的命令来确定 JAVA_HOME 变量被设置到 JDK base 目录:

    echo %JAVA_HOME%

    如果你现在安装的 Java 环境为 JRE(Java Runtime Environment)或者使用的是 Confluence 安装器,替换 JAVA_HOME 为 JRE_HOME。请参考 Setting the JAVA_HOME Variable in Windows 页面获得更多信息。

    请注意,在任何目录路径中的文件夹是以空格为分割符的话(例如,C:\Program Files 必须转换为 8 个字符等价的字符串,需要转换为 C:\Progra~1)。

  3. 在默认的设置中,使用下面的命令来安装服务:

    service.bat install Confluence

    服务的名字将会被命名为 Atlassian Confluence 同时将会默认被配置为自动重启,但是不会自动重启知道你下一次对服务器进行重启。

  4. 如果你有大型的 Confluence 安装,你可以增加 Confluence 使用的最大内存数量(默认为 1024MB)。例如,你可以增加最大内存使用数量到 2048MB :

    tomcat9w //US//Confluence --JvmMx 2048
    
  5. 基于你安装的 Confluence,如果你没有任何 JVM 参数,你可以跳过这个步骤。如果你有这个参数,请添加到服务中:

    tomcat9w //US//Confluence ++JvmOptions="-Djust.an.example=True"

    可选的,你可以使用下面的命令来运行服务器属性对话框然后导航到 Java 标签页,然后添加更多的 JVM 参数。

    tomcat9w //ES//Confluence


    有关更多的配置选项,请参考 Tomcat Windows Service How-To 指南。

  6. 进入 控制面板(Control Panel)  > 管理工具(Administrative Tools) > 服务(Services) > Atlassian Confluence 然后右键单击 属性(Properties )来确定你的配置是正确的。使用命令行启动 Confluence 服务。
  7. 最后,启动 Confluence 服务。从现在开始,Confluence 的服务将会随着操作系统的重启而自动启动。

    net start Confluence
    

以服务管理 Confluence

你可以通过命令行工具来管理 Confluence。

  • 使用下面的命令来停止 Confluence:

    net stop Confluence
    
  • 使用下面的命令来卸载 Confluence:

    service.bat remove Confluence
    

更新 Confluence

在你对 Confluence 进行升级更新后,你可以选择卸载后重新安装 Confluence Windows 的服务,或者修改 StartPath 参数为你心的目录。请参考 Tomcat documentation 页面中的内容获得更多的帮助。

以 WIndow 服务运行 Confluence 的问题解决

  • 请参考官方 KB 中的内容。
  • 如果 KB 中的内容没有帮你解决你所遇到的问题,请参考完整的 问题列表这个也是在官方的 KB 库中的。
  • 当你需要对内存或者 bug 进行问题查找的时候。你可能需要考虑 Confluence 的垃圾回收。有关如何打开垃圾回收的信息,请参考 How to Enable Garbage Collection (GC) Logging 页面中的内容。

  • 你也可以使用 Sysinternals tool ,被称为 Procmon.exe,这个是 Microsoft Windows Sysinternals Team 提供的。这个工具被用来检查在 Confluence 服务启动的时候出现的错误。你需要找到与 Tomcat 失败的时间向一致的时间,使用这个工具进行快照,然后根据这个时间在 Windows Event Viewer 中进行查看。

    Note

    我们不建议你长期运行这个工具,因为这个工具将会干扰 Atlassian 应用。一旦你已经获得了快照信息,你可以使用 Ctrl + E 来停止捕获。

寻求支持

如果你按照上面给出的方法进行了修改,但是你还是遇到 Windows 服务在启动的时候出现了问题或者有关服务的 JVM 配置出现了问题,你可以 创建服务支持请求

当你创建服务支持请求的时候,请提供下面的信息,因为我们需要下面的信息才能够为你提供支持帮助:

  • 给我们你运行 java -version 返回的信息,这个是在 Windows 命令行中运行的。
  • 有关你 Window 针对 Tomcat 配置的截图。
  • 如果你修改了 service.bat 文件,同时也请提供你修改了的文件的拷贝给我们。
  • 你的 atlassian-confluence.log 日志文件。
  • No labels