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

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

Developer Channel Services ポータルをインストールする手順は次のとおりです。

インストールに進む前に、Drupal ウェブルート全体のバックアップを作成してください。 されます。デフォルトのインストール先は /var/www/html ですが、すでに変更されている可能性もあります。 インストール時に発生します。以下のインストール手順を実施したら、 カスタマイズを実行します。

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

http://community.apigee.com/content/apigee-customer-support に移動します。 [Login to your Support Portal] を選択して、 次の 2 つの方法から選択できます

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

で確認できます。

2. システムが要件を満たしていることを確認する 要件

ポータルをインストールする前に、サーバーが次の要件を満たしている必要があります。

1. サポートされている 64 ビット版の Red Hat Enterprise Linux、CentOS、Oracle のいずれか。サポートされているバージョンのリストについては、こちらをご覧ください。
2. Yum がインストールされていることを確認します。
3. （インターネット接続のないサーバーへのインストールの場合）次のことを行う必要があります。 まず、インターネット接続を使用して、必要なすべてのファイルを単一の .tar.gz ファイルです。次に、その .tar.gz ファイルをインターネットに接続していない状態でサーバーにコピーします。 インストールを実行します。
   1. インターネット接続のあるサーバーに root またはスーパーユーザーとしてログインします。
   2. portal_tar などのインストール ファイル用のディレクトリを作成します。
   3. CD を新しいディレクトリに移動して、デベロッパー チャネル サービスの DeveloperServices_x.y.z.tar をダウンロードします。 ここで、x.y.z はポータルのバージョン番号です。
   4. 次のコマンドを使用して、デベロッパー チャネル サービスの .tar ファイルの内容を抽出します コマンド:
      &gt;tar -xvf <tar file&gt;
   5. CD を DeveloperServices-4.x.y.z に保存します。
   6. 次のコマンドを使用して、ポータルの .tar.gz ファイルを作成します。
      &gt; ./non-networked-install.sh
      
      このコマンドは、必要なすべてのファイルとそれらを 1 つの .tar.gz ファイルにダウンロードします。マイページ インターネット接続のないサーバーに tar.gz ファイルをコピーして インストールできます。
4. 次の cURL コマンドを実行して、Edge 管理サーバーへの接続をテストします。 ポータル サーバーのコマンド プロンプトから読み込む場合:
   &gt;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"、
   &quot;displayName&quot;: "cg",
   "環境": [ "test", "prod"],
   「lastModifiedAt」: 1348689232699、
   「lastModifiedBy」: "foo@bar.com",
   "名前": "cg",
   "プロパティ": {
   "property": [ ]
   },
   "種類": "試用"
   }

3. デベロッパーをインストール 自動インストール スクリプトを使用するチャネル サービス

自動インストール スクリプトを使用してポータルをインストールするには、次の手順を行います。この この手順は、外部インターネット接続の有無にかかわらずサーバーで機能します。

1. root またはスーパーユーザーとしてサーバーにログインします。
2. portal などのインストール ファイル用のディレクトリを作成します。
3. インターネットに接続されているサーバーの場合: <ph type="x-smartling-placeholder">
   </ph>
   1. 新しいポータルへの CD デベロッパー チャネル サービスの DeveloperServices_x.y.z.tar をダウンロードします。 ここで、x.y.z はポータルのバージョン番号です。
      
      ファイルは、ブラウザで Apigee から送信されたリンクからダウンロードするか、コピーしてダウンロードできます。 これを次の cURL コマンドに追加します。
      &gt;curl -kOL <リンクを貼り付ける here&gt;
   2. 次のコマンドを使用して、デベロッパー チャネル サービスの .tar ファイルの内容を抽出します コマンド:
      &gt;tar -xvf <tar file&gt;
   3. CD を DeveloperServices-4.x.y.z に保存します。
   4. 次のコマンドを使用してインストール スクリプトを実行します。
      &gt; ./networked-install.sh
