Halaman ini diterjemahkan oleh Cloud Translation API.

Menginstal komponen Edge pada node

Edge for Private Cloud v. 4.16.05

Setelah Anda menginstal utilitas apigee-setup Edge pada node, gunakan utilitas apigee-setup untuk menginstal satu atau beberapa komponen Edge pada node.

Utilitas apigee-setup menggunakan perintah dalam bentuk:

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

dengan komponen adalah komponen Edge yang akan diinstal, dan configFile adalah file konfigurasi senyap yang berisi penginstalan tidak akurat atau tidak sesuai. File konfigurasi harus dapat diakses atau dibaca oleh "apigee" . Sebagai misalnya, letakkan file di direktori {i> /tmp<i} pada {i>node<i}.

Misalnya, untuk menginstal Server Pengelolaan Edge:

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/myConfig

Pertimbangan penginstalan

Saat Anda menulis file konfigurasi, pertimbangkan opsi berikut.

Menyiapkan Postgres replikasi master-standby

Secara default, Edge menginstal semua node Postgres dalam mode master. Namun, dalam sistem produksi dengan beberapa node Postgres, Anda harus mengonfigurasinya untuk menggunakan replikasi master-standby sehingga jika node master gagal, node standby dapat terus menyalurkan traffic.

Anda dapat mengaktifkan dan mengonfigurasi replikasi master-standby pada waktu penginstalan menggunakan properti dalam file konfigurasi senyap. Atau, Anda dapat mengaktifkan replikasi master-standby setelah penginstalan. Sebagai selengkapnya, lihat Menyiapkan Master-Standby Replikasi untuk Postgres.

Mengaktifkan Cassandra autentikasi

Secara default, Cassandra menginstal tanpa mengaktifkan autentikasi. Itu berarti siapa pun dapat mengakses Cassandra. Anda dapat mengaktifkan autentikasi setelah menginstal Edge, atau sebagai bagian dari penginstalan {i>checkout<i}.

Anda dapat mengaktifkan autentikasi Cassandra sebagai waktu penginstalan menggunakan properti di mode senyap file konfigurasi. Atau, Anda dapat mengaktifkannya setelah penginstalan.

Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan Cassandra autentikasi.

Mengikat {i>Router<i} ke port yang dilindungi

Jika Anda ingin mengikat Router ke port yang dilindungi, seperti nomor port kurang dari 1024, maka Anda harus mengkonfigurasi {i>Router<i} untuk dijalankan sebagai pengguna dengan akses ke porta tersebut. Secara default, Router berjalan sebagai pengguna "apigee" yang tidak memiliki akses ke porta yang dilindungi.

Untuk menjalankan Router sebagai pengguna yang berbeda:

Sebagai root, buat file /opt/apigee/etc/edge-router.d/RUN_USER.sh.
Tambahkan entri berikut ke file:
RUN_USER=root
Jika Anda tidak ingin menjalankan Router sebagai root, tentukan pengguna yang memiliki akses ke port.
Simpan file.
Jika Anda menentukan pengguna selain root, ubah pemilik file menjadi pengguna tersebut:
> anak ayam PENGGUNA:PENGGUNA /opt/apigee/etc/edge-router.d/RUN_USER.sh
Mulai ulang router:
> /opt/apigee/apigee-service/bin/apigee-service edge-router mulai ulang

Menentukan komponen yang akan diinstal

Tabel berikut mencantumkan opsi yang Anda teruskan ke opsi -p pada utilitas apigee-service untuk menentukan komponen yang akan diinstal pada node:

Komponen	Deskripsi
c	Instal Cassandra saja.
zk	hanya menginstal ZooKeeper.
ds	Instal ZooKeeper dan Cassandra.
ld	Hanya instal OpenLDAP.
md	Instal Edge Management Server, yang juga menginstal UI Edge dan OpenLDAP. Jika Anda menyetel USE_LDAP_REMOTE_HOST=y di konfigurasi file, maka penginstalan OpenLDAP dilewati dan Server Manajemen menggunakan OpenLDAP yang diinstal pada {i>node<i} yang berbeda.
r	Instal Edge Router saja.
mp	Hanya instal Edge Message Processor.
rmp	Instal Edge Router dan Message Processor.
ui	Instal UI Edge.
qs	Hanya instal Server Qpid.
ps	Instal Server Postgres saja.
saksofon	Menginstal komponen analisis, yaitu Qpid dan Postgres. Gunakan opsi ini hanya untuk pengembangan dan pengujian, bukan untuk produksi.
bln	Instal Monetisasi.
sa	Instal Edge mandiri, yang berarti Cassandra, ZooKeeper, Management Server, OpenLDAP, UI Edge, Router, dan Pemroses Pesan. Opsi ini menghilangkan komponen analisis Edge: Qpid dan Postgres. Gunakan opsi ini hanya untuk pengembangan dan pengujian, bukan untuk produksi.
AIO	Menginstal semua komponen pada satu node. Gunakan opsi ini hanya untuk pengembangan dan pengujian, bukan untuk produksi.

Membuat file konfigurasi

File konfigurasi berisi semua informasi yang diperlukan untuk menginstal Edge. Anda sering kali dapat menggunakan file konfigurasi yang sama untuk menginstal semua komponen dalam penginstalan Edge.

