에지 구성 파일 참조

다음은 9 노드 Edge 설치를 위한 완전한 자동 구성 파일의 예시입니다. 구성에 맞게 이 파일을 수정하세요. 이 파일을 포함하려면 -f 옵션을 setup.sh로 사용합니다. 각 토폴로지와 관련된 구성 파일의 예시는 Edge 구성요소 설치를 참조하세요.

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra (IP address only; do not use a DNS name)
IP2=192.168.1.2  # ZooKeeper, Cassandra (IP address only; do not use a DNS name)
IP3=192.168.1.3  # ZooKeeper, Cassandra (IP address only; do not use a DNS name)
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)

# Specify "y" to check that the system meets the CPU and memory requirements
# for the component being installed. See Installation Requirements for requirements
# for each component. The default value is "n" to disable check.
ENABLE_SYSTEM_CHECK=n

# When "hostname -i" returns multiple IP addresses,
# set to "y", to have the installer prompt you to select the IP address to use.
ENABLE_DYNAMIC_HOSTIP=n

# 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.

# 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.

# Space-separated IP addresses of the Cassandra hosts (previously defined; do not use DNS names)
# Syntax is: IP_address:host_number,rack_number
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=''

# Postgres username and password as set when you installed Edge.
# Default is apigee:postgres.
PG_USER=apigee
PG_PWD=postgres

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

# 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.
SMTPMAILFROM="My Company <myco@company.com>"

다음 표에는 이러한 속성에 대한 추가 정보가 나와 있습니다.

속성 참고
IP/DNS 이름 노드의 IP 주소를 지정할 때 127.0.0.1 또는 127.0.0.1의 IP 주소에는 호스트 이름을 매핑하지 마세요.

Cassandra 호스트 정의에는 IP 주소만 사용해야 하며 DNS 이름은 사용하지 마세요.

ENABLE_SYSTEM_CHECK

'y'인 경우 시스템이 설치 중인 구성요소의 CPU 및 메모리 요구사항을 충족하는지 확인합니다. 각 구성요소의 요구사항은 설치 요구사항을 참고하세요.

기본값은 확인을 사용 중지하는 'n'입니다.

ENABLE_DYNAMIC_HOSTIP

서버에 인터페이스 카드가 여러 개 있으면 'hostname -i' 명령어가 공백으로 구분된 IP 주소 목록을 반환합니다. 기본적으로 Edge 설치 프로그램은 반환된 첫 번째 IP 주소를 사용하므로 상황에 따라 정확하지 않을 수도 있습니다. 또는 설치 구성 파일에 다음 속성을 설정할 수 있습니다.

'y'로 설정하면 설치에 사용할 IP 주소를 선택하라는 메시지가 설치 프로그램에 표시됩니다. 기본값은 'n'입니다.

ADMIN_EMAIL
APIGEE_ADMINPW

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

설치가 완료되면 구성 파일에서 비밀번호를 삭제하는 것이 좋습니다.

LICENSE_FILE

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

APIGEE_LDAPPW

OpenLDAP 비밀번호를 지정합니다.

설치가 완료되면 구성 파일에서 비밀번호를 삭제하는 것이 좋습니다.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

USE_LDAP_REMOTE_HOST가 n인 경우 Edge는 관리 서버를 설치할 때 자동으로 OpenLDAP를 설치합니다.

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

원격 OpenLDAP 서버에 연결하는 경우 LDAP_HOSTLDAP_PORT를 사용하여 IP 주소 또는 DNS 이름과 호스트의 포트 번호를 지정하세요.

LDAP_TYPE
LDAP_SID
LDAP_PEER

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

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

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

  • LDAP_SID=1 - 이 LDAP 서버의 고유 ID입니다. 각 LDAP 노드는 서로 다른 ID를 사용합니다. 예를 들어 LDAP 피어에는 2로 설정합니다.
  • LDAP_PEER=10.0.0.1 - LDAP 피어의 IP 또는 DNS 이름입니다.
MP_POD 메시지 프로세서 및 라우터 포드의 이름을 지정합니다. 기본적으로 이름은 게이트웨이입니다.
REGION

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

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

ZK_HOSTS

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

HOSTIPZK_HOSTS에 사용하는 것과 동일한 형식을 사용하세요. 즉, ZK_HOSTS에 IP 주소를 지정하는 경우 HOSTIP에 IP 주소를 사용합니다. DNS를 사용하는 경우 둘 다 DNS 이름을 사용하세요.

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

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

ZK_CLIENT_HOSTS

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

HOSTIPZK_CLIENT_HOSTS에 사용하는 것과 동일한 형식을 사용하세요. 즉, ZK_CLIENT_HOSTS에 IP 주소를 지정하는 경우 HOSTIP에 IP 주소를 사용합니다. DNS를 사용한다면 둘 다 DNS 이름을 사용하세요.

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

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

CASS_CLUSTERNAME 원하는 경우 Cassandra 클러스터의 이름을 지정합니다. 기본 이름은 'Apigee'입니다.
CASS_HOSTS

Cassandra 노드의 호스트 IP 주소 (DNS 이름 아님)를 쉼표로 구분된 목록으로 지정하고, 원하는 경우 데이터 센터 번호와 노드가 속하는 을 지정합니다.

프로덕션 토폴로지의 경우 이 목록에 노드가 3개 이상 있어야 합니다. 처음 두 노드는 '시드 서버'로 사용됩니다. 따라서 IP 주소가 모든 Cassandra 노드에서 동일한 순서로 나열되어야 합니다.

목록의 각 항목에 대한 구문은 다음과 같습니다.

IP_address[:data_center_number,rack_number]

Cassandra 노드는 선택적으로 Cassandra 노드의 데이터 센터와 랙을 지정할 수 있습니다. 12개 호스트 설치에 설명된 것처럼 여러 데이터 센터를 만들 때만 data_center_number 수정자를 지정합니다. 단일 데이터 센터 설치에서는 해당 수정자를 생략합니다.

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

다중 데이터 센터 환경에서는 방화벽 문제를 극복하기 위해 CASS_HOSTS를 현재 데이터 센터의 노드가 처음에 배치되는 방식으로 정렬되어야 합니다 (위 예 참고). 자세한 내용은 12 호스트 클러스터링 설치를 참조하세요.

Cassandra 호스트의 rack_number 지정에 관한 자세한 내용은 Cassandra 랙 지원 추가를 참고하세요.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

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

설치가 완료되면 구성 파일에서 비밀번호를 삭제하는 것이 좋습니다.

PG_USER
PG_PWD

기본적으로 PostgreSQL 데이터베이스에는 'postgres'와 'apigee'의 두 가지 사용자가 정의되어 있습니다.

PG_USER에서는 'Apigee' 사용자의 사용자 이름을 변경할 수 있습니다. 'postgres' 사용자의 이름은 변경할 수 없습니다.

기본적으로 PostgreSQL 데이터베이스에는 'postgres'와 'apigee'의 두 가지 사용자가 정의되어 있습니다. 두 사용자 모두 기본 비밀번호는 'postgres'입니다. PG_PWD를 사용하여 설치 시 두 사용자의 비밀번호를 다른 값으로 설정합니다.

설치가 완료되면 구성 파일에서 비밀번호를 삭제하는 것이 좋습니다.

PG_MASTER
PG_STANDBY

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

PG_MASTER=IPofNewMaster
PG_STANDBY=IPofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

SMTPMAILFROM 항목은 필수 사항입니다.

여기에 나열된 속성 외에도 Apigee mTLS를 구성하는 속성이 있습니다. 자세한 내용은 Apigee mTLS 구성을 참조하세요.