4. インターネットに接続していないサーバーの場合: <ph type="x-smartling-placeholder">
   </ph>
   1. 上記のセクション 2 で作成した .tar.gz ファイルをコピーします。システムが次の基準を満たしていることを確認する 説明します。
   2. 次のコマンドを使用して、.tar.gz ファイルの内容を抽出します。
      &gt;tar -xvf <tar file&gt;
   3. tar コマンドで作成されたディレクトリに移動します。
   4. install-from-rpm-bundle.sh スクリプトに権限を設定します。
      &gt;chmod 755 install-from-rpm-bundle.sh
   5. 次のコマンドで install-from-rpm-bundle.sh スクリプトを実行します。 次のコマンドを使用します。
      &gt; ./install-from-rpm-bundle.sh
5. 画面の指示に沿って操作します。
6. インストールが完了したら、ブラウザでサーバーの URL（ 形式:
   http://localhost.特定の IP または DNS を http://IP_address または http://DNS_name に移動します。
   
   Apigee プロファイルの [データベース構成] ページにリダイレクトされます。
   
   注: 通常、ホスト名は設定して登録済みです。 そのため、http://localhost を使用する必要はありません。
7. MySQL への接続を構成します。MySQL がリモートマシン上にある場合は、 [詳細オプション] セクションで、そのマシンへの接続情報を入力します。 [保存して次へ] を選択します。
8. 次の情報を入力して Apigee エンドポイントへの接続を構成します。 [保存] を選択します。
   これらの値の詳細については、「インストールを開始する前に必要な情報」をご覧ください。 デベロッパー サービス ポータルで 提供します。
   1. デベロッパー ポータルの組織
   2. デベロッパー ポータルのエンドポイント URL
   3. エンドポイント認証ユーザー
   4. Authenticated Users'パスワード
9. プロンプトが表示されたら、[Install Sample SmartDocs WADL] ボタンを選択してインストールします。 サンプルの SmartDocs WADL を使用します。この手順をスキップすると、SmartDocs API の例で 表示されます。
   注: ポータルが Apigee Edge for Private のインストールに接続している場合 外部インターネット接続がない Edge のインストールでは、Cloud Logging で SmartDocs モジュールの追加の構成を定義する必要があります。詳細 SmartDocs については、http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis をご覧ください。
10. SMTP サーバーの設定を構成します。Apigee では、Kubernetes サービス ポータルからメール メッセージを送信する SMTP サーバー。
    詳細については、http://apigee.com/docs/developer-services/content/configuring-email をご覧ください。
