에지 구성 파일 참조

다음은 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=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.
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 =
    
# Set up username and password to access Qpid broker's management console

QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234

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

속성 참고
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자 이상이어야 하며 대문자 1개, 소문자 1개, 숫자 1개 또는 특수 문자 1개를 포함해야 합니다. 비밀번호를 생략하면 비밀번호를 입력하라는 메시지가 표시됩니다.

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

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

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

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

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

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

ZK_CLIENT_HOSTS

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

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

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

다중 데이터 센터 환경에서는 이 데이터 센터의 JoKeeper 노드만 나열합니다. 자세한 내용은 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=IPorDNSofNewMaster
PG_STANDBY=IPorDNSofOldMaster
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 JMX SSL 트러스트 저장소 사용자 이름(Cassandra에서 SSL 기반 JMX를 사용 설정한 경우) Apigee 사용자는 JMX 트러스트 저장소 파일을 읽을 수 있어야 합니다.
CASS_JMX_TRUSTSTORE_PASS Cassandra JMX SSL 트러스트 저장소 비밀번호(Cassandra에서 SSL 기반 JMX를 사용 설정한 경우)
QPID_MGMT_USERNAME
QPID_MGMT_PASSWORD
이러한 사용자 인증 정보는 Qpid 브로커의 Qpid Web Management Console에 대한 액세스를 제공합니다. 웹 관리 콘솔은 Qpid 브로커의 관리 및 제어를 위한 간단하고 직관적인 인터페이스를 제공합니다.

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