ノードに Edge コンポーネントをインストールする

Edge for Private Cloud v. 4.17.01

Edge apigee-setup ユーティリティをノードにインストールしたら、 インストールする apigee-setup ユーティリティ ノード上にある 1 つ以上の Edge コンポーネントです。

apigee-setup ユーティリティは、次の形式のコマンドを使用します。

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

ここで、component はインストールする Edge コンポーネントです。 configFile は、インストールを含むサイレント構成ファイルです。 情報です。構成ファイルは、「apigee」からアクセス可能または読み取り可能である必要があります。できます。対象 たとえば、ファイル用の新しいディレクトリを作成し、/usr/local または /usr/local/share ディレクトリ、または「apigee」からアクセス可能なノード上の他の場所 できます。

たとえば、Edge Management Server をインストールするには、次のようにします。

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

インストールに関する考慮事項

構成ファイルを作成する際には、次のオプションを考慮してください。

Postgres の設定 マスター / スタンバイ レプリケーション

デフォルトでは、すべての Postgres ノードがマスターモードでインストールされます。しかし本番環境システムでは 場合は、マスター / スタンバイ レプリケーションを使用するように構成し、 マスターノードに障害が発生しても、スタンバイ ノードは引き続きトラフィックを処理できます。

次のプロパティを使用して、インストール時にマスター / スタンバイ レプリケーションを有効にして構成できます。 属性を宣言します。または、インストール後にマスター / スタンバイ レプリケーションを有効にすることもできます。対象 詳しくは、マスター / スタンバイを設定する Postgres のレプリケーションをご覧ください。

Cassandra の有効化 認証

デフォルトでは、Cassandra は認証を有効にせずにインストールされます。つまり、誰でもアクセスでき CassandraEdge のインストール後に、またはインストールの一環として認証を有効にできます。 プロセスです

詳細については、Cassandra を有効にする 認証をご覧ください。

保護された ポートを使用して

Router をポートなどの保護されたポートにバインドする仮想ホストを作成する場合 1000 未満の数字のみを提供する場合は、ルーターを ポートを 2 つ以上作成しますデフォルトでは、Router はユーザー「apigee」として実行されます。Compute Engine インスタンスに 許可します。

1000 未満のポートにアクセスするように仮想ホストと Router を構成する方法については、 仮想ホストの設定をご覧ください。

インストールするコンポーネントの指定

次の表に、apigee-service ユーティリティの -p オプションに渡すオプションを示します。 ノードにインストールするコンポーネントを指定します。

コンポーネント

説明

c

Cassandra のみをインストールします。
ZK ZooKeeper のみをインストールします。

ds

ZooKeeper と Cassandra をインストールします。

ld

OpenLDAP のみをインストールします。

ミリ秒

Edge Management Server をインストールします。これにより、Edge UI と OpenLDAP もインストールされます。

設定で USE_LDAP_REMOTE_HOST=y を設定した場合 OpenLDAP のインストールはスキップされ、Management Server では OpenLDAP を使用します。 別のノードにインストールされています。

r

Edge Router のみをインストールします。

MP

Edge Message Processor のみをインストールします。

rmp

Edge Router と Message Processor をインストールします。

ui

Edge UI をインストールします。

qs

Qpid Server のみをインストールします。

ps

Postgres Server のみをインストールします。
pdb Postgres データベースのみをインストール - Developer Services をインストールするときにのみ使用 登録できますDeveloper Services ポータルを参照 インストールをご覧ください。

サックス

分析コンポーネント、つまり Qpid と Postgres をインストールします。

このオプションは開発とテストでのみ使用し、本番環境には使用しないでください。

月額

Monetization をインストールします。

sa

Edge スタンドアロン、つまり Cassandra、ZooKeeper、Management Server、OpenLDAP、 Edge UI、Router、Message Processor です。このオプションでは、Edge 分析コンポーネントが省略されます。 Qpid と Postgres です。

このオプションは開発とテストでのみ使用し、本番環境には使用しないでください。

Aio

すべてのコンポーネントを単一のノードにインストールします。