11. 次の情報を入力して管理者ユーザーを設定し、[ 保存します。Drupal では「admin」という名前の管理者ユーザーが作成されます。使用できます。「admin」は 表示されます。
    この手順をスキップしても、以下で説明するように、Drush を使用して管理者を作成できます 4 で管理者ユーザーを作成します。
    1. デベロッパーの氏名
    2. デベロッパーのポータルのユーザー名
    3. パスワード
    4. メールアドレス
12. インストールが完了したら、settings.php ファイルで権限を設定します。
    &gt;chmod 640 /var/www/html/sites/default/settings.php
13. ポータルのホームページ（http://localhost/）または DNS 名に移動します。 必要があります。
14. 管理者の認証情報を使用してポータルにログインします。

4. 管理者ユーザーを作成する

Drush を使用して、Developer Channel Services インストール用の管理ユーザーを作成します。 Drupal では、「admin」という名前の管理者ユーザーが自動的に作成されます。使用できます。「admin」はとして 表示されます。

1. CD から drupal_root/sites/default ディレクトリに移動します。Drupal ルートの標準的な場所 ディレクトリは /var/www/html:
   &gt;cd &lt;drupal_root&gt;/sites/default
2. 非公開の Drupal ファイルに対する書き込み権限があることを確認します。
   &gt;Drush vget file_private_path
   
   このコマンドは、非公開 Drupal ファイルのパスを返します。次に例を示します。
   file_private_path: 「sites/default/private」
   
   /var/www/html/sites/default/private/ に対応します。このコマンドを使用して、Cloud Shell に このディレクトリは、オーナーとグループによって書き込み可能です。
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. 次のコマンドを入力して管理者ユーザーを作成します。「< >」次の値に置き換えます。
   &gt;drush ユーザー作成 <ユーザー名>--mail=&quot;&lt;email-address&gt;&quot;--password=&quot;&lt;password&gt;&quot;
   &gt;drush user-add-role 管理者 <ユーザー名>
4. 指定されたユーザー名とパスワードを使用して、デベロッパー ポータルに管理者としてログインします。 ご覧ください。

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

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

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

> mysqladmin -u root password NEWPASSWORD

すでに設定済みの root パスワードを変更する場合は、以下を使用します。 command:

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

/var/www/html/sites/default/settings.php でパスワードも更新する必要があります。 表示されます。

6. アップデート マネージャー モジュールが 有効

Drupal の更新通知を受け取るには、Drupal Update Manager モジュールが 有効にします。Drupal メニューで [Modules] を選択し、 アップデート マネージャー モジュール。有効になっていない場合は有効にします。

有効にすると、[レポート] >使用可能 [更新] メニュー項目を選択します。次の Drush コマンドを使用することもできます。

> drush pm-info update

[レポート >利用可能なアップデート >[Settings] メニュー項目で設定します。 アップデートが利用可能になったときにメール通知を受け取れます。また、アップデートの あります。

7. 省略可 - 本番環境へのデプロイ サーバー

ポータルを本番環境サーバーにデプロイする場合は、追加のセキュリティ 手順について説明します。

1. 次のスクリプトを実行して、MySQL インストールを保護します。
   &gt; /usr/bin/mysql_secure_installation
   
   このスクリプトは root パスワードを設定し、root アクセスを デフォルトで作成されたテスト データベースと匿名ユーザーを削除します。この スクリプトを強くおすすめします。
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. 省略可 - 以下をサポートする mod_ssl をインストールします。 HTTPS

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 を文書化して、 完全にインタラクティブな 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 ドキュメントへのリンクも記載されています。

タスク	説明
カスタム ディメンションを テーマ	テーマによって、色、スタイル、その他の形式など、ポータルの外観が サポートします。
外観	ホームページには、メインメニュー、ウェルカム メッセージ、ヘッダー、フッター、タイトルが含まれます。
ユーザー アカウントの管理	登録プロセスでは、新しいデベロッパーが 登録できますたとえば、新しい開発者がポータルに即座にアクセスできるようにするか、 管理者が確認する必要があります。また、このプロセスでは、 新しいアカウントが作成されると管理者に通知されます。
構成 メールアドレス	特定のイベントが発生すると、ポータルからメールが送信されます。たとえば、 デベロッパーがポータルに登録し、デベロッパーがパスワードを紛失したとき。
ユーザー アカウントの管理	キーワードを追加してデベロッパーが許可する前に同意する必要がある [Conditions] ページ 登録する必要があります
ユーザー アカウントの管理	ポータルには、ロールベースの認可モデルが実装されています。開発者が ポータルで使用する権限とロールを定義します。
ブログと フォーラムの投稿	ポータルには、ブログとスレッド形式のフォーラムに対するサポートが組み込まれています。権限を定義する ブログとフォーラムの投稿を表示、追加、編集、削除するために必要な権限です。
データベースのバックアップを行ってください。	Drupal データベースをバックアップしていることを確認します。なお、 バックアップとバックアップはそれぞれ異なるため、 データベースです
ホスト名を設定する	DNS サーバーにホスト名を設定していない場合は、 サーバーの IP アドレスです。ホスト名を使用する場合は、 基本設定で、他の構成がなくても正常に動作するはずです。 ロードバランサを設定している場合や、サイトの一部で正しくない URL を取得している場合 それ以外の理由については、デベロッパー ポータルの settings.php ファイルで $base_url を デフォルトでは /var/www/html/sites/default にあります。 されます。