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

デベロッパー サービス ポータル 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 Server をデベロッパー チャネル サービス（シングルマシン トポロジ）と同じマシンにインストールする場合、デベロッパー チャネル サービス インストーラはデータベース名とデータベース ユーザーを入力し、MySQL Server をインストールしてデータベース スキーマを作成します。インストールされているバージョンが、OS で利用可能な最新バージョンである。

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

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

データベース ユーザーは、デベロッパー チャネル サービスによってデータベースに接続する際に使用され、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' verified by 'devportal';
    mysql> すべての権限を *.* に 'devportal'@'localhost'; に付与します。
    mysql> flush 特権;
    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 Server をローカルにインストールしないように指定します。リモート データベースの 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 アクセス権が必要です。

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

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

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

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

  1. 構成しようとしているプラットフォームは、Red Hat と CentOS のどちらですか？Red Hat のインストールを行う場合、RPM をダウンロードするには、マシンを Red Hat ネットワークに登録する必要があります。
  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 管理サーバーの IP アドレス、EdgeIp は Edge API ポートの SSL.port です。例: 8443。
    2. Apigee 組織名: ポータルと Apigee Edge 組織の間には関係があります。Management API エンドポイントを設定する際に、デフォルトの組織を設定します。デフォルト値は my-org です。
    3. Management API エンドポイントのユーザー名とパスワード: ポータルから Edge への呼び出しは、組織の管理者が行う必要があります。

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

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