노드에 Edge 구성요소 설치

노드에 Edge apigee-setup 유틸리티를 설치한 후 apigee-setup 유틸리티를 사용하여 노드에 하나 이상의 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 관리 서버를 설치하려면 다음 단계를 따르세요.

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

Edge apigee-setup 설치에 관한 자세한 내용은 Edge apigee-setup 유틸리티 설치를 참고하세요.

설치 고려사항

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

Postgres 마스터-대기 복제 설정

기본적으로 Edge는 모든 Postgres 노드를 마스터 모드로 설치합니다. 그러나 Postgres 노드가 여러 개인 프로덕션 시스템에서는 마스터 노드가 실패할 경우 스탠바이 노드가 트래픽을 계속 전송할 수 있도록 마스터-스탠바이 복제를 사용하도록 구성해야 합니다.

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

RHEL 9.X/Rocky 9.X/Oracle 9.X openldap 2.4 고려사항

온프레미스 설치에는 OpenLDAP 2.4가 필요하며 이는 apigee-thirdparty-opdk 저장소에 포함되어 있습니다. 쉽게 설치하려면 openldap-compat 라이브러리를 삭제하세요.

호스트 13대 설치 및 데이터 센터 2개가 있는 호스트 12대 설치의 경우 OpenLDAP를 호스팅하는 노드가 여러 개 있으므로 OpenLDAP 복제가 필요합니다.

Cassandra 인증 사용 설정

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

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

가상 호스트 생성 시 보호된 포트 사용

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

가상 호스트와 라우터가 1,000 미만의 포트에 액세스하도록 구성하는 방법은 가상 호스트 설정을 참조하세요.

Apigee-qpidd-4.52.01-X.X.X에서 도입된 새로운 요구사항

버전 4.52.01부터 설치 중에 새로운 요구사항이 도입되었습니다. 설치 중에 QPID_MGMT_USERNAME 및 QPID_MGMT_PASSWORD 속성을 포함해야 합니다. 이러한 속성이 구성 파일에 적절한 값과 함께 추가되도록 하여 설치를 성공적으로 완료하도록 하세요.

새 Edge UI 설치

초기 설치를 완료한 후에는 Apigee Edge for Private Cloud의 개발자 및 관리자를 위한 향상된 사용자 인터페이스인 새 Edge UI를 설치하는 것이 좋습니다. 기존 UI는 기본적으로 설치되어 있습니다.

Edge UI를 사용하려면 기본 인증을 사용 중지하고 SAML 또는 LDAP와 같은 IDP를 사용해야 합니다.

자세한 내용은 새 Edge UI 설치를 참고하세요.

설치할 구성요소 지정

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

구성요소 설명

c

Cassandra만 설치합니다.
zk ZooKeeper만 설치합니다.

ds

주키퍼 및 Cassandra를 설치합니다.

ld

OpenLDAP만 설치합니다.

mt

OpenLDAP도 설치하는 Edge 관리 서버를 설치합니다.

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

ms

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

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

r

Edge 라우터만 설치합니다.

mp

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

rmp

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

ui

Edge UI를 설치합니다.

qs

Qpid 서버만 설치합니다.

ps

Postgres 서버만 설치합니다.
pdb Postgres 데이터베이스만 설치 - Apigee 개발자 서비스 포털 (또는 간단히 포털)을 설치할 때만 사용됩니다. 포털 설치를 참고하세요.

sax

Qpid 및 Postgres와 같은 분석 구성요소를 설치합니다.

이 옵션은 프로덕션이 아닌 개발 및 테스트에만 사용하세요.
sso Apigee SSO 모듈을 설치합니다.

mo

수익 창출 앱을 설치합니다.

sa

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

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

aio

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

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

포털을 설치합니다.

구성 파일 만들기

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

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

  • 여러 OpenLDAP 서버를 설치하고 있으며 13노드 설치의 일부로 복제를 구성해야 합니다. 각 파일에는 LDAP_SID 및 LDAP_PEER의 서로 다른 값이 필요합니다.
  • 12노드 설치의 일부로 여러 데이터 센터를 만듭니다. 데이터 센터마다 ZK_CLIENT_HOSTS 및 CASS_HOSTS와 같은 속성에 다른 설정이 필요합니다.

아래에 설명된 각 설치 토폴로지에는 해당 토폴로지의 구성 파일 예시가 표시됩니다. 구성 파일에 관한 전체 참조는 Edge 구성 파일 참조를 참고하세요.

설치를 실행하지 않고 시스템 요구사항 테스트

Private Cloud용 Edge는 설치 시 머신의 CPU 및 메모리 요구사항을 확인할 수 있도록 ENABLE_SYSTEM_CHECK=y 속성을 지원합니다. 하지만 이전 버전의 Edge에서는 이를 확인하려면 실제로 설치를 수행해야 했습니다.

이제 '-t' 플래그를 사용하여 설치하지 않고도 이 검사를 실행할 수 있습니다. 예를 들어 실제로 설치하지 않고 'aio' 설치의 시스템 요구사항을 확인하려면 다음 명령어를 사용합니다.

/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t

이 명령어는 시스템 요구사항과 관련된 오류를 화면에 표시합니다.

모든 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용 마스터-스탠바이 복제 설정을 참고하세요.
  • 메시지 프로세서와 라우터가 동일한 노드에 있습니다. 서로 다른 노드에 메시지 프로세서와 라우터를 설치하는 경우 먼저 모든 메시지 프로세서를 설치한 후 모든 라우터를 설치합니다.

