Referensi File Konfigurasi Edge

Edge untuk Private Cloud v. 4.17.09

Berikut adalah contoh file konfigurasi senyap lengkap untuk penginstalan Edge 9 node. Edit file ini sesuai kebutuhan untuk konfigurasi Anda. Gunakan opsi -f untuk setup.sh agar menyertakan file ini. Juga ditampilkan di bawah adalah contoh file konfigurasi untuk setiap topologi Edge.

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

Tabel berikut berisi informasi tambahan tentang properti ini:

Properti

Catatan

Nama IP/DNS

Jangan gunakan pemetaan nama host ke 127.0.0.1 atau alamat IP 127.0.0.1 saat menentukan alamat IP node.

PERIKSA_SISTEM

Jika "y", pastikan sistem memenuhi persyaratan CPU dan memori untuk komponen yang sedang diinstal. Lihat Persyaratan Penginstalan untuk mengetahui persyaratan setiap komponen.

Nilai defaultnya adalah "n" untuk menonaktifkan pemeriksaan.

ENAM_DYNAMIC_HOSTIP

Jika server memiliki beberapa kartu antarmuka, perintah "nama host -i" akan menampilkan daftar alamat IP yang dipisahkan spasi. Secara default, penginstal Edge menggunakan alamat IP pertama yang ditampilkan, yang mungkin tidak benar dalam semua situasi. Sebagai alternatif, Anda dapat menetapkan properti berikut di file konfigurasi penginstalan.

Jika disetel ke "y", penginstal akan meminta Anda untuk memilih alamat IP yang akan digunakan dalam penginstalan. Nilai defaultnya adalah "n".

Perhatian: Jika Anda menetapkan ENABLE_DYNAMIC_HOSTIP=y, pastikan file properti Anda tidak menetapkan HOSTIP.

ADMIN_EMAIL
APIGEE_ADMINPW

Panjang sandi administrator sistem minimal harus 8 karakter dan terdiri dari satu huruf besar, satu huruf kecil, satu digit, atau satu karakter khusus. Jika menghilangkan sandi, Anda akan diminta untuk melakukannya.

Setelah penginstalan selesai, Apigee merekomendasikan agar Anda menghapus sandi dari file konfigurasi.

FILE_FILE

Lokasi file lisensi, yang harus dapat diakses oleh pengguna "apigee". Misalnya, simpan di direktori /tmp dan simpan chmod 777 di file. File akan disalin ke direktori penginstalan Edge.

APIGEE_LDAPPW

Menentukan sandi OpenLDAP.

Setelah penginstalan selesai, Apigee merekomendasikan agar Anda menghapus sandi dari file konfigurasi.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Jika USE_LDAP_REMOTE_HOST adalah n, Edge akan menginstal OpenLDAP secara otomatis saat menginstal Server Pengelolaan.

Tetapkan USE_LDAP_REMOTE_HOST ke y jika Anda terhubung ke server LDAP jarak jauh. OpenLDAP tidak diinstal dengan Server Pengelolaan.

Jika Anda terhubung ke server OpenLDAP jarak jauh, gunakan LDAP_HOST
dan LDAP_PORT untuk menentukan alamat IP atau nama DNS serta nomor port host.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Menyetel LDAP_TYPE=1 untuk OpenLDAP tanpa replikasi. LDAP_TYPE=2 sesuai dengan OpenLDAP dengan replikasi.

Jika topologi Edge Anda menggunakan satu server OpenLDAP, tentukan 1. Jika penginstalan Edge Anda menggunakan beberapa node OpenLDAP, seperti dalam penginstalan produksi 13 node, tentukan 2.

Jika Anda mengaktifkan replikasi, tetapkan properti berikut:

  • LDAP_SID=1 - ID Unik untuk server LDAP ini. Setiap node LDAP menggunakan ID yang berbeda. Misalnya, tetapkan ke 2 untuk peer LDAP.
  • LDAP_PEER=10.0.0.1 - Nama IP atau DNS dari peer LDAP.

POD_MP

Tentukan nama pod Prosesor Pesan dan Router. Secara default, nama ini adalah gateway.

REGION

Nama region. Berdasarkan konvensi, nama biasanya dalam bentuk dc-# dengan # sesuai dengan nilai bilangan bulat. Misalnya, dc-1, dc-2, dll. Anda dapat menggunakan dc-1 kecuali jika menginstalnya di lingkungan pusat multi-data.

