Developer Services ポータルのインストール

Developer Services Portal v. 4.16.09

インストールする前に、次のことを確認してください。

• サポートされているバージョンの Red Hat Enterprise Linux、CentOS、または Oracle の 64 ビット版にインストールしている。サポートされているバージョンのリストはこちらでご確認ください。
• Yum がインストールされている。
• 既存のインストールをバックアップします。Drupal コアまたはカスタム以外のモジュールのコードを変更した場合、変更は上書きされます。これには、.htaccess に加えた変更などが含まれます。/sites ディレクトリ外のものはすべて Drupal が所有していると想定する必要があります。このルールの例外は robots.txt です。このファイルがウェブルートに存在する場合は、保持されます。インストールを続行する前に、Drupal のウェブルート ディレクトリ全体のバックアップを作成します。デフォルトのインストール場所は /var/www/html ですが、インストール時に変更されている可能性があります。以下で説明するインストール手順を完了したら、バックアップからカスタマイズを復元できます。

デベロッパー チャネル サービス ポータルをインストールする手順は次のとおりです。

1. デベロッパー チャネル サービス バンドルを入手する

http://community.apigee.com/content/apigee-customer-support にアクセスし、[Login to your Support Portal] を選択して、次のいずれかの方法で Developer Channel Services の .tar ファイルをリクエストします。

• Edge for Private Cloud のダウンロード ディレクトリへのアクセスをリクエストします。
• デベロッパー チャネル サービスの .tar ファイルの URL をリクエストします。

2. Apigee Edge への接続をテストする

ポータル サーバーのコマンド プロンプトから次の cURL コマンドを実行して、Edge Management Server への接続をテストします。
> curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

ここで、EMAIL と PASSWORD は、ORGNAME の管理者のメールアドレスとパスワードです。

Edge のインストールに固有のホスト名とポート番号を指定してください。ポート 8080 は、Edge で使用されるデフォルトのポートです。クラウド上の組織に接続する場合、リクエスト URL は次のようになります: https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

成功した場合、このコマンドは次のような応答を返します:
{
"createdAt" : 1348689232699,
"createdBy" : "USERNAME",
"displayName" : "cg",
"environments" : [ "test", "prod" ],
"lastModifiedAt" : 1348689232699,
"lastModifiedBy" : "foo@bar.com",
"name" : "cg",
"properties" : {
"property" : [ ]
},
"type" : "trial"
}

3. 7.0 より前のバージョンの PHP を削除する

インストール スクリプトは、インストールを開始する前に、システムに 7.0 より前のバージョンの PHP がインストールされているかどうかを確認します。7.0 より前のバージョンの PHP が存在する場合は、次の警告メッセージが表示されます。

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.
php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

CentOS と Red Hat Enterprise Linux（RHEL）の場合は、次のコマンドを使用して PHP パッケージを削除します。

yum remove <package-name>

4. 自動インストール スクリプトを使用して Developer Channel Services をインストールする

インターネット接続のあるサーバーにインストールするか、インターネット接続のないサーバーにインストールするかに応じて、次のいずれかの手順でポータルをインストールします。

インターネット接続があるサーバーで、次の操作を行います。

インターネット接続があるサーバーにデベロッパー チャネル サービスをインストールするには:

1. root またはスーパーユーザーとしてサーバーにログインします。
2. インストール ファイル用のディレクトリ（portal など）を作成します。
3. 新しい portal ディレクトリに移動し、Developer Channel Services の DeveloperServices_x.y.z.tar ファイルをダウンロードします。ここで、x.y.z はポータルのバージョン番号に対応します。
   
   Apigee から送信されたリンクからファイルをダウンロードするには、ブラウザでリンクを開くか、リンクをコピーして次の cURL コマンドに追加します。
   > curl -kOL <ここにリンクを貼り付け>
4. 次のコマンドを使用して、Developer Channel Services の .tar ファイルの内容を抽出します。
   > tar -xvf <tar file>
5. DeveloperServices-4.x.y.z に移動します。
6. 次のコマンドを使用してインストール スクリプトを実行します。
   > ./networked-install.sh
7. プロンプトに応答します。

インターネットに接続されていないサーバーの場合:

まず、インターネット接続があるシステムで、ネットワークに接続されていないインストール スクリプトを作成します。

1. インターネットに接続されているシステムに root またはスーパーユーザーとしてログインします。
2. インストール ファイル用のディレクトリ（portal_tar など）を作成します。
3. portal_tar ディレクトリに移動し、Developer Channel Services の DeveloperServices_x.y.z.tar ファイルをダウンロードします。ここで、x.y.z はポータルのバージョン番号に対応します。
4. 次のコマンドを使用して、Developer Channel Services の .tar ファイルの内容を抽出します。
   > tar -xvf <tar file>
5. DeveloperServices-4.x.y.z に移動します。
6. 次のコマンドを使用して、ポータルの .tar.gz ファイルを作成します。
   > ./non-networked-install.sh

ネットワークに接続されていないインストール用の新しい .tar.gz ファイルが作成されます。

1. root またはスーパーユーザーとしてサーバーにログインします。
2. インストール ファイル用のディレクトリ（portal など）を作成します。
3. portal ディレクトリに移動します。
4. （上記の手順で）ネットワークに接続されていないインストール用に作成した .tar.gz ファイルを portal ディレクトリにコピーします。
5. 次のコマンドを使用して、.tar.gz ファイルの内容を抽出します。
   > tar -xvf <tar file>
6. tar コマンドで作成されたディレクトリに移動します。
7. install-from-rpm-bundle.sh スクリプトの権限を設定します。
   > chmod 755 install-from-rpm-bundle.sh
8. 次のコマンドを使用して、install-from-rpm-bundle.sh スクリプトを実行します。
   > ./install-from-rpm-bundle.sh
9. プロンプトに応答します。

5. デベロッパー ポータルを構成する

ポータル構成の多くは、Drupal モジュールのインストールやデフォルトのコンテンツ作成など、ユーザーの操作を必要とせずに行われます。データベースの設定、Edge エンドポイントの構成、新しい管理者ユーザーの作成を求めるメッセージが表示されます。

デベロッパー ポータルを構成するには:

1. ブラウザでサーバーの URL（
   http://localhost など）に移動します。特定の IP または DNS が構成されている場合は、http://IP_address または http://DNS_name にアクセスします。
   
   Apigee プロファイルのデータベース構成ページにリダイレクトされます。
   
   注: 通常は、ホスト名をすでに構成して DNS サーバーに登録しているため、http://localhost を使用する必要はありません。
2. データベースへの接続を構成します。データベースがリモートマシン上にある場合は、[詳細オプション] セクションを開いて、そのマシンへの接続情報を入力し、[保存して続行] を選択します。
3. 次の情報を入力して Apigee エンドポイントへの接続を構成し、[保存] を選択します。
   これらの値の詳細については、Developer Services ポータルの要件の「インストールを開始する前に必要な情報」をご覧ください。
   1. Management API Org
   2. Management API エンドポイント URL
   3. エンドポイント認証済みユーザー
   4. 認証済みユーザーのパスワード
4. 次の情報を入力して管理者ユーザーを構成し、[Save] を選択します。Drupal では、デフォルトで「admin」という名前の管理者ユーザーが作成されるため、ユーザー名として「admin」を使用しないでください。
   この手順をスキップしても、Drush を使用して管理者を作成できます。これについては、以下の 4 で説明します。管理者ユーザーを作成します。
   1. デベロッパーの氏名
   2. デベロッパー ポータルのユーザー名
   3. パスワード
   4. メールアドレス
5. インストールが完了したら、settings.php ファイルに権限を設定します。
   > chmod 640 /var/www/html/sites/default/settings.php
6. http://localhost/ のポータルのホームページ、またはポータルの DNS 名に移動します。
7. 管理者認証情報を使用してポータルにログインします。

6. 管理者ユーザーを作成する（省略可）

Drush を使用して、デベロッパー チャネル サービスのインストール用の管理者権限を持つユーザーを作成します。Drupal では、デフォルトで「admin」という名前の管理者ユーザーが自動的に作成されるため、ユーザー名として「admin」を使用しないでください。

1. drupal_root/sites/default ディレクトリに移動します。Drupal ルート ディレクトリの標準の場所は /var/www/html です。
   > cd <drupal_root>/sites/default
2. Drupal のプライベート ファイルに対する書き込み権限があることを確認します。
   > drush vget file_private_path
   
   このコマンドは、Drupal のプライベート ファイルへのパスを返します。例:
   file_private_path: 'sites/default/private'
   
   /var/www/html/sites/default/private/ に対応します。次のコマンドを使用して、このディレクトリがオーナーとグループによって書き込み可能であることを確認します。
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. 次のコマンドを入力して、管理者ユーザーを作成します。< > 内のコマンドは、実際の値に置き換えます。
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. 上記で指定したユーザー名とパスワードを使用して、管理者としてデベロッパー ポータルにログインします。

