制限モードでNetApp Consoleエージェントを手動でデプロイする
変更を提案
PDF
発信接続が制限された環境でNetApp Consoleを使用する場合は、制限モードでConsoleエージェントを手動で展開する必要があります。
マーケットプレイスのサブスクリプションを使用しない場合、またはGoogle Cloudをデプロイする場合は、Consoleエージェントを手動でインストールする必要があります。
ステップ1：クラウド権限を準備する
Consoleエージェントをインストールする前に、リソースの管理に必要なクラウド プロバイダの権限を準備してください。
ステップ2：Google Cloud APIを有効にする（Google Cloudのみ）
Google CloudにConsoleエージェントをインストールする場合は、インストールの前にプロジェクトで必要なAPIを有効にしてください。これらのAPIは、特定のCloud Volumes ONTAP機能に必要です。
-
"Google Cloud プロジェクトで API を有効にする"
-
Cloud Build API（Infrastructure Managerを使用したプライベートモードCloud Volumes ONTAPデプロイメントに必要）
-
クラウド デプロイメント マネージャー V2 API
-
クラウド インフラストラクチャ マネージャー API
-
クラウドロギングAPI
-
クラウド リソース マネージャー API
-
コンピューティングエンジン API
-
アイデンティティとアクセス管理 (IAM) API
-
Cloud Key Management Service（KMS）API（NetApp Backup and Recoveryを顧客管理暗号化キー（CMEK）で使用する予定がある場合のみ必要）
-
Cloud Quotas API（Infrastructure Managerを使用したCloud Volumes ONTAPデプロイメントに必要）
-
ステップ3：ネットワーク アクセスの準備
Consoleエージェントをインストールするクラウド プロバイダに必要な発信エンドポイントを許可します。
クラウド プロバイダのエンドポイント
AWS環境
これらのAWSサービスエンドポイントが、FSx for ONTAPを含むAWSリソースを管理できるようにします。
| エンドポイント | 目的 |
|---|---|
AWS サービス (amazonaws.com):
|
AWS リソースを管理します。エンドポイントは AWS リージョンによって異なります。 "詳細についてはAWSドキュメントを参照してください" |
Amazon FSx for NetApp ONTAP：
|
Webベースのコンソールは、このエンドポイントに接続して Workload Factory API と対話し、FSx for ONTAPベースのワークロードを管理および操作します。 |
Azure環境
ご利用のAzureリージョンに該当するエンドポイントを許可してください：パブリック、政府機関、または中国。
| エンドポイント | 目的 |
|---|---|
|
Azure パブリック リージョン内のリソースを管理します。 |
|
Azure Government リージョン内のリソースを管理します。 |
|
Azure China リージョンのリソースを管理します。 |
Google Cloud環境
これらのGoogle Cloud APIエンドポイントに、プロジェクト内のリソースの管理を許可します。
| エンドポイント | 目的 |
|---|---|
|
Google Cloud 内のリソースを管理します。 |
NetApp Consoleエンドポイント
NetAppサポート、Console機能、およびConsoleエージェントの展開とアップグレードのための共有エンドポイントを許可します。
| エンドポイント | 目的 |
|---|---|
|
ライセンス情報を取得し、AutoSupportメッセージをNetAppサポートに送信します。 |
|
NetAppサポート サイト (NSS) の資格情報を更新したり、 NetApp Consoleに新しい NSS 資格情報を追加したりします。 |
|
ライセンス情報を取得し、AutoSupportメッセージをNetAppサポートに送信するとともに、Cloud Volumes ONTAPのソフトウェアアップデートを受信するため。 |
|
NetApp Console内で機能とサービスを提供します。 |
政府機関以外の地域では、以下のエンドポイントを使用してください：
政府機関の管轄区域の場合は、代わりに以下のエンドポイントを使用してください：
|
Consoleエージェントの展開とアップグレード用のイメージを取得するため。 |
ブラウザアクセスおよびその他のネットワーク要件については、"制限モードのネットワーク アクセスを準備する"を参照してください。
ステップ4: PodmanまたはDocker Engineをインストールする
オペレーティング システムに応じて、エージェントをインストールする前に Podman または Docker Engine のいずれかが必要になります。
-
Red Hat Enterprise Linux 8 および 9 には Podman が必要です。
-
Ubuntu には Docker Engine が必要です。
Podman をインストールして設定するには、次の手順に従います。
-
podman.socket サービスを有効にして起動します
-
Python3をインストールする
-
podman-composeパッケージをインストールします（Red Hatのバージョンによって異なります）
-
podman-composeをPATH環境変数に追加する
-
Red Hat Enterprise Linux を使用している場合は、Podman バージョンが CNI ではなく Netavark Aardvark DNS を使用していることを確認してください。
|
DNS ポートの競合を避けるために、エージェントをインストールした後、aardvark-dns ポート (デフォルト: 53) を調整します。指示に従ってポートを構成します。 |
-
ホストに podman-docker パッケージがインストールされている場合は削除します。
dnf remove podman-docker rm /var/run/docker.sock -
Podman をインストールします。
Podman は、公式の Red Hat Enterprise Linux リポジトリから入手できます。
-
Red Hat Enterprise Linux 9.6 の場合:
sudo dnf install podman-5:<version><version> は、インストールする Podman のサポートされているバージョンです。サポートされているPodmanのバージョンを表示する 。
-
Red Hat Enterprise Linux 9.1 から 9.4 の場合:
sudo dnf install podman-4:<version><version> は、インストールする Podman のサポートされているバージョンです。サポートされているPodmanのバージョンを表示する 。
-
Red Hat Enterprise Linux 8 の場合:
sudo dnf install podman-4:<version><version> は、インストールする Podman のサポートされているバージョンです。サポートされているPodmanのバージョンを表示する 。
-
-
podman.socket サービスを有効にして起動します。
sudo systemctl enable --now podman.socket -
python3 をインストールします。
sudo dnf install python3 -
システムにまだインストールされていない場合は、EPEL リポジトリ パッケージをインストールします。
podman-compose は、Extra Packages for Enterprise Linux (EPEL) リポジトリから入手できるため、この手順は必須です。
-
Red Hat Enterprise 9 を使用している場合:
-
EPEL リポジトリ パッケージをインストールします。
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm+
-
podman-compose パッケージ 1.5.0 をインストールします。
sudo dnf install podman-compose-1.5.0
-
-
Red Hat Enterprise Linux 8 を使用している場合:
-
EPEL リポジトリ パッケージをインストールします。
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm -
podman-compose パッケージ 1.0.6 をインストールします。
sudo dnf install podman-compose-1.0.6
使用して `dnf install`コマンドは、PATH 環境変数に podman-compose を追加するための要件を満たしています。インストールコマンドは、すでにインストールされているpodman-composeを/usr/binに追加します。 `secure_path`ホスト上のオプション。 -
Red Hat Enterprise Linux 8 を使用している場合は、Podman バージョンが CNI ではなく Aardvark DNS を備えた NetAvark を使用していることを確認します。
-
次のコマンドを実行して、networkBackend が CNI に設定されているかどうかを確認します。
podman info | grep networkBackend -
networkBackendが
CNI、それを変更する必要がありますnetavark。 -
インストール `netavark`そして `aardvark-dns`次のコマンドを使用します。
dnf install aardvark-dns netavark -
開く `/etc/containers/containers.conf`ファイルを編集し、network_backend オプションを変更して、「cni」の代わりに「netavark」を使用します。
もし
/etc/containers/containers.conf`存在しない場合は、設定を変更してください `/usr/share/containers/containers.conf。 -
podman を再起動します。
systemctl restart podman -
次のコマンドを使用して、networkBackend が「netavark」に変更されていることを確認します。
podman info | grep networkBackend
-
-
-
このエージェントを Cloud Volumes ONTAP システムに関連付ける場合は、パフォーマンスを向上させるために、エージェントに関連付けられたスレッド数を増やすことを検討してください。"エージェントのコンテナスレッド制限の増加について"。
Docker のドキュメントに従って Docker Engine をインストールします。
-
サポートされている Docker エンジン バージョンをインストールするには、手順に従ってください。最新バージョンはコンソールでサポートされていないため、インストールしないでください。
-
Docker が有効になっていて実行されていることを確認します。
sudo systemctl enable docker && sudo systemctl start docker
ステップ 5：クラウド環境にNetApp Console制限モードを手動でインストールします（Google Cloudでは必須）
AWS、Azure、または Google Cloud で実行されている独自の Linux ホストに、コンソール エージェントを手動でインストールできます。
次のものが必要です:
-
コンソール エージェントをインストールするためのルート権限。
-
コンソール エージェントからのインターネット アクセスにプロキシが必要な場合のプロキシ サーバーの詳細。
インストール後にプロキシ サーバを設定するオプションがありますが、設定するにはコンソールエージェントを再起動する必要があります。
-
プロキシ サーバーが HTTPS を使用する場合、またはプロキシがインターセプト プロキシである場合は、CA 署名証明書。
|
|
コンソール エージェントを手動でインストールする場合、透過プロキシ サーバーの証明書を設定することはできません。透過プロキシ サーバーの証明書を設定する必要がある場合は、インストール後にメンテナンス コンソールを使用する必要があります。詳細はこちら "エージェントメンテナンスコンソール"。 |
-
インストール中に送信接続を検証する構成チェックを無効にする必要があります。このチェックが無効になっていない場合、手動インストールは失敗します。"手動インストールの構成チェックを無効にする方法を説明します。"
インストール後、新しいバージョンが利用可能な場合、コンソール エージェントは自動的に更新されます。
-
ホストに http_proxy または https_proxy システム変数が設定されている場合は、それらを削除します。
unset http_proxy unset https_proxyこれらのシステム変数を削除しないと、インストールは失敗します。
-
コンソール エージェント ソフトウェアをダウンロードし、Linux ホストにコピーします。 NetApp ConsoleまたはNetAppサポート サイトからダウンロードできます。
-
NetApp Console：エージェント > 管理 > エージェントのデプロイ > オンプレミス > 手動インストール に移動します。
エージェント インストーラ ファイルをダウンロードするか、ファイルへの URL を選択します。
-
"NetAppサポート サイト"（NetApp Consoleへのアクセス権をまだ持っていない場合に必要です）。
ネットワークまたはクラウドで使用するための「オンライン」エージェント インストーラーをダウンロードします。NetApp Console エージェントには別の「オフライン」インストーラーが用意されていますが、プライベート モードの展開でのみサポートされます。 -
NetApp Support Site（まだコンソールへのアクセス権がない場合に必要） "NetAppサポート サイト"。
-
-
スクリプトを実行するための権限を割り当てます。
chmod +x NetApp_Console_Agent_Cloud_<version><version> は、ダウンロードしたコンソール エージェントのバージョンです。
-
Government Cloud 環境にインストールする場合は、構成チェックを無効にします。"手動インストールの構成チェックを無効にする方法を説明します。"
-
インストール スクリプトを実行します。
./NetApp_Console_Agent_Cloud_<version> --proxy <HTTP or HTTPS proxy server> --cacert <path and file name of a CA-signed certificate>ネットワークでインターネットアクセスにプロキシが必要な場合は、プロキシ情報を追加する必要があります。インストール中に明示的にプロキシを追加できます。 `--proxy`および `--cacert`パラメータはオプションであり、追加を要求されることはありません。明示的なプロキシ サーバがある場合は、示されているようにパラメータを入力する必要があります。
透過プロキシを設定したい場合は、インストール後に設定できます。"エージェントメンテナンスコンソールについて学ぶ"。 CA署名付き証明書を使用した明示的なプロキシ サーバの設定例を以下に示します：
./NetApp_Console_Agent_Cloud_v4.0.0 --proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer ./NetApp_Console_Agent_Cloud_v4.0.0 --proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer`--proxy`次のいずれかの形式を使用して、HTTPまたはHTTPSプロキシ サーバを使用するようにConsoleエージェントを設定します：
-
http://アドレス:ポート
-
http://ユーザー名:パスワード@アドレス:ポート
-
http://ドメイン名%92ユーザー名:パスワード@アドレス:ポート
-
https://アドレス:ポート
-
https://ユーザー名:パスワード@アドレス:ポート
-
https://ドメイン名%92ユーザー名:パスワード@アドレス:ポート
次の点に注意してください。
-
ユーザーはローカル ユーザーまたはドメイン ユーザーになります。
-
ドメイン ユーザーの場合は、上記のように \ の ASCII コードを使用する必要があります。
-
コンソールエージェントは、@文字を含むユーザー名またはパスワードをサポートしていません。
-
パスワードに以下の特殊文字が含まれている場合は、その特殊文字の前にバックスラッシュ ( & または ! ) を付けてエスケープする必要があります。
例えば：
-
http://bxpproxyuser:netapp1\!@アドレス:3128
-
-
Podman を使用した場合は、aardvark-dns ポートを調整する必要があります。
-
コンソール エージェント仮想マシンに SSH で接続します。
-
podman /usr/share/containers/containers.conf ファイルを開き、Aardvark DNS サービス用に選択したポートを変更します。たとえば、54 に変更します。
vi /usr/share/containers/containers.conf例えば：
# Port to use for dns forwarding daemon with netavark in rootful bridge # mode and dns enabled. # Using an alternate port might be useful if other DNS services should # run on the machine. # dns_bind_port = 54-
コンソール エージェント仮想マシンを再起動します。
-
コンソール エージェントがインストールされました。プロキシ サーバーを指定した場合、インストールの最後に、コンソール エージェント サービス (occm) が 2 回再起動します。
NetApp Consoleをセットアップします。
ステップ6：NetApp Consoleのセットアップ
コンソールに初めてアクセスすると、コンソール エージェントの組織を選択するように求められ、制限モードを有効にする必要があります。
コンソール エージェントを設定するユーザーは、コンソール組織に属していないログインを使用してコンソールにログインする必要があります。
ログインが別の組織に関連付けられている場合は、新しいログインでサインアップする必要があります。そうしないと、セットアップ画面に制限モードを有効にするオプションが表示されません。
-
コンソール エージェント インスタンスに接続しているホストから Web ブラウザを開き、インストールしたコンソール エージェントの次の URL を入力します。
-
NetApp Consoleにサインアップまたはログインします。
-
ログインしたら、コンソールを設定します。
-
コンソール エージェントの名前を入力します。
-
新しいコンソール組織の名前を入力します。
-
安全な環境で実行していますか? を選択します。
-
*このアカウントで制限モードを有効にする*を選択します。
アカウントの作成後はこの設定を変更できないことに注意してください。制限モードを後から有効にしたり無効にしたりすることはできません。
コンソール エージェントを政府リージョンに展開した場合、チェック ボックスは既に有効になっており、変更できません。これは、制限モードが政府地域でサポートされている唯一のモードであるためです。
-
*始めましょう*を選択します。
-
コンソール エージェントがインストールされ、コンソール組織に設定されました。すべてのユーザーは、コンソール エージェント インスタンスの IP アドレスを使用してコンソールにアクセスする必要があります。
以前に設定した権限をコンソールに提供します。
ステップ7：Consoleエージェントに権限を付与する
Consoleエージェントを手動でインストールした場合は、以前に設定した権限を付与する必要があります。
以前に作成した IAM ロールを、コンソールエージェントをインストールした EC2 インスタンスにアタッチします。
これらの手順は、AWS にコンソールエージェントを手動でインストールした場合にのみ適用されます。 AWS Marketplace のデプロイメントでは、コンソールエージェントインスタンスは、必要な権限を含む IAM ロールにすでに関連付けられています。
-
Amazon EC2 コンソールに移動します。
-
*インスタンス*を選択します。
-
コンソール エージェント インスタンスを選択します。
-
*アクション > セキュリティ > IAM ロールの変更*を選択します。
-
IAM ロールを選択し、*IAM ロールの更新*を選択します。
必要な権限を持つ IAM ユーザーの AWS アクセス キーをNetApp Consoleに提供します。
-
*管理 > 資格情報*を選択します。
-
*組織の資格情報*を選択します。
-
*資格情報の追加*を選択し、ウィザードの手順に従います。
-
資格情報の場所: *Amazon Web Services > エージェント*を選択します。
-
資格情報の定義: AWS アクセスキーとシークレットキーを入力します。
-
マーケットプレイス サブスクリプション: 今すぐサブスクライブするか、既存のサブスクリプションを選択して、マーケットプレイス サブスクリプションをこれらの資格情報に関連付けます。
-
確認: 新しい資格情報の詳細を確認し、[追加] を選択します。
-
Azure ポータルに移動し、1 つ以上のサブスクリプションのコンソール エージェント仮想マシンに Azure カスタム ロールを割り当てます。
-
Azure ポータルから サブスクリプション サービスを開き、サブスクリプションを選択します。
サブスクリプション サービスからロールを割り当てることが重要です。これは、サブスクリプション レベルでのロール割り当ての範囲を指定するためです。 scope は、アクセスが適用されるリソースのセットを定義します。別のレベル (たとえば、仮想マシン レベル) でスコープを指定すると、 NetApp Console内からアクションを完了する機能に影響します。
-
アクセス制御 (IAM) > 追加 > ロール割り当ての追加 を選択します。
-
*役割*タブで、*コンソールオペレーター*役割を選択し、*次へ*を選択します。
コンソール オペレーターは、ポリシーで提供されるデフォルト名です。ロールに別の名前を選択した場合は、代わりにその名前を選択します。 -
*メンバー*タブで、次の手順を実行します。
-
マネージド ID へのアクセスを割り当てます。
-
*メンバーの選択*を選択し、コンソール エージェント仮想マシンが作成されたサブスクリプションを選択し、*マネージド ID*の下で*仮想マシン*を選択して、コンソール エージェント仮想マシンを選択します。
-
*選択*を選択します。
-
*次へ*を選択します。
-
*レビュー + 割り当て*を選択します。
-
追加の Azure サブスクリプションのリソースを管理する場合は、そのサブスクリプションに切り替えて、これらの手順を繰り返します。
-
以前に設定したAzureサービスプリンシパルのクレデンシャルをNetApp Consoleに入力します。
-
*管理 > 資格情報*を選択します。
-
*資格情報の追加*を選択し、ウィザードの手順に従います。
-
資格情報の場所: Microsoft Azure > エージェント を選択します。
-
資格情報の定義: 必要な権限を付与する Microsoft Entra サービス プリンシパルに関する情報を入力します。
-
アプリケーション（クライアント）ID
-
ディレクトリ（テナント）ID
-
クライアントシークレット
-
-
マーケットプレイス サブスクリプション: 今すぐサブスクライブするか、既存のサブスクリプションを選択して、マーケットプレイス サブスクリプションをこれらの資格情報に関連付けます。
-
確認: 新しい資格情報の詳細を確認し、[追加] を選択します。
-
NetApp Consoleに、ユーザーに代わってAzureで操作を実行するために必要な権限が付与されました。
サービス アカウントをコンソール エージェント VM に関連付けます。
-
Google Cloud ポータルに移動し、サービス アカウントをコンソール エージェント VM インスタンスに割り当てます。
-
他のプロジェクトのリソースを管理する場合は、コンソール エージェント ロールを持つサービス アカウントをそのプロジェクトに追加してアクセスを許可します。プロジェクトごとにこの手順を繰り返す必要があります。