Ringkasan Pemasangan Edge

Edge untuk Private Cloud v4.18.05

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

Proses penginstalan

Menginstal Edge pada node adalah proses multi-langkah:

  1. Nonaktifkan SELinux pada node atau setel 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 pada satu node untuk pengujian, atau pada 13 node untuk produksi. Lihat Topologi Penginstalan untuk mengetahui informasi selengkapnya.
  5. Pada setiap node dalam topologi yang dipilih, instal utilitas Edge apigee-setup:
    • Download file Edge bootstrap_4.18.05.sh ke /tmp/bootstrap_4.18.05.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 pada setiap node berdasarkan topologi yang Anda pilih.

    Lihat Menginstal komponen Edge pada node.

  7. Pada node Management Server, gunakan utilitas apigee-setup untuk menginstal apigee-Provider, yaitu utilitas yang Anda gunakan untuk membuat dan mengelola organisasi Edge.

    Lihat Melakukan aktivasi organisasi untuk mengetahui informasi selengkapnya.

  8. Mulai ulang komponen UI Edge setelah penginstalan selesai.

Siapa yang dapat melakukan penginstalan

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

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

  • 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 {i>sudo <i}penuh jika tidak diperlukan.)
  • Skrip update.sh untuk mengupdate komponen Edge

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

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

  • 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 penuh sudo ke pengguna "apigee"

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

installUser        ALL=(apigee)      NOPASSWD: ALL

Dengan installUser adalah nama pengguna orang yang menggunakan Edge.

Menyetel izin pada file konfigurasi

File atau resource apa pun yang digunakan oleh perintah Edge harus dapat diakses oleh pengguna "apigee". Ini termasuk file lisensi Edge dan semua file konfigurasi.

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 nama pemilik file menjadi "apigee:apigee" atau, jika Anda mengubah pengguna yang menjalankan layanan Edge dari pengguna "apigee", ubah file menjadi pengguna yang menjalankan layanan Edge.

Memisahkan tugas penginstalan Edge antara pengguna root dan non-root

Meskipun melakukan seluruh proses penginstalan Edge sebagai root atau oleh pengguna yang memiliki akses penuh sudo adalah cara termudah, hal itu tidak selalu memungkinkan. Sebagai gantinya, Anda dapat memisahkan proses menjadi tugas yang dilakukan oleh root dan tugas yang dilakukan oleh pengguna yang memiliki akses penuh sudo ke pengguna "apigee".

  1. Tugas yang dijalankan oleh root:
    1. Download dan jalankan file bootstrap_4.18.05.sh: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

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

    2. Konfigurasikan pengguna agar memiliki akses penuh sudo ke pengguna "apigee" seperti yang dijelaskan dalam Membuat pengguna dengan akses penuh sudo 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 pada node: 
      /opt/apigee/apigee-service/bin/apigee-service compName install

      RPM Edge yang diinstal pada node bergantung pada topologi Anda. Daftar komponen yang tersedia meliputi: 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 pada node, pengguna dengan akses penuh sudo ke pengguna "apigee" akan menyelesaikan proses konfigurasi:
    1. Gunakan utilitas setup.sh untuk menyelesaikan konfigurasi komponen Edge pada node. Bentuk perintah bergantung pada komponen yang Anda instal pada node. Untuk mengetahui daftar lengkapnya, lihat Menginstal komponen Edge pada 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 lengkap, 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 pada 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 pada node dan chown ke "apigee:apigee".

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

Lihat Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.

Menangani kegagalan penginstalan

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

Setelah menginstal atau mengupgrade, pastikan untuk memulai ulang komponen UI Edge pada setiap node tempatnya berjalan.

Penginstalan selain internet

Untuk menginstal Edge pada 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 pencerminan 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 dan dependensi Edge. Setelah membuat repositori 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 untuk menggunakan repositori lokal, atau yang dicerminkan, adalah untuk menginstal Edge pada node tanpa koneksi internet eksternal, seperti yang dijelaskan di bagian sebelumnya.

Menyelesaikan dependensi penginstalan RPM

File distribusi Apigee Edge diinstal sebagai sekumpulan file RPM, yang masing-masing dapat memiliki rantai dependensi penginstalannya sendiri. Banyak dari 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 pada komputer yang memiliki akses internet, node dapat mendownload RPM dan dependensi yang diperlukan. Namun, jika menginstal dari node tanpa akses internet, biasanya Anda perlu 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 penginstalan, mengidentifikasi dependensi yang hilang, lalu menyalinnya ke repo lokal hingga penginstalan berhasil.

Perintah umum Yum

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

  • Hapus semua cache Yum: 
    sudo yum clean all
  • Untuk mengupdate komponen Edge: 
    sudo yum update componentName

    Contoh:

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

Struktur Sistem File

Edge akan menginstal semua file di direktori /opt/apigee.

Dalam panduan ini dan di Edge Operations Guide, direktori penginstalan root dicatat sebagai:

/opt/apigee

