インストール後

Edge のインストールが正常に完了したら、インストールを検証し、設定を調整して構成をカスタマイズするために、一般的なタスクを実行します。タスクは次のとおりです。

これらは、Edge のインストール後に通常行う一般的なタスクの一部です。その他のオペレーションと管理タスクについては、Edge の構成方法とオペレーションをご覧ください。

Edge コンポーネントでコマンドを呼び出す

Edge は、Edge のインストールを管理するために使用できる管理ユーティリティを /opt/apigee/apigee-service/bin にインストールします。たとえば、apigee-all ユーティリティを使用して、ノード上のすべての Edge コンポーネントを起動、停止、再起動したり、ステータスを確認したりできます。

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

apigee-service ユーティリティを使用して、個々のコンポーネントを制御、構成します。apigee-service ユーティリティの形式は次のとおりです。

/opt/apigee/apigee-service/bin/apigee-service component_name action

ここで component_name はコンポーネントを表します。コンポーネントは、apigee-service を実行するノードに存在する必要があります。構成に応じて、component_name の値には次のものが含まれます。

• apigee-cassandra（Cassandra）
• apigee-openldap（OpenLDAP）
• apigee-postgresql（PostgreSQL データベース）
• apigee-qpidd（Qpidd）
• apigee-zookeeper（ZooKeeper）
• edge-management-server（管理サーバー）
• edge-management-ui（新しい Edge UI）
• edge-message-processor（Message Processor）
• edge-postgres-server（Postgres サーバー）
• edge-qpid-server（Qpid サーバー）
• edge-router（エッジルーター）

これらのコンポーネントに加えて、構成によっては apigee-provision コンポーネントと apigee-validate コンポーネントで apigee-service を呼び出すこともできます。

たとえば、Edge Router を再起動するには、次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

ノードにインストールされているコンポーネントのリストを確認するには、/opt/apigee ディレクトリを調べます。このディレクトリには、ノードにインストールされている Edge コンポーネントごとにサブディレクトリが含まれています。各サブディレクトリの先頭には次のプレフィックスが付いています。

• apigee: Edge で使用されるサードパーティ コンポーネント。例: apigee-cassandra
• edge: Apigee の Edge コンポーネント。例: edge-management-server
• edge-mint: 収益化コンポーネント。（例: edge-mint-management-server）。

コンポーネントのアクションの完全なリストはコンポーネント自体によって異なりますが、すべてのコンポーネントは次のアクションをサポートしています。

• start, stop, restart
• status, version
• backup, restore
• install, uninstall

Edge コンポーネントを構成する

インストール後に Edge を構成するには、.properties ファイルと Edge ユーティリティを組み合わせて使用します。たとえば、新しい Edge UI で TLS/SSL を構成するには、.properties ファイルを編集して必要なプロパティを設定します。.properties ファイルを変更した場合は、影響を受ける Edge コンポーネントを再起動する必要があります。

.properties ファイルは /opt/apigee/customer/application ディレクトリにあります。各コンポーネントには、そのディレクトリに独自の .properties ファイルがあります。たとえば、router.properties や management-server.properties です。

コンポーネントのプロパティを設定するには、対応する .properties ファイルを編集して、コンポーネントを再起動します。

/opt/apigee/apigee-service/bin/apigee-service component restart

次に例を示します。

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Edge を更新すると、/opt/apigee/customer/application ディレクトリの .properties ファイルが読み取られます。つまり、更新しても、コンポーネントに設定したプロパティは保持されます。

Edge の構成の詳細については、Edge の構成方法をご覧ください。

ノードに apigee-monit をインストールする

ノードへのコンポーネントのインストールが完了したら、必要に応じて apigee-monit ユーティリティを追加できます。apigee-monit はノード上のコンポーネントをモニタリングし、コンポーネントが失敗した場合は再起動を試みます。詳細については、apigee-monit による自己回復をご覧ください。

SymasLDAP サーバーを読み取り専用に構成する

Edge 環境に SymasLDAP サーバーが含まれるが、そのサーバーにトラフィックを切り替える必要がない場合は、そのサーバーを読み取り専用に構成することをおすすめします。手順は次のとおりです。

1. サーバーでファイル mark_readonly.ldif を作成して、以下の行を追加します。

   dn: olcDatabase={2}mdb,cn=config
     changetype: modify
     replace: olcReadOnly
     olcReadOnly: TRUE

2. サーバーで次のコマンドを実行して、サーバーを読み取り専用にします。

     ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif

プライマリ サーバーで障害が発生した場合は、次の手順で切り替え処理を行って、スタンバイ サーバーをプライマリとして使用できます。

1. スタンバイ サーバーでファイル mark_writable.ldif を作成して、以下の行を追加します。

     dn: olcDatabase={2}mdb,cn=config
     changetype: modify
     replace: olcReadOnly
     olcReadOnly: FALSE

2. スタンバイ サーバーで次のコマンドを実行します。

     ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif