在这个指南中，我们将会与你一同对最新的 Confluence 站点在 Windows 或者 Linux 平台进行安装和更新。 如果你的 Confluence 安装实例是当前的许可证的话，那么对 Confluence 进行升级是免费的。请参考页面 Licensing FAQ 中的内容来获得更多的信息。 对 Confluence 进行升级的其他方法： 手动升级 – 使用 Confluence 安装器进行升级。 数据中心 – 升级你的数据中心集群。 XML 备份文件不能在升级的时候使用。 在你对 Confluence 进行升级之前，你需要对下面的一些问题进行了解。   使用安装文件的升级方式是否适合你？ 告诉我更多 ... 你可以选择使用安装程序，zip 或者 tar.gz 文件进行升级。在大部分情况下，使用安装程序为升级你 Confluence 安装实例最简便的方法。如果你遇到了下面的情况，那么你需要手动进行升级了： 你现在移动到其他的操作系统或者文件的路径属于本次升级的一部分。 你正在从 Confluence 3.5 或者早期版本上进行升级。 你正在从 Confluence 5.6 或者早期版本上进行升级，但是这些早期版本使用的是 EAR/WAR 分发包来进行部署到一个已经存在的应用服务器上的。 你是否具有升级资格？ 告诉我更多 ... 希望对你当前运行 Confluence 的实例的许可证是否当前，你可以进入  > 基本配置（General Configuration） > 问题检查和支持工具（Troubleshooting and support tools） 来确定你的许可证支持是否过期了。 软件维护（Software maintenance）：在这个时间区间内进行升级。 如果你的许可证支持以及过期了，请在对 Confluence 进行升级之前按照提示的步骤来对许可证进行更新。 我们支持的平台是否有了改变？ 告诉我更多 ... 请查看 Supported Platforms 页面来查看你将要升级的 Confluence 版本。这个页面能够给你 Confluence 支持的操作系统，数据库和浏览器提供相关信息。 你应该了解： Confluence 安装文件包含有 Java (JRE) 和 Tomcat。所以你不需要针对 Java 运行环境单独进行升级。 如果你需要升级的数据库的话，请查看升级指南中有关支持的数据库版本，同时也请参考数据库的升级指南中的升级备注。 你是否需要修改你的环境？ 告诉我更多 ... 更新的 Confluence 版本有时候需要要求修改你的环境，例如提供更多的内存或者调整反向代理设置。 你应该了解： 我们使用 升级日志 来告诉你 Confluence 的升级版本将会对你产生什么影响，例如： 修改支持的数据库，内存的需求，和其他的修改将会影响到你的 Confluence 运行环境。 Confluence 将会进行的重大修改和从这次发行版本中删除的内容。 当你升级完成后，你应该对你 Confluence 安装实例马上进行的操作。 针对你进行升级的 Confluence 版本之间，这些信息是非常重要的，你应该有所了解。例如，如果你从 Confluence 的 5.8 版本升级到 5.10 版本，你应该阅读 Confluence 5.9 和 5.10 版本的发行备注。 https://www.cwiki.us/display/CONF6ZH/Upgrading+Confluence

