升级x光

概述

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

数据库同步要求

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

确保DB同步成功完成
如果您正在离线模式下将Xray与Global Database Server同步，那么要完成升级过程，您需要执行手动操作离线数据库同步使用JFrog CLI版本1.10.0及以上。

安装日志

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

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

从2.7以下版本升级

如果您正在从较低版本升级到2.7x版本，并继续升级到版本3。X，在升级到版本3.x之前，检查所有数据迁移是否已经完成。的xray-migration-readiness工具使您能够验证所有数据迁移是否已经完成。下载这个工具，并按照自述文件中的说明操作。

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

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

USE_DEFAULTS = true

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

页面内容

升级x光哈

升级Xray HA有不同的说明

升级HA集群时，升级每个节点的过程类似于升级单个实例(非HA)安装，但是，节点需要执行额外的操作才能作为高可用性集群运行。

如果您正在升级Xray HA集群，请参考升级HA集群．

升级在码头工人

下载安装脚本

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

使用外部数据库

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

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

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

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

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

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

使用外部数据库

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

与安装脚本交互

除了管理安装和升级之外，安装脚本还可以提供额外的信息或在安装过程中执行额外的任务，如重新启动Xray、显示日志文件等。对于细节,运行:

x光帮助

在Linux上升级

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

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

使用外部数据库

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

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

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

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

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

使用外部数据库

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

与安装脚本交互

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

修改默认文件位置

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

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

升级数据库

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

数据库升级

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

数据库升级错误

使用外部数据库

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

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

支持版本

Xray目前支持以下每个数据库的版本:

postgres: 9.5.2
蒙戈:3.2.6

在升级Xray时，由您来选择要外部化哪些数据库(如果有的话)。

您对自己的数据库承担全部责任

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

只有一次具体化

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

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

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

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

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

向MongoDB添加所需的模式

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

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

向PostgreSQL添加所需的模式

创建密码为“xray”的用户CREATE DATABASE xraydb WITH OWNER=xray ENCODING='UTF8';将数据库xraydb上的所有权限授予xray

清除当前安装的Xray:

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

手动清理以前的安装

手动清理要求

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

因此，在清除上一个版本之后，确保清除系统中残留的所有数据库文件和data文件夹(默认情况下位于)/var/opt．
继续升级Xray，如升级在码头工人或在Linux上升级根据您的安装类型。