Ringkasan Pemasangan Edge

Edge for Private Cloud v. 4.17.01

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

Proses penginstalan

Menginstal Edge di node adalah proses multi-langkah:

  • Nonaktifkan SELinux di node atau tetapkan ke mode permisif. Lihat Menginstal utilitas penyiapan apigee Edge untuk mengetahui informasi selengkapnya.
  • Tentukan apakah Anda ingin mengaktifkan autentikasi Cassandra.
  • Tentukan apakah Anda ingin menyiapkan replika master-standby untuk Postgres.
  • 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 Menyiapkan Replikasi Master-Standby untuk Postgres untuk mengetahui informasi selengkapnya.
  • Di setiap node dalam topologi yang dipilih, instal utilitas apigee-setup Edge:
    • Download file Edge bootstrap_4.17.01.sh ke /tmp/bootstrap_4.17.01.sh.
    • Instal utilitas dan dependensi apigee-service Edge.
    • Instal utilitas dan dependensi apigee-setup Edge.

      Lihat Menginstal utilitas penyiapan Edge apigee untuk mengetahui informasi selengkapnya.
  • 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.
  • Di node Server Pengelolaan, gunakan utilitas apigee-setup untuk menginstal apigee-provision, utilitas yang Anda gunakan untuk membuat dan mengelola organisasi Edge.
    Lihat Melakukan aktivasi organisasi untuk mengetahui informasi selengkapnya.

Siapa yang dapat melakukan penginstalan

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

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

  • Utilitas apigee-service:
    • Perintah apigee-service: install, uninstall, update.
    • Perintah apigee-all: instal, uninstal, update.
  • setup.sh untuk menginstal komponen Edge (Kecuali 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 akan membuat pengguna baru di sistem Anda, yang bernama "apigee". Banyak perintah Edge yang memanggil sudo agar 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.

Untuk mengonfigurasi pengguna agar memiliki akses sudo penuh ke pengguna "apigee", edit file sudoers untuk menambahkan:

installUser        ALL=(apigee)      NOPASSWD: ALL

dengan installUser adalah nama pengguna orang yang bekerja dengan Edge.

File atau resource apa pun 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", chown file ke pengguna yang menjalankan layanan Edge.

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, tempatkan 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 menghilangkan sandi, utilitas apigee-setup akan meminta Anda 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 kembali penginstal. Penginstal dirancang untuk dijalankan berulang kali jika mendeteksi kegagalan, atau jika nanti Anda ingin mengubah atau mengupdate komponen setelah penginstalan.

Penginstalan dengan internet atau tanpa 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 mirror 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 repo di jaringan internal.

    Catatan: Apigee tidak menghosting semua dependensi pihak ketiga di repositori publik kami. Anda harus mendownload dan menginstal dependensi ini dari repositori yang dapat diakses secara publik.

    Untuk membuat repositori Apigee internal, Anda memerlukan node dengan akses internet eksternal agar dapat mendownload RPM dan dependensi Edge. 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 menggunakan repositori lokal atau yang dicerminkan adalah untuk menginstal Edge pada node tanpa koneksi internet eksternal, seperti yang dijelaskan di bagian sebelumnya.

Namun, ada keuntungan lain dari menggunakan repo lokal, bahkan untuk node dengan koneksi internet eksternal. Saat menginstal Edge dari repositori publik Apigee, Anda selalu menginstal RPM Edge terbaru. Oleh karena itu, jika Anda ingin mendownload dan menyimpan RPM Edge untuk versi Edge tertentu, Anda harus membuat repo lokal untuk versi Edge tersebut. Kemudian, Anda dapat menggunakan repo lokal tersebut untuk melakukan penginstalan untuk versi Edge apa pun.

Misalnya, Anda terlebih dahulu menggunakan repo lokal untuk menginstal lingkungan pengembangan Edge. Kemudian, saat siap beralih ke lingkungan produksi, Anda akan menginstal Edge lagi dari repo lokal. Dengan menginstal dari repo lokal, Anda menjamin bahwa lingkungan pengembangan dan produksi Anda cocok.

Repositori yang dicerminkan sangat fleksibel. Misalnya, Anda dapat membuat repo yang dicerminkan dari RPM Edge terbaru atau dari versi Edge tertentu. Setelah membuat repo, Anda juga dapat mengupdatenya untuk menambahkan RPM dari versi Edge yang berbeda. Lihat Menginstal utilitas penyiapan apigee Edge untuk mengetahui informasi selengkapnya.

Menyelesaikan dependensi penginstalan RPM

File distribusi Apigee Edge diinstal sebagai kumpulan 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 dari setiap dependensi.

Jika Anda melakukan penginstalan di komputer dengan akses internet, node dapat mendownload RPM dan dependensi yang diperlukan. Namun, jika 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 penginstalan, 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.

  • Bersihkan semua cache Yum:
    sudo yum clean all
  • Untuk mengupdate komponen Edge:
    sudo yum update componentName
    Misalnya:
    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 dalam Panduan Operasi Edge, direktori penginstalan root dicatat sebagai:

<inst_root>/apigee

Penginstalan menggunakan struktur sistem file berikut untuk 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 berada di direktori:

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

Tabel berikut mencantumkan lokasi file log:

Komponen

Lokasi

Server Pengelolaan

<inst_root>/apigee/var/log/edge-management-server

Router

<inst_root>/apigee/var/log/edge-router

Message Processor

<inst_root>/apigee/var/log/edge-message-processor

Server Qpid Apigee

<inst_root>/apigee/var/log/edge-qpid-server

Server Postgres Apigee

<inst_root>/apigee/var/log/edge-postgres-server

UI Edge

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

&lt;inst_root&gt;/apigee/var/log/apigee-zookeeper

OpenLDAP

&lt;inst_root&gt;/apigee/var/log/apigee-openldap

Cassandra

&lt;inst_root&gt;/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

Database PostgreSQL

<inst_root>/apigee/var/log/apigee-postgresql

Data

Komponen

Lokasi

Server Pengelolaan

<data_root>/apigee/data/edge-management-server

Router

&lt;data_root&gt;/apigee/data/edge-router

Message Processor

&lt;data_root&gt;/apigee/data/edge-message-processor

Agen Apigee Qpid

<data_root>/apigee/data/edge-qpid-server

Agen Postgres Apigee

&lt;data_root&gt;/apigee/data/edge-postgres-server

ZooKeeper

<data_root>/apigee/data/apigee-zookeeper

OpenLDAP

<data_root>/apigee/data/apigee-openldap

Cassandra

<data_root>/apigee/data/apigee-cassandra/data

Qpidd

<data_root>/apigee/data/apigee-qpid/data

Database PostgreSQL

&lt;data_root&gt;/apigee/data/apigee-postgres/pgdata

Tugas pasca-penginstalan

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

Mengonfigurasi komponen Edge setelah penginstalan

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

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

Untuk menetapkan properti bagi 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 di direktori /opt/apigee/customer/application akan dibaca. Artinya, update akan 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

Edge menginstal utilitas pengelolaan di /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 di node:

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

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

/opt/apigee/apigee-service/bin/apigee-service component action

Misalnya, untuk memulai ulang Edge Router:

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

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

  • apigee - komponen pihak ketiga yang digunakan oleh Edge. Misalnya, apigee-cassandra.
  • edge - komponen Edge dari Apigee. Misalnya, edge-management-server.
  • edge-mint - komponen Monetisasi. Misalnya edge-mint-management-server.
  • baas - komponen BaaS API. Misalnya, baas-usergrid.

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

  • mulai, hentikan, mulai ulang
  • status, versi
  • cadangan, pemulihan
  • install, uninstall