在 Windows 中以独立启动方式安装。 你可以将安装文件拷贝到任何你希望运行的目录中，下面的步骤中。我们没有将 Archiva 安装成服务，所以你需要通过控制台的方式来进行启动。 Windows 独立启动安装步骤 在 Windows 环境下请参考下面的步骤进行安装 下载安装程序 进入 Archiva 的项目的下载页面中，请单击链接：https://archiva.apache.org/download.cgi 来下载你需要的版本。 针对 Windows 的环境，我们选择使用 zip 版本。 解压缩 你可以将下载的压缩文件解压缩到任何文件夹下面。 因为启动的时候是不需要检查路径的，但是你需要安装 JDK，根据我们的经验，针对最新版本的，你需要安装 JDK 1.8， 否则你可能会遇到启动错误。 因为安装程序使用的是 zip，你可以使用任何解压缩工具来进行解压缩。 这里我们解压缩到文件夹：C:\Users\yhu\Dkits\2.23 中。 启动 Archiva 在 cmd 命令行中，进入你 Archiva 的文件夹中，然后进入这个文件夹的 bin 目录中。 然后运行 ./archiva console 命令，如果你能够看到下面的输出，则表示 Archiva 已经启动成功了。 PS C:\Users\yhu\Dkits\2.23\bin> ./archiva console wrapper  | --> Wrapper Started as Console wrapper  | Launching a JVM... jvm 1    | Wrapper (Version 3.2.3) http://wrapper.tanukisoftware.org jvm 1    |   Copyright 1999-2006 Tanuki Software, Inc.  All Rights Reserved. jvm 1    | jvm 1    | 2019-04-17 09:26:07.027:WARN:oejd.ContextDeployer:ContextDeployer is deprecated. Use ContextProvider jvm 1    | 2019-04-17 09:26:07.032:WARN:oejd.WebAppDeployer:WebAppDeployer is deprecated. Use WebAppProvider jvm 1    | 2019-04-17 09:26:07.095:INFO:oejs.Server:jetty-8.1.14.v20131031 jvm 1    | 2019-04-17 09:26:07.112:INFO:oejs.NCSARequestLog:Opened C:\Users\yhu\Dkits\2.23\logs\request-20190417.log jvm 1    | 2019-04-17 09:26:07.145:INFO:oejd.ContextDeployer:Deploy C:\Users\yhu\Dkits\2.23\contexts\archiva.xml -> o.e.j.w.WebAppContext{/,null},C:\Users\yhu\Dkits\2.23/apps/archiva jvm 1    | 2019-04-17 09:26:10.127:INFO:oejpw.PlusConfiguration:No Transaction manager found - if your webapp requires one, please configure one. jvm 1    | 2019-04-17 09:26:10.280:INFO:oejw.StandardDescriptorProcessor:NO JSP Support for /, did not find org.apache.jasper.servlet.JspServlet jvm 1    | 2019-04-17 09:26:11.142:INFO:/:Initializing Spring root WebApplicationContext jvm 1    | Apr 17, 2019 9:26:19 AM org.apache.tomcat.jdbc.pool.ConnectionPool init jvm 1    | WARNING: maxIdle is larger than maxActive, setting maxIdle to: 20 jvm 1    | 2019-04-17 09:26:31.111:INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:8080 jvm 1    | [INFO] Unable to read properties file, will force index regeneration jvm 1    | [INFO] Unable to read properties file, will force index regeneration 在默认的情况下，启动使用的端口是 8080 确定安装成功 如果你能够通过给定的 UI 和端口看到管理员的 Web 界面的话，那么就表示你的安装已经成功了。 第一次通过 Web UI 界面进行访问的时候，将会提示你创建 admin 用户的密码。 你可以通过单击页面的右上角开始创建管理员的用户和密码。 请注意，你只能对管理员用户的密码进行修改，你不能修改管理员用户的用户名。 当你完成创建后，你就可以 Archiva 进行访问了。   https://www.cwiki.us/display/ArchivaZH/Windows+Installing+Standalone

