Edge for Private Cloud v. 4.17.09
Untuk menginstal Edge pada node, instal utilitas penyiapan Edge apigee terlebih dahulu. Jika Anda berada dalam tempat node Anda 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 mengubahnya
saat ini. Namun, jika diinginkan, Anda dapat membuat symlink untuk memetakan /opt/apigee
ke
lokasi lain. Lihat Persyaratan Penginstalan untuk mengetahui informasi selengkapnya
tidak akurat atau tidak sesuai.
Prasyarat: Nonaktifkan SELinux
Anda harus menonaktifkan SELinux, atau menyetelnya ke mode permisif, sebelum dapat menginstal Edge
Utilitas apigee-setup
atau komponen Edge apa pun. Jika perlu, setelah menginstal Edge, Anda
dapat mengaktifkan kembali SELinux.
- Untuk menetapkan SELinux ke mode permisif untuk sementara, jalankan perintah berikut
berikut:
- Di sistem operasi Linux 6.x:
> sudo echo 0 > /selinux/enforce
Untuk mengaktifkan kembali SELinux setelah menginstal Edge:
> sudo echo 1 > /selinux/enforce
- Di sistem operasi Linux 7.x:
> sudo setenforce 0
Untuk mengaktifkan kembali SELinux setelah menginstal Edge:
> sudo setenforce 1
- Di sistem operasi Linux 6.x:
- Untuk secara permanen menonaktifkan SELinux atau menetapkannya ke mode permisif:
- 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
tetapkan
SELINUX=enabled
.
- Buka
Prasyarat: Aktifkan repo EPEL
Anda harus mengaktifkan Paket Tambahan untuk Enterprise Linux (atau EPEL) untuk menginstal atau mengupdate Edge, atau membuat repo lokal. Tujuan yang Anda gunakan bergantung pada versi RedHat/CentOS:
- Untuk RedHat/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 RedHat/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
Prasyarat: Periksa libdb4 versi library pada RedHat 7.4 dan CentOS 7.4
Di RedHat 7.4 dan CentOS 7.4, periksa versi RPM libdb4
sebelum Anda menginstalnya. Tepi
memerlukan versi 4.8 dan beberapa versi RedHat 7.4 dan CentOS 7.4 ship dengan
versi yang lebih baru.
Anda dapat menggunakan perintah berikut untuk memeriksa versi:
> rpm -qa | grep libdb
Jika Anda melihat bahwa versi RPM libdb4
lebih baru dari versi 4.8, gunakan
perintah berikut untuk mengganti RPM:
> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm
Jika harus mendownload RPM ini, Anda bisa mendapatkannya dari:
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm
Instal Edge utilitas apigee-setup 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 nama pengguna:sandi untuk situs FTP Apigee, Anda dapat menggunakannya memiliki kredensial yang lengkap.
- 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 seperti yang dijelaskan di atas.
- Aktifkan repositori EPEL seperti yang dijelaskan di atas.
- 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
- Download file
bootstrap_4.17.09.sh
Edge ke/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Instal utilitas dan dependensi layanan Edge apigee:
> sudo bash /tmp/bootstrap_4.17.09.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 default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, Anda 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 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 utilitasapigee-setup
:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Gunakan
apigee-setup
untuk menginstal dan mengonfigurasi komponen Edge pada node. Lihat Instal komponen Edge pada node untuk mengetahui informasi selengkapnya.
Instal Edge utilitas apigee-setup pada node tanpa koneksi Internet eksternal
Jika node Edge Anda berada di belakang firewall, atau dengan cara lain dilarang mengakses repositori Apigee melalui Internet, maka Anda harus membuat repositori lokal, dari repo Apigee. Kemudian, cermin tersebut harus dapat diakses oleh semua node. Setelah dibuat, node dapat mengakses cermin lokal itu untuk menginstal Edge.
Untuk membuat repositori Apigee internal, Anda memerlukan node dengan internet eksternal akses untuk dapat mendownload RPM dan dependensi Edge. Setelah Anda membuat , Anda dapat memindahkannya ke {i>node<i} lain atau membuat {i>node<i} tersebut dapat diakses oleh {i>node<i} Edge untuk penginstalan.
Setelah membuat repositori Edge lokal, Anda mungkin nanti harus memperbaruinya dengan File rilis Edge. Bagian berikut menjelaskan cara membuat repositori lokal, dan cara memperbaruinya.
Membuat repositori Apigee lokal
Untuk membuat repo Apigee lokal:
- 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 menggunakannya memiliki kredensial yang lengkap.
- 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 seperti yang dijelaskan di atas.
- Aktifkan repositori EPEL seperti yang dijelaskan di atas.
- Jika Anda menginstal di AWS, jalankan perintah berikut
Perintah
yum-configure-manager
:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Download file
bootstrap_4.17.09.sh
Edge ke/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Instal utilitas dan dependensi Edge
apigee-service
:> sudo bash /tmp/bootstrap_4.17.09.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 file terbaru RPM. Anda memerlukan ruang disk sekitar 1,6 GB untuk mendownload:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Jika Anda ingin mendownload seluruh repo, termasuk RPM yang lebih lama, hapus
--only-new-rpms
. Anda memerlukan ruang disk sekitar 6 GB untuk mendownload versi lengkap:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
Anda sekarang memiliki salinan lokal repo Apigee. Bagian selanjutnya menjelaskan cara menginstal Utilitas
apigee-setup
Edge dari repositori lokal. -
(Opsional) Jika Anda ingin menginstal Edge dari repositori lokal ke
yang menghosting repositori lokal, Anda harus menjalankan perintah berikut terlebih dahulu:
- Jalankan
bootstrap_4.17.09.sh
dari repo lokal untuk menginstal Utilitasapigee-service
:> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.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 Instal 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 repo, salin file .tar ke node, lalu instal Edge dari file {i> .tar<i}.
- Instal 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 dengan server web
Instal dari file .tar:
- Pada node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal ke dalam sebuah
file .tar tunggal bernama
/opt/apigee/data/apigee-mirror/apigee-4.17.09.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. - Instal
yum-utils
danyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Pada node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
- Aktifkan repositori EPEL seperti yang dijelaskan di atas.
- Pada node baru, untar file ke direktori /tmp:
> tar -xzf apigee-4.17.09.tar.gz
Perintah ini membuat direktori baru, bernama {i>repos<i}, di direktori yang berisi file {i> .tar<i} . Misalnya
/tmp/repos.
- Instal utilitas dan dependensi layanan Edge apigee dari
/tmp/repos
:> sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.
- Gunakan
apigee-service
untuk instalapigee-setup
utilitas:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Gunakan
apigee-setup
untuk menginstal dan mengkonfigurasi komponen Edge pada node. Lihat Instal komponen Edge pada node untuk mengetahui informasi selengkapnya.
Instal dari repo menggunakan server web Nginx:
- Instal server web Nginx pada 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. Kepada
ubah nilai-nilai ini:
- Buka
/opt/apigee/customer/application/mirror.properties
di editor. Buat 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
- Instal
yum-utils
danyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Pada node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
- Aktifkan repositori EPEL seperti yang dijelaskan di atas.
- Pada node jarak jauh, download file Edge bootstrap_4.17.09.sh ke
/tmp/bootstrap_4.17.09.sh
:> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas untuk 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.17.09.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 Instal komponen Edge pada node untuk mengetahui informasi selengkapnya.
Mengupdate repositori Apigee lokal
Untuk memperbarui repo, Anda harus mengunduh file bootstrap_4.17.09.sh terbaru, lalu lakukan yang baru sinkronisasi:
- Download file bootstrap_4.17.09.sh Edge ke
/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Jalankan file
bootstrap_4.17.09.sh
Edge:> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
dengan uName:pWord adalah nama pengguna dan sandi yang Anda yang diterima 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 mendownload 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 perbarui Edge 4.16.0x/4.17.0x dalam repo 4.17.09
Jika Anda harus mempertahankan instalasi untuk Edge 4.16.0x atau 4.17.01/4.17.05 dalam repo 4.17.09, Anda dapat mempertahankan {i> repo<i} yang berisi semua versi. Dari repo itu, Anda kemudian dapat menginstal versi Edge.
Untuk menambahkan 4.16.0x/4.17.0x ke repo 4.17.09:
- Pastikan Anda telah menginstal utilitas
apigee-mirror
versi 4.17.09:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
Anda akan melihat hasil dalam formulir di bawah, dengan xyz adalah build-nya nomor:
apigee-mirror-4.17.09-0.0.xyz
- Menggunakan
apigee-mirror
utilitas untuk mengunduh Edge 4.16.0x/4.17.01/4.17/05 ke repo Anda. Perhatikan bagaimana Anda memberi awalan pada 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 memperbarui repo 4.16.0x/4.17.05 dengan menentukan nomor versi.
- Periksa direktori
/opt/apigee/data/apigee-mirror/repos
untuk melihat file struktur:> 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 thirdparty
Perhatikan bahwa Anda memiliki file bootstrap untuk semua versi Edge.
apigee
juga berisi direktori terpisah untuk setiap versi Edge. - Untuk memaketkan repo ke dalam file .tar, gunakan perintah berikut:
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
Perintah ini memaketkan semua repo 4.17.0x dan 4.16.0x ke dalam file .tar yang sama. Anda tidak dapat paket hanya sebagian dari repo.
Untuk menginstal Edge dari file .tar atau repo lokal, pastikan untuk menjalankan 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 "Instal dari file .tar" di atas.
- Jika menginstal menggunakan server web Nginx, unduh dan 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 "Instal dari repo menggunakan Server Web Nginx" di atas.