升级任务控制

概述

升级“任务控制”的过程取决于您的安装类型。我们强烈建议您在继续升级之前通读此页面。

任务控制中心正在转向人工制造即服务

从JFrog Artifactory版本7.27开始，任务控制已经作为一项服务直接集成到Artifactory中。您将不再需要安装Mission Control来使用它提供的功能，只需在Artifactory中启用该服务。

任务控制中心提供的度量能力现在将通过JFrog Insight提供。要了解有关如何安装Insight的更多信息，请参见安装的洞察力。

要了解有关任务控制如何集成到Artifactory以及如何迁移到任务控制微服务的更多信息，请参阅迁移平台部署和许可证桶。

迁移到任务控制微服务后，必须安装JFrog Insights来使用趋势和图表。有关更多信息，请参见从任务控制转移到洞察号。

如果您希望继续使用任务控制，在升级之前，请参阅任务控制要求和任务控制支持平台。

确保使用与最初安装Mission Control相同的升级方法(RPM、Debian、Docker等)。

升级到版本4。第一次做X ?

建议您先复习一下有什么新鲜事最新的JFrog平台。查看重大变更、弃用特性等。

继续之前

JFrog任务控制中心。x只能作为JFrog Platform Deployment安装的一部分安装。请确保在继续之前先完成此安装。

默认主目录

默认的home目录是根据安装类型定义的。有关更多详细信息，请参阅JFrog产品目录结构页面。

注意:本指南使用JFROG_HOME美元表示包含已部署产品的JFrog根目录。

建立任务控制的高可用性

任务控制的高可用性配置需要在同一LAN上有3个或更多活动/活动节点的集群。

JFrog订阅级别

自托管

_{企业
企业+}

页面内容

从3.5.1以下版本升级

升级前，请确认当前使用的操作系统版本为支持。看到系统需求有关操作系统支持的详细信息。

要从3.5及以下版本升级，首先需要升级到3.5.1版本，如从3.5.1以下版本升级，然后继续从3.5.1版本升级到4.x。

从3.5及以下版本升级到4。不支持X。

从3.5.1版本升级到4.x

升级前，请确认当前使用的操作系统版本为支持。看到系统需求有关操作系统支持的详细信息。

JFrog任务控制中心。x只兼容JFrog Artifactory v7.x。要升级，你必须首先安装JFrog Artifactory 7.x。有关更多信息，请参见安装Artifactory。

在任务控制4.x中引入了几个新概念，改进安装和定制流程。有关更多信息，请参见更新内容:自托管。

升级到版本4。x，您需要首先解压缩Mission Control的安装程序存档，而不安装服务，然后使用以下迁移过程导出/导入许可证。

当使用任务控制之前4.7.5释放，并使用Export<>Import功能来复制/复制任务控制实例，许可证桶应该在导入后手动加载，因为它们不包括在导出中。

许可证以外的数据，例如您的服务信息和洞察力不升级后可用。

下载任务控制。
提取压缩归档文件的内容并转到提取的文件夹。
```
jfrog-mc--.tar.gz CD jfrog-mc--
```
.env文件包含在Docker-Compose归档文件中

这个.env文件由docker-compose在安装和升级期间更新。

请注意，有些操作系统默认情况下不显示点文件。如果对文件进行了任何更改，请记住在升级之前进行备份。
复制jfmcDataExport.sh迁移脚本从的< >提取文件夹/第三方/ postgresql /目录,来的/ tmp目录托管您的任务控制v3.5.1数据库的机器(或容器)。
对于Linux Archive安装，脚本将位于< extract-folder > / app /第三方/ postgresql。

在托管Mission Control v3.5.1数据库的机器(或容器)上运行以下命令。

本地Postgres安装

chown postgres:postgres /tmp/jfmcDataExport.sh cd /tmp/ su postgres -c "POSTGRES_PATH=/opt/PostgreSQL/9.6/bin PGPASSWORD=password bash /tmp/jfmcDataExport.sh——output=/tmp"

Postgres在Docker容器中

