将发行版升级到1.4及以下版本

概述

升级发行版的过程取决于您的安装类型。我们强烈建议您在继续升级之前通读此页面。

升级过程主要包括以下几个步骤:

备份您的MongoDB集合和$DISTRIBUTION_HOME文件夹，如所述继续之前．
接下来的步骤取决于您是在运行单个服务器安装还是HA集群
1. 单服务器安装
  根据安装类型(Docker或Linux)运行升级脚本在单个节点/服务器上运行升级．
2. HA集群
  按照下面的说明操作在高可用集群上执行升级．此过程包括为集群中的每个节点升级单个服务器安装。

升级到1.4版本

在版本1.4中，JFrog Distribution经历了一个重大的变化，用PostgreSQL取代了MongoDB。如果您正在升级到1.4版本，请密切关注将数据从MongoDB迁移到PostgreSQL的过程迁移过程．

页面内容

继续之前

升级前

我们强烈建议您采取本节中的操作，以确保在升级过程中遇到任何问题时可以回滚系统:

执行MongoDB集合的完整备份。
备份DISTRIBUTION_HOME美元文件夹

备份MongoDB的集合

如何备份您的MongoDB集合取决于您是使用Distribution的内部MongoDB数据库，还是您的组织的MongoDB数据库是外部的分布。

备份MongoDB内部数据库
要备份Distribution的内部MongoDB数据库，请遵循以下说明:
```
mongodb -h 127.0.0.01 -u distribution -p password -d distribution -o ./backup . conf
```
备份外部MongoDB数据库
要备份组织的外部MongoDB数据库，请参考mongodump在mongoDB文档中。

备份分发服务器主文件夹

只需将$DISTRIBUTION_HOME文件夹的内容复制到您选择的备份文件夹中。

在单个节点/服务器上运行升级

中下载脚本JFrog企业+下载页面．

在Docker上升级

使用外部数据库

JFrog发行版使用PostgreSQL在安装过程中，您可以选择安装一个专用的数据库实例，或者使用您自己的PostgreSQL数据库(如果您的组织中已经安装和使用了一个数据库)。如果您选择使用自己的PostgreSQL数据库，则需要确保在升级后Distribution与它保持连接。

详情请参阅使用外部数据库．

执行分发服务器的安全关闭现有distribution.sh文件:
停止销售
```
停止。/分布
```
运行升级命令在安装脚本中使用发行版的新版本h文件:
```
升级。/分布
```
使确保mongo服务器/docker容器已启动并运行，以确保数据迁移可以运行。
启动分发版发行版的新版本h文件。在服务初始化过程中，服务首先触发迁移过程。
```
开始。/分布
```

Linux升级

使用外部数据库

JFrog发行版使用PostgreSQL在安装过程中，您可以选择安装一个专用的数据库实例，或者使用您自己的PostgreSQL数据库(如果您的组织中已经安装和使用了一个数据库)。如果您选择使用自己的PostgreSQL数据库，则需要确保在升级后Distribution与它保持连接。

详情请参阅使用外部数据库．

各种类型的Linux都支持发行版，并遵循文件夹结构的标准约定。具体操作请参见Linux安装。

以下关于升级发行版的说明适用于所有受支持的Linux版本。

要升级在Linux上运行的发行版，请按照下面的说明将< Linux -flavor>替换为您正在使用的版本:

解压缩下载的安装归档文件。
```
-latest. Tar .gz
```
运行安装脚本
(如果您不是以“root”身份运行，请在下面的命令前加上“sudo”)。
```
。/ installDistribution - < linux-flavor > . sh
```

迁移过程

在升级节点启动时完成新版本的安装后，将执行自动迁移过程。此过程对配置文件和数据库表进行必要的更改。

此过程可能需要一些时间，具体取决于数据库的大小。

您可以通过查看Distribution服务器来跟踪迁移过程日志：

日志的例子

2018-08-06 09:49:13 589 [main] [INFO] (o.j.b.d.a.l.ApplicationStartingListener:24)服务器版本:1.4.0，最新数据库版本为:1.3.0 2018-08-06 09:52:13 285 [main] [INFO] (o.j.b.d.a.b.m.AbstractMigrationService:31)运行从1.3.0到1.4.0的迁移....2018-08-06 09:53:21 1,276 [main] [INFO] (o.j.b.d.a.l.ApplicationStartedListener:27)服务器版本:1.4.0，最后配置版本为:1.3.0 2018-08-06 09:53:22,674 [main] [INFO] (o.j.b.d.a.b.m.AbstractMigrationService:31)运行从1.3.0到1.4.0的迁移....2018-08-06 09:53:42,111 [main] [INFO] (o.j.b.d.a.b.m.DataBaseMigrationService:79) 1.4.0迁移成功。完成所需时间:20秒

在高可用集群上执行升级

发行版HA从发行版1.2开始可用。

所需停机时间

在当前版本升级中，为了成功地将数据从mongoDb迁移到PostgreSQL，需要完全停机时间

升级应一次执行一个节点

升级HA集群时，请确保一次在一个节点上完成升级过程，然后再转移到下一个节点。

确保没有正在进行或即将开始的分发流程，如下所示:
1. 对于release Bundles模块中的每个发布包，选择该包以查看其详细信息。
2. 对于发布包详细信息中的每个版本，选择的配送跟踪选项卡．
3. 对于每个分发流程，验证其状态是完成，失败的或流产
停止所有JFrog Distribution处理服务器
升级集群中的每个节点在单个节点/服务器上运行升级．
所有节点升级并成功启动后，您可以关闭mongoDB数据库，因为它不再使用:
1. 要安装Docker，运行:
```
Docker stop distribution_mongo_1
```
2. 对于本机安装，运行:
```
服务mongod stop
```

从升级失败中恢复

如果由于某种原因迁移过程失败，并且您在服务器日志中看到异常，或者迁移后服务器没有启动，则可能需要恢复到以前的版本，并联系我们的支持以获得帮助。

在恢复到以前的版本之前

在恢复到以前的版本之前，请保存distribution.log然后运行一个转储在Distribution的postgreSQL数据库上帮助我们调查和解决问题。

要恢复到以前的版本，请遵循以下步骤:

重新安装以前版本的发行版。详情请参阅安装分布．
在启动服务器之前，从使用的备份中恢复Mongo集合mongorestore．详情请参阅mongorestore在MongoDB文档中。
复制DISTRIBUTION_HOME美元从您创建的备份到其原始位置。
删除所有可能已经在PostgreSQL数据库中创建的表。
启动服务器。

从发行版1.2以下的任何版本升级

要从1.2以下的任何版本(例如1.1)升级，请遵循以下步骤:

停止分发服务器。
删除发行版(通常称为“distribution”)使用的Mongo数据库，使用'db.dropDatabase ()”。有关更多信息，请参见db.dropDatabase．
删除的内容DISTRIBUTION_HOME美元文件夹
安装新版本安装分发说明．
重新配置分布根据前一个版本的配置。
重新创建发布包和以前版本的权限。

在源工件上部署GPG密钥

从v1.3.0开始，Distribution将触发源Artifactory将签名的发布包的内容克隆到一个孤立的release-bundles存储库．为此，您需要将GPG密钥(用于每个Artifactory Edge节点)部署到源Artifactory。参考JFrog Artifactory用户指南．