Untuk menginstal Edge pada node, instal utilitas penyiapan Edge apigee terlebih dahulu. Jika Anda berada di lingkungan tempat node tidak memiliki koneksi internet eksternal, Anda juga harus menginstal salinan lokal repo Apigee.
Direktori penginstalan default: /opt/apigee
Edge menginstal semua file di direktori /opt/apigee
. Anda tidak dapat mengubah direktori ini. Namun, jika diinginkan, Anda dapat membuat symlink untuk memetakan /opt/apigee
ke
lokasi lain. Lihat Persyaratan Penginstalan untuk informasi selengkapnya.
Prasyarat: Menonaktifkan SELinux
Anda harus menonaktifkan SELinux, atau menyetelnya ke mode permisif, sebelum dapat menginstal utilitas
apigee-setup
Edge atau komponen
Edge apa pun. Jika perlu, setelah menginstal Edge, Anda dapat mengaktifkan kembali SELinux.
- Buka
/etc/sysconfig/selinux
di editor. - Tetapkan
SELINUX=disabled
atauSELINUX=permissive
- Simpan hasil editan Anda.
- Mulai ulang node.
- Jika perlu, aktifkan kembali SELinux setelah penginstalan Edge dengan mengulangi prosedur ini untuk
menyetel
SELINUX=enabled
.
Prasyarat: Mengaktifkan repo EPEL
Anda harus mengaktifkan Extra Packages for Enterprise Linux (atau EPEL) untuk menginstal atau mengupdate Edge, atau membuat repo lokal. Perintah yang Anda gunakan bergantung pada versi RedHat/CentOS:
- Untuk Red Hat/CentOS/Oracle 8.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
- Untuk Red Hat/CentOS/Oracle 9.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm
- Aktifkan Extra Packages for
Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- Nonaktifkan Postgres dan Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Aktifkan Extra Packages for Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
- Nonaktifkan Postgres dan Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Dapatkan nama pengguna dan sandi dari Apigee yang Anda gunakan untuk mengakses repositori Apigee. Jika sudah memiliki username:password untuk situs ftp Apigee, Anda dapat menggunakan kredensial tersebut.
- Login ke node sebagai root untuk menginstal RPM Edge
- Nonaktifkan SELinux.
- Aktifkan repositori EPEL.
- Jika Anda menginstal aplikasi di RHEL 9/Rocky 9/Oracle 9, ikuti langkah-langkah dalam Prasyarat untuk RHEL 9/Rocky 9/Oracle 9.
- Download file
bootstrap_4.53.00.sh
Edge ke/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Instal utilitas dan dependensi layanan apigee Edge:
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.
Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, aplikasi akan menginstalnya untuk Anda. Gunakan opsi
JAVA_FIX
untuk menentukan cara menangani penginstalan Java.JAVA_FIX
menggunakan nilai berikut:- I: Menginstal OpenJDK 1.8 (default)
- C: Lanjutkan tanpa menginstal Java
- T: Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
Penginstalan utilitas apigee-service akan membuat file /etc/yum.repos.d/apigee.repo yang menentukan repositori Apigee. Untuk melihat file definisi, gunakan perintah:
cat /etc/yum.repos.d/apigee.repo
Untuk melihat konten repo, gunakan perintah:
sudo yum -v repolist 'apigee*'
- Gunakan apigee-service untuk menginstal utilitas apigee-setup:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Gunakan apigee-setup untuk menginstal dan mengonfigurasi komponen Edge pada node. Lihat Menginstal komponen Edge di node untuk mengetahui informasi selengkapnya.
- Menambahkan konfigurasi proxy HTTP di
/etc/yum.conf
- Menambahkan konfigurasi proxy HTTP global di
/etc/environment
- Repositori Apigee Edge: Seperti yang dijelaskan dalam Membuat repositori Apigee lokal.
- Extra Packages for Enterprise Linux (atau EPEL): Tim operasi Anda seharusnya dapat menyiapkannya untuk Anda.
- Dapatkan nama pengguna dan sandi dari Apigee yang Anda gunakan untuk mengakses repositori Apigee. Jika sudah memiliki nama pengguna:sandi untuk situs ftp Apigee, Anda dapat menggunakan kredensial tersebut.
- Login ke node Anda sebagai root untuk menginstal RPM Edge.
- Nonaktifkan SELinux seperti yang dijelaskan di atas.
- Download file
bootstrap_4.53.00.sh
Edge ke/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Instal utilitas dan dependensi layanan Edge apigee:
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.
- Instal utilitas
apigee-mirror
di node:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- Gunakan utilitas
apigee-mirror
untuk menyinkronkan repo Apigee ke direktori/opt/apigee/data/apigee-mirror/repos/
.Untuk meminimalkan ukuran repo, sertakan
--only-new-rpms
untuk mendownload RPM terbaru saja. -
(Opsional) Jika ingin menginstal Edge dari repo lokal ke node yang sama dengan yang menghosting repo lokal, Anda harus menjalankan perintah berikut terlebih dahulu:
- Jalankan
bootstrap_4.53.00.sh
dari repo lokal untuk menginstal utilitasapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- Gunakan
apigee-service
untuk menginstal utilitasapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Gunakan
apigee-setup
untuk menginstal dan mengonfigurasi komponen Edge pada node. Lihat Menginstal komponen Edge di node untuk mengetahui informasi selengkapnya.
- Jalankan
- Buat file .tar repo, salin file .tar ke node, lalu instal Edge dari file .tar.
- Instal server web di node dengan repo lokal agar node lain dapat mengaksesnya. Apigee menyediakan server web Nginx untuk Anda gunakan, atau Anda dapat menggunakan server web Anda sendiri.
- Di node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal ke dalam satu file .tar bernama
/opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Salin file .tar ke node tempat Anda ingin menginstal Edge. Misalnya, salin ke direktori
/tmp
di node baru. - Di node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
- Di node baru, pastikan Anda dapat mengakses repo utilitas Yum lokal dan repo EPEL.
- Periksa kembali apakah semua repositori internet eksternal dinonaktifkan (seharusnya hal ini dilakukan karena Anda menginstal di komputer tanpa akses internet):
sudo yum repolist
Semua repo eksternal harus dinonaktifkan, tetapi repo Apigee lokal dan repo internal Anda harus diaktifkan.
- Gunakan
apigee-service
untuk menginstal utilitasapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Gunakan
apigee-setup
untuk menginstal dan mengonfigurasi komponen Edge pada node. Lihat Menginstal komponen Edge di node untuk mengetahui informasi selengkapnya. - Instal server web Nginx di node repo:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- Secara default, Nginx dikonfigurasi untuk menggunakan localhost sebagai nama server dan port 3939. Untuk
mengubah nilai ini:
- Buka
/opt/apigee/customer/application/mirror.properties
di editor. Buat file jika tidak ada. - Tetapkan nilai berikut sesuai kebutuhan:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- Mulai ulang Nginx:
/opt/nginx/scripts/apigee-nginx restart
- Buka
- Secara default, repo memerlukan nama pengguna:sandi
admin:admin
. Untuk mengubah kredensial ini, tetapkan variabel lingkungan berikut:MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- Di node baru, pastikan repositori EPEL diaktifkan secara lokal.
- Di node baru, periksa versi
libdb4
Anda seperti yang dijelaskan di atas. - Di node jarak jauh, instal utilitas dan dependensi
apigee-service
Edge:sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Dengan uName:pWord adalah nama pengguna dan sandi repo.
- Di node jarak jauh, gunakan
apigee-service
untuk menginstal utilitasapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Gunakan
apigee-setup
untuk menginstal dan mengonfigurasi komponen Edge di node jarak jauh. Lihat Menginstal komponen Edge di node untuk mengetahui informasi selengkapnya. - Download file Edge bootstrap_4.53.00.sh ke
/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Jalankan file
bootstrap_4.53.00.sh
Edge:sudo bash/tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.
- Update
apigee-mirror
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- Lakukan sinkronisasi:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- Jika Anda ingin seluruh repo:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
Prasyarat untuk RHEL 8/Rocky 8/Oracle 8
Jika Anda menginstal Edge di server yang menjalankan Red Hat Enterprise Linux (RHEL) 8, lakukan langkah-langkah berikut sebelum melakukan penginstalan:
Prasyarat untuk RHEL 9/Rocky 9/Oracle 9
Jika Anda menginstal Edge di server yang menjalankan Red Hat Enterprise Linux (RHEL) 9, Rocky 9, atau Oracle 9, selesaikan langkah-langkah berikut sebelum melakukan penginstalan:
Untuk perubahan pra-penginstalan PostgreSQL dan LDAP, lihat persyaratan pra-penginstalan database PostgreSQL dan perubahan pra-penginstalan OpenLDAP 2.4.
Instal utilitas penyiapan apigee Edge pada node dengan koneksi internet eksternal
Untuk menginstal Edge pada node dengan koneksi internet eksternal:
Pemecahan masalah
Saat mencoba menginstal di node dengan koneksi internet eksternal, Anda mungkin mengalami salah satu atau beberapa error berikut:
Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm bootstrap.sh: Error: Repo configuration failed error: package package_name is not installed
Tabel berikut mencantumkan beberapa kemungkinan penyelesaian untuk error ini:
Jenis Kesalahan | Kemungkinan Penyelesaian |
---|---|
Sandi mengandung karakter yang buruk | Jangan gunakan karakter khusus dalam sandi Apigee Anda. |
Masalah konektivitas | Uji konektivitas jaringan Anda dengan menjalankan perintah nc -v software.apigee.com 443 Anda akan mendapatkan pesan yang mirip dengan berikut ini: Connection to software.apigee.com 443 port [tcp/https] succeeded! Jika telnet software.apigee.com 443 Jika perintah berhasil, Anda dapat menggunakan CTRL+C untuk membatalkan koneksi yang terbuka. Jika salah satu perintah gagal, berarti konektivitas jaringan Anda terbatas atau tidak ada sama sekali. Hubungi administrator jaringan Anda. |
Kredensial salah | Pastikan nama pengguna dan sandi Anda sudah benar. Misalnya, periksa apakah Anda mengalami error saat mencoba menggunakan perintah berikut dengan nama pengguna dan sandi Apigee: curl -i -u username:password https://software.apigee.com/apigee-repo.rpm |
Masalah proxy | Konfigurasi lokal Anda menggunakan proxy HTTP keluar dan Anda belum memperluas konfigurasi yang sama ke pengelola paket yum . Periksa variabel lingkungan Anda:
echo $http_proxy
Untuk proxy HTTP keluar, Anda harus menggunakan salah satu opsi berikut: |
Instal utilitas penyiapan apigee Edge pada node tanpa koneksi internet eksternal
Jika node Edge Anda berada di balik firewall, atau dengan cara lain dilarang mengakses internet, Anda harus membuat beberapa repositori, atau mirror, yang berisi file yang akan Anda perlukan selama penginstalan. Mirror tersebut kemudian harus dapat diakses oleh semua node. Setelah dibuat, node dapat mengakses mirror lokal ini untuk menginstal Edge.
Proses penginstalan Apigee Edge untuk node tanpa koneksi internet memerlukan akses ke repositori lokal berikut:
Membuat repositori Apigee lokal
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.
Setelah membuat repositori Apigee lokal, Anda mungkin nanti harus mengupdatenya dengan file rilis Edge terbaru. Bagian berikut menjelaskan cara membuat repositori Apigee lokal, dan cara mengupdatenya.
Untuk membuat repo Apigee lokal:
Menginstal apigee-setup di node jarak jauh dari repo lokal
Anda memiliki dua opsi untuk menginstal Edge dari repo lokal. Anda dapat:
Menginstal dari file .tar
Untuk menginstal dari file .tar:
Menginstal dari repo menggunakan server web Nginx
Untuk menginstal dari repo menggunakan server web Nginx:
Memperbarui repositori Apigee lokal
Untuk mengupdate repo, Anda harus mendownload file bootstrap_4.53.00.sh terbaru, lalu lakukan sinkronisasi baru.
Untuk mengupdate repo:
Membersihkan repo Apigee lokal
Membersihkan repo lokal akan menghapus /opt/apigee/data/apigee-mirror dan /var/tmp/yum-apigee-*.
Untuk membersihkan repo lokal, gunakan:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean