Untuk menginstal Edge pada sebuah node, Anda harus menginstal utilitas penyiapan Edge apigee terlebih dahulu. Jika berada di lingkungan tempat node Anda tidak memiliki koneksi internet eksternal, Anda juga harus menginstal salinan lokal repo Apigee.
Direktori penginstalan default: /opt/apigee
Edge akan 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: Nonaktifkan 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.
- Untuk menetapkan SELinux untuk sementara ke mode permisif, jalankan perintah
berikut:
- Pada sistem operasi Linux 6.x:
sudo echo 0 > /selinux/enforce
Untuk mengaktifkan kembali SELinux setelah menginstal Edge:
sudo echo 1 > /selinux/enforce
- Pada sistem operasi Linux 7.x:
sudo setenforce 0
Untuk mengaktifkan kembali SELinux setelah menginstal Edge:
sudo setenforce 1
- Pada sistem operasi Linux 6.x:
- Untuk menonaktifkan SELinux secara permanen atau menyetelnya ke mode permisif:
- Buka
/etc/sysconfig/selinux
di editor. - Tetapkan
SELINUX=disabled
atauSELINUX=permissive
- Simpan hasil edit Anda.
- Mulai ulang node.
- Jika perlu, aktifkan kembali SELinux setelah penginstalan Edge dengan mengulangi prosedur ini untuk
menyetel
SELINUX=enabled
.
- Buka
Prasyarat: Mengaktifkan repositori EPEL
Anda harus mengaktifkan Extra Packages for Enterprise Linux (atau EPEL) untuk menginstal atau mengupdate Edge, atau untuk membuat repo lokal. Perintah yang Anda gunakan bergantung pada versi RedHat/CentOS Anda:
Untuk Red Hat Enterprise Linux (RHEL) 8.0, lihat Prasyarat untuk RHEL 8.
- Untuk Red Hat/CentOS/Oracle 7.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo rpm -ivh epel-release-latest-7.noarch.rpm
- Untuk Red Hat/CentOS/Oracle 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
sudo rpm -ivh epel-release-latest-6.noarch.rpm
- Untuk AWS-2:
sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel
Prasyarat: Periksa versi library libdb4 di RedHat 7.4 dan CentOS 7.4
Di RedHat 7.4 dan CentOS 7.4, periksa versi RPM libdb4
sebelum Anda menginstalnya. Edge
memerlukan versi 4.8 dan beberapa versi RedHat 7.4 dan CentOS 7.4 tersedia dengan
versi yang lebih baru. Jika Anda memiliki versi yang lebih baru, uninstal aplikasi tersebut dan penginstal Edge akan
menginstal versi 4.8.
Anda dapat menggunakan perintah berikut untuk memeriksa versi:
rpm -qa | grep libdb4
Jika Anda melihat bahwa versi RPM libdb4
lebih baru dari versi 4.8, uninstal
RPM.
Prasyarat untuk RHEL 8
Jika Anda menginstal Edge pada server yang menjalankan Red Hat Enterprise Linux (RHEL) 8, lakukan langkah-langkah berikut sebelum menjalankan penginstalan:
- Aktifkan Paket Tambahan untuk
Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- Menonaktifkan Postgres dan Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Instal Python 2 dan buat symlink:
sudo dnf install -y python2
sudo ln -s /usr/bin/python2 /usr/bin/python
Instal utilitas apigee-setup Edge pada node dengan koneksi internet eksternal
Untuk menginstal Edge pada node dengan koneksi internet eksternal:
- 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 Anda sebagai root untuk menginstal RPM Edge
- Instal
yum-utils
danyum-plugin-priorities
.sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Nonaktifkan SELinux.
- Aktifkan repo EPEL.
- Periksa versi
libdb4
Anda. - Jika Anda menginstal di RHEL 8, ikuti langkah-langkah dalam Prasyarat untuk RHEL 8.
- Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut:
sudo yum-config-manager --enable ol7_optional_latest
- Jika Anda menginstal aplikasi di AWS, jalankan perintah
yum-configure-manager
berikut:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Download file
bootstrap_4.52.01.sh
Edge ke/tmp/bootstrap_4.52.01.sh
:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
- Instal utilitas dan dependensi layanan apigee Edge:
sudo bash /tmp/bootstrap_4.52.01.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.
Secara {i>default<i}, penginstal memeriksa untuk melihat bahwa Anda telah menginstal Java 1.8. Jika belum, Chrome akan menginstalnya untuk Anda. Gunakan opsi
JAVA_FIX
untuk menentukan cara menangani penginstalan Java.JAVA_FIX
menggunakan nilai berikut:- I: Instal OpenJDK 1.8 (default)
- C: Melanjutkan tanpa menginstal Java
- T: Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
Penginstalan utilitas apigee-service akan menghasilkan 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 pada node untuk mengetahui informasi selengkapnya.
Pemecahan masalah
Saat mencoba menginstal pada node dengan koneksi internet eksternal, Anda mungkin mendapati satu atau beberapa error berikut:
Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm bootstrap.sh: Error: Repo configuration failed error: package package_name is not installed
Tabel berikut mencantumkan beberapa kemungkinan resolusi untuk error ini:
Jenis Error | Kemungkinan Penyelesaian |
---|---|
Sandi berisi karakter yang salah | Jangan gunakan karakter khusus dalam sandi Apigee Anda. |
Terjadi masalah konektivitas | Uji konektivitas jaringan Anda dengan menjalankan perintah nc -v software.apigee.com 443 Anda seharusnya mendapatkan pesan yang mirip dengan yang 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. Hubungi administrator jaringan Anda. |
Kredensial salah | Pastikan nama pengguna dan sandi Anda sudah benar. Misalnya, periksa apakah Anda mendapatkan error saat mencoba menggunakan perintah berikut dengan nama pengguna dan sandi Apigee Anda: 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 traffic keluar, Anda harus menggunakan salah satu opsi berikut:
|
Instal utilitas apigee-setup Edge pada node tanpa koneksi internet eksternal
Jika node Edge Anda berada di belakang firewall, atau dengan cara lain dilarang mengakses internet, Anda harus membuat beberapa repositori, atau mirror, yang berisi file yang diperlukan selama penginstalan. Cermin tersebut kemudian harus dapat diakses oleh semua node. Setelah dibuat, node kemudian dapat mengakses cermin lokal ini untuk menginstal Edge.
Proses penginstalan Apigee Edge untuk node tanpa koneksi internet memerlukan akses ke repositori lokal berikut:
- Repo Apigee Edge: Seperti yang dijelaskan dalam Membuat repositori Apigee lokal.
- Repo Yum (untuk utilitas seperti
yum-utils
danyum-plugin-priorities
): Tim operasi Anda seharusnya dapat menyiapkannya untuk Anda. - Paket Tambahan untuk Enterprise Linux (atau EPEL): Tim operasi Anda seharusnya dapat menyiapkannya untuk Anda.
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 harus mengupdatenya dengan file rilis Edge terbaru. Bagian berikut menjelaskan cara membuat repositori Apigee lokal, dan cara mengupdatenya.
Untuk membuat repo Apigee lokal:
- Dapatkan nama pengguna dan sandi dari Apigee yang Anda gunakan untuk mengakses repositori Apigee. Jika Anda sudah memiliki namapengguna: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.52.01.sh
Edge ke/tmp/bootstrap_4.52.01.sh
:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
- Instal utilitas dan dependensi layanan apigee Edge:
sudo bash /tmp/bootstrap_4.52.01.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.
- Instal utilitas
apigee-mirror
pada 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.52.01.sh
dari repo lokal untuk menginstal utilitasapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.01.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 pada node untuk mengetahui informasi selengkapnya.
- Jalankan
Menginstal apigee-setup pada node jarak jauh dari repo lokal
Anda memiliki dua opsi untuk menginstal Edge dari repo lokal. Anda dapat:
- Buat file .tar dari repo, salin file .tar ke node, lalu instal Edge dari file .tar.
- Menginstal server web pada node dengan repo lokal sehingga node lain dapat mengaksesnya. Apigee menyediakan server web Nginx untuk Anda gunakan, atau Anda dapat menggunakan server web Anda sendiri.
Menginstal dari file .tar
Untuk menginstal dari file .tar:
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal menjadi satu
file .tar bernama
/opt/apigee/data/apigee-mirror/apigee-4.52.01.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
pada node baru. - Di node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
- Pada node baru, pastikan Anda dapat mengakses repo utilitas Yum lokal dan repo EPEL.
- Periksa kembali apakah semua repositori internet eksternal dinonaktifkan (seharusnya ini terjadi karena Anda menginstal pada komputer tanpa akses internet):
sudo yum repolist
Semua repositori eksternal harus dinonaktifkan, tetapi repo Apigee lokal dan repo internal Anda harus diaktifkan.
- Pada node baru, instal
yum-utils
danyum-plugin-priorities
dari repo lokal Anda.sudo yum install yum-utils
sudo yum install yum-plugin-priorities
Tim operasi atau grup lain dalam organisasi Anda harus menyiapkan repo lokal agar Anda dapat menginstal alat Yum.
- Di node baru, periksa versi
libdb4
Anda seperti yang dijelaskan di atas. - Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut:
sudo yum-config-manager --enable ol7_optional_latest
- Jika Anda menginstal di AWS, jalankan perintah
yum-configure-manager
berikut:sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Pada node baru, untar file ke direktori /tmp:
tar -xzf apigee-4.52.01.tar.gz
Perintah ini akan membuat direktori baru, yang bernama repo, dalam direktori yang berisi file .tar. Misalnya
/tmp/repos.
- Instal utilitas dan dependensi layanan apigee Edge dari
/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Perhatikan bahwa Anda menyertakan jalur ke direktori repositori dalam perintah ini.
- 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 pada node untuk mengetahui informasi selengkapnya.
Menginstal dari repo menggunakan server web Nginx
Untuk menginstal dari repo menggunakan server web Nginx:
- 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. Membuat file jika tidak ada. - Tetapkan nilai berikut seperlunya:
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
- Pada node baru, instal
yum-utils
danyum-plugin-priorities
.sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Di node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
- Di node baru, pastikan repo EPEL lokal diaktifkan.
- Di node baru, periksa versi
libdb4
Anda seperti yang dijelaskan di atas. - Pada node jarak jauh, download file bootstrap_4.52.01.sh Edge ke
/tmp/bootstrap_4.52.01.sh
:curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
Dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas untuk repo, dan remoteRepo adalah alamat IP atau nama DNS node repo.
- Pada node jarak jauh, instal utilitas dan dependensi Edge
apigee-service
:sudo bash /tmp/bootstrap_4.52.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Dengan uName:pWord adalah nama pengguna dan sandi repo.
- Pada 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 pada node jarak jauh. Lihat Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.
Mengupdate repositori Apigee lokal
Untuk mengupdate repo, Anda harus mendownload file bootstrap_4.52.01.sh terbaru, lalu melakukan sinkronisasi baru.
Untuk mengupdate repo:
- Download file Edge bootstrap_4.52.01.sh ke
/tmp/bootstrap_4.52.01.sh
:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
- Jalankan file
bootstrap_4.52.01.sh
Edge:sudo bash/tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.
- Perbarui
apigee-mirror
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- Jalankan sinkronisasi:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- Jika Anda ingin menggunakan seluruh repo:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
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
Tambahkan atau update Edge 4.16.0x/4.17.0x dalam repo 4.52.01
Jika harus mempertahankan penginstalan untuk Edge 4.16.0x atau 4.17.0x dalam repo 4.52.01, Anda dapat mempertahankan repo yang berisi semua versi. Dari repo tersebut, Anda kemudian dapat menginstal versi Edge apa pun.
Untuk menambahkan 4.16.0x/4.17.0x ke repo 4.52.01:
- Pastikan Anda telah menginstal utilitas
apigee-mirror
versi 4.52.01:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
Anda akan melihat hasilnya dalam formulir di bawah, dengan xyz sebagai nomor build:
apigee-mirror-4.52.01-0.0.xyz
- Gunakan utilitas
apigee-mirror
untuk mendownload Edge 4.16.0x/4.17.0x ke repo Anda. Perhatikan cara Anda mengawali perintah dengan versi yang diinginkan:apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Gunakan perintah yang sama ini untuk mengupdate repositori 4.16.0x/4.17.0x nanti dengan menentukan nomor versi yang diperlukan.
- Periksa direktori
/opt/apigee/data/apigee-mirror/repos
untuk melihat struktur file:ls /opt/apigee/data/apigee-mirror/repos
Anda akan melihat file dan direktori berikut:
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh bootstrap_4.18.05.sh bootstrap_4.19.01.sh thirdparty
Perhatikan bagaimana Anda memiliki file bootstrap untuk semua versi Edge. Direktori
apigee
juga berisi direktori terpisah untuk setiap versi Edge. - Untuk mengemas repo menjadi file .tar, gunakan perintah berikut:
apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
Perintah ini mengemas semua repo 4.17.0x dan 4.16.0x ke dalam file .tar yang sama. Anda tidak dapat mengemas hanya sebagian dari repo.
Untuk menginstal Edge dari repo lokal atau file .tar, pastikan Anda menjalankan file bootstrap yang benar menggunakan salah satu perintah berikut. Contoh ini menginstal Edge 4.17.01:
- Jika menginstal dari file .tar, jalankan file bootstrap yang benar dari repo:
sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Untuk menyelesaikan penginstalan, ikuti langkah-langkah yang tersisa dari bagian "Menginstal dari file .tar" di atas.
- Jika menginstal menggunakan server web Nginx, download lalu jalankan file bootstrap yang benar
dari repo:
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Untuk menyelesaikan penginstalan, ikuti langkah-langkah yang tersisa dari "Menginstal dari repo menggunakan server web Nginx" di atas.