에지 구성 파일 참조

다음은 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=Apigee1234
    
    # FIPS_OS should be set to true when OPDK 4.53 or later is installed on 
    # FIPS enabled operating system
    FIPS_OS=false
    

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

속성 참고
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

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

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

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

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

ZK_CLIENT_HOSTS

이 데이터 센터에서 사용하는 ZooKeeper 노드의 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 이름이 아님)를 지정하고 선택적으로 해당 데이터 센터 번호와 노드가 속한 을 지정합니다.

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

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

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에서 SSL 기반 JMX를 사용 설정한 경우 Cassandra JMX SSL 트러스트 저장소 사용자 이름입니다. JMX Truststore 파일은 Apigee 사용자가 읽을 수 있어야 합니다.
CASS_JMX_TRUSTSTORE_PASS Cassandra에서 SSL 기반 JMX를 사용 설정한 경우 Cassandra JMX SSL 트러스트 저장소 비밀번호입니다.
QPID_MGMT_USERNAME
QPID_MGMT_PASSWORD
이 사용자 인증 정보는 Qpid 브로커의 Qpid 웹 관리 콘솔에 대한 액세스 권한을 제공합니다. 웹 관리 콘솔은 Qpid 브로커의 관리 및 제어를 위한 간단하고 직관적인 인터페이스를 제공합니다.
FIPS_OS FIPS_OS는 true 또는 false이며 기본값은 false입니다. FIPS 지원 운영체제에서 Private Cloud용 Edge 버전 4.53.00 이상의 경우 true로 설정하세요.

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