Ringkasan Pemasangan Edge

Penginstalan Edge yang umum terdiri dari komponen Edge yang didistribusikan di beberapa node. Setelah menginstal Edge di node, Anda kemudian menginstal dan mengonfigurasi satu atau beberapa komponen Edge di node.

Proses penginstalan

Menginstal Edge di node adalah proses multi-langkah:

1. Nonaktifkan SELinux di node atau tetapkan ke mode permisif. Lihat Menginstal utilitas apigee-setup Edge untuk mengetahui informasi selengkapnya.
2. Tentukan apakah Anda ingin mengaktifkan autentikasi Cassandra.
3. Tentukan apakah Anda ingin menyiapkan replikasi master-standby untuk Postgres.
4. Pilih konfigurasi Edge Anda dari daftar topologi yang direkomendasikan. Misalnya, Anda dapat menginstal Edge di satu node untuk pengujian, atau di 13 node untuk produksi. Lihat Topologi Penginstalan untuk mengetahui informasi selengkapnya.
5. Di setiap node dalam topologi yang Anda pilih, instal utilitas Edge apigee-setup:
   • Download file bootstrap_4.52.02.sh Edge ke /tmp/bootstrap_4.52.02.sh.
   • Instal utilitas dan dependensi Edge apigee-service.
   • Instal utilitas dan dependensi Edge apigee-setup.

     Lihat Menginstal utilitas apigee-setup Edge untuk mengetahui informasi selengkapnya.

6. Gunakan utilitas apigee-setup untuk menginstal satu atau beberapa komponen Edge di setiap node berdasarkan topologi yang Anda pilih.

   Lihat Menginstal komponen Edge di node.

7. Di node Server Pengelolaan, gunakan utilitas apigee-setup untuk menginstal apigee-provision, utilitas yang Anda gunakan untuk membuat dan mengelola organisasi Edge.

   Lihat Mengaktifkan organisasi untuk mengetahui informasi selengkapnya.

8. Mulai ulang komponen UI Klasik di setiap node setelah penginstalan selesai, seperti yang ditunjukkan contoh berikut:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. (Direkomendasikan) Setelah Anda menyelesaikan penginstalan awal, Apigee merekomendasikan agar Anda menginstal UI Edge baru (yang nama komponennya adalah edge-management-ui), yang merupakan antarmuka pengguna yang ditingkatkan untuk developer dan administrator Apigee Edge untuk Private Cloud.

   Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge baru.

Setelah penginstalan selesai, lihat daftar tindakan pasca-penginstalan umum ini.

Siapa yang dapat melakukan penginstalan

File distribusi Apigee Edge diinstal sebagai serangkaian RPM dan dependensi. Untuk menginstal, meng-uninstal, dan mengupdate RPM Edge, perintah harus dijalankan oleh pengguna root atau oleh pengguna yang memiliki akses sudo penuh. Untuk akses sudo penuh, berarti pengguna memiliki akses sudo untuk melakukan operasi yang sama seperti root.

Setiap pengguna yang ingin menjalankan perintah atau skrip berikut harus menjadi root, atau menjadi pengguna dengan akses sudo penuh:

• Utilitas apigee-service:
  • Perintah apigee-service: install, uninstall, update.
  • Perintah apigee-all: install, uninstall, update.
• skrip setup.sh untuk menginstal komponen Edge (Kecuali jika Anda telah menggunakan "apigee-service install" untuk menginstal RPM yang diperlukan. Kemudian, akses root atau sudo penuh jika tidak diperlukan.)
• Skrip update.sh untuk mengupdate komponen Edge

Selain itu, penginstal Edge membuat pengguna baru di sistem Anda, yang bernama "apigee". Banyak perintah Edge yang memanggil sudo untuk dijalankan sebagai pengguna "apigee".

Setiap pengguna yang ingin menjalankan semua perintah selain yang ditampilkan di atas harus merupakan pengguna dengan akses sudo penuh ke pengguna "apigee". Perintah ini mencakup:

• Perintah utilitas apigee-service, termasuk:
  • Perintah apigee-service seperti start, stop, restart, configure.
  • Perintah apigee-all seperti start, stop, restart, configure.

Membuat pengguna dengan akses sudo penuh ke pengguna "apigee"

Untuk mengonfigurasi pengguna agar memiliki akses sudo penuh ke pengguna "apigee", gunakan perintah "visudo" untuk mengedit file sudoers guna menambahkan:

installUser        ALL=(apigee)      NOPASSWD: ALL

Dengan installUser adalah nama pengguna orang yang bekerja dengan Edge.

Menetapkan izin pada file konfigurasi

Semua file atau resource yang digunakan oleh perintah Edge harus dapat diakses oleh pengguna "apigee". Hal ini mencakup file lisensi Edge dan file konfigurasi apa pun.

Saat membuat file konfigurasi, Anda dapat mengubah pemiliknya menjadi "apigee:apigee" untuk memastikan bahwa file tersebut dapat diakses oleh perintah Edge:

1. Buat file di editor sebagai pengguna mana pun.
2. chown pemilik file ke "apigee:apigee" atau, jika Anda mengubah pengguna yang menjalankan layanan Edge dari pengguna "apigee", ubah kepemilikan file ke pengguna yang menjalankan layanan Edge.

Memisahkan tugas penginstalan Edge antara pengguna root dan non-root

Meskipun proses penginstalan Edge secara keseluruhan paling mudah dilakukan sebagai root atau oleh pengguna yang memiliki akses sudo penuh, hal itu tidak selalu memungkinkan. Sebagai gantinya, Anda dapat memisahkan proses menjadi tugas yang dilakukan oleh root dan tugas yang dilakukan oleh pengguna dengan akses sudo penuh ke pengguna "apigee".

1. Tugas yang dilakukan oleh root:
   1. Download dan jalankan file bootstrap_4.52.02.sh:

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      Langkah ini menginstal utilitas apigee-service dan membuat pengguna "apigee".

   2. Konfigurasi pengguna agar memiliki akses sudo penuh ke pengguna "apigee" seperti yang dijelaskan dalam Membuat pengguna dengan akses sudo penuh ke pengguna "apigee".
   3. Instal utilitas apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. Gunakan utilitas apigee-setup untuk menginstal RPM Edge di node:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      RPM Edge yang Anda instal di node bergantung pada topologi Anda. Daftar komponen yang tersedia mencakup: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. Setelah pengguna root menginstal RPM Edge di node, pengguna dengan akses sudo penuh ke pengguna "apigee" menyelesaikan proses konfigurasi:
   1. Gunakan utilitas setup.sh untuk menyelesaikan konfigurasi komponen Edge di node. Bentuk perintah bergantung pada komponen yang Anda instal di node. Untuk daftar lengkapnya, lihat Menginstal komponen Edge di node.

      Misalnya, untuk menyelesaikan penginstalan ZooKeeper dan Cassandra, gunakan perintah berikut:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      Dengan configFile adalah file konfigurasi Edge.

      Atau, untuk melakukan penginstalan all-in-one, gunakan perintah berikut:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Lokasi file konfigurasi penginstalan

Anda harus meneruskan file konfigurasi ke utilitas apigee-setup yang berisi informasi tentang penginstalan Edge. Satu-satunya persyaratan untuk penginstalan senyap adalah file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee". Misalnya, letakkan file di direktori /usr/local/var atau /usr/local/share di node dan chown ke "apigee:apigee".

Semua informasi dalam file konfigurasi diperlukan, kecuali sandi administrator sistem Edge. Jika Anda tidak memasukkan sandi, utilitas apigee-setup akan meminta Anda untuk memasukkannya di command line.

Lihat Menginstal komponen Edge di node untuk mengetahui informasi selengkapnya.

Menangani kegagalan penginstalan

Jika terjadi kegagalan selama penginstalan komponen Edge, Anda dapat mencoba memperbaiki masalah tersebut, lalu menjalankan penginstal lagi. Penginstal dirancang untuk dijalankan berulang kali jika mendeteksi kegagalan, atau jika Anda ingin mengubah atau mengupdate komponen setelah penginstalan.

