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

デベロッパー サービス ポータル v. 4.16.09

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

ハードウェア

要件

オペレーティング システム

以下のインストール手順と提供されているインストール ファイルは、https://apigee.com/docs/api-services/reference/supported-software に記載されているオペレーティング システムでテストされています。

RAM

1 GB

ハードディスク

10 GB

ネットワーク インターフェース

アクティブなインターネット接続が必要です。

インストール プロセスの一環として、インストーラがウェブからリソースをダウンロードします。ご使用の環境が送信 HTTP / HTTPS リクエストをプロキシするように設定されている場合は、ダウンロードの際にリクエストがリダイレクトされた場合に備え、リダイレクトされたリクエストを正しく処理するようにプロキシを構成する必要があります。

たとえば、https://drupal.org/ に対するリクエストは HTTP 301 ステータス コードを返し、https://www.drupal.org/ にリダイレクトします。

リダイレクトからリクエストされたコンテンツとともに HTTP 200 ステータス コードを返すようにプロキシを構成する必要があります。

SAP インストールについては、ご使用の環境が送信 HTTPS リクエストをプロキシするように設定されている場合、プロキシが TLSv1.0 をサポートしていなければなりません。OpenSSL 0.9.8 では TLSv1.1 および TLSv1.2 をサポートしていません。サポートしているのは TLSv1.0 のみです。

MySQL データベースの要件

MySQL サーバーを Developer Channel Services と同じマシン（単一マシン トポロジ）にインストールする場合、Developer Channel Services インストーラからデータベース名とデータベース ユーザーの入力を求められます。入力すると、MySQL サーバーがインストールされ、データベース スキーマが作成されます。インストールされているバージョンが、お使いの OS で利用可能な最新バージョンである。

MySQL サーバーを別のシステムにインストールする場合は、Developer Channel Services インストーラを開始する前に、そのシステムに MySQL サーバーをインストールしておく必要があります。MySQL 5.0.15 以降がインストールされている必要があります。

デベロッパー チャネル サービス インストーラを使用するには、MySQL サーバーに空のデータベース スキーマを持つデータベースが必要です。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 プロバイダに確認してください。

その他の要件

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

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

デベロッパー チャネル サービスでは、REST API を介して Apigee Management Server とのインターフェースを 1 つに絞り、ユーザーのアプリケーションに関する情報を格納および取得します。デベロッパー チャネル サービスは、インストールに応じて、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 Management Server と通信するには、3 つの情報が必要となります。この情報は以下のとおりです。
    1. Apigee Management API エンドポイントの URL: ホスト名または IP アドレスのいずれかです。アプリを作成したり、アプリキーのデベロッパーを登録したりするための呼び出しはすべて、この REST エンドポイントに対して行われます。デフォルトのエンドポイントは https://api.enterprise.apigee.com/v1 です。

      プライベート クラウド用 Edge のインストールの場合、URL は次の形式になります。
      http://EdgeIp:8080/v1

      または:
      https://EdgeIp:SSLport/v1

      ここで、EdgeIp は Edge Management Server の IP アドレス、SSLport は Edge Management API の SSL ポートです。例: 8443。
    2. Apigee 組織名: ポータルと Apigee Edge 組織には関係があります。管理 API エンドポイントを設定する際に、デフォルトの組織を設定します。デフォルト値は my-org です。
    3. Management API エンドポイントのユーザー名とパスワード: ポータルから Edge への呼び出しは、組織の管理者が実行する必要があります。

      このユーザー名/パスワードは組織の管理者用であるため、ポータルから Edge に接続する場合にのみ使用するようにしてください。たとえば、ユーザーの認証情報を指定した場合、そのユーザーが Edge で削除されると、ポータルは Edge に接続できなくなります。したがって、この接続専用の管理者を組織に作成します。

      例:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd