노드에 Edge 구성요소 설치

Private Cloud용 Edge v. 4.16.05

노드에 Edge apigee-setup 유틸리티를 설치한 후 apigee-setup 유틸리티를 사용하여 하나 이상의 Edge 구성요소를 노드에 설치합니다.

Apigee-setup 유틸리티는 다음 형식의 명령어를 사용합니다.

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

여기서 component는 설치할 Edge 구성요소이고 configFile은 설치 정보가 포함된 자동 구성 파일입니다. 'apigee' 사용자가 구성 파일에 액세스하거나 읽을 수 있어야 합니다. 예를 들어, 이 파일을 노드의 /tmp 디렉터리에 넣습니다.

예를 들어 에지 관리 서버를 설치하려면 다음 안내를 따르세요.

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

설치 고려사항

구성 파일을 작성할 때는 다음 옵션을 고려하세요.

Postgres 마스터 대기 복제 설정

기본적으로 Edge는 모든 Postgres 노드를 마스터 모드로 설치합니다. 하지만 Postgres 노드가 여러 개 있는 프로덕션 시스템에서는 마스터-대기 복제를 사용하도록 구성해야 마스터 노드에 장애가 발생해도 대기 노드가 트래픽을 계속 처리할 수 있습니다.

자동 구성 파일의 속성을 사용하여 설치 시 마스터-대기 복제를 사용 설정하고 구성할 수 있습니다. 또는 설치 후에 마스터-대기 복제를 사용 설정할 수 있습니다. 자세한 내용은 Postgres용 마스터 대기 복제 설정을 참조하세요.

Cassandra 인증 사용 설정

기본적으로 Cassandra는 인증이 사용 설정되지 않은 상태로 설치됩니다. 즉, 누구나 Cassandra에 액세스할 수 있습니다. Edge를 설치한 후 또는 설치 프로세스의 일부로 인증을 사용 설정할 수 있습니다.

자동 구성 파일의 속성을 사용하여 Cassandra 인증을 설치 시간으로 사용 설정할 수 있습니다. 또는 설치 후에 사용 설정할 수 있습니다.

자세한 내용은 Cassandra 인증 사용 설정을 참조하세요.

라우터를 보호된 포트에 바인딩

라우터를 보호된 포트(예: 1024 미만의 포트 번호)에 바인딩하려면 이러한 포트에 액세스할 수 있는 사용자로 실행되도록 라우터를 구성해야 합니다. 기본적으로 라우터는 권한이 있는 포트에 액세스할 수 없는 사용자 'apigee'로 실행됩니다.

라우터를 다른 사용자로 실행하려면 다음 단계를 따르세요.

  1. 루트로 /opt/apigee/etc/edge-router.d/RUN_USER.sh 파일을 만듭니다.
  2. 파일에 다음 항목을 추가합니다.
    RUN_USER=root
    라우터를 루트로 실행하지 않으려면 포트에 액세스할 수 있는 사용자를 지정합니다.
  3. 파일을 저장합니다.
  4. 루트 이외의 사용자를 지정한 경우 파일 소유자를 해당 사용자로 변경합니다.
    > chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. 라우터를 다시 시작합니다.
    > /opt/apigee/apigee-service/bin/apigee-service Edge-router restart

설치할 구성요소 지정

다음 표에는 apigee-service 유틸리티의 -p 옵션에 전달하여 노드에 설치할 구성요소를 지정하는 옵션이 나와 있습니다.

구성요소

설명

c

Cassandra만 설치합니다.

ZK 사용할 수 있습니다.

ds

JoKeeper 및 Cassandra를 설치합니다.

ld

OpenLDAP만 설치합니다.

ms

에지 관리 서버를 설치합니다. 그러면 Edge UI 및 OpenLDAP도 설치됩니다.

구성 파일에 USE_LDAP_REMOTE_HOST=y를 설정하면 OpenLDAP 설치를 건너뛰고 관리 서버가 다른 노드에 설치된 OpenLDAP를 사용합니다.

r

에지 라우터만 설치합니다.

mp

에지 메시지 프로세서만 설치합니다.

MPN

에지 라우터 및 메시지 프로세서를 설치합니다.

ui

Edge UI를 설치합니다.

qs

Qpid 서버만 설치합니다.

ps

Postgres 서버만 설치합니다.

색소폰

Qpid 및 Postgres를 의미하는 애널리틱스 구성요소를 설치합니다.

이 옵션은 프로덕션이 아닌 개발 및 테스트에만 사용하세요.

수익 창출 설치.

sa

Cassandra, 주Keeper, 관리 서버, OpenLDAP, Edge UI, 라우터, 메시지 프로세서를 의미하는 Edge 독립형을 설치합니다. 이 옵션에서는 Edge 분석 구성요소인 Qpid 및 Postgres가 생략됩니다.

이 옵션은 프로덕션이 아닌 개발 및 테스트에만 사용하세요.

AIO

단일 노드에 모든 구성요소를 설치합니다.

이 옵션은 프로덕션이 아닌 개발 및 테스트에만 사용하세요.

구성 파일 만들기

구성 파일에는 Edge를 설치하는 데 필요한 모든 정보가 포함되어 있습니다. 종종 동일한 구성 파일을 사용하여 Edge 설치에 모든 구성요소를 설치할 수 있습니다.

하지만 다음과 같은 경우에는 다른 구성 파일을 사용하거나 구성 파일을 수정해야 합니다.

  • 여러 OpenLDAP 서버를 설치 중이며 13 노드 설치의 일부로 복제를 구성해야 합니다. 각 파일에는 LDAP_SIDLDAP_PEER에 다른 값이 필요합니다.
  • 노드 12개를 설치하는 과정에서 여러 개의 데이터 센터를 만들려고 합니다. 데이터 센터마다 ZK_CLIENT_HOSTSCASS_HOSTS와 같은 속성 설정이 필요합니다.

구성 파일 예시

다음은 9 노드 Edge 설치를 위한 완전한 자동 구성 파일의 예시입니다. 구성에 맞게 이 파일을 수정합니다. 이 파일을 포함하려면 setup.sh-f 옵션을 사용합니다. 또한 아래에는 각 Edge 토폴로지의 구성 파일 예도 나와 있습니다.

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

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

# Location of Edge license file.
LICENSE_FILE=/tmp/license.txt

# Management Server information.
MSIP=$IP1    # IP or DNS name of Management Server node. 
# Specify the port the Management Server listens on for API calls.
# APIGEE_PORT_HTTP_MS=8080    # Default is 8080.

#
# OpenLDAP information.
#
# Set to y if you are connecting to a remote LDAP server. 
# If n, Edge installs OpenLDAP when it installs the Management Server.
USE_LDAP_REMOTE_HOST=n 

# If connecting to remote OpenLDAP server, specify the IP/DNS name and port.
# LDAP_HOST=$IP1    # IP or DNS name of OpenLDAP node.
# LDAP_PORT=10389   # Default is 10389.
APIGEE_LDAPPW=yourLdapPassword

# Specify OpenLDAP without replication, 1, or with replication, 2.
LDAP_TYPE=1 

# Set only if using replication.
# LDAP_SID=1    # Unique ID for this LDAP server. 
# LDAP_PEER=    # IP or DNS name of LDAP peer.

BIND_ON_ALL_INTERFACES=y 

# The Message Processor and Router pod.
MP_POD=gateway 

# The name of the region, corresponding to the data center name.
REGION=dc-1 # Use dc-1 unless installing in a 
            # multi-data center environment. 

# ZooKeeper information.
# See table below if installing in a multi-data center environment.
ZK_HOSTS="$IP1 $IP2 $IP3"         # IP/DNS names of all ZooKeeper nodes. 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"  # IP/DNS names of all ZooKeeper nodes.

# Cassandra information.
CASS_CLUSTERNAME=Apigee    # Default name is Apigee.

# IP addresses of the Cassandra hosts separated by spaces.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Set to enable Cassandra authentication.
# CASS_AUTH=y    # The default value is n.
# Cassandra uname/pword required if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Use to enable Postgres master-standby replication
# when you have multiple Postgres nodes. 
# PG_MASTER=IPorDNSofNewMaster
# PG_STANDBY=IPorDNSofOldMaster

# SMTP information.
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.

다음 표에는 이러한 속성에 대한 추가 정보가 포함되어 있습니다.

속성

참고

IP/DNS 이름

노드의 IP 주소를 지정할 때 호스트 이름 매핑 127.0.0.1 또는 IP 주소 127.0.0.1을 사용하지 마세요.

ADMIN_EMAIL
APIGEE_ADMINPW

시스템 관리자의 비밀번호는 8자 이상이어야 하며 대문자, 소문자, 숫자, 특수문자 1개를 포함해야 합니다. 비밀번호를 생략하면 비밀번호를 입력하라는 메시지가 표시됩니다.