docker exec -it  bash su postgres -c "POSTGRES_PATH=/usr/lib/postgresql/9.6/bin PGPASSWORD=password bash /tmp/jfmcDataExport.sh——output=/tmp" docker cp :/tmp/jfmcDataExport.tar.gz /tmp/jfmcDataExport.tar.gz #如果数据库主机与JFrog任务控制主机不同，#则将/tmp/jfmcDataExport.tar.gz从数据库主机拷贝到JFrog任务控制主机(例如使用scp)

commmand-line选项

——host=数据库服务器主机(默认值:"127.0.0.1")——port= port数据库服务器端口(默认值:"5432")——user= user数据库用户名(默认值:"jfmc")——database=要连接的数据库数据库名(默认值:"mission_control")——schema=要连接的数据库架构名(默认值:"jfmc_server")——output=要创建jfmcDataExport.tar.gz的输出目录的输出路径(默认值:".")

查看上述命令的输出。

2019-10-28T16:13:18.277Z [shell] [INFO] [] [jfmcDataExport.sh:425] [main] -导出license桶…2019-10-28T16:13:18.313Z [shell] [INFO] [] [jfmcDataExport.sh:428] [main] -导出管理许可…2019-10-28T16:13:18.349Z [shell] [INFO] [] [jfmcDataExport.sh:419] [main] -绑定导出数据…2019-10-28T16:13:18.365Z [shell] [INFO] [] [jfmcDataExport.sh:421] [main] -任务控制数据转储到:./jfmcDataExport.tar.gz

运行命令删除旧的RPM和Debian安装包。对于zip，您需要停止并继续。

注意:此步骤仅在安装任务控制4时需要。在运行旧版本的同一台服务器上。

RPM -删除旧的软件包

#卸载任务控制yum remove jfmc rm -fr /var/opt/jfrog/ Mission - Control #卸载PostgreSQL/ opt/PostgreSQL/9.6/ Uninstall - PostgreSQL rm -fr /var/opt/postgres #服务/etc/systemd/system/multi-user.target.wants / postgresql - 9.6。service systemctl daemon-reload systemctl reset-failed #For SystemV系统#卸载Elasticsearch yum remove -y Elasticsearch -oss rm -fr /etc/elasticsearch rm -fr /usr/share/elasticsearch . conf

Docker安装—停止并移除容器

#安装docker-compose -f ./jfmc-compose。. json -p jfmc down #对于docker安装任务控制停止docker ps -a——format '{{}。grep ^jfmc_* | xargs docker rm -f

Debian -删除旧包

卸载PostgreSQL/ opt/PostgreSQL/9.6/ Uninstall - PostgreSQL rm -fr /var/opt/postgres rm -rf /var/spool/mail/postgres rm -rf /opt/PostgreSQL rm -rf /tmp/postgresql_installer_* rm -rf /etc/selinux/targeted/active/modules/100/ PostgreSQL #对于SystemD系统rm -fr /lib/ SystemD /system/ PostgreSQL -9.6服务/etc/systemd/system/multi-user.target.wants / postgresql - 9.6。service systemctl daemon-reload systemctl reset-failed #For SystemV system rm -rf /etc/init.d/ postgresql -9.6 #卸载Elasticsearch

安装任务控制系统。

复制导出的数据。

mkdir -p $JFROG_HOME/mc/var/bootstrap/mc cp /tmp/jfmcDataExport.tar.gz $JFROG_HOME/mc/var/bootstrap/mc #注:以下只需要用于docker-compose installer chown -R 1050:1050 $JFROG_HOME/mc/var/bootstrap

重新启动任务控制。
验证导入是否成功。文件名应该重命名为jfmcDataExport.tar.gz.done。它将被重命名为jfmcDataExport.tar.gz.failed如果导入过程失败。

检查任务控制日志。

$JFROG_HOME/mc/var/log/console.log . tail

从版本4升级。X到4.x

升级到任务控制4.6.x

升级到任务控制4.6.xrequires Artifactory 7.11.x. Prior to upgrading, to enable the new metrics and trends, you must perform the following:

