升级分布

概述

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

从1.4以下版本升级到1.4及以上版本

在1.4版本中，JFrog发行版发生了重大变化，用PostgreSQL取代了MongoDB。因此，如果您的当前版本低于1.4，而您正在升级到1.4及以上版本您必须首先升级到版本1.4中描述的将发行版升级到1.4及以下版本．然后，如果您希望继续升级到较新的版本，请遵循本页上的说明

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

备份您的MongoDB集合和您的$DISTRIBUTION_HOME文件夹在你继续之前．
下一步的步骤取决于运行的是单个服务器安装还是HA集群
1. 单一服务器安装
  根据您的安装类型(Docker或Linux)运行升级脚本单节点/服务器升级．
2. HA集群
  遵循下面的说明在HA集群中执行升级．该过程包括为集群中的每个节点升级单个服务器安装。

页面内容

在你继续之前

在你升级

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

执行数据库的完全备份
备份DISTRIBUTION_HOME美元文件夹

备份PostgreSQL DB

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

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

备份分发版主文件夹

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

单节点/服务器升级

从。下载脚本JFrog企业+下载页面．

升级在码头工人

使用外部数据库

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>替换为您正在使用的版本:

解压缩下载的安装存档。

焦油-xzf分布——< linux-flavor > -latest.tar.gz

运行安装脚本
(如果您不是以“root”身份运行，请在以下命令前加上“sudo”)。
```
。/ installDistribution - < linux-flavor > . sh
```

迁移过程

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

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

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

日志的例子

[main] [INFO] (o.j.b.d.a.l.ApplicationContextReadyListener:33) server version: 1.6.0, last database version was: 1.5.1 2019-02-21 13:21:57000 [main] [INFO] (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 19-02-21 13:21:57,052 [main] [INFO] (o.j.b.d.s.d.DataBaseSchemaServiceImpl:130) Created table: metric_audit 2019-02-21 13:21:57,058 [main] [INFO] (o.j.b.d.s.d.DataBaseSchemaServiceImpl:184) Index Created: rb_dist_audit_edge_tracker_idx in table: rb_dist_audit 2019-02-21 13:21:57,086 [main] [INFO] (o.j.b.d.s.d.DataBaseSchemaServiceImpl:112) Created table:[main] [INFO] (o.j.b.d.a.b.m.d.DataBaseMigrationService:105) Migration to 1.6.0 finished successfully。完成所需时间:0秒

在HA集群中执行升级

升级应该一次执行一个节点

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

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

从升级失败中恢复

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

在恢复到以前的版本之前

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

要恢复到以前的版本，请执行以下步骤:

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