为了方便起见，我们假设你的 archiva 安装到目录 /opt 下面。 下载安装程序 进入 Archiva 的项目的下载页面中，请单击链接：https://archiva.apache.org/download.cgi 来下载你需要的版本。 在这里我们选择下在 tar.gz 的版本 你可以在这里拷贝下载链接，然后在 CentOS 上使用 wget，你也可以下载 tar.gz 文件后，上传到你的服务器上。 使用 wget 直接下载到你的服务器上。 解压缩 在 CentOS 上，你可以使用下面的命令来进行解压缩： tar -xzvf apache-archiva-2.2.3-bin.tar.gz 解压缩的文件名称为 apache-archiva-2.2.3 移动到文件夹 /opt 使用命令，将解压缩后的文件夹移动到 /opt/archiva 文件夹下 mv apache-archiva-2.2.3 /opt/archiva 启动 archiva 在 /opt/archiva 路径下，运行命令： ./bin/archiva console 你将看到下面的启动选项 确定安装成功 如果你能够通过给定的 UI 和端口看到管理员的 Web 界面的话，那么就表示你的安装已经成功了。 如果你还希望进行更进一步的操作的话，请参考后续章节的内容。 将 archiva  在 CentOS 中安装成服务 在 Linux环境下，archiva  安装目录下的 bin/archiva 是直接启动的，你可以为你的 CentOS 创建一个启动 link 到这个文件中，你也可以知己拷贝这个文件到 /etc/init.d 目录下，然后通过 root 来进行运行。 但是在我们测试后，发现直接将 archiva 拷贝到 /etc/init.d 中是无法启动的，所以你最好是创建一个链接。 针对上面的完全的安装后，创建链接的命令为： ln -sf /opt/archiva/bin/archiva /etc/init.d/archiva 然后你就可以通过 $ service archiva start $ service archiva stop 来对服务进行启动和停止了。 https://www.cwiki.us/display/ArchivaZH/Linux+Installing+Standalone

在 Archiva 安装成功后运行的时候出现协议版本错误： Caused by: javax.net.ssl.SSLException: Received fatal alert: protocol_version at sun.security.ssl.Alerts.getSSLException(Alerts.java:208) ~[?:1.7.0_80] at sun.security.ssl.Alerts.getSSLException(Alerts.java:154) ~[?:1.7.0_80] at sun.security.ssl.SSLSocketImpl.recvAlert(SSLSocketImpl.java:1979) ~[?:1.7.0_80] at sun.security.ssl.SSLSocketImpl.readRecord(SSLSocketImpl.java:1086) ~[?:1.7.0_80] at sun.security.ssl.SSLSocketImpl.performInitialHandshake(SSLSocketImpl.java:1332) ~[?:1.7.0_80] at sun.security.ssl.SSLSocketImpl.startHandshake(SSLSocketImpl.java:1359) ~[?:1.7.0_80] at sun.security.ssl.SSLSocketImpl.startHandshake(SSLSocketImpl.java:1343) ~[?:1.7.0_80] at org.apache.http.conn.ssl.SSLConnectionSocketFactory.createLayeredSocket(SSLConnectionSocketFactory.java:394) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.conn.ssl.SSLConnectionSocketFactory.connectSocket(SSLConnectionSocketFactory.java:353) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.impl.conn.DefaultHttpClientConnectionOperator.connect(DefaultHttpClientConnectionOperator.java:141) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.impl.conn.PoolingHttpClientConnectionManager.connect(PoolingHttpClientConnectionManager.java:353) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.impl.execchain.MainClientExec.establishRoute(MainClientExec.java:380) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.impl.execchain.MainClientExec.execute(MainClientExec.java:236) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.impl.execchain.ProtocolExec.execute(ProtocolExec.java:184) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.impl.execchain.RetryExec.execute(RetryExec.java:88) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.impl.execchain.RedirectExec.execute(RedirectExec.java:110) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.impl.client.InternalHttpClient.doExecute(InternalHttpClient.java:184) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.http.impl.client.CloseableHttpClient.execute(CloseableHttpClient.java:82) ~[httpclient-4.5.2.jar:4.5.2] at org.apache.maven.wagon.providers.http.AbstractHttpClientWagon.execute(AbstractHttpClientWagon.java:832) ~[wagon-http-2.9.jar:2.9] at org.apache.maven.wagon.providers.http.AbstractHttpClientWagon.fillInputData(AbstractHttpClientWagon.java:983) ~[wagon-http-2.9.jar:2.9] ... 19 more 如果你在安装 Archiva 2.2.3 后尝试添加远程仓库。 但是远程仓库不能同步数据到你的本地仓库中， 同时服务器上有上面的错误。但是 Archiva 的安装和运行是没有问题的。 这个情况你需要检查你 JDK 的版本，如果你运行的是 JDK 1.7 的话，尝试运行 JDK 1.8。

