Edge Yapılandırma Dosyası Referansı

Aşağıda, 9 düğümlü Edge yüklemesi için eksiksiz bir sessiz yapılandırma dosyası örneği gösterilmektedir. Bu dosyayı yapılandırmanız için gereken şekilde düzenleyin. Bu dosyayı eklemek için setup.sh -f seçeneğini kullanın. Her topolojiye özel yapılandırma dosyası örnekleri için Edge bileşenlerini yükleme bölümüne bakın.

# 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

Aşağıdaki tabloda bu tesisler hakkında ek bilgiler verilmiştir:

Özellik Not
IP/DNS adları Bir düğümün IP adresini belirtirken 127.0.0.1 ile ana makine adı eşlemesi veya 127.0.0.1 IP adresi kullanmayın.

Cassandra ana makine tanımları için yalnızca IP adreslerini kullanın, DNS adlarını kullanmayın.

ENABLE_SYSTEM_CHECK

Burada "y" yazıyorsa sistemin, yüklenen bileşen için CPU ve bellek gereksinimlerini karşılayıp karşılamadığını kontrol edin. Her bir bileşenin gereksinimleri için Yükleme Gereksinimleri'ne bakın.

Kontrolü devre dışı bırakmak için varsayılan değer "n"dir.

ENABLE_DYNAMIC_HOSTIP

Bir sunucuda birden fazla arayüz kartı varsa "anamakineadı -i" komutu, IP adreslerinin boşlukla ayrılmış bir listesini döndürür. Varsayılan olarak, Edge yükleyici döndürülen ilk IP adresini kullanır. Bu adres her durumda doğru olmayabilir. Alternatif olarak, yükleme yapılandırma dosyasında aşağıdaki özelliği ayarlayabilirsiniz.

"y" değerine ayarlanırsa yükleyici, yükleme işleminde kullanılacak IP adresini seçmenizi ister. Varsayılan değer "n"dir.

ADMIN_EMAIL
APIGEE_ADMINPW

Sistem yöneticisi şifresi en az 8 karakter uzunluğunda olmalı ve bir büyük harf, bir küçük harf, bir rakam veya bir özel karakter içermelidir. Şifreyi atlarsanız girmeniz istenir.

Yükleme tamamlandıktan sonra Apigee, yapılandırma dosyasından şifreyi kaldırmanızı önerir.

LICENSE_FILE

"Apigee" kullanıcısı tarafından erişilebilir olması gereken lisans dosyasının konumu. Örneğin, dosyayı /tmp dizininde ve chmod 777'de depolayın. Dosya, Edge yükleme dizinine kopyalanır.

APIGEE_LDAPPW

OpenLDAP şifresini belirtir.

Yükleme tamamlandıktan sonra Apigee, yapılandırma dosyasından şifreyi kaldırmanızı önerir.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

USE_LDAP_REMOTE_HOST değeri n ise Edge, Yönetim Sunucusu'nu yüklediğinde OpenLDAP'yi otomatik olarak yükler.

Uzak bir LDAP sunucusuna bağlanıyorsanız USE_LDAP_REMOTE_HOST değerini y olarak ayarlayın. OpenLDAP, Yönetim Sunucusu ile yüklü değil.

Uzak bir OpenLDAP sunucusuna bağlanıyorsanız IP adresini veya DNS adını ve ana makinenin bağlantı noktası numarasını belirtmek için LDAP_HOST ve LDAP_PORT özelliklerini kullanın.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Çoğaltmasız OpenLDAP için LDAP_TYPE=1 değerini ayarlayın. LDAP_TYPE=2, çoğaltma ile OpenLDAP'ye karşılık gelir.

Edge topolojiniz tek bir OpenLDAP sunucusu kullanıyorsa 1 değerini belirtin. Edge yüklemenizde birden fazla OpenLDAP düğümü kullanılıyorsa (ör. 13 düğümlü üretim kurulumunda) 2 değerini belirtin.

Çoğaltmayı etkinleştirirseniz aşağıdaki özellikleri ayarlayın:

  • LDAP_SID=1 - Bu LDAP sunucusunun benzersiz kimliği. Her LDAP düğümü farklı bir kimlik kullanır. Örneğin, LDAP eşi için 2 olarak ayarlayın.
  • LDAP_PEER=10.0.0.1 - LDAP eşinin IP veya DNS adı.
