에지 구성 파일 참조

Private Cloud용 에지 v. 4.17.09

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

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

# IP (not DNS names) 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=

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

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

속성

참고

IP/DNS 이름

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

시스템 사용 확인

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

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

동적 사용_가능

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

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

주의: ENABLE_DYNAMIC_HOSTIP=y를 설정한 경우 속성 파일에서 HOSTIP를 설정하지 않았는지 확인하세요.

ADMIN_EMAIL
APIGEE_ADMINPW

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

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

라이선스_파일

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

APIGEE_LDAPPW

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

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

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Edge가 USE_LDAP_REMOTE_HOST가 n이면 관리 서버를 설치할 때 OpenLDAP가 자동으로 설치됩니다.

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

원격 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 설치에서 여러 OpenLDAP 노드를 사용하는 경우(예: 13노드 프로덕션 설치) 2를 지정합니다.

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

  • LDAP_SID=1 - 이 LDAP 서버의 고유 ID입니다. 각 LDAP 노드는 서로 다른 ID를 사용합니다. 예를 들어 LDAP 피어의 경우 2로 설정합니다.
  • LDAP_PEER=10.0.0.1 - LDAP 피어의 IP 또는 DNS 이름입니다.

MP_POD

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

지역

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

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

ZK_HOST

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

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

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

ZK_CLIENT_HOSTS

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

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

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

CASS_CLUSTERNAME 필요한 경우 Cassandra 클러스터의 이름을 지정합니다. 기본 이름은 'Apigee'입니다.

CASS_HOST

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를 현재 데이터 센터의 노드가 처음에 배치되는 방식으로 (위 예시와 같이) 정렬해야 합니다. 자세한 내용은 노드에 Edge 구성요소 설치에서 '12 호스트 클러스터링 설치'를 참고하세요.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

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

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

PG_USER
PG_PWD

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

PG_USER를 사용하면 'Apigee' 사용자의 사용자 이름을 변경할 수 있습니다. 'postgres' 사용자의 이름은 변경할 수 없습니다.

두 사용자 모두 기본 비밀번호는 'postgres'입니다. PG_PWD를 사용하여 설치 시 두 사용자 모두에 대해 다른 값으로 비밀번호를 설정합니다.

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

PG_MASTER(PG_MASTER)

PG_STANDBY

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

PG_MASTER=새 IP 주소

PG_STANDBY=IPORDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMailFROM

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

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

SMTPMAILFROM은 필수 항목입니다.