Menginstal utilitas penyiapan apigee Edge

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.

Prasyarat: Nonaktifkan SELinux

Anda harus menonaktifkan SELinux, atau menyetelnya ke mode permisif, sebelum dapat menginstal Edge Utilitas apigee-setup atau Edge apa pun komponen. 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 8.x: 
      sudo setenforce 0

      Untuk mengaktifkan kembali SELinux setelah menginstal Edge:

      sudo setenforce 1
    • 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: 
      sudo echo 0 > /selinux/enforce

      Untuk mengaktifkan kembali SELinux setelah menginstal Edge:

      sudo echo 1 > /selinux/enforce
  • Untuk secara permanen menonaktifkan SELinux atau menetapkannya ke mode permisif:
    1. Buka /etc/sysconfig/selinux di editor.
    2. Tetapkan SELINUX=disabled atau SELINUX=permissive
    3. Simpan hasil editan Anda.
    4. Mulai ulang node.
    5. Jika perlu, aktifkan kembali SELinux setelah penginstalan Edge dengan mengulangi prosedur ini untuk tetapkan SELINUX=enabled.

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 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 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. Jika Anda memiliki versi yang lebih baru, copot instalasinya dan penginstal Edge akan kemudian instal 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 anotasi.

Prasyarat untuk RHEL 8

Jika Anda menginstal Edge pada server yang menjalankan Red Hat Enterprise Linux (RHEL) 8, lakukan langkah berikut sebelum menjalankan penginstalan:

  1. Aktifkan Paket Tambahan untuk Linux Perusahaan (EPEL): 
    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  2. Nonaktifkan Postgres dan NGINX: 
    sudo dnf module disable postgresql
sudo dnf module disable nginx
  3. Instal Python 2 dan buat symlink: 
    sudo dnf install -y python2
sudo ln -s /usr/bin/python2 /usr/bin/python

Menginstal utilitas penyiapan apigee Edge pada node dengan internet eksternal koneksi

Untuk menginstal Edge pada node dengan koneksi internet eksternal:

  1. Dapatkan nama pengguna dan sandi dari Apigee yang Anda gunakan untuk mengakses repositori Apigee. Jika Anda sudah memiliki username:password untuk situs FTP Apigee, Anda dapat menggunakannya memiliki kredensial yang lengkap.
  2. Login ke node Anda sebagai root untuk menginstal RPM Edge
  3. Instal yum-utils dan yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Nonaktifkan SELinux.
  5. Aktifkan repositori EPEL.
  6. Periksa versi Anda dari libdb4.
  7. Jika Anda menginstal di RHEL 8, ikuti langkah-langkah di Prasyarat untuk RHEL 8.
  8. Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. Jika Anda menginstal di AWS, jalankan perintah berikut Perintah yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Download file bootstrap_4.51.00.sh Edge ke /tmp/bootstrap_4.51.00.sh: 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  11. Instal utilitas dan dependensi layanan Edge apigee: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Dari mana uName:pWord adalah nama pengguna dan sandi yang Anda terima 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 mengambil nilai berikut:

    • I: Menginstal 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*'
  12. Gunakan apigee-service untuk menginstal utilitas apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Gunakan apigee-setup untuk menginstal dan mengonfigurasi komponen Edge pada node. Lihat Menginstal komponen Edge pada node untuk informasi selengkapnya.

Pemecahan masalah

Saat mencoba menginstal pada {i>node<i} dengan koneksi internet eksternal, Anda mungkin menemui 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 tersebut:

Jenis Kesalahan Kemungkinan Penyelesaian
Sandi mengandung karakter yang buruk Jangan gunakan karakter khusus dalam sandi Apigee Anda.
Masalah konektivitas

Uji konektivitas jaringan dengan menjalankan ncat berikut berikut:

nc -v software.apigee.com 443

Anda akan mendapatkan pesan yang mirip dengan yang berikut ini:

Connection to software.apigee.com 443 port [tcp/https] succeeded!

Jika belum menginstal nc, Anda dapat menjalankan perintah berikut Perintah telnet:

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 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 melakukan perluasan yang sama konfigurasi ke pengelola paket yum. Periksa variabel lingkungan Anda: 
echo $http_proxy
echo $https_proxy

Untuk proxy HTTP keluar, Anda harus menggunakan salah satu opsi berikut:

  • Menambahkan konfigurasi proxy HTTP di /etc/yum.conf
  • Tambahkan konfigurasi proxy HTTP global di /etc/environment

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 internet, maka Anda harus membuat beberapa repositori, atau {i>mirror<i}, yang berisi file yang akan butuhkan selama penginstalan. Selanjutnya, cermin tersebut harus dapat diakses oleh semua node. Setelah dibuat, node dapat mengakses cermin lokal ini untuk menginstal Edge.

Proses penginstalan Apigee Edge untuk node tanpa koneksi internet yang memerlukan akses ke repositori lokal berikut:

Membuat repositori Apigee lokal

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 Apigee lokal, Anda mungkin nanti harus mengupdatenya dengan File rilis Edge. Bagian berikut menjelaskan cara membuat repositori Apigee lokal, dan cara memperbaruinya.

Untuk membuat repo Apigee lokal:

  1. 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.
  2. Login ke node Anda sebagai root untuk menginstal RPM Edge.
  3. Nonaktifkan SELinux seperti yang dijelaskan di atas.
  4. Download file bootstrap_4.51.00.sh Edge ke /tmp/bootstrap_4.51.00.sh: 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  5. Instal utilitas dan dependensi layanan Edge apigee: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Dari mana uName:pWord adalah nama pengguna dan sandi yang Anda terima Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.

  6. Instal utilitas apigee-mirror pada node: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  7. 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 hanya RPM terbaru. 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.

  8. (Opsional) Jika Anda ingin menginstal Edge dari repositori lokal ke yang menghosting repositori lokal, Anda harus menjalankan perintah berikut terlebih dahulu:
    1. Jalankan bootstrap_4.51.00.sh dari repo lokal untuk menginstal Utilitas apigee-service: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Gunakan apigee-service untuk menginstal utilitas apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Gunakan apigee-setup untuk menginstal dan mengonfigurasi komponen Edge pada node. Lihat Instal komponen Edge pada node untuk mengetahui informasi selengkapnya.

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, atau Anda dapat menggunakan server web dengan server web

Menginstal dari file .tar

Untuk menginstal dari file .tar:

  1. 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.51.00.tar.gz: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Salin file .tar ke node tempat Anda ingin menginstal Edge. Misalnya, salin ke Direktori /tmp pada node baru.
  3. Pada node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
  4. Pada node baru, pastikan Anda dapat mengakses repositori utilitas Yum lokal dan EPEL ke dalam repositori tambahan.
  5. Periksa kembali apakah semua repositori internet eksternal dinonaktifkan (seharusnya demikian karena yang Anda instal di komputer tanpa akses internet): 
    sudo yum repolist

    Semua repositori eksternal harus dinonaktifkan, tetapi repositori Apigee lokal dan repositori internal Anda harus diaktifkan.

  6. Pada node baru, instal yum-utils dan yum-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 repositori lokal untuk dapat menginstal alat Yum.

  7. Pada node baru, periksa versi libdb4 Anda seperti yang dijelaskan di atas.
  8. Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. 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
  10. Pada node baru, untar file ke direktori /tmp: 
    tar -xzf apigee-4.51.00.tar.gz

    Perintah ini membuat direktori baru, bernama {i>repos<i}, di direktori yang berisi file {i> .tar<i} . Misalnya /tmp/repos.

  11. Instal utilitas dan dependensi layanan Edge apigee dari /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.

  12. Gunakan apigee-service untuk menginstal utilitas apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Gunakan apigee-setup untuk menginstal dan mengonfigurasi komponen Edge pada node. Lihat Instal komponen Edge pada node untuk mengetahui informasi selengkapnya.