このオプションは開発とテストでのみ使用し、本番環境には使用しないでください。
dp

Developer Services ポータルをインストールします。

構成ファイルの作成

構成ファイルには、Edge のインストールに必要なすべての情報が含まれています。多くの場合、 同じ構成ファイルを使用して、Edge インストールのすべてのコンポーネントをインストールします。

ただし、別の構成ファイルを使用するか、構成を変更する必要があります。 次の場合:

  • 複数の OpenLDAP サーバーをインストールし、LDAP サーバーの一部としてレプリケーションを 13 ノード インストール。ファイルごとに異なる LDAP_SID と LDAP_PEER の値が必要です。
  • 12 ノード インストールの一部として複数のデータセンターを作成する。各データセンターは、 ZK_CLIENT_HOSTS や CASS_HOSTS などのプロパティに異なる設定が必要です。

以下で説明する各インストール トポロジは、そのトポロジの構成ファイルの例を示しています。対象 構成ファイルの詳細については、Edge 構成ファイルのリファレンスをご覧ください。

インストール ログファイル

デフォルトでは、setup.sh ユーティリティはインストールに関するログ情報を次の場所に書き込みます。

/opt/apigee/var/log/apigee-setup/setup.log

setup.sh ユーティリティを実行しているユーザーが そのディレクトリへのアクセス権があると、そのログがファイルとして /tmp ディレクトリに書き込まれます。 setup_username.logという名前を付けます。

ユーザーに /tmp へのアクセス権がない場合は、setup.sh ユーティリティによって表示される 失敗します

Edge コンポーネントをインストールする

このセクションでは、さまざまなトポロジに Edge コンポーネントをインストールする方法について説明します。注文 コンポーネントのインストール方法は 必要なトポロジに基づいて決まります

以下のインストール例はすべて、以下をインストールすることを前提としています。

  • Cassandra 認証が無効（デフォルト）。詳細については、Cassandra 認証を有効にするをご覧ください。
  • Postgres のマスター / スタンバイ レプリケーションが無効（デフォルト）。マスター / スタンバイ レプリケーションを設定する Postgres をご覧ください。
  • Message Processor と Router を同じノード上に配置する。Message Processor をローカルにインストールし、 Router をインストールする場合は、まずすべての Message Processor をインストールしてから、すべての Message Processor を 構成されます
で確認できます。

オールインワンの設置

  1. 次のコマンドを使用して、すべてのコンポーネントを単一のノードにインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. インストールします。
  3. できます。

このトポロジのサイレント構成ファイルを以下に示します。詳細については、このモジュールの 詳細については、Edge 構成ファイルのリファレンスをご覧ください。

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

2 ホスト スタンドアロン インストール

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. スタンドアロン Gateway とノード 1 をインストールする
    > /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. アナリティクスをノード 2 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. インストールします。
  4. できます。

このトポロジのサイレント構成ファイルを以下に示します。詳細については、このモジュールの 詳細については、Edge 構成ファイルのリファレンスをご覧ください。

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

5 ホスト クラスタ インストール

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. Datastore クラスタをノード 1、2、3 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Management Server をノード 1 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Router と Message Processor をノード 2 と 3 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. アナリティクスをノード 4 と 5 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. インストールします。
  6. できます。

このトポロジのサイレント構成ファイルを以下に示します。詳細については、このモジュールの 詳細については、Edge 構成ファイルのリファレンスをご覧ください。

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
 HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password 
SMTPSSL=n
SMTPPORT=25

9 ホスト クラスタ インストール

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. Datastore クラスタノードをノード 1、2、3 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Apigee Management Server をノード 1 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Router と Message Processor をノード 4 と 5 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Apigee Analytics Qpid Server をノード 6 と 7 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Apigee Analytics Postgres Server をノード 8 と 9 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. インストールします。
  7. できます。

このトポロジのサイレント構成ファイルを以下に示します。詳細については、このモジュールの 詳細については、Edge 構成ファイルのリファレンスをご覧ください。

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25

