升级x光

概述

x射线由几个微服务组成;一些是x射线的核心，而另一些是第三方服务，如MongoDB或PostgreSQL。其中一个微服务是Xray安装程序，除了初始安装外，它还负责升级过程，允许您频繁升级而没有丢失数据的风险。因此，升级x射线的过程非常类似安装过程．

需要同步数据库

当Xray从1.8以下版本升级到1.8及以上版本时:

确保DB同步成功完成
如果正在以脱机模式将Xray与全局数据库服务器同步，则需要执行手动操作才能完成升级过程离线数据库同步使用JFrog CLI1.10.0及以上版本。

安装日志

作为安装/升级的一部分，Xray会创建一个日志文件来跟踪安装过程。每次安装/升级都会创建一个新的安装日志文件，格式如下:

$ {INSTALLER_DIR} / $ {SCRIPT_NAME} ${日期}. log

从2.7以下版本升级

如果您正在从较低版本升级到2.7x版本，并继续升级到版本3。在升级到3.x版本之前，请确认所有数据迁移都已完成。的xray-migration-readiness该工具用于验证所有数据迁移是否完成。下载工具，并按照自述文件中的说明操作。

使用非交互式自动脚本安装Xray

要使用自动化安装/升级Xray，请将以下内容添加到环境变量和xray-env.cnf文件:

USE_DEFAULTS = true

现有参数将在自动化过程中使用。

页面内容

升级x射线HA

升级Xray HA有不同的说明

升级HA集群时，升级每个节点的过程与升级单个实例(非HA)安装类似，但是，要使节点作为高可用性集群运行，还需要执行其他操作。

如果升级的是Xray HA集群，请参考升级HA集群．

在Docker上升级

下载安装脚本

升级Xray的Docker发行版使用最新的安装脚本完成，您需要从x射线下载页面．

使用外部数据库

JFrog Xray使用多个数据库来实现其操作的不同功能。在版本1.10之前，Xray安装了所有这些数据库的一个实例供自己使用。

从版本1.10开始，Xray为您提供了使用自己的选项MongoDB或PostgreSQL数据库(如果您的组织中已经安装和使用了这些数据库)。

如果希望使用自己的外部数据库，首先需要在升级Xray之前执行一些初步操作。

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

下载最新的安装脚本后x射线下载页面，要升级你的x射线安装，请遵循以下步骤:

在您的机器上赋予安装脚本“执行”权限。
```
Chmod +x x射线
```
停止当前的x射线实例:
```
x光停止
```
运行升级命令
```
x光升级
```
开始x光
```
x光开始
```

使用外部数据库

若要使用组织中已安装的外部数据库，请遵循这里描述的过程．

与安装脚本交互

除了管理安装和升级之外，安装脚本还可以提供额外的信息或执行安装上的额外任务，如重新启动Xray、显示日志文件等。详情请参见:

x光帮助

Linux下升级

Xray在各种风格的Linux上都受到支持，并且遵循文件夹结构的标准约定。详情请参阅Linux安装．

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

使用外部数据库

JFrog Xray使用多个数据库来实现其操作的不同功能。在版本1.10之前，Xray安装了所有这些数据库的一个实例供自己使用。

从版本1.10开始，Xray为您提供了使用自己的选项MongoDB或PostgreSQL数据库(如果您的组织中已经安装和使用了这些数据库)。

如果希望使用自己的外部数据库，首先需要在升级Xray之前执行一些初步操作。

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

从。下载Linux发行版的最新安装脚本x射线下载页面．安装脚本用于各种功能，也用于升级过程
将下载的安装存档解压缩到一个临时文件夹/ tmp
```
Tar -zxvf xray--latest. Tar .gz
```
运行解压后文件夹中的安装脚本
(如果您不是以“root”身份运行，请在以下命令前加上“sudo”)
```
。/ installXray - < linux-flavor > . sh
```

使用外部数据库

若要使用组织中已安装的外部数据库，请遵循这里描述的过程．

与安装脚本交互

安装脚本提供了几个维护工具。详情请参阅与Linux安装程序交互．

修改默认文件位置

升级Xray安装时，安装脚本将文件放在默认的位置．

对于x射线数据文件和PostgreSQL主目录，您可以修改默认的位置。有关详细信息，请参阅Xray主目录中的README文件。

升级数据库

在某些情况下，当将Xray升级到最新版本时，Xray还需要更新其数据库(例如，如果数据库模式更改)。虽然Xray会自动处理这个内部升级过程，但这个过程可能需要一些时间，因此不要中断升级过程，让它运行到完成，这一点很重要。在升级过程中，x射线将提供一个可视化的进度指示。

数据库升级

如果出现问题，Xray将停止升级过程，并提供错误信息，您可以与JFrog支持共享，以获得进一步帮助。这也可以进行疑难解答．

DB升级错误

使用外部数据库

JFrog Xray使用多个数据库来实现其操作的不同功能。在版本1.10之前，Xray安装了所有这些数据库的一个实例供自己使用。

从版本1.10开始，Xray为您提供了使用自己的选项MongoDB或PostgreSQL数据库(如果您的组织中已经安装和使用了这些数据库)。

支持版本

Xray目前支持这些数据库的以下版本:

postgres: 9.5.2
蒙戈:3.2.6

在升级Xray时，由您选择要外部化这些数据库中的任何一个。

您要对自己的数据库负全部责任

如果您选择让Xray使用您自己的任何数据库进行操作，您将对这些数据库的维护、监控、备份和正确运行承担全部责任。

只外部化一次

您只需要按照下面的过程使用一次您自己的数据库。后续升级可以像往常一样执行，而不必遵循下面的过程。

要使用Xray自己的数据库，请遵循以下步骤:

停止x射线微服务
```
/ xray.sh停止。
```
使用如下命令备份Xray配置文件:
```
mv < XRAY_HOME_FOLDER > / config / xray_config。yaml < XRAY_HOME_FOLDER > / config / xray_config_orig.yaml
```
在升级过程中，将在同一位置重新创建默认配置文件。
做一个数据库转储备份所有你想要Xray使用的数据库(即那些你正在外部化的Xray)。
停止你想要Xray使用的所有外部数据库
```
./xray.sh停止所有
```

准备所有你想要Xray使用的外部数据库，添加所需的模式，如下面的相应片段所述:

点击查看代码片段，将所需的模式添加到MongoDB…

向MongoDB添加所需的模式

//创建默认管理用户var adminUser = {user:"admin"， pwd: "password"，角色:["root"]， customData: {createdBy: "JFrog x射线安装程序"}}db. getsibblingdb ("admin").createUser(adminUser) //创建默认x射线用户var xrayUser = {user:" Xray "， pwd: "password"，角色:["dbOwner"]， customData: {createdBy:"JFrog x射线安装程序"}}//以admin身份验证创建x射线用户var loginOutput = db. getsibblingdb ("admin").auth(adminUser.user,adminUser.pwd) db. getsibblingdb (" Xray ").createUser(xrayUser)

点击查看代码片段，将所需的模式添加到PostgreSQL…

向PostgreSQL添加所需的模式

创建密码为“x射线”的用户创建数据库xraydb, OWNER=xray ENCODING='UTF8';授予数据库xraydb上的所有权限给xray;

清除当前安装的Xray:

用Aptitude: apt-get清除x射线与YUM: YUM擦除x射线

手动清理以前的安装

需要手动清理

清除之前安装的Xray只会删除Xray的配置文件夹，默认情况下，在/选择。

因此，在清除以前的版本之后，请确保清除系统中残留的任何数据库文件以及在默认情况下找到的数据文件夹/var/opt．
中所述的继续升级x射线在Docker上升级或Linux下升级根据您的安装类型。