Windows>Preferences>General>Workspace 然后选择你需要的编码就可以了。

CloudAMQP 有多种账号级别，请参考下面的链接的内容访问你可以注册的级别：https://www.cloudamqp.com/plans.html 作为测试来说，你可以注册免费的的消息。 你可以选择免费的账号。 输入电子邮件 在注册界面中输入电子邮件后单击 Sign Up 来创建账号。 到邮箱中检查 当你输入电子邮件提交后，系统将会发送一个电子邮件到你提交的邮箱中。 你可以到你的电子邮箱中查看发过来的电子邮件。 系统提示电子邮件已经发送成功。 电子邮箱中收到的进行注册的电子邮件。 单击邮件中的链接进行注册。 创建一个账号 输入密码来在系统中创建账号 创建新的实例 你可以在账号创建成功的界面中开始创建新的实例。 然后你就可以在新创建的实例中开始进行消息测试了。   https://www.cwiki.us/display/RabbitMQZH/Sign+Up+Account+In+CloudAMQP

在你开始之前 在你开始安装 Confluence 之前，请确定你的安装环境满足 最小系统安装要求和支持的平台. 如果你计划将你的 Confluence 运行到虚拟环境下，请参考 Running Confluence in a Virtualized Environment 页面中的内容。 选择你的安装方式 有多种方式可以对 Confluence 进行安装。请针对你的安装环境选择最合适的安装方式。 安装方式 这个方式适合你吗？ 安装 Confluence 测试版 Windows, Linux or OS X 这个方式最将 Confluence 站点设置和运行起来的最快的方法。如果你现在正在对 Confluence 进行评估，你可以使用这个方法进行安装或者尝试免费的 Confluence Cloud。 安装 Confluence 测试版，你不需要安装外部数据库。 使用安装文件（installer）来安装 Confluence Windows Linux 这个安装方式将会使用安装器对 Confluence 进行安装。同时这个方法也是将 Confluence 运行到 Window 或者 Linux 服务器上最直接的方法。 从 zip 或者归档文件来安装 Confluence Windows Linux 这个安装方法要求你手动配置安装文件和系统参数。能够让你对 Confluence 安装有最大的控制权。 这个安装方式能够让你对 Confluence 安装过程进行完全控制。当针对你的操作系统没有合适的 Confluence 文件的话，你可以使用这个方法来进行安装。 使用 Docker 容器来运行 Confluence Docker 使用这个安装方法，Confluence 服务器可以以最快的速度启动和运行 Docker 中预先配置选项的镜像。请访问 https://docs.docker.com/ 来获得更多有关 Docker 的相关内容。 Atlassian 能够对运行在 Docker 容器中的 Confluence 提供支持，但是并不能对环境运行本身的问题提供支持。 将 Confluence 安装到云平台 Windows or Linux AWS Quick Start Azure Confluence 数据中心方法是针对大型企业使用的集群解决方案。你可以将 Confluence 部署到你自己的的 IT 基础环境上，你也可以将 Confluence 部署的到 AWS 或 Azure 等私有云解决方案上。 请阅读 Confluence Data Center Technical Overview 页面中的内容来确定数据中心是否适合你的组织。 请注意：我们不能对在 OS X 上安装 Confluence 提供支持。OS X 的下载文件只能用于对 Confluence 进行评估。与 Confluence 运行在支持的平台上运行一样，运行 Confluence 在 OS X 上没有任何限制。 EAR/WAR 分发包 已经不再可用（no longer available）。如果你现在运行的 Confluence 是在之前的 EAR/WAR 包安装来的，那么你需要选择使用 zip 或者归档文件（archive file）来进行安装。   https://www.cwiki.us/display/CONF6ZH/Confluence+Installation+Guide