停止人造和任务控制服务。
升级到Artifactory 7.11。x和任务控制4.6.x。
更新人工系统YAML使用Elasticsearch URL、用户名和密码。有关更多信息，请参见使趋势。
停止并启动Artifactory以使更改生效。

支持以下升级方式:

升级任务控制高可用性集群时，请确保同时触发所有节点的升级过程。

交互式脚本升级(推荐)

它支持所有的安装类型，包括Docker Compose、RPM和Debian。

停止服务。

systemd操作系统

Systemctl stop MC

systemv操作系统

服务MC停止

码头工人组成

CD jfrog-mc--compose docker-compose -p MC down

提取压缩归档文件的内容并转到提取的文件夹。
请注意确保将您的自定义合并到当前docker-compose.yaml文件的新解压缩版本docker-compose.yaml文件。
```
jfrog-mc--.tar.gz CD jfrog-mc--
```
的内容.env文件在之前的安装中新建.env此存档中的文件不复制版本，因为这将影响升级。
运行安装脚本。
请注意:如果需要，脚本将提示您一系列强制输入，包括jfrogURL(自定义基URL)和joinKey。
组成
```
。/ config.sh
```
RPM / DEB
```
。/ install.sh
```

启动和管理任务控制服务。

systemd操作系统

Systemctl start|stop MC

systemv操作系统

Service MC start / stop

码头工人组成

CD jfrog-mc--compose docker-compose -p MC up -d docker-compose -p MC ps docker-compose -p MC down

访问任务控制从你的浏览器:http:// < jfrogUrl > / ui/，去吧。指示板选项卡应用程序模块。

检查任务控制日志。

$JFROG_HOME/mc/var/log/console.log . tail

手动RPM/Debian升级

停止当前服务器。
systemd操作系统
```
Systemctl stop MC
```
systemv操作系统
```
服务MC停止
```
提取压缩归档文件的内容并转到提取的文件夹。
```
CD jfrog-mc--.tar.gz
```
配置Elasticsearch。

如果您是从任务控制4.5版本升级。x及以下版本，则需要升级Elasticsearch。这个包可定位于提取的内容在jfrog-mc - <版本> < rpm | deb > /第三方/ elasticsearch / elasticsearch-oss - <版本>。< rpm | deb >。升级步骤请参考Elasticsearch文档。
当将Elasticsearch的外部实例连接到Mission Control时，在的Shared Configurations中添加以下标志美元JFROG_HOME / mc / var / etc /系统。yaml文件和步骤(6)可以跳过。
```
Shared: elasticsearch: external: true
```
使用任务控制自带的Elasticsearch时，建议安装Search Guard插件。这将有助于确保与Elasticsearch的安全通信。
1. 搜索保护包可以位于提取的内容在jfrog-mc - <版本> < rpm | deb > /第三方/ elasticsearch / search-guard——<版本> . zip。
  有关安装步骤，请参见搜索守卫文件。
2. 添加一个admin用户到Search Guard，以确保与Elasticsearch的认证通信。
  1. Search Guard配置接受散列密码。使用以下命令生成密码的散列。此外，按照上面步骤(5)中指定的，在共享配置中添加这里生成的用户名和密码。
    /etc/elasticsearch/plugins/search-guard-7/tools/hash.sh -p #这将输出一个散列密码()，并复制它
  2. 准备配置代码片段，以使用从上一步获得的散列密码添加一个新(admin)用户
    : hash: "" backend_roles: - "admin" description: "Insight Elastic admin用户"
  3. 将上面的代码段粘贴到该文件的末尾sg_internal_users.yml位于/等/ elasticsearch / plugins / search-guard-7 / sgconfig /
