Nexus 2.x と比較して、Nexus 3.x はより実用的な新機能を提供します。SonaType は、最新バージョンの Nexus 2.x を使用して最新バージョンの Nexus 3.x にアップグレードすることを公式に推奨しており、 記事内で各バージョンの Nexus を最新バージョンの Nexus 3.x にアップグレードするプロセスを提供しています。 Nexusアップグレードの互換性 (以下の表に示すとおり)。
| 古いバージョン | アップグレードプロセス |
|---|---|
| 3.1.0以降 |
|
| 3.0.0 ～ 3.0.2 |
|
| 最新の2.xバージョン |
|
| 2.0 およびその他の 2.x バージョン |
|
| 1.x |
|
注: Nexus 1.x は、2.7.2 以降のバージョンへの直接アップグレードをサポートしていません。
上の表からわかるように、Nexus 2.x から Nexus 3.x へのアップグレードには 2 つの手順が必要です。
- 最新バージョンの Nexus 2.x にアップグレードします。
- 最新の Nexus 3.x バージョンにアップグレードする
最新バージョンの Nexus 2.x にアップグレードします。
1. 最新バージョンの Nexus 2.x をダウンロードして解凍します。
最新バージョンの Nexus 2.x (現在は Nexus-2.14.20-02) をダウンロードして解凍します。
2. 作業ディレクトリを置き換えます
Nexus 2.x であっても Nexus 3.x であっても、解凍後のインストール パッケージには次の 2 つの部分が含まれています。
- nexus-version 番号 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 に変更されました。
4. Nexus 2 サービスが新しいインスタンスを指すようにします。
上記の手順を完了した後、古いバージョンの Nexus が Windows サービスとして実行されている場合は、古いバージョンの Nexus サービスをアンインストールし、新しいインスタンスを使用して Nexus サービスを再インストールする必要があります。具体的な手順は次のとおりです。
1) win +R ショートカット キーを使用してファイル名を指定して実行ウィンドウを開き、services.msc と入力して [OK] ボタンをクリックします。
2) Windows サービス リストに入り、nexus という名前のサービスを見つけます。
3) nexus サービスをダブルクリックしてサービスのプロパティ ウィンドウを開くと、サービスが古いバージョンの Nexus 2.x を指していることがわかります。
4) 古いバージョンの Nexus アプリケーション ディレクトリの下にある bin\jsw\windows-x86-64 ディレクトリ (ローカル オペレーティング システムに応じて) で、管理者として uninstall-nexus.bat を実行して、Nexus サービスをアンインストールします。
5) 新しいバージョンの Nexus アプリケーション ディレクトリの下の bin\jsw\windows-x86-64 ディレクトリ (ローカル オペレーティング システムに応じて) で、管理者として install-nexus.bat を実行して nexus サービスをインストールします。
6) サービス リストを再度入力し、Nexus サービスのプロパティを確認すると、サービスが新しいバージョンの Nexus インスタンスを指していることがわかります。
5. 新しいインスタンスを開始する
新しいバージョンの Nexus (ネイティブ オペレーティング システムに応じて) の <アプリケーション ディレクトリ>\bin\jsw\windows-x86-64 ディレクトリで、管理者として start-nexus.bat を実行します。正常に起動したら、ブラウザのアドレス バーに http://localhost:8082/nexus と入力して、新しいバージョンの Nexus 2.x ユーザー インターフェイスにアクセスします。
最新バージョンの 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 でアップグレードが可能: エージェント機能
- Nexus 3.x ではアップグレード機能が有効になります
- Nexus 3.x でのアップグレード情報の構成
- アップグレード プログラムを実行する
1. Nexus 2.x でアップグレード可能: エージェント機能
Nexus 2.x を Nexus 3.x にアップグレードする最初のステップは、Nexus 2.x でアップグレード: エージェント機能を有効にすることです。手順は次のとおりです。
1) Nexus 2.x ユーザー インターフェイスの左側にあるナビゲーション バーで、[管理] の下の [機能] をクリックして、以下に示すように Nexus 2.x の機能リストを表示します。
2) 以下に示すように、機能リストの上にある「新規」ボタンをクリックし、タイプ「アップグレード: エージェント」の新しい機能を作成し、アクセス トークンを入力して、最後に下の「追加」ボタンをクリックします。
3) リスト ページに戻ると、[アップグレード: エージェント] が追加されていることがわかります。以下に示すように、この機能を選択して、以下の構成を表示または変更します。
ここで注意すべき点は、アクセス トークンが非常に重要な役割を果たしており、Nexus 間のデータ送信に必要な重要な認証情報の 1 つです。
Nexus 3.x ではアップグレード機能が有効になります
次に、Nexus 2.x から送信されたデータを受信できるように、Nexus 3.x のアップグレード機能を有効にする必要があります。具体的な手順は次のとおりです。
1) 上部の歯車アイコンをクリックして Nexus 3.x の「管理と構成」モジュールに切り替え、次に「システム」の下の「機能」をクリックして、以下に示すように Nexus 3.x の機能リストを表示します。
2) 以下に示すように、リストの上にある [機能の作成] ボタンをクリックして、タイプ (タイプ) アップグレードの機能を作成します。
3) 次に、タイプ「アップグレード」の新しいデータが機能リストに追加されただけでなく、以下に示すように、「システム」の下に「アップグレード」メニューも存在することがわかりました。
アップグレード プログラムを実行する
1) Nexus 3.x でアップグレード機能を有効にした後、「システム」の下の「アップグレード」をクリックして、アップグレード プログラムの概要に入ります。概要では、アップグレード時の注意事項、アップグレードできるコンテンツ、アップグレードできないコンテンツを紹介します。お読みになった後、下の「次へ」ボタンをクリックしてください。
2) 「エージェント接続」ページに移動し、URL、アクセストークンなどを設定し、設定が完了したら、下の「次へ」ボタンをクリックします。
上記のフィールドは次のように説明されます。
- URL: Nexus 2.x の完全なアクセス アドレス (http://localhost:8082/nexus など)。
- アクセス トークン: Nexus 2.x がアップグレード: エージェント機能を有効にするときに設定されるアクセス トークン。
3) 「コンテンツ」ページに移動します。ここで、アップグレード プロセス中に転送するコンテンツを選択する必要があります。これには次の 2 つの項目が含まれます。
- 倉庫の構成と内容
- Nexusサーバーの設定
選択後、下の「次へ」ボタンをクリックしてください。
4) 「リポジトリのデフォルト」ページに移動し、ウェアハウスコンテンツの保存場所（Blob Store）とデータ転送方法（Data Transfer Method）を設定し、設定完了後、下の「次へ」ボタンをクリックします。
5) 「リポジトリ」ページに移動し、移行するウェアハウスを選択し、選択が完了したら、以下に示すように「次へ」ボタンをクリックします。
アップグレードするウェアハウスを選択することに加えて、以下に示すように、ウェアハウス リストの最後の列にある構成アイコンをクリックして、ウェアハウスのアップグレード オプションをカスタマイズします。
6) 設定が完了したら、下部の「次へ」ボタンをクリックして「プレビュー」ページに移動します。このページには、すべてのアップグレード構成情報が表示されます。それが正しいことを確認したら、下の「開始」ボタンをクリックして、以下に示すようにアップグレード プログラムを開始します。
7) アップグレードを開始する前に、「準備中」ページに移動し、簡単な準備を行います。準備の進行状況バーが 100% に達したら、下の [続行] ボタンをクリックして次のステップに進みます。
8) 「同期」ページに移動します。ここで、Nexus アップグレード プログラムは、ウェアハウスのスキャンとデータ同期の 2 段階の操作を実行します。ウェアハウスのスキャンが完了したら、下の [続行] ボタンをクリックしてデータの同期を開始します。同期の開始後、Nexus 2.x リポジトリに加えられた変更は Nexus 3.x に同期されません。
9) 同期が完了したら、下の [完了] ボタンをクリックしてアップグレード プロセスを終了します。
10) 上部の立方体アイコンをクリックし、Nexus 3.x の「参照」モジュールに切り替え、左側の「参照」メニューをクリックして、Nexus 3.x ウェアハウス リストを参照します。Nexus 2 のウェアハウスとコンポーネントが表示されます。 .x が移行されました Nexus 3.x です。