这个页面针对运行在虚拟硬件环境下的 Confluence 提供一些信息。 概要 在虚拟环境（virtual machine （VM））下运行 Confluence 需要一些特定的技能来进行设定和进行管理。更主要的是 Confluence 的运行性能将会受到在相同架构下运行的其他虚拟机的影响，同时也与你如何配置 Confluence 有关。 Atlassian 能够支持 Confluence 和 Confluence 数据中心环境在虚拟机环境下运行，但是不能对虚拟环境自身环境的维护提供支持。 建议 下面的一些建议来自于我们将 Confluence 部署到虚拟环境下运行的一些经验。这些虚拟环境包括如 VMWare 和 KVM，同时也来自于我们对这些环境下运行用户提供支持后获得一些经验。 了解你的平台（Know your platform）—— 对你运行环境下的操作系统相关文档应该需要有一些了解，然后来选择虚拟化的技术或者设置可以依赖 VM（virtual machine）环境的一些知识。 指派足够的内存（Allocate enough memory）—— 作为一个 Java 的 Web 应用程序，与其他的 Web 应用程序相比，Confluence 需要大量的内存。请确定你的虚拟机能够提供足够多的物理内存来运行 Confluence，同时还不需要将 Confluence 运行到交换区（swapping）。 处理高 I/O（Handle high I/O）—— 在通常的使用情况下，Confluence 需要大量的 I/O 数，这些操作被用来操作数据库和主目录的内容请求。这些请求针对每一次资源请求都会被进行。请确定在你的 VM 环境中使用了正确的驱动器类型来优化这些访问。 处理峰值 CPU 和内存使用（Handle peak CPU and memory usage）——  针对一些特定的操作（包括 PDF 导出，Office 文档处理和显示大量内容的页面）Confluence 将会需要大量的 CPU 和内存使用。请确定你选择的虚拟环境具有足够的弹性和能力来处理峰值运行，而不是仅仅是等待运行。 正确的时间同步（Synchronise time correctly）—— 一些用户在 VM 和主机上的时间同步上有问题。这个将会导致 Confluence 的计划任务执行混乱从而中断计划任务的执行。当你再虚拟环境下发现 Confluence 计划任务执行混乱的时候，我们强烈推荐你对 VM 和服务器主机的时间同步进行检查。 更多帮助 有关为在虚拟环境下运行 Confluence 进行设置的更多帮助，你可以选择咨询 Atlassian Expert。一些专家对安装和性能优化具有相关的经验，并且能够帮助你对 Confluence 进行配置。 https://www.cwiki.us/display/CONF6ZH/Running+Confluence+in+a+Virtualized+Environment

这里是有关存储空间和内存使用的情况，数据更新于 2013年04月： 数据库大小 2827 MB Home 目录占用空间大小 116 GB 平均内存消耗 1.9 GB 选择实例的数据库表格 数据（Data） 相关表格（Relevant Table） 行（Rows） 大小（Size） 附件元数据（Attachment metadata） attachments 193903 60 MB 内容和用户属性（Content and user properties） os_propertyentry (?) 639737 255 MB 内容正文（包括有所有博客页面，页面内评论的版本历史） bodycontent 517520 1354 MB 内容元数据（包括有标题，作者） content 623155 459 MB 标签（Labels） label (5982, 1264 kB), content_label (134151, 46 MB) 140133 47.2 MB 用户（Users） users 38766 6200 kB 备注：这里没有显示所有的数据库表或者索引，平均的行数量针对安装的实例不同而不同。 选择的 home 目录组件大小 数据（Data） 文件（Files） 大小（Size） 附件（Attachments ，包括有所有附件的版本） 207659 105 GB Did-you-mean 搜索索引 10 14 MB Office 连接器缓存 3506 456 MB 插件文件（Plugin files） 1851 669 MB 搜索索引（Search index） 448 3.9 GB 临时文件（Temporary files） 14232 5 GB 缩略图（Thumbnails） 86516 1.7 GB 使用索引（Usage index 目前已经被禁用） 239 2.6 GB 备注：这里没有显示所有的数据库表或者索引，平均的行数量针对安装的实例不同而不同。 https://www.cwiki.us/display/CONF6ZH/Server+Hardware+Requirements+Guide

