에지 구성 파일 참조

다음은 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.

# If you are using region names other than dc-1, dc-2 etc, set this property to map your region
# name to the appropriate dc-x format region name. This property is required by Management server
# to appropriately register Cassandra data stores based on Cassandra's data centers and regions.
REGION_MAPPING="<custom-region-1>:dc-1 <custom-region-2>:dc-2 ... <custom-region-x>:dc-x"

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

# The following four properties are only effective for Management server:
# Cassandra JMX uname/pword required if you enabled Cassandra JMX authentication.
# CASS_JMX_USERNAME =
# CASS_JMX_PASSWORD =

# Cassandra JMX SSL truststore details if you have enabled SSL based JMX in Cassandra.
# JMX Truststore file should be readable by Apigee user
# CASS_JMX_TRUSTSTORE =
# CASS_JMX_TRUSTSTORE_PASS =

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

속성 참고
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-# 형식의 이름만 사용하도록 제한되지는 않습니다. 리전 이름은 무엇이든 사용할 수 있습니다.

REGION_MAPPING

dc-1, dc-2 등 다른 지역 이름을 사용하는 경우 지역 이름을 적절한 dc-x 형식 지역 이름에 매핑하도록 이 속성을 설정합니다. 이 속성은 관리 서버에서 Cassandra의 데이터 센터와 리전을 기준으로 Cassandra 데이터 저장소를 적절하게 등록하는 데 필요합니다.

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 사용자 이름 및 비밀번호를 전달할 수 있습니다.

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

CONFIG_DELTA_LOG

CONFIG_DELTA_LOG는 구성 파일의 변경사항이 로깅되는 방식을 제어합니다. CONFIG_DELTA_LOG=y를 설정하면 구성요소의 구성 변경사항이 로깅되지 않습니다.

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 항목은 필수 사항입니다.

CASS_JMX_USERNAME Cassandra JMX 사용자 이름 Cassandra JMX 인증을 사용 설정한 경우 필수입니다.
CASS_JMX_PASSWORD Cassandra JMX 비밀번호 Cassandra JMX 인증을 사용 설정한 경우 필수입니다.
CASS_JMX_TRUSTSTORE Cassandra에서 SSL 기반 JMX를 사용 설정한 경우 Cassandra JMX SSL truststore 사용자 이름 JMX Truststore 파일은 Apigee 사용자가 읽을 수 있어야 합니다.
CASS_JMX_TRUSTSTORE_PASS Cassandra에서 SSL 기반 JMX를 사용 설정한 경우 Cassandra JMX SSL truststore 비밀번호

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