3. 启用对" _cluster/health "端点的匿名访问。检查Elasticsearch集群的健康状态。
  1. 在此文件中启用匿名身份验证sg_config.yml在/etc/elasticsearch /插件/ search-guard-7 / sgconfig /
    Sg_config: dynamic: http: anonymous_auth_enabled: true #将此设置为true
  2. 地图匿名用户sg_anonymous到后端角色sg_anonymous_backendrole在这个文件中g_roles_mapping.yml在/etc/elasticsearch /插件/ search-guard-7 / sgconfig
    Sg_anonymous: backend_roles:—sg_anonymous_backendrole
  3. 将此代码片段添加到该文件的末尾sg_roles.yml位于/等/ elasticsearch/插件/ search-guard-7 / sgconfig
    Sg_anonymous: cluster_permissions:—cluster:monitor/health
在Red Hat兼容的Linux发行版上，以root用户将Mission Control作为服务安装。
rpm
```
install ./mc/mc.rpm
```
Debian
```
DPKG - 1 ./mc/mc.deb
```
设置Artifactory连接详细信息。
启动和管理任务控制。
```
Service MC start / stop
```
从浏览器访问任务控制:http:// < jfrogUrl > / ui /，去吧。指示板选项卡应用程序模块。

检查任务控制日志。

$JFROG_HOME/mc/var/log/console.log . tail

Linux Archive升级

停止当前服务器。

停止任务控制

cd $JFROG_HOME/mc/app/bin ./mc.sh stop .sh

配置Elasticsearch。

如果您是从任务控制4.5版本升级。x及以下版本，则需要升级Elasticsearch。这个包可定位于提取的内容在mc / app /第三方/ elasticsearch / elasticsearch-oss - <版本> gz。升级步骤请参考Elasticsearch文档。
当将Elasticsearch的外部实例连接到Mission Control时，在的Shared Configurations中添加以下标志美元JFROG_HOME / mc / var / etc /系统。yaml文件和步骤(6)可以跳过。
```
Shared: elasticsearch: external: true
```
使用任务控制自带的Elasticsearch时，建议安装Search Guard插件。这将有助于确保与Elasticsearch的安全通信。
1. 搜索保护包可以位于提取的内容在mc / app /第三方/ elasticsearch / search-guard - <版本> . zip
  有关安装步骤，请参见搜索守卫文件。
2. 添加一个admin用户到Search Guard，以确保与Elasticsearch的认证通信。
  1. Search Guard配置接受散列密码。使用以下命令生成密码的散列。此外，按照上面步骤(5)中指定的，在共享配置中添加这里生成的用户名和密码。
    /etc/elasticsearch/plugins/search-guard-7/tools/hash.sh -p #这将输出一个散列密码()，并复制它
  2. 准备配置代码片段，以使用从上一步获得的散列密码添加一个新(admin)用户
    : hash: "" backend_roles: - "admin" description: "Insight Elastic admin用户"
  3. 将上面的代码段粘贴到该文件的末尾sg_internal_users.yml位于/etc/elasticsearch /插件/ search-guard-7 / sgconfig /
3. 启用对" _cluster/health "端点的匿名访问。检查Elasticsearch集群的健康状态。
  1. 在此文件中启用匿名身份验证sg_config.yml在/etc/elasticsearch /插件/ search-guard-7 / sgconfig /
    Sg_config: dynamic: http: anonymous_auth_enabled: true #将此设置为true
  2. 地图匿名用户sg_anonymous到后端角色sg_anonymous_backendrole在这个文件中g_roles_mapping.yml在/etc/elasticsearch /插件/ search-guard-7 / sgconfig
    Sg_anonymous: backend_roles:—sg_anonymous_backendrole
  3. 将此代码片段添加到该文件的末尾sg_roles.yml位于/etc/elasticsearch/插件/ search-guard-7 / sgconfig
    Sg_anonymous: cluster_permissions:—cluster:monitor/health
提取压缩归档文件的内容并转到提取的文件夹。
解压
```
Tar -xvf jfrog-mc--linux. Tar .gz
```

替换现有的美元JFROG_HOME / mc /应用程序用新的应用程序文件夹中。

升级

#导出变量以简化命令Export JFROG_HOME=/opt/jfrog Export JF_NEW_VERSION=/opt/jfrog/mc-4。cp -r $JF_NEW_VERSION/app $JFROG_HOME/mc #删除已提取的新版本rm -rf $JF_NEW_VERSION . x #删除应用程序rm -rf $JF_NEW_VERSION

