セルフホスト型 Classic Edition のアップグレード ( Docker )

Classic Edition をアップグレードするには、以下の手順に従ってください：

注：アップグレードポリシーでは、最大で1つのリリースをスキップできると定められています。つまり、 リリース245-x からリリース247-x またはリリース249-x へのアップグレードは可能ですが、それ以上のスキップはできません。ポリシーにより、必要なアップグレードを一度に実行できない場合は、複数のアップグレード・ステップを実行する必要があります。

注：バックエンド 279 以前のリリース、stanctl 1.6.0、または Operator 1.0.0 については、バックエンドを最大 2 バージョンずつ段階的にアップグレードする必要があります。たとえば、バージョン279へのアップグレードは、バージョン275以降からのみ可能です。詳細については、 Instana の旧バージョンのドキュメントを参照してください。

重要： Classic Edition では、アップグレード後の「 Instana 」バックエンドのロールバックはサポートされていません。

シングルホストの Docker 環境のアップグレード

オンラインで編集する

シングルホストの Docker 環境をアップグレードするには、以下の手順に従ってください：

Instana コンソールをターゲットバージョンにアップグレードしてください。詳細については、「 Instana コンソールのアップグレード」を参照してください。
Instana のバックエンドをアップグレードしてください。詳細については、「 Instana バックエンドのアップグレード」を参照してください。

デュアルホスト構成の Docker のアップグレード

オンラインで編集する

デュアルホスト構成の Docker をアップグレードするには、以下の手順に従ってください：

Instana コンソールを、 ClickHouse ホスト上のターゲットバージョンにアップグレードします。詳細については、「 Instana コンソールのアップグレード」を参照してください。
Instana が展開されているホストマシンで、以下の操作を行ってください：
1. Instana コンソールを、 Instana ホスト上のターゲットバージョンにアップグレードします。詳細については、「 Instana コンソールのアップグレード」を参照してください。
2. Instana ホスト上の Instana バックエンドをアップグレードしてください。詳細については、「 Instana バックエンドのアップグレード」を参照してください。

エアギャップ環境の Docker 環境のアップグレード

オンラインで編集する

エアギャップ環境の Docker は、外部の仮想マシン（ VM ）または対象の VM のいずれかでアップグレードできます。

外部サイト VM （インターネット接続が必要です）

オンラインで編集する

Instana コンソールアプリケーションをダウンロードしてインストールしてください。

この yum --showduplicates コマンドは、 Instana コンソールアプリケーションの利用可能なバージョンの一覧を表示します。

yum --showduplicates list instana-console
(...)
instana-console.x86_64   259_3-1   instana-product
instana-console.x86_64   259_4-1   instana-product
instana-console.x86_64   261_0-1   instana-product
instana-console.x86_64   261_1-1   instana-product
instana-console.x86_64   261_2-1   instana-product
instana-console.x86_64   263_0-1   instana-product
instana-console.x86_64   263_1-1   instana-product
instana-console.x86_64   263_2-1   instana-product
instana-console.x86_64   263_3-1   instana-product
instana-console.x86_64   265_0-1   instana-product

Instana コンソールを使用して、必要なすべての Instana イメージをダウンロードしてください。
Instana コンソールアプリケーションと Instana のイメージを、エアギャップ環境の VM にエクスポートします。

次の instana images export -k DOWNLOAD_KEY コマンドを実行すると、 Instana のイメージがファイルにダウンロードされ、 .tar そのファイルをエアギャップ環境の VM にエクスポートすることができます：
```
instana images export -k DOWNLOAD_KEY
Images export ⣯ pull artifact-public.instana.io/backend/butler:3.265.276-0
(...)
-rw------- 1 root    root    8295586304 Feb  8 01:38 export-265-1.tar
 
```
注：Instana.tar ファイルのサイズは約8 GBです。

対象サイト： VM （インターネット接続は不要）

オンラインで編集する

必要なバージョンにインストールまたは更新 instana-console してください。詳しくは、「 Instana コンソールのアップグレード」を参照してください。

次の yum install --downloadonly コマンドを実行すると、指定した場所に instana-console ファイルがダウンロードされます。その後、インターネットに接続していない VM にそのファイルをエクスポートすることができます：

yum install -y --downloadonly --downloaddir=/opt/instana instana-console-265_1-1
(...)
-rw-r--r-- 1 root    root      30581559 Feb 12 02:41 instana-console-265_1-1.x86_64.rpm

以下の yum localinstall コマンドは、ローカル・ファイル (例: Red Hat Package Manager (RPM)) からパッケージをインストールします。

yum localinstall instana-console-259_2-1.x86_64.rpm
(...)
Total size: 29 M
Is this ok [y/N]: Y
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
 Preparing        :                                                                                                                                                     1/1
 Upgrading        : instana-console-265_1-1.x86_64                                                                                                                      1/2
 Cleanup          : instana-console-259_2-1.x86_64                                                                                                                      2/2
 Running scriptlet: instana-console-259_2-1.x86_64                                                                                                                      2/2
 Verifying        : instana-console-265_1-1.x86_64                                                                                                                      1/2
 Verifying        : instana-console-259_2-1.x86_64                                                                                                                      2/2
 Installed products updated.

 Upgraded:
 instana-console-265_1-1.x86_64

次のコマンドを使用して、 Instana の画像をインポートします：
```
instana images import -f /opt/instana/export-265-0.tar
 
```
instana-console バージョンがサポートされていない場合、更新手順は失敗します。
次のコマンドを使用して、 Instana の更新プロセスを実行してください：
```
instana update -f settings.hcl
 
```