에지 구성 파일 참조

Private Cloud용 Edge v4.18.05

다음은 9노드 Edge 설치를 위한 전체 무음 구성 파일의 예입니다. 구성에 따라 이 파일을 수정합니다. -f 옵션을 사용하여 setup.sh를 실행하여 이 파일을 포함합니다. 또한 아래에는 각 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. 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/DNS names of the Cassandra hosts (previously defined)
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 주소를 사용하지 마세요.
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-# 형식의 이름만 사용할 필요는 없습니다. 지역의 이름은 무엇이든 사용할 수 있습니다.

ZK_HOSTS

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

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

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

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

ZK_CLIENT_HOSTS

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

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

단일 데이터 센터 설치의 경우 ZK_HOSTS로 지정된 노드와 동일합니다.

다중 데이터 센터 환경에서 이 데이터 센터의 동물원 Keeper 노드만 나열합니다. 자세한 내용은 12개 호스트 클러스터 설치를 참고하세요.

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

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가 현재 데이터 센터의 노드가 앞에 배치되도록 위 예와 같이 순서를 지정해야 합니다. 자세한 내용은 12개 호스트 클러스터 설치를 참조하세요.

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=IPorDNSofNewMaster
PG_STANDBY=IPorDNSofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

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