LICENSE_FILE

라이선스 파일의 위치로, 'apigee' 사용자가 액세스할 수 있어야 합니다. 예를 들어 파일을 /tmp 디렉터리에 저장하고 파일의 chmod 777에 저장합니다. 파일이 Edge 설치 디렉터리에 복사됩니다.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

USE_LDAP_REMOTE_HOST가 n이면 Edge에서 관리 서버를 설치할 때 자동으로 OpenLDAP를 설치합니다.

원격 LDAP 서버에 연결하는 경우 USE_LDAP_REMOTE_HOST를 y로 설정합니다. 관리 서버가 포함된 OpenLDAP는 설치되어 있지 않습니다.

원격 OpenLDAP 서버에 연결하는 경우 LDAP_HOST
및 LDAP_PORT를 사용하여 호스트의 IP 주소 또는 DNS 이름과 포트 번호를 지정합니다.

LDAP_TYPE
LDAP_SID
LDAP_PEER

복제 없이 OpenLDAP에 대해 LDAP_TYPE=1을 설정합니다. LDAP_TYPE=2는 복제가 있는 OpenLDAP에 해당합니다.

Edge 토폴로지에서 단일 OpenLDAP 서버를 사용하는 경우 1을 지정합니다. 13노드 프로덕션 설치와 같이 Edge 설치에 OpenLDAP 노드가 여러 개 사용되는 경우 2를 지정합니다.

복제를 사용 설정하는 경우 다음 속성을 설정합니다.

  • LDAP_SID=1 - 해당 LDAP 서버의 고유 ID입니다. 각 LDAP 노드는 다른 ID를 사용합니다. 예를 들어 LDAP 피어의 경우 2로 설정합니다.
  • LDAP_PEER=10.0.0.1 - LDAP 피어의 IP 또는 DNS 이름입니다.

BIND_ON_ALL_INTERFACES

'y'로 설정하면 라우터/메시지 프로세서가 모든 인터페이스 (IP)에서 바인드 (수신 대기)됩니다. 'n'으로 설정하면 라우터/메시지 프로세서가 특정 인터페이스, 'hostname -i' 명령어에서 반환된 IP에서 바인딩 (수신 대기)됩니다.

MP_POD

메시지 프로세서 및 라우터 포드의 이름을 지정합니다. 기본적으로 이름은 게이트웨이입니다.

지역

리전 이름입니다. 규칙에 따라 이름은 일반적으로 dc-# 형식이며 여기서 # 은 정수 값에 해당합니다. 예를 들어 dc-1, dc-2 등입니다. 멀티 데이터 센터 환경에 설치하지 않는 한 dc-1을 사용할 수 있습니다.

다중 데이터 센터 설치에서는 설치 중인 데이터 센터에 따라 값이 dc-1 또는 dc-2 등입니다. 하지만 dc-# 형식의 이름만 사용할 수 있는 것은 아닙니다. 리전의 이름을 모두 사용할 수 있습니다.

ZK_HOSTS

JoKeeper 노드의 IP 주소 또는 DNS 이름입니다. IP 주소 또는 DNS 이름은 모든 주Keeper 노드에서 동일한 순서로 나열되어야 합니다.

멀티 데이터 센터 환경에서 두 데이터 센터의 모든 JoKeeper 노드를 나열합니다.

12개의 호스트 설치에 설명된 대로 여러 데이터 센터를 만들 때만 JoKeeper 노드에 ':observer' 수정자를 지정합니다. 단일 데이터 센터 설치에서는 이 수정자를 생략합니다. 자세한 내용은 12 호스트 클러스터형 설치를 참조하세요.

ZK_CLIENT_HOSTS

이 데이터 센터에서 사용하는 JoKeeper 노드의 IP 주소 또는 DNS 이름입니다. IP 주소 또는 DNS 이름은 모든 JoKeeper 노드에서 동일한 순서로 나열되어야 합니다.

단일 데이터 센터 설치에서 이들은 ZK_HOSTS에 의해 지정된 것과 동일한 노드입니다.

멀티 데이터 센터 환경에서는 이 데이터 센터의 JoKeeper 노드만 나열합니다. 자세한 내용은 12 호스트 클러스터형 설치를 참조하세요.

CASS_HOSTS