5. MySQL の root パスワードを設定する

ポータルのインストールの一部として MySQL をインストールした場合、インストール スクリプトは MySQL の root パスワードをデフォルト値（空白）のままにします。

次のコマンドを使用して、root パスワードを設定します。

> mysqladmin -u root password NEWPASSWORD

以前に root パスワードを設定していて、それを変更する場合は、次のコマンドを使用します。

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

/var/www/html/sites/default/settings.php ファイルのパスワードも更新する必要があります。

6. Update Manager モジュールが有効になっていることを確認する

Drupal の更新に関する通知を受け取るには、Drupal Update Manager モジュールが有効になっていることを確認してください。Drupal メニューから [Modules] を選択し、[Update manager] モジュールまで下にスクロールします。有効になっていない場合は、有効にします。

有効にすると、[レポート] > [利用可能なアップデート] メニュー項目を使用して、利用可能なアップデートを確認できます。次の Drush コマンドを使用することもできます。

> drush pm-info update

[Reports] > [Available Updates] > [Settings] メニュー項目を使用して、アップデートが利用可能になったときにメールを送信するようにモジュールを構成し、アップデートの確認頻度を設定します。

7. 本番環境サーバーにデプロイする（省略可）

本番環境サーバーにポータルをデプロイする場合は、次のような追加のセキュリティ手順を実行する必要があります。

1. 次のスクリプトを実行して、MySQL のインストールを保護します。
   > /usr/bin/mysql_secure_installation
   
   このスクリプトは、root パスワードを設定し、root アクセスを localhost のみに制限するオプションを提供します。また、デフォルトで作成されたテスト データベースと匿名ユーザーを削除するオプションも提供します。本番環境サーバーでは、このスクリプトを実行することを強くおすすめします。
2. 企業ポリシーで必要な場合は、SELinux を有効にして構成します。

8. Apache Solr 検索エンジンを構成する（省略可）

デフォルトでは、ポータルをインストールすると、Apache Solr 検索エンジンに接続する Drupal モジュールが無効になります。ほとんどのポータルは内部の Drupal 検索エンジンを使用するため、Drupal Solr モジュールは必要ありません。

Solr を検索エンジンとして使用する場合は、サーバーに Solr をローカルにインストールしてから、ポータルで Drupal Solr モジュールを有効にして構成する必要があります。

Drupal Solr モジュールを有効にするには:

1. 管理者権限またはコンテンツ作成権限を持つユーザーとしてポータルにログインします。
2. Drupal メニューで [Modules] を選択します。
3. Apache Solr Framework モジュールと Apache Solr Search モジュールを有効にします。
4. 変更を保存します。
5. https://drupal.org/node/1999280 の説明に従って Solr を構成します。

9. HTTPS をサポートするために mod_ssl をインストールする（省略可）

mod_ssl モジュールは、Apache HTTP サーバーが HTTPS 経由でウェブページを配信するために使用されます。HTTPS を使用する場合は、次のコマンドを使用して mod_ssl をインストールします。

> yum install mod_ssl

SSL を使用するようにポータルを構成する方法については、http://apigee.com/docs/developer-services/content/using-ssl-portal をご覧ください。

10. SmartDocs をインストールする（省略可）

SmartDocs を使用すると、Developer Services ポータルで API ドキュメントを完全な対話型のドキュメントにすることができます。ただし、ポータルで SmartDocs を使用するには、まず Edge に SmartDocs をインストールする必要があります。

• ポータルを Edge Cloud インストールに接続する場合、SmartDocs はすでにインストールされているため、追加の構成は必要ありません。
• ポータルを Edge for Private Cloud のインストールに接続する場合は、SmartDocs が Edge にインストールされていることを確認する必要があります。Edge と SmartDocs のインストールの詳細については、SmartDocs をインストールするをご覧ください。

SmartDocs の詳細については、SmartDocs を使用した API のドキュメント化をご覧ください。

11. 次のステップ

Developer Services ポータルをインストールしたら、特定の要件に合わせて構成とカスタマイズを行います。Apigee ウェブサイトのドキュメントには、ポータルの構成、スタイル設定、管理に関するすべての情報が記載されています。ドキュメント（http://apigee.com/docs/developer-services/content/what-developer-portal）にアクセスします。

次の表に、インストール後に実行する最も一般的なタスクの一部を示します。また、詳細を確認できる Apigee ドキュメントへのリンクも記載しています。