升级x光

概述

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

数据库同步要求

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

确保DB同步成功完成
如果在脱机模式下同步Xray和Global Database Server，要完成升级过程，需要执行手动操作离线数据库同步使用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安装时，安装脚本将文件放入默认的位置。

对于Xray数据文件和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一起使用，请遵循以下步骤:

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

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

单击获取代码片段，将所需的模式添加到MongoDB…

向MongoDB添加所需的模式

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

单击“片段”，将所需的模式添加到PostgreSQL…

在PostgreSQL中添加所需的模式

创建用户xray，密码为xray用OWNER=xray ENCODING='UTF8'创建xraydb数据库授予xraydb数据库的所有权限;

清除当前安装的Xray:
```
YUM: YUM擦除x射线
```
手动清理之前的安装

需要手动清理

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

因此，在清除以前的版本之后，请确保清除系统中遗留的所有数据库文件和数据文件夹(默认情况下为at)/var/opt。
继续升级Xray，如在Docker上升级或Linux升级根据您的安装类型。