针对非集群 Confluence 实例，下面是一些硬件配置。上面的内存数量不区分服务器使用的内存还是 JVM 使用的内存，表格中的空白，表示的是没有这方面的数据。 用户数量 空间数量 页面数量 CPUs CPU (GHz) RAM (MB) 备注 150 30 1,000 1 2.6 1,024 350 100 15,000 2 2.8 1,536 5,000 500 4 3 2,024 10,000 350 16,000 2 3.8 2,024 10,000 60 3,500 2 3.6 4,048 21,000 950 2 3.6 4,048 85,000 100 12,500 4 2.6 4,048 总共需要 3 台服务器：应用服务器，数据库服务器和 Apache HTTPD + LDAP 服务器。 服务器负载和可扩展性 当针对你的 Confluence 部署的时候，你需要计划你的服务器硬件。你需要针对你网站的高峰访问量，所有的内容页面数量，和编辑对访问的比率量来评估你服务器的扩展性。 编辑对访问比率是指由多少访问者对内容进行编辑对比仅仅对内容进行查看。 针对网站的所有内容的最好评估方法是通过所有空间的数量。 Confluence 的扩展性最好是根据访问者的数量，而不是高峰时期用户访问量，有多少编辑用户和多少空间。下面的内容也应该考虑进你的性能分析中。： Confluence 站点中的页面总数通常不是性能的主要考虑。例如，一个 Confluence 实例可能存储有 80K 的页面，但是只消耗了 512MB 的内存。 总是使用外部数据库，和查看 Performance Tuning 页面中的内容。 已知的最大使用情况 下面表格中是用户报告给 Atlassian 已知的最大使用情况，或者被用于进行性能测试。如果你 Confluence 的使用数量超过了下面表格中的内容，那么集群，数据库性能优化和其他性能优化将需要你进行额外进行了。 创建的最多空间（Most Spaces） 1700 最多的内部用户（Most Internal Users） 15K 最多的 LDAP 用户（Most LDAP Users） 100K 最多页面（Most Pages） 80K 硬盘需求 所有的页面内容都是存储在数据库中的，但是页面的附件是存储在文件系统中的。附件越多，需要的磁盘存储空间就越多。 私有和公开的对比 私有的 Confluence 实例管理的用户是内部用户，或者通过用户配置仓库入 LDAP 来进行管理的。如果你的 Confluence 允许公众进行注册的话，你的 Confluence 就需要处理额外的负载了让匿名用户进行访问。请注意，下面的配置是一个示例，不是推荐配置： 用户案例（Use Case） 空间数（Spaces） 用户数（User Accounts） 编辑数（Editors） 编辑查看比率（Editor To Viewer Ratio） 页面（Pages） 页面版本（Page Revisions） 附件（Attachments） 评论（Comments） 总存储数据量（Total DataSize (GB)） 备注（Notes） 在线文档（Online Documentation） 140 11,500 1,000 9% 8,800 65,000 7,300 11,500 10.4 私有的实例（Private Intranet） 130 180 140 78% 8,000 84,000 3,800 500 4.5 公司间协同（Company-Wide Collaboration） 100 85,000 1,000+ 1%+ 12,500 120,000 15,000 专业帮助 针对大型的 Confluence 实例，最好的办法，你可以联系  Atlassian Solution Partner 来针对硬件大小来获得专业帮助，测试和性能优化。   https://www.cwiki.us/display/CONF6ZH/Server+Hardware+Requirements+Guide