新しい Edge UI をインストールする

このドキュメントでは、Apigee Edge for Private Cloud 用の Edge UI をインストールする方法について説明します。Edge UI は次世代の Edge UI です。

Prerequisites

Apigee Edge for Private Cloud インストール環境で新しい Edge UI を試すには、次のことを行う必要があります。

  • Edge UI を専用のノードにインストールします。他の Edge コンポーネントを含むノード(既存の Classic UI が存在するノードを含む)にはインストールできません。この操作を行うと、Classic UI にログインできなくなります。

    Edge UI のノードは次の要件を満たす必要があります。

    • Java 1.8
    • 4 GB の RAM
    • 2 コア
    • 60 GB のディスク容量
    • 最初に、Edge apigee-setup ユーティリティのインストールの説明に従って apigee-setup ユーティリティのバージョン 4.50.00 をノードにインストールする必要があります。
    • ポート 3001 が開いている必要があります。これは、Edge UI へのリクエストに使用されるデフォルトのポートです。新しい UE 構成ファイルで説明されているプロパティを使用してポートを変更する場合は、ポートが開いていることを確認してください。
  • Edge で外部 IDP を有効にします。Edge UI は、認証メカニズムとして SAML または LDAP をサポートしています。
  • (SAML IDP のみ)Edge UI は TLS v1.2 のみをサポートします。SAML IDP には TLS で接続します。したがって、SAML を使用する場合は、ご利用の IDP が TLS v1.2 をサポートしている必要があります。

Edge UI の詳細については、Private Cloud 用の新しい Edge UI をご覧ください。

インストールの概要

Apigee Edge for Private Cloud の Edge UI をインストールするプロセスの概要は次のとおりです。

  • クラスタに新しいノードを追加する
  • 新しいノードにログインする
  • apigee-setup ユーティリティをダウンロードする
  • 構成ファイルを作成し、自分の設定で修正する
  • apigee-setup ユーティリティを実行する
  • 新しい UE にログインしてテストする

新しいノードで実行すると、apigee-setup ユーティリティは次のことを行います。

  • shoehorn という名前のベース Classic UI をインストールし、外部 IDP を使用して Edge の認証を行うように Classic UI を構成します。
  • 新しい Edge UI をインストールし、外部 IDP を使用して Edge で認証を行うように Edge UI を構成します。

新しい Edge UI をインストールする前の考慮事項

前提条件で説明したように、Edge UI では Edge で外部 IDP を有効にする必要があります。つまり、ユーザー認証は IdP によって制御され、ユーザー ID としてメールアドレスを使用するように構成します。したがって、すべての Edge UI ユーザーを IDP に登録する必要があります。

Apigee Edge for Private Cloud でインストールしたデフォルトの UI である Classic UI では、外部 IDP は必要ありません。IDP または Basic 認証を使用できます。つまり、次のいずれかを行います。

  • Edge で外部 IDP のサポートを有効にし、Classic UI と Edge UI の両方で外部 IDP のサポートを有効にする。

    このシナリオでは、すべての Classic UI ユーザーと Edge UI ユーザーが IDP に登録されます。IDP への新しいユーザーの追加方法については、新しい Edge ユーザーを登録するをご覧ください。

  • Edge で外部 IDP のサポートを有効にするが、Basic 認証は有効のままにする。Edge UI は IDP を使用し、Classic UI は引き続き Basic 認証を使用します。

    このシナリオでは、すべての Classic UI ユーザーが Basic 認証情報を使用してログインし、認証情報が Edge OpenLDAP データベースに保存されます。Edge UI ユーザーは IDP に登録され、SAML または LDAP を使用してログインします。

    ただし、Classic UI ユーザーは、新しい Edge ユーザーを登録するの説明に従って IDP に追加されない限り、Edge UI にはログインできません。

以前のリリースからのインストール構成の変更点

Edge UI のベータ版リリースからインストール手順に次の変更点があります。

新しい Edge UI 構成ファイル

次の構成ファイルには、新しい Edge UI をインストールして構成するために必要なすべての情報が含まれています。同じ構成ファイルを使用して、shoehorn/Classic UI と Edge UI の両方をインストールして構成できます。

# IP of the Edge Management Server.
# This node also hosts the Apigee SSO module and the current, or Classic, UI.
IP1=management_server_IP

# IP of the Edge UI node.
IP2=edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# Edge UI configuration.
#

# Enable the Edge UI.
EDGEUI_ENABLE_UNIFIED_UI=y
# Specify IP and port for the Edge UI.
# The management UI port must be open for requests to the Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
# Set to 'OPDK' to specify a Private Cloud deployment.
MANAGEMENT_UI_APP_ENV=OPDK
# Disable TLS on the Edge UI.
MANAGEMENT_UI_SCHEME=http

# Location of Edge UI.
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=YOUR_CSRF_SECRET
# Duration of CSRF token.
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
# Defaults to 8760 hours, or 365 days.
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=8760

## SSO configuration for the Edge UI.
MANAGEMENT_UI_SSO_ENABLED=y

