升级分布

概述

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

从1.4以下版本升级到1.4或更高版本

在版本1.4中，JFrog Distribution经历了一个重大的变化，用PostgreSQL取代了MongoDB。因此，如果当前版本低于1.4，并且要升级到1.4或更高版本您必须首先升级到版本1.4如将发行版升级到1.4及以下版本．然后，如果您希望继续升级到新版本，请按照本页上的说明进行操作

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

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

页面内容

继续之前

升级前

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

执行DB的完整备份
备份DISTRIBUTION_HOME美元文件夹

备份PostgreSQL DB

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

备份内部PostgreSQL数据库
要备份Distribution的内部PostgreSQL数据库，请遵循以下说明:
```
pg_dump -f  distributiondb
```
备份外部数据库
要备份组织的数据库，请参考postgresdump在PostgreSQL文档中

备份分发服务器主文件夹

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

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

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

在Docker上升级

使用外部数据库

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

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

方法执行分发服务器的正常关闭distribution.sh文件你当前的版本：
停止销售
```
停止。/分布
```
运行升级的命令。distribution.sh安装脚本要升级到的新版本的：
```
升级。/分布
```
确保PostgreSQL服务器/docker容器已经启动并运行，以确保数据迁移可以运行。
启动分发版distribution.sh安装脚本要升级到的新版本的．在服务初始化期间，服务首先触发迁移过程年代。
```
开始。/分布
```

Linux升级

使用外部数据库

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

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

各种类型的Linux都支持发行版，并遵循文件夹结构的标准约定。详情请参阅Linux安装．

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

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

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

迁移过程

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

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

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

日志的例子

[main] [INFO] (o.j.b.d.a.l.ApplicationContextReadyListener:33) server version: 1.6.0, last database version: 1.5.1 2019-02-21 13:21:57,000 [main] (o.j.b.d.a.b.m.AbstractMigrationService:31) running migration from 1.5.1 to 1.6.0 2019-02-21 13:21:57,010 [main] [INFO] (o.j.b.d.s.d.DataBaseSchemaServiceImpl:184) Index created: edge_artifact_tracker_idx in table:edge_node_tracker_artifact 2019-02-21 13:21:57,052 [main] [INFO] (o.j.b.d.s.d.DataBaseSchemaServiceImpl:130)创建表:metric_audit [main] [INFO] (o.j.b.d.s.d.DataBaseSchemaServiceImpl:184)索引创建:rb_dist_audit_edge_tracker_idx in table: rb_dist_audit 2019-02-21 13:21:57,086 [main] (o.j.b.d.s.d.DataBaseSchemaServiceImpl:112)创建表:call_home 2019-02-21 13:21:57 . 111 [main] [INFO] (o.j.b.d.a.b.m.d.DataBaseMigrationService:105)迁移到1.6.0成功完成。完成时间:0秒

在高可用集群上执行升级

升级应一次执行一个节点

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

确保没有正在进行或即将开始的分发，如下所示:
1. 对于release Bundles模块中的每个发布包，选择该包以查看其详细信息。
2. 对于发布包详细信息中的每个版本，选择配送跟踪选项卡．
3. 对于每个分发流程，验证其状态是完成，失败的或流产
升级集群中的每个节点在单个节点/服务器上运行升级．

从升级失败中恢复

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

在恢复到以前的版本之前

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

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

重新安装以前版本的发行版。详情请参阅安装分布．
在启动服务器之前，使用以下命令从创建的备份中恢复PostgreSQL数据库:
posgresql-restore
```
pg_restore -f  -d distributiondb . d
```
详情请参阅app-pgrestore在PostgreSQL文档中。
复制DISTRIBUTION_HOME美元从您创建的备份到其原始位置。
启动服务器。