MP_POD Mesaj İşlemci ve Yönlendirici kapsülünün adını belirtin. Bu ad, varsayılan olarak ağ geçididir.
REGION

Bölge adı. Kural olarak, adlar genellikle dc-# biçimindedir; burada # işareti bir tam sayı değerine karşılık gelir. Örneğin, dc-1, dc-2 vb.. Çok veri merkezili bir ortamda yüklemediğiniz sürece dc-1'i kullanabilirsiniz.

Çoklu veri merkezi kurulumunda, hangi veri merkezini yüklediğinize bağlı olarak değer dc-1, dc-2 vb. olur. Ancak, yalnızca dc-# biçimindeki adları kullanmanızla sınırlı değilsiniz. Bölge için herhangi bir adı kullanabilirsiniz.

REGION_MAPPING

dc-1, dc-2 dışında bir bölge adı kullanıyorsanız bu özelliği, bölge adınızı uygun dc-x biçimindeki bölge adıyla eşleyecek şekilde ayarlayın. Yönetim sunucusunun, Cassandra'nın veri merkezlerine ve bölgelerine göre Cassandra veri depolarını uygun şekilde kaydetmesi için bu mülk gerekir.

ZK_HOSTS

ZooKeeper düğümlerinin IP adresleri veya DNS adları. IP adresleri veya DNS adları, tüm ZooKeeper düğümlerinde aynı sırada listelenmelidir.

HOSTIP için, ZK_HOSTS için kullandığınız biçimi kullanın. Yani ZK_HOSTS için IP adresini belirtirseniz HOSTIP için bir IP adresi kullanın. DNS kullanıyorsanız her ikisi için de DNS adı kullanın.

Çoklu veri merkezi ortamında, her iki veri merkezindeki tüm ZooKeeper düğümlerini listeleyin.

ZooKeeper düğümlerinde ":observer" değiştiricisini yalnızca birden fazla veri merkezi oluştururken 12 ana makineli kurulumda açıklandığı gibi belirtin. Tek bir veri merkezi kurulumunda bu değiştiriciyi atlayın. Daha fazla bilgi için 12 ana makineli kümelenmiş yükleme sayfasına bakın.

ZK_CLIENT_HOSTS

Bu veri merkezi tarafından kullanılan ZooKeeper düğümlerinin IP adresleri veya DNS adları. IP adresleri veya DNS adları, tüm ZooKeeper düğümlerinde aynı sırada listelenmelidir.

HOSTIP için, ZK_CLIENT_HOSTS için kullandığınız biçimi kullanın. Yani ZK_CLIENT_HOSTS için IP adresini belirtirseniz HOSTIP için bir IP adresi kullanın. DNS kullanıyorsanız her ikisi için de DNS adı kullanın.

Tek bir veri merkezi kurulumunda bunlar ZK_HOSTS tarafından belirtilen düğümlerle aynıdır.

Çoklu veri merkezi ortamında, bu veri merkezindeki yalnızca ZooKeeper düğümlerini listeleyin. Daha fazla bilgi için 12 ana makineli kümelenmiş yükleme sayfasına bakın.

CASS_CLUSTERNAME İsteğe bağlı olarak Cassandra kümesinin adını belirtin. Varsayılan ad "Apigee"dir.
CASS_HOSTS

Cassandra düğümlerinin ana makine IP adreslerinin (DNS adlarının değil) virgülle ayrılmış listesini ve isteğe bağlı olarak veri merkezi numaralarını ve ait oldukları rafı belirtir.

Üretim topolojileri için bu listede en az üç düğüm olmalıdır. İlk iki düğüm "kaynak sunucu" olarak kullanılır. Bu nedenle, IP adresleri tüm Cassandra düğümlerinde aynı sırada listelenmelidir.

Listedeki her bir girişin söz dizimi aşağıdaki gibidir:

IP_address[:data_center_number,rack_number]

Cassandra düğümleri isteğe bağlı olarak Cassandra düğümünün veri merkezini ve rafını belirtebilir. data_center_number değiştiricisini, yalnızca 12 ana makineli kurulumda açıklandığı gibi birden fazla veri merkezi oluştururken belirtin. Tek bir veri merkezi kurulumunda bu değiştiriciyi atlayın.

