노드에 Edge 구성요소 설치

프라이빗 클라우드용 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 디렉터리에 파일을 배치합니다.

예를 들어 Edge Management Server를 설치하려면 다음 안내를 따르세요.

> /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 ZooKeeper만 설치합니다.

ds

ZooKeeper 및 Cassandra를 설치합니다.

ld

OpenLDAP만 설치합니다.

밀리초

Edge 관리 서버를 설치합니다. 이 서버는 Edge UI 및 OpenLDAP도 설치합니다.

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

r

Edge 라우터만 설치합니다.

mp

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

rmp

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

ui

Edge UI를 설치합니다.

qs

Qpid 서버만 설치합니다.

ps

Postgres 서버만 설치합니다.

sax

분석 구성요소(Qpid 및 Postgres)를 설치합니다.

이 옵션은 개발 및 테스트용으로만 사용하고 프로덕션용으로는 사용하지 마세요.

월

수익 창출을 설치합니다.

sa

Cassandra, ZooKeeper, 관리 서버, OpenLDAP, Edge UI, 라우터, 메시지 프로세서 등 Edge 독립형을 설치합니다. 이 옵션은 Edge 분석 구성요소인 Qpid 및 Postgres를 생략합니다.

이 옵션은 개발 및 테스트용으로만 사용하고 프로덕션용으로는 사용하지 마세요.

aio

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

이 옵션은 개발 및 테스트용으로만 사용하고 프로덕션용으로는 사용하지 마세요.

구성 파일 만들기

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

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

  • 여러 OpenLDAP 서버를 설치하고 있으며 13노드 설치의 일부로 복제를 구성해야 합니다. 각 파일에는 LDAP_SID 및 LDAP_PEER에 서로 다른 값이 필요합니다.
  • 12노드 설치의 일부로 여러 데이터 센터를 만들고 있습니다. 각 데이터 센터에는 ZK_CLIENT_HOSTS 및 CASS_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에 매핑되는 호스트 이름이나 127.0.0.1의 IP 주소를 사용하지 마세요.

ADMIN_EMAIL
APIGEE_ADMINPW

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

LICENSE_FILE

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

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

USE_LDAP_REMOTE_HOST가 n이면 Edge는 Management Server를 설치할 때 OpenLDAP를 자동으로 설치합니다.

원격 LDAP 서버에 연결하는 경우 USE_LDAP_REMOTE_HOST를 y로 설정합니다. OpenLDAP는 Management Server와 함께 설치되지 않습니다.

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

LDAP_TYPE
LDAP_SID
LDAP_PEER

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

Edge 토폴로지에서 단일 OpenLDAP 서버를 사용하는 경우 1을 지정합니다. Edge 설치에서 13노드 프로덕션 설치와 같이 여러 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

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

REGION

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

여러 데이터 센터 설치에서 값은 설치 중인 데이터 센터에 따라 dc-1 또는 dc-2 등입니다. 하지만 dc-# 형식의 이름만 사용하도록 제한되지는 않습니다. 리전에 어떤 이름이든 사용할 수 있습니다.

ZK_HOSTS

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

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

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

ZK_CLIENT_HOSTS

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

단일 데이터 센터 설치에서 이러한 노드는 ZK_HOSTS에서 지정한 노드와 동일합니다.

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

CASS_HOSTS

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

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

예를 들어 '192.168.124.201:1,1 = 데이터 센터 1 및 랙/가용성 영역 1, '192.168.124.204:2,1 = 데이터 센터 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 사용자 인증 정보가 필요하지 않으면 SMTPUSER 및 SMTPPASSWORD를 생략합니다.

구성요소 설치 순서

구성요소 설치 순서는 원하는 토폴로지에 따라 다릅니다.

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

  • 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. Edge 라우터를 다시 시작합니다.
    > /<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에 Analytics를 설치합니다.
    > /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 Management Server를 설치합니다.
    > /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 Analytics 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 Management Server를 설치합니다.
    > /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 Analytics 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개 호스트 클러스터 설치

12개 호스트 클러스터링된 토폴로지 (데이터 센터 2개)에 Edge를 설치하기 전에 무인 구성 파일에서 ZooKeeper 및 Cassandra 속성을 설정하는 방법을 이해해야 합니다.

  • ZooKeeper

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

    이 토폴로지에서 호스트 9의 ZooKeeper 호스트는 옵저버입니다.

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

    각 데이터 센터의 CASS_HOSTS에 대해 두 데이터 센터의 모든 Cassandra IP 주소 (DNS 이름 아님)를 지정해야 합니다. 데이터 센터 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. 노드 1, 2, 3, 7, 8, 9에 Datastore 클러스터 노드를 설치합니다.
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 노드 1 및 7에 OpenLDAP 복제가 포함된 Apigee Management Server를 설치합니다.
    > /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 Analytics 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를 구성합니다.
  • 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@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