Cassandra 노드의 IP 주소 (DNS 이름이 아님) 처음 두 노드는 시드 서버로 사용됩니다. IP 주소는 모든 Cassandra 노드에서 동일한 순서로 나열되어야 합니다.

Cassandra 노드에는 Cassandra 노드의 데이터 센터와 랙을 지정하는 ':dc,ra' 서픽스(선택사항)를 포함할 수 있습니다. 12개의 호스트 설치에 설명된 대로 여러 데이터 센터를 만들 때만 이 수정자를 지정합니다. 단일 데이터 센터 설치에서는 이 수정자를 생략합니다.

예를 들어 '192.168.124.201:1,1 = datacenter 1 및 랙/가용성 영역 1' 및 '192.168.124.204:2,1 = datacenter 2 및 랙/가용성 영역 1'입니다.

다중 데이터 센터 환경에서 방화벽 문제를 해결하려면 현재 데이터 센터의 노드가 맨 앞에 오는 방식으로 CASS_HOSTS를 정렬해야 합니다 (위의 예 참조). 자세한 내용은 12 호스트 클러스터형 설치를 참조하세요.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

Cassandra 인증 CASS_AUTH=y를 사용 설정하면 이러한 속성을 사용하여 Cassandra 사용자 이름과 비밀번호를 전달할 수 있습니다.

PG_MASTER

PG_STANDBY

Postgres 마스터 대기 복제를 다음 형식으로 사용 설정하도록 설정합니다.

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

Edge에서 비밀번호 분실 및 기타 알림이 있을 때 이메일을 보낼 수 있도록 SMTP를 구성합니다.

SMTP 사용자 인증 정보가 필요하지 않은 경우 SMTPUSERSMTPPASSWORD를 생략합니다.

구성요소 설치 순서

구성요소 설치 순서는 원하는 토폴로지를 기준으로 합니다.

아래의 모든 설치 예에서는 다음을 설치한다고 가정합니다.

  • Cassandra 인증이 사용 중지됨 (기본값) 자세한 내용은 Cassandra 인증 사용 설정을 참조하세요.
  • Postgres 마스터 대기 복제가 사용 중지된 경우 (기본값) 자세한 내용은 Postgres용 마스터 대기 복제 설정을 참조하세요.
  • 메시지 프로세서와 라우터가 같습니다. 메시지 프로세서와 라우터를 서로 다른 노드에 설치하는 경우 먼저 모든 메시지 프로세서를 설치한 다음 모든 라우터를 설치하세요.

설치 로그 파일

기본적으로 setup.sh 유틸리티는 설치에 대한 로그 정보를 다음 위치에 작성합니다.

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

setup.sh 유틸리티를 실행하는 사용자에게 해당 디렉터리에 대한 액세스 권한이 없으면 로그를 /tmp 디렉터리에 setup_username.log라는 파일로 작성합니다.

사용자가 /tmp에 액세스할 수 없으면 setup.sh 유틸리티가 실패합니다.

