Edge Yapılandırma Dosyası Referansı

Edge for Private Cloud 4.18.01 sürümü

Aşağıda, 9 düğümlü bir Edge kurulumu için eksiksiz bir sessiz yapılandırma dosyası örneği gösterilmektedir. Bu dosyayı yapılandırmanız için gerektiği şekilde düzenleyin. Bu dosyayı eklemek için setup.sh -f seçeneğini kullanın. Ayrıca, her Edge topolojisi için örnek yapılandırma dosyaları da aşağıda gösterilmiştir.

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

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

Aşağıdaki tabloda bu özellikler hakkında ek bilgiler yer almaktadır:

Mülk Not
IP/DNS adları Bir düğümün IP adresini belirtirken 127.0.0.1 ile eşlenen bir ana makine adı veya 127.0.0.1 IP adresi kullanmayın.
ENABLE_SYSTEM_CHECK

"y" ise sistemin, yüklenen bileşen için CPU ve bellek gereksinimlerini karşılayıp karşılamadığını kontrol edin. Her bileşenin gereksinimleri için Kurulum Gereksinimleri bölümü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 "hostname -i" komutu, boşlukla ayrılmış bir IP adresi listesi 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" olarak ayarlandığında yükleyici, yükleme sırasında kullanılacak IP adresini seçmenizi ister. Varsayılan değer "n"dir.

ADMIN_EMAIL
APIGEE_ADMINPW

Sistem yöneticisinin ş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 şifre girmeniz istenir.

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

LICENSE_FILE

Lisans dosyasının konumu. Bu konuma "apigee" kullanıcısı tarafından erişilebilmelidir. Örneğin, dosyayı /tmp dizininde depolayın ve dosyada chmod 777 komutunu çalıştırın. Dosya, Edge kurulum dizinine kopyalanır.

APIGEE_LDAPPW

OpenLDAP şifresini belirtir.

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

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

USE_LDAP_REMOTE_HOST n ise Edge, Yönetim Sunucusu'nu yüklerken 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 birlikte yüklenmez.

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

LDAP_TYPE
LDAP_SID
LDAP_PEER

Replika içermeyen OpenLDAP için LDAP_TYPE=1 değerini ayarlayın. LDAP_TYPE=2, replikasyonlu OpenLDAP'ye karşılık gelir.

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

Kopyalamayı 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 İşleyici ve Yönlendirici kapsülünün adını belirtin. Varsayılan olarak ad, gateway'dir.
REGION

Bölge adı. Kural olarak, adlar genellikle dc-# biçimindedir. Burada #, bir tam sayı değerine karşılık gelir. Örneğin, dc-1, dc-2 vb. Çoklu veri merkezi ortamına yükleme yapmıyorsanız dc-1'i kullanabilirsiniz.

Birden fazla veri merkezi kurulumunda değer, hangi veri merkezini kurduğunuza bağlı olarak dc-1 veya dc-2 vb. olur. Ancak yalnızca dc-# biçimindeki adları kullanmak zorunda değilsiniz. Bölge için istediğiniz adı kullanabilirsiniz.

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 ile aynı 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.

":observer" değiştiricisini ZooKeeper düğümlerinde yalnızca 12 ana makine kurulumunda açıklandığı gibi birden fazla veri merkezi oluştururken belirtin. Tek bir veri merkezi kurulumunda bu değiştiriciyi atlayın. Daha fazla bilgi için 12 ana makine kümelenmiş yükleme başlıklı makaleyi inceleyin.

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 ile aynı 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, yalnızca bu veri merkezindeki ZooKeeper düğümlerini listeleyin. Daha fazla bilgi için 12 ana makine kümelenmiş yükleme başlıklı makaleyi inceleyin.

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

Cassandra düğümlerinin IP adresleri (DNS adları değil). İlk iki düğüm, temel sunucu olarak kullanılır. IP adresleri, tüm Cassandra düğümlerinde aynı sırada listelenmelidir.

Cassandra düğümleri, Cassandra düğümünün veri merkezini ve rafını belirten isteğe bağlı bir ":dc,ra" son ekine sahip olabilir. Bu değiştiriciyi yalnızca 12 ana makine kurulumunda 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 bölgesi 1 ve "192.168.124.204:2,1 = veri merkezi 2 ve raf/kullanılabilirlik bölgesi 1.

Çoklu veri merkezi ortamında, güvenlik duvarı sorunlarını aşmak için CASS_HOSTS, mevcut veri merkezinin düğümleri en başta yer alacak şekilde sıralanmalıdır (yukarıdaki örnekte gösterildiği gibi). Daha fazla bilgi için 12 ana makine kümelenmiş yükleme başlıklı makaleyi inceleyin.

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

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

PG_USER
PG_PWD

Varsayılan olarak PostgreSQL veritabanında iki kullanıcı tanımlanmıştır: "postgres" ve "apigee".

PG_USER, "apigee" kullanıcısının kullanıcı adını değiştirmenize olanak tanır. "postgres" kullanıcısının adını değiştiremezsiniz.

Varsayılan olarak, PostgreSQL veritabanında tanımlanmış iki kullanıcı vardır: "postgres" ve "apigee". Her iki kullanıcının da varsayılan şifresi "postgres"tir. Yükleme sırasında her iki kullanıcının şifresini farklı bir değere ayarlamak için PG_PWD kullanın.

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

PG_MASTER
PG_STANDBY

Postgres ana-yedek replikasyonunu etkinleştirmek için şu biçimde 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 amacıyla SMTP'yi yapılandırın.

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

SMTPMAILFROM gereklidir.