デベロッパー サービス ポータルの要件

Developer Services Portal v. 4.16.09

インストールに必要なハードウェアとソフトウェアの要件は次のとおりです。

MySQL データベースの要件

デベロッパー チャネル サービスと同じマシンに MySQL サーバーをインストールする場合（単一マシン トポロジ）、デベロッパー チャネル サービスのインストーラによって、データベース名とデータベース ユーザーの入力を求められます。その後、MySQL サーバーがインストールされ、データベース スキーマが作成されます。インストールされているバージョンは、お使いの OS で利用可能な最新バージョンです。

MySQL サーバーを別のシステムにインストールする場合は、デベロッパー チャネル サービスのインストーラを起動する前に、そのシステムに MySQL サーバーをインストールしておく必要があります。MySQL 5.0.15 以降がインストールされている必要があります。

Developer Channel Services インストーラでは、MySQL サーバーに空のデータベース スキーマを持つデータベースが含まれている必要があります。Developer Channel Services インストーラにより、データベースのホスト名、データベース名、データベース ユーザーの入力を求められます。インストーラはデータベースに接続して、デフォルトのデータベース テーブルとデータを作成します。

データベース ユーザーは、Developer Channel Services がデータベースに接続するために使用されます。このユーザーには、SELECT、INSERT、UPDATE、DELETE、CREATE、DROP、INDEX、ALTER、CREATE TEMPORARY TABLES、LOCK TABLES の権限が必要です。

たとえば、devportal という名前のデータベースと devportal という名前のユーザーを作成するには、次のようにします。

1. システムに MySQL サーバーをインストールします。
2. 次のコマンドを使用して、root ユーザーとして MySQL にログインします。
   > mysql -u root -p
3. プロンプトが表示されたら、root のパスワードを入力します。
4. mysql> プロンプトで、次のように入力して devportal ユーザーを作成します。
   mysql>create user 'devportal'@'localhost' identified by 'devportal';
   mysql> grant all privileges on *.* to 'devportal'@'localhost';
   mysql> flush privileges;
   mysql> quit
5. システム プロンプトで、devportal データベースを作成します。
   > mysqladmin -u devportal -p create devportal
   
   devportal のパスワードを入力します。
6. MySQL にログインし、ポータル サーバーの IP から devportal へのアクセスを許可します。
   mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';
   
   ここで、portalIP はポータル サーバーの IP アドレス、devportalPW は devportal ユーザーのパスワードです。
7. /etc/my.cnf を編集して、bind-address を MySQL サーバーの IP アドレスに設定します。
8. MySQL を再起動します。
   > /etc/init.d/mysqld restart
9. MySQL サーバーでポート 3306 が開いていることを確認します。この手順は、オペレーティング システムによって異なります。たとえば、Linux の場合は、次のコマンドを使用します。
   > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

Developer Channel Services をインストールするときに、MySQL サーバーをローカルにインストールしないように指定します。リモート データベースの IP アドレス、ユーザー名、データベース名の入力を求められます。

Red Hat Enterprise Linux（RHEL）の要件

RHEL には、Red Hat からソフトウェアをダウンロードするために必要なサブスクリプションに関する追加の要件があります。サーバーは、yum 経由で RPM をダウンロードするためにインターネットに接続できる必要があります。RHEL を使用している場合、サーバーは Red Hat Network（RHN）に登録され、サーバーのオプション チャンネルに登録されている必要があります。

Red Hat の要件はインストール中にチェックされ、RHEL がまだ登録されていない場合は、ポータル インストーラによってプロンプトが表示されます。Red Hat のログイン認証情報がすでにある場合は、次のコマンドを使用して RHEL を登録してから、インストール プロセスを開始できます。

> subscription-manager register --username=my_username --password=my_password --auto-attach 

my_username と my_password を Red Hat の認証情報に置き換えます。