올인원 설치

  1. 다음 명령어를 사용하여 단일 노드에 모든 구성요소를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. /opt/nginx/conf.d에서 모든 파일을 삭제합니다.
    > rm -f /opt/nginx/conf.d/*
  3. 에지 라우터를 다시 시작합니다.
    > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router restart
  4. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  5. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

다음은 이 토폴로지의 자동 구성 파일입니다.

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.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"
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. 독립형 게이트웨이 및 노드 1 설치
    > /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. 노드 1에서:
    1. /opt/nginx/conf.d에서 모든 파일을 삭제합니다.
      > rm -f /opt/nginx/conf.d/*
    2. 에지 라우터를 다시 시작합니다.
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router restart
  3. 노드 2에 애널리틱스를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  4. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  5. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

다음은 이 토폴로지의 자동 구성 파일입니다.

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.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"
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. 노드 1, 2, 3에 Datastore 클러스터를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 노드 1에 관리 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 노드 2 및 3:
    1. 라우터 및 메시지 프로세서를 설치합니다.
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. /opt/nginx/conf.d에서 모든 파일을 삭제합니다.
      > rm -f /opt/nginx/conf.d/*
    3. 에지 라우터를 다시 시작합니다.
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router restart
  4. 노드 4와 5에 애널리틱스를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  6. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

다음은 이 토폴로지의 자동 구성 파일입니다.

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.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" 
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. 노드 1, 2, 3에 Datastore 클러스터 노드를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 노드 1에 Apigee 관리 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 노드 4 및 5:
    1. 라우터 및 메시지 프로세서를 설치합니다.
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. /opt/nginx/conf.d에서 모든 파일을 삭제합니다.
      > rm -f /opt/nginx/conf.d/*
    3. 에지 라우터를 다시 시작합니다.
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router restart
  4. 노드 6 및 7에 Apigee 애널리틱스 Qpid 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. 노드 8 및 9에 Apigee Analytics Postgres 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  7. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

다음은 이 토폴로지의 자동 구성 파일입니다.

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.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" 
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. 노드 1, 2, 3에 Datastore 클러스터 노드를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 노드 4 및 5에 OpenLDAP를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. 노드 6 및 7에 Apigee 관리 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. 노드 8 및 9에 Apigee Analytics Postgres 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. 노드 10 및 11:
    1. 라우터 및 메시지 프로세서를 설치합니다.
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. /opt/nginx/conf.d에서 모든 파일을 삭제합니다.
      > rm -f /opt/nginx/conf.d/*
    3. 에지 라우터를 다시 시작합니다.
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router restart
  6. 노드 12 및 13에 Apigee 애널리틱스 Qpid 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  8. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

다음은 이 토폴로지의 자동 구성 파일입니다.

# 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@apigee.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" 
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@apigee.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 호스트 클러스터형 토폴로지 (데이터 센터 두 개)에 Edge를 설치하기 전에 자동 구성 파일에서 JoKeeper 및 Cassandra 속성을 설정하는 방법을 알아야 합니다.

  • JoKeeper

    두 데이터 센터의 ZK_HOSTS 속성에 대해 두 데이터 센터의 모든 주Keeper 노드의 IP 주소 또는 DNS 이름을 동일한 순서로 지정하고 ':observer' 한정자로 노드를 표시합니다. ':observer' 수정자가 없는 노드를 'voters'라고 합니다. 구성에 '투표자' 수가 홀수여야 합니다.

    이 토폴로지에서 호스트 9의 JoKeeper 호스트는 관찰자입니다.

    각 데이터 센터의 ZK_CLIENT_HOSTS 속성에는 데이터 센터의 모든 주Keeper 노드에 대해 동일한 순서로 데이터 센터에 있는 JoKeeper 노드의 IP 주소 또는 DNS 이름을 지정합니다. 아래의 구성 파일 예에서 노드 9는 ':observer' 수정자로 태그되어 5명의 투표자가 있습니다(노드 1, 2, 3, 7, 8).
  • Cassandra
    모든 데이터 센터의 Cassandra 노드 수는 동일해야 합니다.

    각 데이터 센터의 CASS_HOSTS에 대해 두 데이터 센터 모두에 DNS 이름이 아닌 모든 Cassandra IP 주소를 지정해야 합니다. 데이터 센터 1의 경우 먼저 해당 데이터 센터의 Cassandra 노드를 나열합니다. 데이터 센터 2의 경우 먼저 해당 데이터 센터의 Cassandra 노드를 나열합니다. 데이터 센터의 모든 Cassandra 노드에 대해 동일한 순서로 Cassandra 노드를 나열합니다.

    모든 Cassandra 노드에는 서픽스 ':<d>,<r>'가 있어야 합니다(예: '<ip>:1,1 = datacenter 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.121:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.1의 첫 번째 노드: data-center



    이 배포 모델에서 Cassandra 설정은 다음과 같이 표시됩니다.

Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.

  1. 노드 1, 2, 3, 7, 8, 9에 Datastore 클러스터 노드를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 노드 1 및 7에 OpenLDAP 복제가 포함된 Apigee 관리 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 노드 2, 3, 8 , 9:
    1. 라우터 및 메시지 프로세서를 설치합니다.
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. /opt/nginx/conf.d에서 모든 파일을 삭제합니다.
      > rm -f /opt/nginx/conf.d/*
    3. 에지 라우터를 다시 시작합니다.
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router restart
  4. 노드 4, 5, 10, 11에 Apigee 애널리틱스 Qpid 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. 노드 6과 12에 Apigee Analytics Postgres 서버를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  7. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

아래는 이 토폴로지의 자동 구성 파일입니다. 이 구성 파일은 다음과 같습니다.

  • 두 개의 OpenLDAP 노드에 대한 복제를 통해 OpenLDAP를 구성합니다.
  • 하나의 JoKeeper 노드에 ':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@apigee.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"
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@apigee.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"
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