Enterprise Consoleの管理

GUI またはコマンドラインを使用して、Enterprise Console で次のプラットフォーム管理タスクを実行できます。

• 新しいプラットフォームの作成
• 既存のプラットフォームの削除
• 認証情報
  の管理
• ホストの管理
  

GUI からも、コマンドラインからも利用できないタスクもあることに注意してください。ここで説明するコマンドの多くは Linux コマンドラインに基づき、プラットフォーム管理の一般的なタスクに対応しています。Windows コマンドプロンプトでも、platform-admin.sh スクリプトを platform-admin.exe cli で置換することで類似するコマンドを実行できます。

<Enterprise Console installation directory>/platform-admin ディレクトリで次のコマンドを実行します。このページには、コマンドの実行に必要な最低限のオプションおよびパラメータが含まれています。 

より多くのオプションとパラメータがあるコマンドもあります。これらの追加オプションを確認するには、-h を指定してコマンドを実行します。たとえば、次のコマンドを実行して、プラットフォーム作成コマンドに関するオプションおよびパラメータをすべて表示します。

bin/platform-admin.sh create-platform -h

bin\platform-admin.exe cli create-platform -h

Enterprise Console の起動または停止

他のタスクを実行するか GUI を使用する前に、Enterprise Console が実行中である必要があります。

Enterprise Console をインストールしたユーザは、Enterprise Console を起動または停止するユーザと同じである必要があります。

次のコマンドを使用して、Enterprise Console を起動または停止します。

bin/platform-admin.sh start-platform-admin

bin\platform-admin.exe cli start-platform-admin

Enterprise Console を停止するには、start を stop で置換します。

プラットフォームの管理

プラットフォームは、AppDynamics コンポーネントとそのホストの集合です。Enterprise Console では、デフォルトで同時に最大 20 のプラットフォームがサポートされます。

プラットフォームの作成

Enterprise Console をエンドツーエンドのインストールおよび管理に使用する場合、最初にプラットフォームを作成する必要があります。Enterprise Console では、Express または Custom インストールを完了するか、GUI で既存のコンポーネントを発見した場合に、プラットフォームが作成されます。 

コマンドラインを使用してプラットフォームを作成するには、次のコマンドを実行します。

bin/platform-admin.sh create-platform --name <platform name> --installation-dir <platform installation directory>

bin\platform-admin.exe cli create-platform --name <platform name> --installation-dir <platform installation directory>

プラットフォーム インストール ディレクトリは、Enterprise Console ですべての AppDynamics コンポーネントがそのすべてのホストにインストールされる絶対ディレクトリです。ホストがプラットフォームに追加された後は、ディレクトリを変更できません。ディレクトリにスペースを含めることはできません。  

プラットフォームの削除

Enterprise Consoleを使用して、使用されなくなったプラットフォームを削除することができます。また、代わりにプラットフォームの構成を編集することも検討できます。GUIのPlatformビューページで、いずれかのアクションを実行できます。

コマンドラインを使用してプラットフォームを削除するには、次のコマンドを実行します。

bin/platform-admin.sh delete-platform --name <platform name>

bin\platform-admin.exe cli delete-platform --name <platform name>

現在のプラットフォームを削除したばかりである場合、将来のコマンドの実行時に予期しないエラーが発生しないよう、APPD_CURRENT_PLATFORM 変数の値を消去する必要があります。

認証情報の管理

Enterprise Console でホストにアクセスし、ホストでイベントサービスへのノードの追加などのタスクを実行するために使用できる認証情報を管理します。GUIのCredentialsページまたはコマンドラインを使用して、認証情報を管理できます。ホストを追加する前に、プラットフォームに認証情報を追加する必要があります。

RSA キーペアの生成

プラットフォームに認証情報を追加するには、RSA 秘密キーファイルが必要です。次の手順では、公開キーファイル ~/.ssh/id_rsa.pub と秘密キーファイル ~/.ssh/id_rsa で構成される RSA キーペアを生成します。

1. SSH を使用して、Enterprise Console ホストマシンにログインします。

2. Enterprise Console の所有者であるユーザに切り替えます。

   sudo -i -u <user-owner of the EC>

   BASH

3. RSA キーペアを作成します。

   ssh-keygen -t rsa -b 2048 -N '' -m pem

   BASH

4. ~/.ssh をキーペアのデフォルトの場所として受け入れます。

5. RSA 公開キーファイルと秘密キーファイルが作成されていることを確認します。

   ls ~/.ssh/
   id_rsa
   id_rsa.pub

   BASH

認証情報の追加

