Referensi File Konfigurasi Edge

Edge for Private Cloud v4.19.01

Di bawah ini adalah contoh file konfigurasi senyap lengkap untuk 9 node Edge penginstalan. Edit file ini seperlunya untuk konfigurasi Anda. Gunakan opsi -f ke setup.sh untuk menyertakan file ini. Untuk contoh file konfigurasi yang spesifik untuk setiap topologi. Lihat Instal komponen 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. 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=IPofNewMaster
# PG_STANDBY=IPofOldMaster

# 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 {i>host<i} ke 127.0.0.1 atau alamat IP 127.0.0.1 saat yang menentukan alamat IP {i>node<i}.
ENABLE_SYSTEM_CHECK

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

Nilai defaultnya adalah "n" untuk menonaktifkan pemeriksaan.

ENABLE_DYNAMIC_HOSTIP

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

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

ADMIN_EMAIL
APIGEE_ADMINPW

Sandi administrator sistem harus minimal 8 karakter dan berisi satu karakter huruf besar, satu huruf kecil, satu angka, atau satu karakter khusus. Jika Anda menghilangkan {i>password<i}, Anda akan diminta untuk memasukkannya.

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

LICENSE_FILE

Lokasi file lisensi, yang harus dapat diakses oleh "apigee" . Sebagai contoh, simpan dalam direktori /tmp dan chmod 777 pada file tersebut. File berhasil 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 secara otomatis menginstal OpenLDAP saat menginstal Server Pengelolaan.

Setel USE_LDAP_REMOTE_HOST ke y jika Anda menghubungkan ke server LDAP jarak jauh. OpenLDAP tidak diinstal di bagian Pengelolaan Server.

Jika Anda terhubung ke server OpenLDAP jarak jauh, gunakan LDAP_HOST dan LDAP_PORT untuk menentukan alamat IP atau nama DNS dan nomor porta {i>host<i}.

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 Edge Anda instalasi menggunakan beberapa {i>node<i} OpenLDAP, seperti dalam instalasi produksi 13 {i>node<i}, menentukan 2.

Jika Anda mengaktifkan replikasi, tetapkan properti berikut:

  • LDAP_SID=1 - Unik ID 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.
MP_POD Tentukan nama pod Message Processor dan Router. Secara {i>default<i}, nama ini adalah gateway.
REGION

Nama wilayah. Berdasarkan konvensi, nama biasanya dalam bentuk dc-# dengan # bersesuaian menjadi nilai bilangan bulat. Misalnya, dc-1, dc-2, dll. Anda dapat menggunakan dc-1 kecuali menginstal di lingkungan multi-pusat data.

Dalam beberapa penginstalan pusat data, nilainya adalah dc-1, atau dc-2, dll. bergantung pada pusat data mana yang sedang 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 {i>node<i} ZooKeeper. Alamat IP atau nama DNS harus tercantum dalam urutan yang sama di semua node ZooKeeper.

Gunakan format yang sama untuk HOSTIP seperti yang Anda gunakan untuk ZK_HOSTS. Artinya, jika Anda tentukan alamat IP untuk ZK_HOSTS gunakan alamat IP untuk HOSTIP. Jika Anda menggunakan DNS, kemudian menggunakan nama DNS untuk keduanya.

Dalam lingkungan multi-pusat data, buat daftar semua node ZooKeeper dari kedua data Google.

Tentukan ":observer" pada node ZooKeeper, hanya saat membuat beberapa pusat data seperti yang dijelaskan dalam penginstalan 12 host. Dalam satu data instalasi pusat, hilangkan pengubah itu. Untuk informasi selengkapnya, lihat Penginstalan dengan cluster 12 host.

ZK_CLIENT_HOSTS

Alamat IP atau nama DNS node ZooKeeper yang digunakan oleh pusat data ini. IP alamat atau nama DNS harus tercantum dalam urutan yang sama pada semua {i>node<i} ZooKeeper.

Gunakan format yang sama untuk HOSTIP seperti yang Anda gunakan untuk ZK_CLIENT_HOSTS. Yaitu, jika Anda menentukan alamat IP untuk ZK_CLIENT_HOSTS, gunakan IP untuk HOSTIP. Jika Anda menggunakan DNS, lalu menggunakan nama DNS untuk keduanya.

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

Dalam lingkungan multi-pusat data, cantumkan hanya node ZooKeeper di pusat data ini. Untuk informasi selengkapnya, lihat Penginstalan dengan cluster 12 host.

CASS_CLUSTERNAME (Opsional) Tentukan nama gugus Cassandra. Nama defaultnya adalah "Apigee".
CASS_HOSTS

Alamat IP (bukan nama DNS) dari node Cassandra. Dua {i>node<i} pertama akan digunakan sebagai server seed. Alamat IP harus tercantum dalam urutan yang sama di semua Cassandra node.

Node Cassandra dapat memiliki ":dc,ra" opsional akhiran yang menentukan pusat data dan rak {i>node<i} Cassandra. Tentukan pengubah ini hanya saat membuat beberapa pusat data seperti yang dijelaskan dalam instalasi 12-host. Dalam satu pusat data penginstalan, hapus pengubah tersebut.

Misalnya '192.168.124.201:1,1 = pusat data 1 dan zona rak/ketersediaan 1, dan '192.168.124.204:2,1 = pusat data 2 dan zona rak/ketersediaan 1.

Di lingkungan multi-pusat data, untuk mengatasi masalah {i>firewall<i}, CASS_HOSTS harus diurutkan dengan cara (seperti yang ditunjukkan di contoh di atas) sedemikian rupa sehingga {i>node<i} dari aliran pusat data ditempatkan di awal. Untuk informasi selengkapnya, lihat Penginstalan dengan cluster 12 host.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

Jika mengaktifkan autentikasi Cassandra, CASS_AUTH=y, Anda dapat meneruskan pengguna Cassandra nama dan {i>password<i} dengan 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 'apigee' . Anda tidak dapat ganti nama 'postgres' .

Secara default, database PostgreSQL memiliki dua pengguna yang ditentukan: 'postgres' dan 'apigee'. Kedua pengguna memiliki sandi default 'postgres'. Gunakan PG_PWD untuk menyetel {i>password<i} ke nilai yang berbeda untuk kedua pengguna saat menginstal.

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

PG_MASTER
PG_STANDBY

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

PG_MASTER=IPofNewMaster
PG_STANDBY=IPofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

SMTPMAILFROM wajib diisi.

Selain properti yang tercantum di sini, ada juga properti untuk mengonfigurasi Apigee mTLS. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi mTLS Apigee.