기본 요건

Edge 구성요소를 설치하려면 먼저 다음을 실행해야 합니다.

  • 설치를 진행하기 전에 설치 요구사항에서 기본 요건 및 가져와야 하는 필수 파일 목록을 확인하세요. 설치 프로세스를 시작하기 전에 요구사항을 검토했는지 확인하세요.
  • SELinux를 사용 중지하거나 허용 모드로 설정합니다. 자세한 내용은 Edge apigee-setup 유틸리티 설치를 참고하세요.

올인원 설치

  1. 다음 명령어를 사용하여 단일 노드에 모든 구성요소를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. 설치가 완료되면 기존 UI 구성요소를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    이는 기본 UI에 적용되며, 구성요소 이름이 edge-management-ui인 새 Edge UI에는 적용되지 않습니다.

  3. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  4. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

여기에서 Edge 올인원 설치 동영상을 확인하세요.

아래는 이 토폴로지의 무음 구성 파일입니다. 구성 파일에 관한 전체 참조는 Edge 구성 파일 참조를 참고하세요.

# With SMTP
IP1=IP_or_DNS_name_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
# Admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

2노드 독립형 설치

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

  1. 독립형 게이트웨이 및 노드 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. 노드 1에서 기존 UI 구성요소를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    이는 구성요소 이름이 edge-management-ui인 새 Edge UI가 아닌 기존 UI에 적용됩니다.

  4. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  5. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

아래는 이 토폴로지의 무음 구성 파일입니다. 구성 파일에 관한 전체 참조는 Edge 구성 파일 참조를 참고하세요.

# With SMTP
IP1=IP_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

5노드 설치

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

  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에 라우터 및 메시지 프로세서를 설치합니다. 
    /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. 노드 1에서 기존 UI 구성요소를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    이는 구성요소 이름이 edge-management-ui인 새 Edge UI가 아닌 기존 UI에 적용됩니다.

  6. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  7. 조직 온보딩에 설명된 대로 조직 온보딩.

아래는 이 토폴로지의 무음 구성 파일입니다. 구성 파일에 관한 전체 참조는 Edge 구성 파일 참조를 참고하세요.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

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에 라우터와 메시지 프로세서를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. 노드 6 및 7에 Apigee Analytics Qpid Server를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. 노드 8 및 9에 Apigee Analytics Postgres Server를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. 노드 1에서 기존 UI 구성요소를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    이는 구성요소 이름이 edge-management-ui인 새 Edge UI가 아닌 기본 UI에 적용됩니다.

  7. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  8. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

다음은 이 토폴로지의 자동 구성 파일입니다. 구성 파일에 관한 전체 참조는 Edge 구성 파일 참조를 참고하세요.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
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=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

13노드 클러스터 설치

이 섹션에서는 13노드 클러스터의 설치 순서를 설명합니다. Edge 토폴로지와 노드 번호 목록은 설치 토폴로지를 참조하세요.

13노드 클러스터의 설치 순서는 다음과 같습니다.

  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 애널리틱스 Postgres 서버를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. 노드 10 및 11에 라우터 및 메시지 프로세서를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. 노드 12 및 13에 Apigee 애널리틱스 Qpid 서버를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. 노드 6 및 7에서 기존 UI 구성요소를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    이는 기본 UI에 적용되며, 구성요소 이름이 edge-management-ui인 새 Edge UI에는 적용되지 않습니다.

  8. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  9. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

다음은 이 토폴로지의 샘플 무음 구성 파일입니다. 구성 파일에 관한 전체 참조는 Edge 구성 파일 참조를 참고하세요.

# For all nodes except IP4 and IP5
# (which are the OpenLDAP nodes)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
# Management Server on IP6 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Management Server on IP7 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Use the same password for both OpenLDAP nodes
APIGEE_LDAPPW=LDAP_PASSWORD 
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.
# Optionally use Cassandra racks
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=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# For OpenLDAP nodes only (IP4 and IP5)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD

# For the OpenLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the OpenLDAP Server on IP5 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=n
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

12노드 클러스터 설치

12노드 클러스터형 토폴로지 (데이터 센터 2곳)에 Edge를 설치하려면 자동 구성 파일에서 주키퍼 및 Cassandra 속성을 설정하는 방법을 이해해야 합니다.

  • ZooKeeper

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

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

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

  • 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 관리 서버를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 노드 2, 3, 8, 9에 라우터 및 메시지 프로세서를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. 노드 4, 5, 10, 11에 Apigee 애널리틱스 Qpid 서버를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. 노드 6 및 12에 Apigee Analytics Postgres Server를 설치합니다. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. 노드 1과 7에서 기본 UI 구성요소를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    이는 구성요소 이름이 edge-management-ui인 새 Edge UI가 아닌 기존 UI에 적용됩니다.

  7. 설치 테스트에 설명된 대로 설치를 테스트합니다.
  8. 조직 온보딩에 설명된 대로 조직을 온보딩합니다.

아래는 이 토폴로지의 무음 구성 파일입니다. 구성 파일의 전체 참조는 Edge 구성 파일 참조를 참고하세요.

  • 두 OpenLDAP 노드 간에 복제를 사용하여 OpenLDAP를 구성합니다.
  • 주키퍼 노드 한 개에서 :observer 수정자를 지정합니다. 단일 데이터 센터 설치에서는 이 수정자를 생략합니다.
# Datacenter 1
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP1
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
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=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# Datacenter 2
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP7
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
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=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234