RHEL の試用版をお持ちの場合は、30 日間の試用ライセンスを取得できます。詳細については、https://access.redhat.com/solutions/32790 をご覧ください。

SMTP の要件

デフォルトでは、ポータルは PHP の mail() 関数を使用してメールを送信します。PHP は、ローカル システムで sendmail を使用してメールを送信しようとします。これは、PHP の php.ini ファイルで構成できます。

本番環境では、ポータルからメール メッセージを送信するように SMTP サーバーを構成する必要があります。したがって、Drupal が SMTP サーバーの必要なポートにアクセスできるようにする必要があります。TLS 以外の SMTP の場合、ポート番号は通常 25 です。TLS 対応の SMTP の場合は 465 であることが多いですが、SMTP プロバイダに確認してください。

その他の要件

インストールを実行するには、ソフトウェアをインストールするユーザーに root アクセス権が必要です。

デプロイ アーキテクチャの要件

デベロッパー チャンネル サービスには、ユーザーのアプリケーションに関する情報を保存および取得するために、REST API を介して Apigee Management Server との単一のインターフェースがあります。Developer Channel Services は、インストールに応じて、HTTP または HTTPS 経由で Management Server に接続できる必要があります。

インストールを開始する前に必要な情報

インストールを開始する前に、次の情報を用意する必要があります。

1. 構成するプラットフォームは、Red Hat と CentOS のどちらですか？Red Hat のインストールの場合、RPM をダウンロードするには、マシンが Red Hat Network に登録されている必要があります。
2. ローカルマシンに MySQL をインストールする予定はありますか？一部の HA インストールでは、ポータルのウェブページを提供するマシンとは別のマシンに MySQL を配置する必要があります。この場合、MySQL をローカルにインストールしないでください。すべてを同じマシンにインストールする簡単なインストールが必要な場合は、MySQL をローカルにインストールします。
3. リモート MySQL サーバーにアクセスする場合は、リモート MySQL サーバーのホスト名、ポート、データベース名、ユーザー名、パスワード。リモート MySQL サーバーは、インストールを開始する前に構成しておく必要があります。
4. ウェブサーバーの完全修飾ドメイン名は何ですか？（この情報は /etc/hosts に追加されます）。これは、IP アドレスまたはホスト名（portalserver.example.com など）にする必要があります。デフォルト値は localhost です。
5. Apache の仮想ホストに Apigee のデフォルト構成を使用しますか？上記の手順 7 で指定したホスト名で 1 つの仮想ホストが作成されます。
6. ポータルが Apigee Edge 管理サーバーと通信できるようにする情報は 3 つあります。この情報は次のとおりです。
   1. Apigee Management API エンドポイントの URL: ホスト名または IP アドレス。これは、アプリを作成し、アプリキーのデベロッパーを登録するためにすべての呼び出しが行われる REST エンドポイントです。デフォルトのエンドポイントは https://api.enterprise.apigee.com/v1 です。
      
      Edge for Private Cloud のインストールの場合、URL の形式は次のとおりです。
      http://EdgeIp:8080/v1
      
      または
      https://EdgeIp:SSLport/v1
      
      ここで、EdgeIp は Edge Management Server の IP アドレス、SSLport は Edge Management API の SSL ポートです。例: 8443。
   2. Apigee 組織名: ポータルと Apigee Edge 組織の間には関係があります。デフォルトの組織は、Management API エンドポイントを設定するときに設定します。デフォルト値は my-org です。
   3. Management API エンドポイントのユーザー名とパスワード: ポータルから Edge への呼び出しは、組織の管理者によって実行される必要があります。
      
      このユーザー名とパスワードは組織の管理者用であり、ポータルから Edge に接続する場合にのみ使用してください。たとえば、ユーザーの認証情報を指定し、そのユーザーが Edge で削除された場合、ポータルは Edge に接続できなくなります。そのため、この接続専用の管理者を組織に作成します。
      
      例:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd