Edge Yapılandırma Dosyası Referansı

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 gerektiği gibi düzenleyin. -f seçeneğini kullanın setup.sh konumuna ekleyin. Her topolojiye özgü yapılandırma dosyası örnekleri için Edge bileşenlerini yükleme başlıklı makaleyi inceleyin.

    # 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
    

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

Cassandra ana makine tanımlarında yalnızca IP adreslerinin kullanıldığını, DNS adlarının kullanılamayacağını unutmayı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 "n"dir. kontrolü devre dışı bırakın.

ENABLE_DYNAMIC_HOSTIP

Bir sunucuda birden fazla arayüz kartı varsa "hostname -i" komutu, IP adreslerinin boşlukla ayrılmış bir 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, yapılandırma dosyası.

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.

Bu durumda USE_LDAP_REMOTE_HOST değerini y olarak ayarlayın. uzaktaki LDAP sunucusuna bağlanırsınız. OpenLDAP, Yönetim ile yüklenmedi Sunucu.

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

LDAP_TYPE
LDAP_SID
LDAP_PEER

Şunun için LDAP_TYPE=1 değerini ayarla: Çoğaltmasız OpenLDAP. LDAP_TYPE=2, kopyalama içeren OpenLDAP'a karşılık gelir.

Edge topolojinizde tek bir OpenLDAP sunucusu kullanılıyorsa 1 değerini belirtin. Edge'iniz birden fazla OpenLDAP düğümü kullanır. Örneğin, 13 düğümlü üretim kurulumunda belirtin 2.

Ç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.
  • LDAP_PEER=10.0.0.1: LDAP eşleğinin IP veya DNS adı.
MP_POD Mesaj İşleyici ve Yönlendirici kapsülünün adını belirtin. Ad varsayılan olarak olabilir.
REGION

Bölge adı. Kural olarak, adlar genellikle dc-# biçimindedir; burada # karşılık gelir. dönüştürülebilir. Örneğin, dc-1, dc-2 vb.. veri merkezi ortamı oluşturabilirsiniz.

Çoklu veri merkezi kurulumunda değer, bağlı olarak dc-1 veya dc-2'dir. yüklediğiniz veri merkezini seçin. Ancak, işletmenizde yalnızca adları içerir. Bölge için istediğiniz adı kullanabilirsiniz.

REGION_MAPPING

dc-1, dc-2 vb. dışında bölge adları kullanıyorsanız bu özelliği, bölge adınızı uygun dc-x biçimli bölge adıyla eşleyecek şekilde ayarlayın. Bu özellik, Cassandra verilerinin doğru şekilde kaydedilmesi için Yönetim sunucusu tarafından gereklidir veri merkezleri ve bölgelerine dayalı mağazaların ana hatlarıyla hizmet vermesi.

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 kullandığınız biçimin aynısını kullanın ZK_HOSTS. Yani, ZK_HOSTS için IP adresi belirtirseniz HOSTIP için bir IP adresi kullanın. DNS kullanıyorsanız ardından her ikisi için de DNS adı kullanın.

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

":observer" öğesini belirtin ZooKeeper düğümlerinde yalnızca 12 ana makineli yüklemede açıklandığı gibi birden fazla veri merkezi oluşturarak. Tek bir veride bu değiştiriciyi atlayın. Daha fazla bilgi için bkz. 12 ana makineli kümeli yükleme.

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 kullandığınız biçimin aynısını kullanın ZK_CLIENT_HOSTS. Yani, ZK_CLIENT_HOSTS için IP adresini belirtirseniz bir IP kullanın HOSTIP adresi. 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 bkz. 12 ana makineli kümeli yükleme.

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

Cassandra düğümlerinin virgülle ayrılmış listesini belirtir ana makine IP adresleri (DNS adları değil), ve isteğe bağlı olarak veri merkezi numarası ile raf oluşturmayı da gerektirir.

Üretim topolojilerinde bu listede en az üç düğüm olmalıdır. İlk olarak kullanılması gerekir. Bu nedenle, IP adreslerinin aynı sırada çalışır.

Listedeki her 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 oluştururken belirtin birden çok veri merkezi olduğunda (12 ana makineli yüklemede açıklandığı gibi) Tek bir veri merkezinde 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".

Çoklu veri merkezi ortamında, güvenlik duvarı sorunlarının üstesinden gelmek için CASS_HOSTS gerektiği şekilde (yukarıdaki örnekte gösterildiği gibi), mevcut akışın düğümlerinin en başa yerleştirilir. Daha fazla bilgi için 12 ana makineli kümelenmiş kurulum başlıklı makaleyi inceleyin.

Cassandra ana makinesi için rack_number belirtme hakkında bilgi edinmek üzere bkz. Cassandra raf desteği ekleyin.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

Cassandra kimlik doğrulamasını (CASS_AUTH=y) etkinleştirirseniz Cassandra kullanıcısını iletebilirsiniz. adını ve şifresini değiştirebilirsiniz.

Yükleme tamamlandıktan sonra Apigee, yapılandırma dosyası.

CONFIG_DELTA_LOG

CONFIG_DELTA_LOG, yapılandırma dosyalarındaki değişikliklerin nasıl kaydedileceğini kontrol eder. CONFIG_DELTA_LOG=y değerini belirlerseniz bir bileşenin yapılandırma değişiklikleri günlüğe kaydedilmez.

PG_USER
PG_PWD

PostgreSQL veritabanında varsayılan olarak 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. Yapamayacağınız işlemler: 'postgres' adını değiştir belirtir.

PostgreSQL veritabanında varsayılan olarak tanımlanmış iki kullanıcı vardır: "postgres" ve 'Apigee' ile birlikte çalışmalıdır. Her iki kullanıcının da varsayılan şifresi "postgres" şeklindedir. Şu ayarı yapmak için PG_PWD düğmesini kullanın: her iki kullanıcı için de farklı bir değere ayarlayacaktır.

Yükleme tamamlandıktan sonra Apigee, yapılandırma dosyası.

PG_MASTER
PG_STANDBY

Postgres ana-bekleme çoğaltmasını etkinleştirmek için şu ş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önderebileceği şekilde yapılandırın.

SMTP kullanıcı kimlik bilgileri gerekli değilse SMTPUSER ve SMTPPASSWORD öğelerini çıkarı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'da SSL tabanlı JMX'yi etkinleştirdiyseniz Cassandra JMX SSL güven mağazası kullanıcı adı. JMX Truststore dosyası, Apigee kullanıcısı tarafından okunabilmelidir.
CASS_JMX_TRUSTSTORE_PASS Cassandra'da SSL tabanlı JMX'yi etkinleştirdiyseniz Cassandra JMX SSL güven mağazası şifresi.
QPID_MGMT_USERNAME
QPID_MGMT_PASSWORD
Bu kimlik bilgileri, Qpid broker'ın Qpid Web Yönetim Konsolu'na erişim sağlar. Web Yönetim Konsolu, yönetim için basit ve sezgisel bir arayüz sağlar ve Qpid aracısının kontrolüne sahip olursunuz.
FIPS_OS Varsayılan değeri yanlış olan FIPS_OS doğru veya yanlış olabilir. FIPS özellikli işletim sistemlerinde Edge for Private Cloud 4.53.00 veya sonraki sürümleri için bunu doğru olarak ayarlayın.

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