Nexus2迁移升级到Nexus3

关键词

与 Nexus 2.x 相比，Nexus 3.x 为我们提供了更多实用的新特性，随着 Nexus 3.x 对 Maven 的支持越来稳定，很多公司和组织都陆续将数据从 Nexus 2.x 迁移升级到 Nexus 3.x。

SonaType 官方建议我们，使用最新版本 Nexus 2.x 升级到最新版本 Nexus 3.x，并在 Nexus 升级兼容性一文中为我们提供了各个版本 Nexus 升级到最新版本 Nexus 3.x 的流程，如下表。

旧版本	升级流程
3.1.0 或更高版本	升级到最新 3.x 版本
3.0.0 到 3.0.2	学习 3.1.0 中引入的重要目录布局升级到最新 3.x 版本
最新 2.x 版本	升级到最新 3.x 版本
2.0 及其他 2.x 版本	升级到最新 2.x 版本升级到最新 3.x 版本
1.x	升级到 2.7.2 之前的任何 2.x 版本升级到最新 2.x 版本升级到最新 3.x 版本

由上表可知，从 Nexus 2.x 升级到 Nexus 3.x 需要 2 步：

升级到 Nexus 2.x 最新版本
升级到 Nexus 3.x 最新版本

本节我们以 Nexus 2.11.4-01 为例，演示如何将 Nexus 2.x 升级到 Nexus 3.x。

升级到 Nexus 2.x 最新版本

1. 下载并提取 Nexus 2.x 最新版本

下载并解压最新版本的 Nexus 2.x（目前为 Nexus-2.14.20-02），具体下载和解压步骤请参考 Nexus 2.x 下载和安装

2. 替换工作目录

无论是 Nexus 2.x 还是 Nexus 3.x，其安装包在解压后都包含两部分：

nexus-版本号 Nexus 应用程序目录
sonatype-work Nexus 工作目录（真正的仓库，同时包含了 Nexus 的配置，如定时任务、用户配置）

若 Nexus 的版本升级是在大版本相同的情况下进行的（例如从 Nexus 2.11.4-01 升级到 Nexus-2.14.20-02），则只需要将新的 Nexus 工作目录复制到现有版本的目录下，替换旧版本 Nexus 的工作目录即可。

3. 修改配置文件

如果用户对以下文件的默认配置进行了任何更改，则需要在新版本中手动进行相同的更改，Nexus 不支持将这些文件从一个版本复制到另一个版本。

<应用程序目录> /conf/nexus.properties
<应用程序目录> /conf/jetty*.xml
<应用程序目录> /bin/jsw/conf/wrapper.conf
<应用程序目录> /nexus/WEB-INF/classes/ehcache.xml
<应用程序目录> /conf/logback*.xml

由于 Nexus 升级迁移过程需要同时启动 Nexus 2.x 和 Nexus 3.x，为了防止端口（两者默认端口都是 8081）冲突，我们可以将 Nexus 2.x 启动时监听的端口（端口在 <应用程序目录>/conf/nexus.properties 中配置）修改为 8082。

图1：修改 Nexus 端口

4. 将 Nexus 2 服务指向新实例

在以上步骤完成后，如果旧版本 Nexus 是作为 Windows 服务运行的，那么我们需要将旧版本的 Nexus 服务卸载，然后使用新实例重新安装 Nexus 服务，具体操作步骤如下。

1）使用 win +R 快捷键，打开运行窗口，输入 services.msc，点击确定按钮，如图 2 所示。

图2：运行窗口

2）进入Windows 服务列表，找到服务名为 nexus 的服务。

图3：nexus 服务

3）双击 nexus 服务，打开服务属性窗口，可以看到该服务指向的是旧版本的 Nexus 2.x。

图4：nexus 服务属性

4）在旧版本 Nexus 应用程序目录下的 bin\jsw\windows-x86-64 目录（根据本机操作系统而定）中，以管理员身份运行 uninstall-nexus.bat，卸载 nexus 服务。

图5：卸载现有版本 Nexus 的服务

5）在新版本 Nexus 应用程序目录下的 bin\jsw\windows-x86-64 目录（根据本机操作系统而定）中，以管理员身份运行 install-nexus.bat，安装 nexus 服务。

图6：安装新版本 Nexus 服务

6）再次进入服务列表，查看 nexus 服务属性，可以看到该服务已经指向新版本 Nexus 实例。

图7：nexus 服务指向新版本 Nexus

5. 启动新实例

在新版本 Nexus 的 <应用程序目录>\bin\jsw\windows-x86-64 目录（根据本机操作系统而定），以管理员身份运行 start-nexus.bat。启动成功后，在浏览器地址栏输入：http://localhost:8082/nexus，访问新版本 Nexus 2.x 用户界面。

图8：升级后 Nexus 界面（猛击图片，查看原图）

升级到 Nexus 3.x 最新版本

将 Nexus 2.x 升级到 Nexus 3.x，从本质上说就是将 Nexus 2.x 中的数据传输或迁移到 Nexus 3.x。

Nexus 2.x 升级到 Nexus 3.x 通常需要如下 4 步：

Nexus 2.x 启用 Upgrade: Agent （升级代理）功能
Nexus 3.x 启用 Upgrade （升级）功能
在 Nexus 3.x 中配置升级信息
运行升级程序

1. Nexus 2.x 启用 Upgrade: Agent 功能

Nexus 2.x 升级到 Nexus 3.x 的第一步，就是在 Nexus 2.x 中开启 Upgrade: Agent 功能，操作步骤如下。

1）在 Nexus 2.x 用户界面左侧的导航栏中，点击 Administration 下的 Capabilities，查看 Nexus 2.x 功能列表，如下图。

图9：Nexus 2.x 功能列表

2）点击 Capabilities 列表上方的 New 按钮，新建一个类型（Type）为 Upgrade: Agent 的功能，并填写 Access Token，最后点击下方的 Add 按钮，如下图。

图10：Nexus 2.x 添加 Upgrade: Agent 功能

3) 返回列表页，可以看到已经添加了 Upgrade: Agent，选中该功能可以在下方查看或修改其中配置，如下图。

图11：Nexus 2.x Upgrade：Agent

Nexus 3.x 启用 Upgrade 功能

接下来，我们需要在 Nexus 3.x 中开启 Upgrade 功能，用来接收来自 Nexus 2.x 传输的数据，具体步骤如下。

1）点击最上方的齿轮状图标，切换到 Nexus 3.x “管理和配置”模块，然后点击 System 下的 Capabilities ，查看 Nexus 3.x 功能列表，如下图。