Menginstal utilitas penyiapan apigee Edge

Edge for Private Cloud v. 4.17.09

Untuk menginstal Edge pada 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: 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.

  • Untuk menetapkan SELinux ke mode permisif sementara, jalankan perintah berikut:
    1. Di sistem operasi Linux 6.x: 
      > sudo echo 0 > /selinux/enforce

      Untuk mengaktifkan kembali SELinux setelah menginstal Edge:

      > sudo echo 1 > /selinux/enforce
    2. Di sistem operasi Linux 7.x: 
      > sudo setenforce 0

      Untuk mengaktifkan kembali SELinux setelah menginstal Edge:

      > sudo setenforce 1
  • Untuk menonaktifkan SELinux secara permanen atau menyetelnya ke mode permisif:
    1. Buka /etc/sysconfig/selinux di editor.
    2. Menetapkan 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: Mengaktifkan repo EPEL

Anda harus mengaktifkan Paket Tambahan untuk Enterprise Linux (atau EPEL) guna menginstal atau mengupdate Edge, atau membuat repo lokal. Perintah 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: Memeriksa 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 menginstal. Edge memerlukan versi 4.8 dan beberapa versi RedHat 7.4 serta CentOS 7.4 dikirimkan dengan versi yang lebih baru.

Anda dapat menggunakan perintah berikut untuk memeriksa versi Anda:

> 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:

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 sudah memiliki nama pengguna:sandi untuk situs ftp Apigee, Anda dapat menggunakan kredensial tersebut.
  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 seperti yang dijelaskan di atas.
  5. Aktifkan repositori EPEL seperti yang dijelaskan di atas.
  6. 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
  7. 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
  8. Instal utilitas dan dependensi apigee-service Edge: 
    > 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 Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.

    Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika belum, alat ini 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 = Lanjutkan tanpa menginstal Java
    • Q = 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 repositori, gunakan perintah:

    > sudo yum -v repolist 'apigee*'
  9. Gunakan apigee-service untuk menginstal utilitas apigee-setup: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  10. Gunakan apigee-setup untuk menginstal dan mengonfigurasi komponen Edge pada node. Lihat Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.

Menginstal utilitas apigee-setup Edge pada node tanpa koneksi Internet eksternal

Jika node Edge Anda berada di belakang firewall, atau dengan cara lain dilarang mengakses repositori Apigee melalui Internet, Anda harus membuat repositori lokal, atau mirror, dari repo Apigee. Mirror tersebut kemudian harus dapat diakses oleh semua node. Setelah dibuat, node kemudian dapat mengakses mirror lokal tersebut untuk menginstal Edge.

Untuk membuat repositori Apigee internal, Anda memerlukan node dengan akses internet eksternal agar dapat mendownload RPM dan dependensi Edge. Setelah membuat repositori internal, Anda dapat memindahkannya ke node lain atau membuat node tersebut dapat diakses oleh node Edge untuk penginstalan.

Setelah membuat repositori Edge lokal, Anda mungkin harus mengupdatenya nanti dengan file rilis Edge terbaru. Bagian berikut menjelaskan cara membuat repositori lokal, dan cara mengupdatenya.

Membuat repositori Apigee lokal

Untuk membuat repositori Apigee lokal:

  1. Dapatkan nama pengguna dan sandi dari Apigee yang Anda gunakan untuk mengakses repositori Apigee. Jika Anda sudah memiliki nama pengguna:sandi untuk situs ftp Apigee, Anda dapat menggunakan kredensial tersebut.
  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 seperti yang dijelaskan di atas.
  5. Aktifkan repositori EPEL seperti yang dijelaskan di atas.
  6. 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
  7. 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
  8. Instal utilitas dan dependensi apigee-service Edge: 
    > 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 Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.

  9. Instal utilitas apigee-mirror di node: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  10. 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. Anda memerlukan kapasitas 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 lama, hapus --only-new-rpms. Anda memerlukan kapasitas disk sekitar 6 GB untuk download lengkap: 

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Sekarang Anda memiliki salinan lokal repositori Apigee. Bagian berikutnya menjelaskan cara menginstal utilitas apigee-setup Edge dari repo lokal.

  11. (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.17.09.sh dari repo lokal untuk menginstal utilitas apigee-service: 
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.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 Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.

Menginstal apigee-setup di node jarak jauh dari repositori 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.
  • Instal server web di node dengan repositori lokal agar node lain dapat mengaksesnya. Apigee menyediakan server web Nginx untuk Anda gunakan, atau Anda dapat menggunakan server web Anda sendiri.

Instal dari file .tar:

  1. Pada node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.17.09.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 di node baru.
  3. Instal yum-utils dan yum-plugin-priorities: 
    > sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
  4. Pada node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
  5. Aktifkan repositori EPEL seperti yang dijelaskan di atas.
  6. Di node baru, ekstrak file ke direktori /tmp:
    > tar -xzf apigee-4.17.09.tar.gz

    Perintah ini akan membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya, /tmp/repos.

  7. Instal utilitas dan dependensi apigee-service Edge 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.

  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 pada node. Lihat Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.

Instal 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 belum 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 nama pengguna:sandi admin:admin. Untuk mengubah kredensial ini, tetapkan variabel lingkungan berikut: 
    MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
  4. 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. Aktifkan repositori EPEL seperti yang dijelaskan di atas.
  7. Pada node jarak jauh, download file bootstrap_4.17.09.sh Edge 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 repo, dan remoteRepo adalah alamat IP atau nama DNS node repo.

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

    dengan uName:pWord sebagai nama pengguna dan sandi repo.

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

Memperbarui repositori Apigee lokal

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

  1. 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
  2. Jalankan file Edge bootstrap_4.17.09.sh: 
    > 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 Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.

  3. Perbarui 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 mendownload seluruh repositori: 
    > /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

Menambahkan atau mengupdate Edge 4.16.0x/4.17.0x di repo 4.17.09

Jika Anda harus mengelola penginstalan untuk Edge 4.16.0x atau 4.17.01/4.17.05 di repo 4.17.09, Anda dapat mengelola repo yang berisi semua versi. Dari repo tersebut, Anda dapat menginstal Edge versi apa pun.

Untuk menambahkan 4.16.0x/4.17.0x ke repo 4.17.09:

  1. 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 bentuk di bawah, dengan xyz adalah nomor build:

    apigee-mirror-4.17.09-0.0.xyz
  2. Gunakan utilitas apigee-mirror untuk mendownload Edge 4.16.0x/4.17.01/4.17/05 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.05 nanti dengan menentukan nomor versi yang diperlukan.

  3. 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
thirdparty

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

  4. Untuk memaketkan repositori ke dalam 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 memaketkan hanya sebagian repo.

Untuk menginstal Edge dari repo lokal atau file .tar, pastikan untuk 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 selanjutnya dari "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 selanjutnya dari "Menginstal dari repo menggunakan server web Nginx" di atas.