認証情報を追加する場合、情報として認証情報名、ユーザー名、および秘密鍵ファイルが必要です。

• 資格情報名
• ユーザ名

• 秘密キー ファイル（Private key file）

認証情報名は認証情報の一意 ID であり、ホストの追加などのタスクの実行時に、認証情報を指定するために使用されます。AppDynamics では、すべての認証情報名で命名規則に従うことが推奨されます。RSA 秘密キーである id_rsa は、Open SSH 標準エンコーディングよりも OpenSSL PEM エンコーディング形式を使用して作成する必要があります。

usernameフィールドで指定されたUnixシステムユーザーに、プラットフォームディレクトリへの書き込み可能アクセス権がある必要があります。

GUI で [Add] をクリックし、認証情報を追加することができます。

bin/platform-admin.sh add-credential --credential-name <name> --type <ssh> --user-name <username> --ssh-key-file <file path to the key file>

<file path to the key file> は、Enterprise Console マシンの秘密キーです。インストールプロセスで、キーがホストにデプロイされます。  

認証情報の削除

使用されなくなった認証情報を削除します。ホストでまだ使用されている認証情報は、削除できません。GUI で認証情報を選択し、[Delete] をクリックすることで、認証情報を削除できます。

bin/platform-admin.sh remove-credential --credential-name <name>

現認証情報の一覧表示

bin/platform-admin.sh list-credentials

ホストの管理

ホストは、コントローラやイベントサービスなどのAppDynamicsコンポーネントを実行するために使用されるマシンです。たとえば、イベントサービスはコントローラと同じホスト、単一ホスト、または3つ以上のホストのクラスタで実行できます。

リモートホストで新しいホストを追加するために使用する認証情報を、適切に構成する必要があります。すなわち、指定した秘密鍵に対し、対応する公開鍵をリモートホスト ~/.ssh/authorized_hosts ファイルに追加する必要があります。

コントローラとイベントサービスは、同じローカルネットワーク上に配置されていて、内部ネットワークで通信できる必要があります。互いに関連していても、Enterprise Console が実行されているコントローラに関連していても、別のネットワークにあるノードにクラスタをデプロイしないでください。構成でクラスタホストを特定する場合は、そのホストの外部ルーティング対応の DNS 名ではなく、ホストの内部 DNS 名または IP アドレスを使用する必要があります。

たとえば、AWS デプロイの場合、ec2-34-201-129-89.us-west-2.compute.amazonaws.com などの公開 DNS ホスト名ではなく、172.31.2.19 などのプライベート IP アドレスを使用します。その場合、Enterprise Console GUI の [Controller Settings] から [Appserver Configurations] に移動し、ページにアクセスできるよう外部 URL を編集する必要があります。

GUI を使用してコンポーネントをインストールまたは発見する場合、Enterprise Console を実行するホストが自動的に作成され、Enterprise Console マシンのホスト名としてプラットフォームに追加されます。GUIを使用しない場合は、このホストを手動で追加する必要があります。

ホストは、Enterprise Console GUI の [Hosts] ページか、またはコマンドラインから管理できます。

RSA 秘密キーである id_rsa は、Open SSH 標準エンコーディングよりも OpenSSL PEM エンコーディング形式を使用して作成する必要があります。

リモートホストの設定

Enterprise Console とリモートホストのシームレスな通信を設定するには、以下の手順を実行します。

From the command line:

      1. パスワード不要な次のSSHを設定します。

1. • Enterprise Console からコントローラ
   • HAの場合：
     
     • Enterprise Consoleからプライマリコントローラ
     • Enterprise Consoleからセカンダリコントローラ
     • プライマリコントローラからセカンダリコントローラへ
     • セカンダリコントローラからプライマリコントローラへ

From the Enterprise Console:

      2. Enterprise Console Linux AppDynamics ユーザの公開/秘密キーペアを特定します（通常は ~/.ssh）。

      3. Enterprise Console Linux AppDynamics ユーザの公開キー（~/.ssh/id_rsa.pub）を、リモート コントローラ サーバ Linux ユーザの ~/.ssh/authorized_keys に追加します。

      4. 次に、chmod 600 /.ssh/authorized_keys を実行します。

      5. 以下を使用し、Enterprise ConsoleサーバーからのSSH接続をテストします。

ssh <remote user>@<remote-server> hostname

      6. リモートホスト名が印刷されていることを確認します。最初に、はいと答えてサーバーフィンガープリントを信頼する必要がある場合があります。

      7. Enterprise Console UI Credentialページにアクセスし、認証情報を追加するか、または既存の認証情報を編集します。

8. すべてのリモートホストで同じになる可能性がある単一の認証情報を作成します。名前は、EC-<ec linux user name>-<remote appd user name>（例：EC-ecappduser-appduser）のようになります。また、ユーザ名が Enterprise Console とリモートサーバで同じである場合は、EC-appdyn のようになります。

      9. リモートサーバーのLinuxユーザー名を入力します。これは、ローカルのEnterprise Console AppDynamicsユーザーと同じである場合があります。

      10. Enterprise Console Linux ユーザの ~/.ssh/id_rsa コンテンツを、ステップ 2 で選択された秘密キーとして入力します。

ホストの追加

プラットフォームにホストを追加する前に、必要な認証情報がプラットフォームに追加されていることを確認してください。

作成されたユーザ ID が、認証情報のユーザ ID と一致していることも確認する必要があります。また、プラットフォーム ベース ディレクトリに対して指定されたパスが存在する必要があります。

GUI で [Add] をクリックし、ホストを追加することができます。

bin/platform-admin.sh add-hosts --hosts host_1 host_2 host_3 --credential <credential name>

--hostsを使用してホストを一覧にする代わりに、次のコマンドを使用し、行区切りリストを含むテキストファイルを指定することができます。

bin/platform-admin.sh add-hosts --host-file <file path to host file> --credential <credential name>

GUI を使用しない場合は、Enterprise Console のホストを追加する必要があります。これは、コントローラおよび埋め込みイベントサービスで使用されるホストでもあります。このホストの名前は「localhost」であり、認証情報は必要ありません。たとえば、次のコマンドを実行します。

bin/platform-admin.sh add-hosts --hosts localhost

bin\platform-admin.exe cli add-hosts --hosts localhost

ループバックアドレス「127.0.0.1」またはマシンの実際のホスト名を使用することもできます。

ホストの削除

ホストを削除する前に、すべての AppDynamics コンポーネントがホストから削除されていることを確認してください。GUI でホストを選択し、[Remove] をクリックすることでホストを削除できます。

bin/platform-admin.sh remove-hosts --hosts host_1 host_2 host_3

--hosts を使用してホストを一覧にする代わりに、次のコマンドを使用し、行区切りリストを含むテキストファイルを指定することができます。

bin/platform-admin.sh remove-hosts --host-file <file path to host file>

アクセスできなくなったホストを、次のコマンドを使用して削除できます。

bin/platform-admin.sh remove-dead-hosts --hosts <host name>

これにより、ホストとそのすべての関連メタデータがEnterprise Consoleデータベースから削除されます。

remove-dead-hosts を実行すると、さまざまなサービスで不整合が発生する可能性があります。

現ホストの一覧表示

bin/platform-admin.sh list-hosts

bin\platform-admin.exe cli list-hosts

ホスト認証情報の更新

Enterprise Console でホストにアクセスするために使用される認証情報を変更します。GUI でホストを選択し、[Change Credentials] をクリックすることで、ホスト認証情報を変更できます。

bin/platform-admin.sh update-host-credential --hosts host_1 host_2 host_3 --credential <credential name>

ホスト追加および削除コマンドと同様に、コマンド内でホストの一覧を入力する代わりにテキストファイルを指定することができます。

Enterprise Console管理ユーザーパスワードの管理

管理ユーザーパスワードの変更

次のコマンドを実行して、管理ユーザのパスワードを変更できます。

bin/platform-admin.sh change-password --user-name <username> --password <current password> --new-password <new password>

bin\platform-admin.exe cli change-password --user-name <username> --password <current password> --new-password <new password>

管理ユーザーパスワードのリセット

Enterprise Console のルートユーザのパスワードを、次のコマンドを実行してリセットできます。

bin/platform-admin.sh reset-password

bin\platform-admin.exe cli reset-password

パスワードをリセットすると、「admin」に設定されます。

Enterprise Console データベース ルート ユーザ パスワードの管理

データベース ルート ユーザ パスワードの変更

platformAdmin.databaseRootPassword を変更するには、次の手順を実行します。

1. <EC_home>/Platform/platform-admin/bin で次のコマンドを実行し、Enterprise Console を停止します。

   bin/platform-admin.sh stop-platform-admin

2. <EC_home>/Platform/mysql/bin でコマンドを実行します。

   bin/mysqld --defaults-file="/<EC_home>/Platform/mysql/db.cnf" --skip-grant-tables

   コマンドを実行する前に、<EC_home> を置換します。

3. 新しいコマンドプロンプトウィンドウを開きます。

4. <EC_home>/Platform/mysql/bin で次のコマンドを実行することで、パスワードを使用せずにデータベースに接続します。

   bin/mysql -u root -h 127.0.0.1 -P 3377 --protocol=TCP

5. 次のクエリを実行します。

   update mysql.user set authentication_string=password('<new_password_here>') where user like 'root%';
   flush privileges;
   quit;

   クエリを実行する前に、<new_password_here>  を置換します。

6. コマンドプロンプトを終了します。

7. <EC_home>/Platform/platform-admin/bin で次のコマンドを実行し、Enterprise Console データベースを停止します。

   bin/platform-admim.sh stop-platform-admin

   

   これにより、MySQL DB を停止し、次の手順の --skip-grant-tables オプションを使用せずに起動します。

8. <EC_home>/Platform/platform-admin/bin で次のコマンドを実行し、Enterprise Console を起動します。

   bin/platform-admin.sh start-platform-admin

9. <EC_home>/Platform/mysql/bin で次のコマンドを実行し、ログインを確認します。

   bin/mysql -u root -p -P 3377 -h 127.0.0.1

Enterprise Console データベース ユーザ パスワードの管理

platformAdmin データベース ユーザ パスワードの変更

platformAdmin.databasePassword を変更するには、次の手順を実行します。

コマンドの実行時に、AppDynamics プラットフォームのインストールを所有するアプリケーション ID を使用します。

1. Enterprise Console が実行していない場合は起動します。
   次のコマンドを実行します。コマンドを実行する前に <EC_home> を置き換えます。

   <EC_home>/platform/platform-admin/bin: ./platform-admin.sh start-platform-admin

2. <EC_home>/platform/mysql/bin  ディレクトリに移動します。

3. 次のコマンドを実行して、ルートユーザとしてデータベースにログインします。

   ./mysql -u root -p -h 127.0.0.1 -P 3377 --protocol=TCP

4. 次のクエリを実行します。クエリの実行前に <new_password_here> を置き換えてください。

   update mysql.user set authentication_string=password('<new_password_here>') where user like 'platformadmin%'; flush privileges; quit;

5. <EC_home>/Platform/mysql/bin  ディレクトリで次のコマンドを実行し、ログインを確認します。

   ./mysql -u platformadmin -p -P 3377 -h 127.0.0.1

6. <EC_home>/platform/platform-admin/bin ディレクトリに移動します。

7. ステップ 4 で platformadmin に設定された新しいパスワードを暗号化するには、次のコマンドを実行します。

   ./platform-admin.sh encrypt --text '<new_password_here>'

   暗号化されたパスワードをメモします。

8. 次のページに移動します。<EC_home>/Platform/platform-admin/conf directory.
9. PlatformAdminApplication.yml ファイルをバックアップします。 
10. vi などのテキストエディタを使用して、PlatformAdminApplication.yml  ファイルを開き、database: セクションで暗号化された password: 行を見つけます。
11. 暗号化されたパスワードを更新し、password: エントリの後のテキストをステップ 7 の後にメモしたパスワードに置き換え、変更を保存します。

12. <EC_home>/Platform/platform-admin/bin directory で次のコマンドを実行し、Enterprise Console を停止します。

    ./platform-admin.sh stop-platform-admin

13. <EC_home>/Platform/platform-admin/bin directory で次のコマンドを実行し、Enterprise Console を起動します。

    ./platform-admin.sh start-platform-admin

14. Enterprise Console が正常に起動したことを確認します。

インストールディレクトリの変更

プラットフォームの作成時に指定したインストールディレクトリが、すべてのAppDynamicsコンポーネントのインストールに使用されます。このディレクトリは変更できますが、すべてのAppDynamicsコンポーネントをアンインストールする必要があります。

1. インストールしたすべてのAppDynamicsコンポーネントをアンインストールします。

2. プラットフォームから、localhostを含むすべてのホストを削除します。たとえば、次のコマンドを実行して localhost を削除します。

   bin/platform-admin.sh remove-hosts --hosts localhost

   BASH

3. インストールディレクトリを変更します。

   bin/platform-admin.sh update-platform --installation-dir <directory>

   BASH
   

   インストールディレクトリにスペースを含めることはできません。

インストールディレクトリを変更した後、ホストを追加し、AppDynamics コンポーネントを再インストールする必要があります。

管理タスクのトラブルシューティング

Enterprise Console の可用性の確認

Enterprise Console の可用性を確認するには、次の API を使用できます。

http://econsole-host:9191/service/version

ホストの追加中のエラー

プラットフォームへのホストの追加時に、「Enterprise Console host expansion failed」エラーが発生することがあります。その場合は、sshd_config で SFTP が有効化されるようにし、SSH サービスを再起動します。