运行迁移脚本，删除旧的服务目录。

以您在当前的Mission Control安装中拥有的相同权限运行迁移脚本。这个脚本将删除旧的服务目录，冗余的服务yaml文件在路由器和翻译你的当前配置到新的配置格式，根据新的文件系统布局。$JFROG_HOME变量指向新安装的导出JFROG_HOME=< jfrog目录的全路径，例如:/opt/jfrog> cd $JFROG_HOME/mc/app/bin ./ migration. sh检查迁移是否成功完成，可查看以下文件:—迁移日志:$JFROG_HOME/mc/var/log/migration.log—system. sh。$JFROG_HOME/mc/var/etc/system. conf配置文件。yamlThis newly created file will contain your current custom configurations in the new format.

管理任务控制。

美元JFROG_HOME / app / bin / mc.sh开始|停止

访问任务控制从你的浏览器:http:// < jfrogUrl > / ui /，去吧。指示板选项卡应用程序模块。

检查任务控制日志。

$JFROG_HOME/mc/var/log/console.log . tail

执掌升级

一旦有了新的图表版本，就可以更新部署。

不相容的升级

如果新版本与现有部署版本不兼容(请参阅相关的更新日志)，你需要做以下工作:

在旧版本旁边部署新版本(并设置新的发布名称)
将配置和数据从旧部署复制到新部署

执行升级需要停机时间。

数据导出是通过迁移脚本完成的jfmcDataExport.sh(可在任务控制图的文件目录下找到)。

升级。

验证您已将Artifactory升级到v.7x。有关更多信息，请参见执掌升级。
将已部署的版本更新为更新后的版本。
```
头盔升级任务控制jfrog/任务控制
```
停止旧的Mission Control pod(将副本缩减到0)(PostgreSQL保留)。
```
$ kubectl scale statfulsets -mission-control——replicas=0
```

使用以下方法从旧PostgreSQL实例导出数据。

连接到旧的PostgreSQL pod(你可以通过运行Kubectl得到豆荚）.
```
$ kubectl exec -it -postgresql bash
```

复制jfmcDataExport.sh文件并执行以下命令。

$ kubectl cp ./jfmcDataExport.sh -postgresql:/tmp/jfmcDataExport.sh $ chown postgres:postgres /tmp/jfmcDataExport.sh $ su postgres -c "PGPASSWORD=password bash /tmp/jfmcDataExport.sh——output=/tmp"如果是2张图表(操作系统用户postgres不存在)运行。/jfmcDataExport.sh——output=/tmp并提供jfmc用户密码

将导出的文件复制到本地系统。

$ kubectl cp -postgresql:/tmp/jfmcDataExport.tar.gz ./jfmcDataExport.tar.gz

安装新的任务控制并复制导出的文件。
1. 运行舵安装与新版本被称为mission-control-new。
2. 将导出的tar文件复制到新的任务控制舱。
```
$ kubectl cp ./jfmcDataExport.tar.gz -mission-control:/opt/jfrog/mc/var/bootstrap/mc/jfmcDataExport.tar.gz
```
3. 重新启动新的任务控制舱。
4. 验证导入是否成功。文件名应该重命名为jfmcDataExport.tar.gz.done(它将被重命名为jfmcDataExport.tar.gz.failed(如果导入过程失败)。
运行以下命令删除旧的任务控制部署和Helm版本。
```
helm delete 
```
从浏览器访问Mission-Control:http:// < jfrogUrl > / ui /，然后去安全性与合规性选项卡应用程序模块。
检查已部署的Helm版本的状态。
```
舵机状态控制中心
```
任务控制中心现在应该可以使用。

内容

空间工具

升级任务控制

概述

继续之前

自托管

从3.5.1以下版本升级

从3.5.1版本升级到4.x

从版本4升级。X到4.x

交互式脚本升级(推荐)

手动RPM/Debian升级

Linux Archive升级

执掌升级