Penginstalan ini menggunakan struktur sistem file berikut guna men-deploy Apigee Edge untuk 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 dalam direktori /opt/apigee/var/log. Setiap komponen memiliki subdirektorinya sendiri. Misalnya, log untuk Server Pengelolaan ada di direktori:

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

Tabel berikut mencantumkan lokasi file log:

Komponen Lokasi

Server Pengelolaan

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

Router

 /opt/apigee/var/log/edge-router

Edge Router diimplementasikan menggunakan Nginx. Untuk log tambahan, lihat:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

Message Processor

 /opt/apigee/var/log/edge-message-processor

Server Apigee Qpid

 /opt/apigee/var/log/edge-qpid-server
Server Apigee Postgres /opt/apigee/var/log/edge-postgres-server
UI Edge /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra
Qpidd /opt/apigee/var/log/apigee-qpidd
Database PostgreSQL /opt/apigee/var/log/apigee-postgresql

Data

Komponen Lokasi
Server Pengelolaan /opt/apigee/data/edge-management-server
Router /opt/apigee/data/edge-router
Message Processor /opt/apigee/data/edge-message-processor
Agen Apigee Qpid /opt/apigee/data/edge-qpid-server
Agen Apigee Postgres /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
Qpidd /opt/apigee/data/apigee-qpid/data
Database PostgreSQL /opt/apigee/data/apigee-postgres/pgdata

Tugas memposting penginstalan

Setelah penginstalan selesai, Anda dapat melakukan tindakan tambahan pada komponen Edge.

Memulai ulang komponen UI Edge

Setelah penginstalan selesai, Anda harus memulai ulang komponen UI Edge pada setiap node:

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

Mengonfigurasi komponen Edge setelah penginstalan

Untuk mengonfigurasi Edge setelah penginstalan, gunakan kombinasi file .properties dan utilitas Edge. Misalnya, untuk mengonfigurasi TLS/SSL di UI Edge, edit file .properties untuk menetapkan properti yang diperlukan. Perubahan pada file .properties mengharuskan Anda memulai ulang komponen Edge yang terpengaruh.

File .properties berada di direktori /opt/apigee/customer/application. Setiap komponen memiliki file .properties sendiri di direktori tersebut. Misalnya, router.properties dan management-server.properties.

Untuk menetapkan properti komponen, edit file .properties yang sesuai, lalu mulai ulang komponen:

/opt/apigee/apigee-service/bin/apigee-service component restart

Contoh:

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

Saat Anda mengupdate Edge, file .properties dalam direktori /opt/apigee/customer/application akan dibaca. Artinya, update mempertahankan properti apa pun yang Anda tetapkan pada komponen.

Lihat Cara mengonfigurasi Edge untuk mengetahui informasi selengkapnya tentang konfigurasi Edge.

Memanggil perintah pada komponen Edge

Utilitas pengelolaan penginstalan Edge berdasarkan /opt/apigee/apigee-service/bin yang dapat Anda gunakan untuk mengelola penginstalan Edge. Misalnya, Anda dapat menggunakan utilitas apigee-all untuk memulai, menghentikan, memulai ulang, atau menentukan status semua komponen Edge pada node:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Gunakan utilitas apigee-service untuk mengontrol dan mengonfigurasi masing-masing komponen. Utilitas apigee-service memiliki bentuk:

/opt/apigee/apigee-service/bin/apigee-service component_name action

Dengan component_name mengidentifikasi komponen. Komponen harus berada di node tempat Anda menjalankan apigee-service. Bergantung pada konfigurasi Anda, nilai component_name dapat mencakup:

  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (Database PostgreSQL)
  • apigee-qpidd (Qpidd)
  • apigee-sso (SSO Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (Server Pengelolaan)
  • edge-management-ui (UI Edge baru)
  • edge-message-processor (Pemroses Pesan)
  • edge-postgres-server (Server Postgres)
  • edge-qpid-server (Server Qpid)
  • edge-router (Router Tepi)
  • edge-ui (UI Klasik)

Selain komponen ini, Anda juga dapat memanggil apigee-service pada komponen apigee-provision dan apigee-validate, bergantung pada konfigurasi Anda.

Misalnya, untuk memulai ulang Router Edge, jalankan perintah berikut:

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

Anda dapat menentukan daftar komponen yang diinstal pada node dengan memeriksa direktori /opt/apigee. Direktori tersebut berisi subdirektori untuk setiap komponen Edge yang diinstal pada node. Setiap subdirektori diawali dengan:

  • apigee: Komponen pihak ketiga yang digunakan oleh Edge. Contoh, apigee-cassandra.
  • edge: Komponen Edge dari Apigee. Contoh, edge-management-server.
  • edge-mint: Komponen Monetisasi. Misalnya edge-mint-management-server.

Daftar lengkap tindakan untuk sebuah komponen bergantung pada komponen itu sendiri, tetapi semua komponen mendukung tindakan berikut:

  • start, stop, restart
  • status, version
  • backup, restore
  • install, uninstall

Aktifkan pemeriksaan sistem saat penginstalan

File konfigurasi penginstalan Edge mendukung properti berikut:

ENABLE_SYSTEM_CHECK=y

Jika Anda menetapkan 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.