13 ホストクラスタ インストール

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. Datastore クラスタノードをノード 1、2、3 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. OpenLDAP をノード 4 と 5 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Apigee Management Server をノード 6 と 7 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Apigee Analytics Postgres Server をノード 8 と 9 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. Router と Message Processor をノード 10 と 11 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. Apigee Analytics Qpid Server をノード 12 と 13 にインストールします。
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. インストールします。
  8. できます。

このトポロジのサイレント構成ファイルを以下に示します。詳細については、このモジュールの 詳細については、Edge 構成ファイルのリファレンスをご覧ください。

# For all components except OpenLDAP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
# First Management Server on IP6
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Second Management Server on IP7
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25

# For OpenLDAP on IP4 and IP5
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com 
APIGEE_ADMINPW=Secret123
# First OpenLDAP Server on IP4
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5
# Second OpenLDAP Server on IP5
# MSIP=$IP7 
# USE_LDAP_REMOTE_HOST=n 
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=secret

12 ホストクラスタ化インストール

a12 ホストクラスタ型トポロジ（2 つのデータセンター）に Edge をインストールする前に、 サイレント構成ファイルで ZooKeeper と Cassandra プロパティを設定する方法

  • ZooKeeper

    両方のデータセンターの ZK_HOSTS プロパティで、すべてのデータセンターの IP アドレスまたは DNS 名を指定します。 両方のデータセンターから同じ順序で ZooKeeper ノードを作成し、任意のノードに 「:observer」修飾子。「:observer」修飾子が付いていないノードは「:observer」修飾子が付いていない 「voters」。「投票者」の人数は奇数である必要があります必要があります。

    このトポロジでは、ホスト 9 の ZooKeeper ホストがオブザーバーです。

    各データセンターの ZK_CLIENT_HOSTS プロパティで、各データセンターの IP アドレスまたは DNS 名を指定します。 データセンター内のすべての ZooKeeper ノードを同じ順序で あります。以下の構成ファイルの例では、ノード 9 に 「:observer」修飾子を追加して、ノード 1、2、3、7、8 の 5 つの投票者を用意します。
  • Cassandra
    すべてのデータセンターで、同じ数の Cassandra ノードが必要です。

    各データセンターの CASS_HOSTS には、すべての Cassandra IP アドレス（ DNS 名など）を使用して、すべての VPC ネットワークに登録済みです。データセンター 1 について、そのデータの Cassandra ノードを一覧表示する 中央に配置してください。データセンター 2 の場合は、そのデータセンター内の Cassandra ノードを最初にリストします。リスト データセンター内のすべての Cassandra ノードを同じ順序で並べた Cassandra ノード。

    すべての Cassandra ノードにはサフィックス ':<d>,<r>' が必要です。たとえば、'<ip>:1,1 = データセンター 1 とラック/アベイラビリティ ゾーン 1 および '<ip>:2,1 = データセンター 2 および ラック/アベイラビリティ ゾーン 1.
    例: "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.124.205:2,1 192.168.124.206:2,1"

    各データセンターのラック/アベイラビリティ ゾーン 1 の最初のノードがシードとして使用されます。 あります。

    このデプロイモデルでは、Cassandra の設定は次のようになります。

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. Datastore クラスタノードをノード 1、2、3、7、8、9 にインストールします。
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. OpenLDAP レプリケーションを使用する Apigee Management Server をノード 1 と 7 にインストールします。
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Router と Message Processor をノード 2、3、8、9 にインストールします。
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Apigee Analytics Qpid Server をノード 4、5、10、11 にインストールします。
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Apigee Analytics Postgres Server をノード 6 と 12 にインストールします。
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. インストールします。
  7. できます。

このトポロジのサイレント構成ファイルを以下に示します。この構成では、 表示されます。構成ファイルの詳細については、Edge 構成ファイルのリファレンスをご覧ください。

  • 2 つの OpenLDAP ノード間でレプリケーションを行うように OpenLDAP を構成します。
  • 1 つの ZooKeeper ノードに「:observer」修飾子を指定します。単一データ この修飾子は省略できます。
# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP1
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25

# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP7
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25