# Only required if MANAGEMENT_UI_SSO_ENABLED is 'y'
MANAGEMENT_UI_SSO_CLIENT_OVERWRITE=y

MANAGEMENT_UI_SSO_CLIENT_ID=newueclient
MANAGEMENT_UI_SSO_CLIENT_SECRET=your_client_sso_secret

#
# Shoehorn UI configuration
#
# Set to http even if you enable TLS on the Edge UI.
SHOEHORN_SCHEME=http
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000

#
# Edge Classic UI configuration.
# Some settings are for the Classic UI, but are still required to configure the Edge UI.
#

# These settings assume that Classic UI is installed on the Management Server.
CLASSIC_UI_IP=$MSIP
CLASSIC_UI_PORT=9000
CLASSIC_UI_SCHEME=http
EDGEUI_PUBLIC_URIS=$CLASSIC_UI_SCHEME://$CLASSIC_UI_IP:$CLASSIC_UI_PORT

# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

# Enable SSO
EDGEUI_SSO_ENABLED=y

# The name of the OAuth client used to connect to apigee-sso.
# The default client name is 'edgeui'.
# Apigee recommends that you use the same settings as you used
# when enabling your IDP on the Classic UI.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars.
EDGEUI_SSO_CLIENT_SECRET=ssoClient123
# If set, existing EDGEUI client will deleted and new one will be created.
EDGEUI_SSO_CLIENT_OVERWRITE=y

# Apigee SSO Component configuration
# Externally accessible IP or DNS of Edge SSO module.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on the Apigee SSO module.
# If Apigee SSO uses a self-signed cert, you must also set MANAGEMENT_UI_SKIP_VERIFY to "y".
SSO_PUBLIC_URL_SCHEME=http
# MANAGEMENT_UI_SKIP_VERIFY=y
# SSO admin credentials as set when you installed Apigee SSO module.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=your_sso_admin_secret

#
##      SSO Configuration (define external IDP)           #
#
# Use one of the following configuration blocks to        #
# define your IDP settings:                               #
#  - SAML configuration properties                        #
#  - LDAP Direct Binding configuration properties         #
#  - LDAP Indirect Binding configuration properties       #

INSERT_IDP_CONFIG_BLOCK_HERE (SAML, LDAP direct, or LDAP indirect)

## SMTP Configuration (required)
#
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company myco@company.com"

Edge UI のインストール

構成ファイルを作成して変更したら、新しいノードに新しい Edge UI をインストールできます。

Edge UI をインストールするには:

  1. 新しいノードをクラスタに追加します。
  2. 新しいノードに管理者としてログインします。
  3. Edge apigee-setup ユーティリティのインストールの説明に従って、apigee-setup ユーティリティのバージョン 4.50.00 をノードにインストールします。
  4. 次のコマンドを実行して、Yum にキャッシュされているすべての情報を消去します。
    sudo yum clean all
  5. 新しい Edge UI 構成ファイルの説明に従って構成ファイルを作成し、ファイルの所有者を「apigee」ユーザーにします。
    chown apigee:apigee configFile

    構成ファイルに次の変更を加えます。

    • 構成ファイルの MANAGEMENT_UI_SSO_CSRF_SECRET プロパティの値を CSRF Secret に変更します。
    • 次のいずれかを使用するように Edge を構成します(新しい Edge UI には外部 IDP が必要です)。
      • SAML
      • LDAP

      詳細については、外部 IDP 認証の概要をご覧ください。

  6. Edge UI へのアクセス権を与えるユーザーを外部 IDP で構成します。詳細については、新しい Edge ユーザーを登録するをご覧ください。
  7. 新しいノードで、次のコマンドを実行します。
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    apigee-setup ユーティリティが Classic UI をインストールします。次に、Classic UI の上に Edge UI をインストールします。

  8. ブラウザで次の URL を開いて Edge UI にログインします。
    http://new_edge_UI_IP:3001

    ここで、new_edge_UI_IP は新しい Edge UI をホストしているノードの IP アドレスです。

    外部 IDP の認証情報を入力するよう求められます。

  9. 認証情報を入力します。

    新しい Edge UI が表示されます。Edge UI の使用方法については、Private Cloud 用の新しい Edge UI をご覧ください。

    Edge UI が表示されない場合は、ポート 3001 が外部接続用に開いていることを確認します。

新しい UI をアンインストールする

新しい UI をそのノードからアンインストールするには、新しい Edge UI と、UI インストール プロセス中にノードにインストールされた基本 Classic UI(shoehorn)の両方をアンインストールする必要があります。

新しい Edge UI をアンインストールするには:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall

従来の Classic UI(shoehorn)をアンインストールするには:

/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

すべての Edge コンポーネントをノードから削除するには:

  1. マシンで実行されているすべての Edge サービスを停止します。
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Yum キャッシュを削除します。
    sudo yum clean all
  3. Apigee RPM をすべて削除します。
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. インストール ルート ディレクトリ
    sudo rm -rf /opt/apigee
    を削除します。