Setelah menginstal atau mengupgrade, pastikan untuk memulai ulang komponen Edge UI di setiap node tempat komponen tersebut berjalan.

Penginstalan dengan atau tanpa internet

Untuk menginstal Edge di node, node harus dapat mengakses repositori Apigee:

• Node dengan koneksi Internet eksternal

  Node dengan koneksi internet eksternal mengakses repositori Apigee untuk menginstal RPM dan dependensi Edge.

• Node tanpa koneksi Internet eksternal

  Node tanpa koneksi Internet eksternal dapat mengakses versi duplikat repositori Apigee yang Anda siapkan secara internal. Repositori ini berisi semua RPM Edge, tetapi Anda harus memastikan bahwa Anda memiliki semua dependensi lain yang tersedia dari repositori di jaringan internal.

  Untuk membuat repositori Apigee internal, Anda memerlukan node dengan akses internet eksternal agar dapat mendownload RPM Edge dan dependensinya. Setelah membuat repo internal, Anda dapat memindahkannya ke node lain atau membuat node tersebut dapat diakses oleh node Edge untuk penginstalan.

Menggunakan repositori Edge lokal untuk mempertahankan versi Edge Anda

Salah satu alasan penggunaan repositori lokal atau yang di-mirror adalah untuk menginstal Edge di node tanpa koneksi internet eksternal, seperti yang dijelaskan di bagian sebelumnya.

Menyelesaikan dependensi penginstalan RPM

File distribusi Apigee Edge diinstal sebagai serangkaian file RPM, yang masing-masing dapat memiliki rantai dependensi penginstalannya sendiri. Banyak dependensi ini ditentukan oleh komponen pihak ketiga yang berada di luar kontrol Apigee dan dapat berubah kapan saja. Oleh karena itu, dokumentasi tidak mencantumkan nomor versi eksplisit setiap dependensi.

Jika Anda melakukan penginstalan di mesin dengan akses internet, node dapat mendownload RPM dan dependensi yang diperlukan. Namun, jika Anda menginstal dari node tanpa akses internet, Anda biasanya menyiapkan repo internal yang berisi semua dependensi yang diperlukan. Satu-satunya cara untuk menjamin bahwa semua dependensi disertakan dalam repo lokal Anda adalah dengan mencoba menginstal, mengidentifikasi dependensi yang hilang, dan menyalinnya ke repo lokal hingga penginstalan berhasil.

Perintah Yum umum

Alat penginstalan Edge untuk Linux mengandalkan Yum untuk menginstal dan mengupdate komponen. Anda mungkin harus menggunakan beberapa perintah Yum untuk mengelola penginstalan di node.

• Hapus semua cache Yum:

  sudo yum clean all

• Untuk memperbarui komponen Edge:

  sudo yum update componentName

  Contoh:

  sudo yum update apigee-setup
  sudo yum update edge-management-server

Struktur Sistem File

Edge menginstal semua file di direktori /opt/apigee.

Dalam panduan ini dan Panduan Operasi Edge, direktori penginstalan root dicatat sebagai:

/opt/apigee

Penginstalan menggunakan struktur sistem file berikut untuk men-deploy Apigee Edge for Private Cloud.

File Log

File log untuk apigee-setup dan skrip setup.sh ditulis ke /tmp/setup-root.log.

File log untuk setiap komponen terdapat di direktori /opt/apigee/var/log. Setiap komponen memiliki subdirektorinya sendiri. Misalnya, log untuk Server Pengelolaan berada di direktori:

/opt/apigee/var/log/edge-management-server

Tabel berikut mencantumkan lokasi file log:

Data

Mengaktifkan pemeriksaan sistem saat penginstalan

File konfigurasi penginstalan Edge mendukung properti berikut:

ENABLE_SYSTEM_CHECK=y

Jika Anda menyetel properti ini ke "y", penginstal akan memeriksa apakah sistem memenuhi persyaratan CPU dan memori untuk komponen yang sedang diinstal. Nilai defaultnya adalah "n" untuk menonaktifkan pemeriksaan.