Menginstal utilitas penyiapan apigee Edge

Untuk menginstal Edge di node, Anda harus menginstal utilitas apigee-setup Edge 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 mengetahui informasi selengkapnya.

Prasyarat: Nonaktifkan SELinux

Anda harus menonaktifkan SELinux, atau menyetelnya ke mode permisif, sebelum dapat menginstal Edge apigee-setup utilitas atau komponen Edge apa pun. Jika perlu, setelah menginstal Edge, Anda dapat mengaktifkan kembali SELinux.

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

    • Prasyarat: Aktifkan repo EPEL

    Anda harus mengaktifkan Extra Packages for Enterprise Linux (atau EPEL) untuk menginstal atau mengupdate Edge, atau untuk membuat repo lokal. Untuk Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x, atau Oracle Linux 9.x, jalankan perintah berikut:

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    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:

    1. Aktifkan Extra Packages for Enterprise Linux (EPEL): 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. Nonaktifkan Postgres dan Nginx: 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    Untuk mengetahui perubahan pra-penginstalan untuk PostgreSQL dan LDAP, lihat Database PostgreSQL persyaratan pra-penginstalan dan SymasLDAP 2.6.10 perubahan pra-penginstalan.

    Menginstal utilitas apigee-setup Edge di node dengan koneksi internet eksternal

    Untuk menginstal Edge di node dengan koneksi internet eksternal:

    1. Dapatkan nama pengguna dan sandi dari Apigee yang Anda gunakan untuk mengakses repositori Apigee. Jika Anda memiliki username:password yang sudah ada untuk situs ftp Apigee, Anda dapat menggunakan kredensial tersebut.
    2. Login ke node Anda sebagai root untuk menginstal RPM Edge
    3. Nonaktifkan SELinux.
    4. Aktifkan repo EPEL.
    5. Jika Anda menginstal di RHEL 9/Rocky 9/Oracle 9, ikuti langkah-langkah di Prasyarat untuk RHEL 9/Rocky 9/Oracle 9.
    6. Download file Edge bootstrap_4.54.00.sh ke /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. Instal utilitas dan dependensi apigee-service Edge: 
      sudo bash /tmp/bootstrap_4.54.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.

      Apigee Edge untuk Private Cloud 4.54.00 memerlukan dukungan Java ganda dengan Java 17 dan Java 21 yang diinstal di node. Anda harus menginstal Java 17 dan Java 21 sebelum menjalankan skrip bootstrap. Penginstal hanya memverifikasi bahwa kedua versi JDK telah diinstal; penginstal tidak menginstal Java secara otomatis.

      Penginstalan utilitas apigee-service 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*'
    8. Gunakan apigee-service untuk menginstal utilitas apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    9. Gunakan apigee-setup untuk menginstal dan mengonfigurasi komponen Edge di node. Lihat Menginstal komponen Edge di node untuk mengetahui informasi selengkapnya.

    Pemecahan masalah

    Saat mencoba menginstal di node dengan koneksi internet eksternal, Anda mungkin mengalami 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 resolusi untuk error ini:

    Jenis Error Kemungkinan Resolusi
    Sandi berisi karakter yang tidak valid Jangan gunakan karakter khusus dalam sandi Apigee Anda.
    Masalah konektivitas

    Uji konektivitas jaringan Anda dengan menjalankan perintah ncat 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 Anda tidak menginstal nc, Anda dapat menjalankan perintah telnet berikut:

    telnet software.apigee.com 443

    Jika perintah berhasil, Anda dapat menggunakan CTRL+C untuk membatalkan koneksi terbuka.

    Jika salah satu perintah gagal, berarti Anda memiliki konektivitas jaringan yang 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
echo $https_proxy

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

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

    Menginstal utilitas apigee-setup Edge di 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 cermin, yang berisi file yang akan Anda perlukan selama penginstalan. Cermin tersebut kemudian 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 memerlukan akses ke repo 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 harus mengupdatenya nanti dengan file rilis Edge terbaru. Bagian berikut menjelaskan cara membuat repositori Apigee lokal, dan cara mengupdatenya.

    Untuk membuat repo Apigee lokal:

    1. Dapatkan nama pengguna dan sandi dari Apigee yang Anda gunakan untuk mengakses repositori Apigee. Jika Anda memiliki username:password yang sudah ada untuk situs ftp Apigee, Anda dapat menggunakan kredensial tersebut.
    2. Login ke node Anda sebagai root untuk menginstal RPM Edge.
    3. Nonaktifkan SELinux seperti yang dijelaskan di atas.
    4. Download file Edge bootstrap_4.54.00.sh ke /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. Instal utilitas dan dependensi apigee-service Edge: 
      sudo bash /tmp/bootstrap_4.54.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.

    6. Instal utilitas apigee-mirror di 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.

    8. (Opsional) Jika Anda ingin menginstal Edge dari repo lokal ke node yang sama yang menghosting repo lokal, Anda harus menjalankan perintah berikut terlebih dahulu:
      1. Jalankan bootstrap_4.54.00.sh dari repo lokal untuk menginstal utilitas apigee-service: 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.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 di node. Lihat Menginstal komponen Edge di node untuk mengetahui informasi selengkapnya.

    Menginstal apigee-setup di node jarak jauh dari repo lokal

    Anda memiliki dua opsi untuk menginstal Edge dari repo lokal. Anda dapat:

    • Membuat file .tar repo, menyalin file .tar ke node, lalu menginstal Edge dari file .tar.
    • Menginstal server web di 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:

    1. Di node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.54.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 /tmp direktori di node baru.
    3. Di node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
    4. Di node baru, pastikan Anda dapat mengakses repo utilitas Yum lokal dan repo EPEL repo.
    5. Periksa kembali bahwa semua repo internet eksternal dinonaktifkan (hal ini seharusnya terjadi karena Anda menginstal di mesin tanpa akses internet): 
      sudo yum repolist

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

    6. Gunakan apigee-service untuk menginstal utilitas apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    7. Gunakan apigee-setup untuk menginstal dan mengonfigurasi komponen Edge di node. Lihat Menginstal komponen Edge di 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 di 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. Untuk mengubah nilai ini:
      1. Buka /opt/apigee/customer/application/mirror.properties di editor. Buat file jika tidak ada.
      2. Tetapkan nilai berikut sesuai kebutuhan: 
        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 username:password admin:admin. Untuk mengubah kredensial ini, tetapkan variabel lingkungan berikut: 
      MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
    4. Di node baru, pastikan repositori EPEL diaktifkan secara lokal.
    5. Di node baru, periksa versi libdb4 Anda seperti yang dijelaskan di atas.
    6. Di node jarak jauh, instal utilitas dan dependensi apigee-service Edge: 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Dengan uName:pWord adalah nama pengguna dan sandi repo.

    7. Di node jarak jauh, gunakan apigee-service untuk menginstal utilitas apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    8. Gunakan apigee-setup untuk menginstal dan mengonfigurasi komponen Edge di node jarak jauh. Lihat Menginstal komponen Edge di node untuk mengetahui informasi selengkapnya.

    Mengupdate repositori Apigee lokal

    Untuk mengupdate repo, Anda harus mendownload file bootstrap_4.54.00.sh terbaru, lalu melakukan sinkronisasi baru.

    Untuk mengupdate repo:

    1. Download file bootstrap_4.54.00.sh Edge ke /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    2. Jalankan file bootstrap_4.54.00.sh Edge: 
      sudo bash/tmp/bootstrap_4.54.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 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