Menginstal dari repo menggunakan server web NGINX

Untuk menginstal dari repo menggunakan server web NGINX:

  1. Instal server web NGINX pada node repo:
    opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Secara default, NGINX dikonfigurasi untuk menggunakan localhost sebagai nama server dan port 3939. Kepada ubah nilai-nilai ini:
    1. Buka /opt/apigee/customer/application/mirror.properties di editor. Buat file jika tidak ada.
    2. Tetapkan nilai berikut seperlunya: 
      conf_apigee_mirror_listen_port=3939
conf_apigee_mirror_server_name=localhost
    3. Mulai ulang NGINX: 
      /opt/nginx/scripts/apigee-nginx restart
  3. Secara default, repo memerlukan nama pengguna:sandi admin:admin. Untuk mengubah kredensial ini, tetapkan variabel lingkungan berikut: 
    MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
  4. Pada node baru, instal yum-utils dan yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. Pada node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
  6. Di node baru, pastikan repo EPEL lokal diaktifkan.
  7. Pada node baru, periksa versi libdb4 Anda seperti yang dijelaskan di atas.
  8. Pada {i>node<i} jarak jauh, unduh file Edge bootstrap_4.51.00.sh ke /tmp/bootstrap_4.51.00.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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.

  9. Pada node jarak jauh, instal utilitas dan dependensi Edge apigee-service: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Dengan uName:pWord adalah nama pengguna dan sandi repo.

  10. Pada node jarak jauh, gunakan apigee-service untuk menginstal apigee-setup utilitas: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Gunakan apigee-setup untuk menginstal dan mengonfigurasi komponen Edge pada node jarak jauh. Lihat Menginstal komponen Edge pada node untuk informasi selengkapnya.

Mengupdate repositori Apigee lokal

Untuk memperbarui repo, Anda harus mengunduh file bootstrap_4.51.00.sh terbaru, lalu melakukan sinkronisasi baru.

Untuk memperbarui repo:

  1. Download file bootstrap_4.51.00.sh Edge ke /tmp/bootstrap_4.51.00.sh: 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  2. Jalankan file bootstrap_4.51.00.sh Edge: 
    sudo bash/tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghapus pWord, Anda akan diminta untuk memasukkannya.

  3. Update apigee-mirror: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Lakukan sinkronisasi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Jika Anda ingin seluruh repo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Membersihkan repo Apigee lokal

Membersihkan repositori 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

Menambahkan atau mengupdate Edge 4.16.0x/4.17.0x dalam repo 4.51.00

Jika Anda harus mempertahankan instalasi untuk Edge 4.16.0x atau 4.17.0x dalam repo 4.51.00, Anda dapat mempertahankan repositori yang berisi semua versi. Dari repo itu, Anda kemudian dapat menginstal versi apa pun Edge.

Untuk menambahkan 4.16.0x/4.17.0x ke repo 4.51.00:

  1. Pastikan Anda telah menginstal apigee-mirror versi 4.51.00 utilitas: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Anda akan melihat hasil dalam formulir di bawah, dengan xyz adalah nomor build:

    apigee-mirror-4.51.00-0.0.xyz
  2. Menggunakan apigee-mirror utilitas untuk mengunduh Edge 4.16.0x/4.17.0x ke repo Anda. Perhatikan bagaimana Anda memberikan awalan 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 memperbarui repo 4.16.0x/4.17.0x dengan menentukan nomor versi.

  3. 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
bootstrap_4.18.01.sh
bootstrap_4.18.05.sh
bootstrap_4.19.01.sh
thirdparty

    Perhatikan bahwa Anda memiliki file bootstrap untuk semua versi Edge. apigee juga berisi direktori terpisah untuk setiap versi Edge.

  4. 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 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 "Instal dari repo menggunakan server web NGINX" di atas.