Namun, Anda harus menggunakan file konfigurasi yang berbeda, atau mengubah file konfigurasi, jika:

Anda menginstal beberapa server OpenLDAP dan perlu mengonfigurasi replikasi sebagai bagian dari penginstalan 13 node. Setiap file memerlukan nilai yang berbeda untuk LDAP_SID dan LDAP_PEER.
Anda membuat beberapa pusat data sebagai bagian dari penginstalan 12 node. Setiap pusat data memerlukan setelan yang berbeda untuk properti seperti ZK_CLIENT_HOSTS dan CASS_HOSTS.

Contoh file konfigurasi

Berikut adalah contoh file konfigurasi senyap lengkap untuk penginstalan Edge 9 node. Edit file ini seperlunya untuk konfigurasi Anda. Gunakan opsi -f untuk setup.sh agar dapat menyertakan file ini. Juga ditampilkan di bawah ini 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)

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

# 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 {i>host<i} ke 127.0.0.1 atau alamat IP 127.0.0.1 saat yang menentukan alamat IP {i>node<i}.
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.
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.
USE_LDAP_REMOTE_HOST LDAP_HOST LDAP_PORT	Jika USE_LDAP_REMOTE_HOST adalah n, Edge akan otomatis menginstal OpenLDAP saat diinstal di Server Pengelolaan. Atur USE_LDAP_REMOTE_HOST ke y jika Anda tersambung 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 {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 - 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.
BIND_ON_ALL_INTERFACES	Jika ditetapkan ke "y" kemudian Router/Message Processor mengikat (mendengarkan) pada semua antarmuka (IP). Jika ditetapkan ke “n”, Router/Pemroses Pesan akan mengikat (memproses) pada antarmuka, IP yang dikembalikan oleh " {i>host<i} -i" ).
MP_POD	Tentukan nama pod Message Processor dan Router. Secara {i>default<i}, namanya adalah gateway.
WILAYAH	Nama wilayah. Berdasarkan konvensi, nama biasanya dalam bentuk dc-# dengan # sesuai menjadi nilai bilangan bulat. Misalnya, dc-1, dc-2, dll. Anda dapat menggunakan dc-1 kecuali 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 hanya dibatasi untuk menggunakan nama dalam bentuk dc-#. Anda dapat menggunakan nama apa pun untuk region.
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. Dalam lingkungan multi-pusat data, buat daftar semua node ZooKeeper dari kedua data Google. Menentukan pengubah “:observer” pada node ZooKeeper hanya jika membuat beberapa pusat data seperti yang dijelaskan dalam penginstalan 12 host. Dalam satu data instalasi pusat, hilangkan pengubah itu. Lihat 12 host yang dikelompokkan penginstalan untuk mengetahui lebih banyak lagi.
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 ditentukan oleh ZK_HOSTS. Dalam lingkungan multi-pusat data, cantumkan hanya node ZooKeeper di pusat data ini. Lihat 12 host yang dikelompokkan penginstalan untuk mengetahui lebih banyak lagi.
CASS_HOSTS	Alamat IP (bukan nama DNS) dari node Cassandra. Dua node pertama akan digunakan sebagai server seed. Alamat IP harus tercantum dalam urutan yang sama di semua Cassandra node. Node Cassandra dapat memiliki akhiran “:dc,ra” opsional 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 penginstalan pusat data, 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. Lihat 12 host yang dikelompokkan penginstalan untuk mengetahui lebih banyak lagi.
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.
PG_MASTER PG_STANDBY	Ditetapkan untuk mengaktifkan replikasi master-standby Postgres, dalam bentuk: PG_MASTER=*IPorDNSofNewMaster* PG_STANDBY=*IPorDNSofOldMaster*
SKIP_SMTP HOST SMTP SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT	Konfigurasi SMTP agar Edge dapat mengirim email untuk sandi yang hilang dan notifikasi lainnya. Jika kredensial pengguna SMTP tidak diperlukan, hapus SMTPUSER dan SMTPPASSWORD.

Urutan pemasangan komponen

Urutan penginstalan komponen didasarkan pada topologi yang diinginkan.

Semua contoh penginstalan yang ditampilkan di bawah mengasumsikan bahwa Anda menginstal:

Dengan autentikasi Cassandra dinonaktifkan (default). Lihat Mengaktifkan autentikasi Cassandra untuk mengetahui informasi selengkapnya.
Dengan replikasi master-standby Postgres dinonaktifkan (default). Lihat Menyiapkan Replikasi Standby Master untuk Postgres untuk informasi selengkapnya.
Pemroses dan Router Pesan di node yang sama. Jika Anda menginstal Message Processor dan Router di node yang berbeda, instal semua Message Processor terlebih dahulu, lalu semua Router.

File log penginstalan

Secara default, utilitas setup.sh menulis informasi log tentang penginstalan ke:

/opt/apigee/var/log/apigee-setup/setup.log

Jika pengguna yang menjalankan utilitas setup.sh tidak memiliki akses ke server tersebut akan menulis log ke direktori /tmp sebagai file bernama setup_username.log.

Jika pengguna tidak memiliki akses ke /tmp, utilitas setup.sh akan gagal.