Örneğin "192.168.124.201:1,1 = veri merkezi 1 ve raf/kullanılabilirlik alt bölgesi 1 ve "192.168.124.204:2,1 = veri merkezi 2 ve raf/kullanılabilirlik alt bölgesi 1.

Çok veri merkezi kullanılan bir ortamda, güvenlik duvarı sorunlarının üstesinden gelmek için CASS_HOSTS, mevcut veri merkezinin düğümleri başa gelecek şekilde (yukarıdaki örnekte gösterildiği gibi) düzenlenmelidir. Daha fazla bilgi için 12 ana makineli kümelenmiş yükleme sayfasına bakın.

Cassandra ana makinesi için rack_number belirtme hakkında bilgi edinmek üzere Cassandra raf desteği ekleme bölümüne bakın.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

Cassandra kimlik doğrulamasını (CASS_AUTH=y) etkinleştirirseniz bu özellikleri kullanarak Cassandra kullanıcı adını ve şifresini geçirebilirsiniz.

Yükleme tamamlandıktan sonra Apigee, yapılandırma dosyasından şifreyi kaldırmanızı önerir.

CONFIG_DELTA_LOG

CONFIG_DELTA_LOG, yapılandırma dosyalarında yapılan değişikliklerin günlüğe nasıl kaydedileceğini kontrol eder. CONFIG_DELTA_LOG=y öğesini ayarlarsanız bir bileşen için yapılandırma değişiklikleri günlüğe kaydedilmez.

PG_USER
PG_PWD

Varsayılan olarak PostgreSQL veritabanında tanımlanmış iki kullanıcı bulunur: "postgres" ve 'Apigee'.

PG_USER, 'Apigee' kullanıcısının kullanıcı adını değiştirmenize izin verir. "Postgres" kullanıcısının adını değiştiremezsiniz.

Varsayılan olarak PostgreSQL veritabanı, tanımlanmış iki kullanıcı içerir: "postgres' ve 'apigee'. Her iki kullanıcı da varsayılan şifresi "postgres" olarak ayarlanmıştır. Yükleme sırasında her iki kullanıcı için farklı bir şifre belirlemek üzere PG_PWD kullanın.

Yükleme tamamlandıktan sonra Apigee, yapılandırma dosyasından şifreyi kaldırmanızı önerir.

PG_MASTER
PG_STANDBY

Postgres ana bekleme modunda çoğaltma işlevini şu biçimde etkinleştirecek şekilde ayarlayın:

PG_MASTER=IPorDNSofNewMaster
PG_STANDBY=IPorDNSofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

Edge'in kayıp şifreler ve diğer bildirimler için e-posta gönderebilmesi için SMTP'yi yapılandırın.

SMTP kullanıcı kimlik bilgileri gerekli değilse SMTPUSER ve SMTPPASSWORD parametrelerini atlayın.

SMTPMAILFROM gerekli.

CASS_JMX_USERNAME Cassandra JMX kullanıcı adı. Cassandra JMX kimlik doğrulamasını etkinleştirdiyseniz gereklidir.
CASS_JMX_PASSWORD Cassandra JMX şifresi. Cassandra JMX kimlik doğrulamasını etkinleştirdiyseniz gereklidir.
CASS_JMX_TRUSTSTORE Cassandra JMX SSL güven deposu kullanıcı adı (Cassandra'da SSL tabanlı JMX'i etkinleştirdiyseniz). JMX Truststore dosyası Apigee kullanıcısı tarafından okunabilmelidir.
CASS_JMX_TRUSTSTORE_PASS Cassandra JMX SSL güven deposu şifresi (Cassandra'da SSL tabanlı JMX'i etkinleştirdiyseniz).
QPID_MGMT_USERNAME
QPID_MGMT_PASSWORD
Bu kimlik bilgileri, Qpid aracısının Qpid Web Yönetim Konsolu'na erişim sağlar. Web Yönetim Konsolu, Qpid aracısının yönetimi ve denetimi için basit ve sezgisel bir arayüz sağlar.

Burada listelenen özelliklere ek olarak Apigee mTLS'yi yapılandırmak için de bazı özellikler bulunur. Daha fazla bilgi için Apigee mTLS'yi yapılandırma başlıklı makaleye bakın.