Di beberapa penginstalan pusat data, nilainya adalah dc-1, atau dc-2, dll., bergantung pada pusat data yang Anda instal. Namun, Anda tidak dibatasi untuk hanya menggunakan nama dalam bentuk dc-#. Anda dapat menggunakan nama apa pun untuk wilayah tersebut.

ZK_HOSTS

Alamat IP atau nama DNS node ZooKeeper. Alamat IP atau nama DNS harus tercantum dalam urutan yang sama pada semua node ZooKeeper.

Dalam lingkungan pusat multi-data, cantumkan semua node ZooKeeper dari kedua pusat data.

Tentukan pengubah “:observer” hanya di node ZooKeeper saat membuat beberapa pusat data seperti yang dijelaskan dalam penginstalan 12 host. Dalam satu penginstalan pusat data, hapus pengubah tersebut. Lihat "Penginstalan yang dikelompokkan 12 host" di Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.

ZK_CLIENT_HOSTS

Alamat IP atau nama DNS node ZooKeeper yang digunakan oleh pusat data ini. Alamat IP atau nama DNS harus tercantum dalam urutan yang sama pada semua node ZooKeeper.

Dalam satu penginstalan pusat data, ini adalah node yang sama seperti yang ditentukan oleh ZK_HOSTS.

Dalam lingkungan pusat multi-data, hanya cantumkan node ZooKeeper di pusat data ini. Lihat "Penginstalan yang dikelompokkan 12 host" di Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.

CASS_CLUSTERNAME Secara opsional, buat nama cluster cluster Cassandra. Nama defaultnya adalah "Apigee".

HOSTING CASS

Alamat IP (bukan nama DNS) node Cassandra. Dua node pertama akan digunakan sebagai server bibit. Alamat IP harus dicantumkan dalam urutan yang sama pada semua node Cassandra.

Node Cassandra dapat memiliki akhiran “:dc,ra” opsional yang menentukan pusat data dan rak node Cassandra. Tentukan pengubah ini hanya saat membuat beberapa pusat data seperti yang dijelaskan dalam penginstalan 12 host. Dalam satu penginstalan pusat data, hapus pengubah tersebut.

Misalnya '192.168.124.201:1,1 = datacenter 1 dan rak/zona ketersediaan 1, serta '192.168.124.204:2,1 = datacenter 2 dan rak/zona ketersediaan 1.

Dalam lingkungan multi-datacenter, untuk mengatasi masalah firewall, CASS_HOSTS harus diurutkan dengan cara tertentu (seperti yang ditunjukkan pada contoh di atas) sehingga node pusat data saat ini ditempatkan di awal. Lihat "Penginstalan yang dikelompokkan 12 host" di Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.

CASS_AUTH
CASS_NAMA PENGGUNA

CASS_PASSWORD

Jika mengaktifkan autentikasi Cassandra, CASS_AUTH=y, Anda dapat meneruskan nama pengguna dan sandi Cassandra menggunakan properti ini.

Setelah penginstalan selesai, Apigee merekomendasikan agar Anda menghapus sandi dari file konfigurasi.

PG_USER
PG_PWD

Secara default, database PostgreSQL memiliki dua pengguna yang ditentukan: 'postgres' dan 'apigee'.

PG_USER memungkinkan Anda mengubah nama pengguna milik pengguna 'apigee'. Anda tidak dapat mengubah nama pengguna 'postgres'.

Kedua pengguna memiliki sandi default 'postgres'. Gunakan PG_PWD untuk menetapkan sandi ke nilai yang berbeda bagi kedua pengguna saat penginstalan.

Setelah penginstalan selesai, Apigee merekomendasikan agar Anda menghapus sandi dari file konfigurasi.

PG_MASTER

PG_KERJA

Setel untuk mengaktifkan replikasi standby master Postgres, dalam bentuk:

PG_MASTER=IPorDNSofNewMaster

PG_standBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPEMAILFROM

Konfigurasikan SMTP, Edge dapat mengirim email untuk sandi yang hilang dan notifikasi lainnya.

Jika kredensial pengguna SMTP tidak diperlukan, hapus SMTPUSER dan SMTPPASSWORD.

SMTPEMAILFROM wajib diisi.