Edge Yapılandırma Dosyası Referansı

Private Cloud için Edge v4.18.05

Aşağıda, 9 düğümlü bir Edge kurulumu için tam sessiz yapılandırma dosyası örneği verilmiştir. Bu dosyayı yapılandırmanıza göre düzenleyin. Bu dosyayı eklemek için -f seçeneğini setup.sh olarak kullanın. Aşağıda, her Edge topolojisi için örnek yapılandırma dosyaları da verilmiş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.

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

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 ana makine adı eşlemesi veya 127.0.0.1 bir IP adresi kullanmayın.
ENABLE_SYSTEM_CHECK

"y" ise sistemin, yüklenen bileşenin CPU ve bellek gereksinimlerini karşılayıp karşılamadığını kontrol edin. Her bileşenin gereksinimleri için Yükleme Koşulları'na bakın.

Varsayılan değer, kontrolü devre dışı bırakmak için "n"dir.

ENABLE_DYNAMIC_HOSTIP

Bir sunucuda birden fazla arayüz kartı varsa "ana makine adı -i" komutu, IP adreslerinin boşlukla ayrılmış listesini döndürür. Edge yükleyicisi varsayılan olarak 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, kurulumda 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 sizden istenir.

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

LICENSE_FILE

"apigee" kullanıcısının erişebilmesi gereken lisans dosyasının konumu. Örneğin, dosyayı /tmp dizininde saklayın ve dosyaya chmod 777 uygulayın. Dosya, Edge yükleme dizinine kopyalanır.

APIGEE_LDAPPW

OpenLDAP şifresini belirtir.

Yükleme tamamlandıktan sonra Apigee, ş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'ı otomatik olarak yükler.

Uzaktan bir LDAP sunucusuna bağlanıyorsanız USE_LDAP_REMOTE_HOST değerini y olarak ayarlayın. OpenLDAP, Yönetim Sunucusu ile yüklenmemişse

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 karakterlerini kullanın.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Kopyalama içermeyen OpenLDAP için LDAP_TYPE=1 değerini ayarlayın. LDAP_TYPE=2, kopyalama içeren OpenLDAP'a 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.

Ç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şlemesi için 2 olarak ayarlayın.
  • LDAP_PEER=10.0.0.1: LDAP eşleğinin IP veya DNS adı.
MP_POD Mesaj İşleyen ve Yönlendirici kapsülünün adını belirtin. Varsayılan ad, ağ geçididir.
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üklemediğiniz sürece dc-1'i kullanabilirsiniz.

Birden fazla veri merkezi kurulumunda, hangi veri merkezine yüklediğinize bağlı olarak değer dc-1 veya dc-2 vb. olur. Ancak yalnızca dc-# biçiminde 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ırayla 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.

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

Yalnızca 12 ana makineli yüklemede açıklandığı gibi birden fazla veri merkezi oluştururken ZooKeeper düğümlerinde ":observer" değiştiricisini belirtin. Tek bir veri merkezi kurulumunda bu değiştiriciyi atlayın. Daha fazla bilgi için 12 ana makineli kümelenmiş kurulum 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ırayla listelenmelidir.

HOSTIP için ZK_CLIENT_HOSTS ile aynı biçimi kullanın. Yani, ZK_CLIENT_HOSTS için IP adresi 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üğümlerdir.

Çok veri merkezi ortamında, yalnızca bu veri merkezindeki ZooKeeper düğümlerini listeleyin. Daha fazla bilgi için 12 ana makineli kümelenmiş kurulum 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, ana sunucu olarak kullanılır. IP adresleri, tüm Cassandra düğümlerinde aynı sırayla listelenmelidir.

Cassandra düğümlerinde, Cassandra düğümünün veri merkezini ve rafını belirten isteğe bağlı bir ":dc,ra" son eki bulunabilir. Bu değiştiriciyi yalnızca 12 ana makineli kurulumda açıklandığı şekilde birden fazla veri merkezi oluştururken belirtin. Tek bir veri merkezi yüklemesinde bu değiştiriciyi atlayın.

Örneğin, "192.168.124.201:1, 1 = veri merkezi 1 ve raf/kullanıma hazır bölge 1" ve "192.168.124.204:2,1 = veri merkezi 2 ve raf/kullanıma hazır bölge 1".

Çok veri merkezi ortamında, güvenlik duvarı sorunlarını önlemek için CASS_HOSTS'ın, mevcut veri merkezinin düğümlerinin başa yerleştirileceği şekilde (yukarıdaki örnekte gösterildiği gibi) sıralanması gerekir. Daha fazla bilgi için 12 ana makineli kümelenmiş kurulum başlıklı makaleyi inceleyin.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

Cassandra kimlik doğrulamasını, CASS_AUTH=y'yi etkinleştirirseniz bu özellikleri kullanarak Cassandra kullanıcı adını ve şifresini iletebilirsiniz.

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

PG_USER
PG_PWD

Varsayılan olarak PostgreSQL veritabanında tanımlanmış iki kullanıcı vardı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.

PostgreSQL veritabanında varsayılan olarak iki kullanıcı tanımlanır: "postgres" ve "apigee". Her iki kullanıcının da varsayılan şifresi "postgres" şeklindedir. Yükleme sırasında şifreyi her iki kullanıcı için de farklı bir değere ayarlamak üzere PG_PWD değerini kullanın.

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

PG_MASTER
PG_STANDBY

Postgres ana-bekleme çoğaltmasını etkinleştirmek için aşağıdaki şekilde ayarlayın:

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

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

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

SMTPMAILFROM gerekli.