Referensi File Konfigurasi Edge

Edge for Private Cloud v. 4.17.01

Berikut adalah contoh file konfigurasi senyap lengkap untuk penginstalan Edge 9 node. Edit file ini sesuai kebutuhan untuk konfigurasi Anda. Gunakan opsi -f ke setup.sh untuk menyertakan file ini. Di bawah ini juga ditunjukkan 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)

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

BIND_ON_ALL_INTERFACES=y 

# 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 addresses (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=

# Set Postgres password. Default is postgres.
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.

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.

ADMIN_EMAIL
APIGEE_ADMINPW

Sandi administrator sistem harus memiliki minimal 8 karakter dan berisi satu huruf besar, satu huruf kecil, satu angka, atau satu karakter khusus. Jika Anda menghapus sandi, Anda akan diminta untuk memasukkannya.

LICENSE_FILE

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

APIGEE_LDAPPW

Menentukan sandi OpenLDAP.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Jika USE_LDAP_REMOTE_HOST adalah n, Edge akan otomatis menginstal OpenLDAP 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 dan nomor port host.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Tetapkan 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 peer LDAP.

BIND_ON_ALL_INTERFACES

Jika disetel ke "y", Router/Message Processor akan mengikat (mendengarkan) di semua antarmuka (IP). Jika ditetapkan ke “n”, Router/Pemroses Pesan akan melakukan binding (proses) pada antarmuka tertentu, IP yang ditampilkan oleh perintah "hostname -i").

MP_POD

Tentukan nama pod Message Processor dan Router. Secara default, namanya adalah gateway.

REGION

Nama wilayah. 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 menginstal di lingkungan multi-pusat data.

Dalam penginstalan beberapa data center, nilainya adalah dc-1, atau dc-2, dll., bergantung pada data center 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 dicantumkan dalam urutan yang sama di semua node ZooKeeper.

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

Tentukan pengubah “:observer” di node ZooKeeper hanya saat membuat beberapa pusat data seperti yang dijelaskan dalam penginstalan 12 host. Dalam satu penginstalan pusat data, hapus pengubah tersebut.

ZK_CLIENT_HOSTS

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

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

Dalam lingkungan multi-pusat data, hanya cantumkan node ZooKeeper di pusat data ini.

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

CASS_HOSTS

Alamat IP (bukan nama DNS) dari node Cassandra. Dua node pertama akan digunakan sebagai server seed. Alamat IP harus dicantumkan dalam urutan yang sama di 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 = pusat data 1 dan rak/zona ketersediaan 1, dan '192.168.124.204:2,1 = pusat data 2 dan rak/zona ketersediaan 1.

Dalam lingkungan multi-pusat data, untuk mengatasi masalah firewall, CASS_HOSTS harus diurutkan dengan cara (seperti yang ditunjukkan pada contoh di atas) sehingga node pusat data saat ini ditempatkan di awal.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

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

PG_PWD

Secara default, database PostgreSQL memiliki dua pengguna yang ditentukan: 'postgres' dan 'apigee'. Kedua pengguna memiliki sandi default 'postgres'. Gunakan PG_PWD untuk menetapkan sandi ke nilai yang berbeda untuk kedua pengguna pada waktu penginstalan.

PG_MASTER

PG_STANDBY

Tetapkan untuk mengaktifkan replikasi master-standby Postgres, dalam bentuk:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

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

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