Menginstal utilitas penyiapan apigee Edge

Edge untuk Private Cloud v. 4.16.05

Untuk menginstal Edge pada sebuah node, Anda perlu menginstal utilitas penyiapan Edge apigee terlebih dahulu. Jika berada di lingkungan di mana node Anda tidak memiliki koneksi internet eksternal, Anda juga harus menginstal salinan lokal repo Apigee.

Membuat symlink dari /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.

Sebelum membuat symlink, Anda harus terlebih dahulu membuat pengguna dan grup bernama "apigee". Ini adalah grup dan pengguna yang sama dengan yang dibuat oleh Edge Installer.

Untuk membuat symlink, lakukan langkah-langkah ini sebelum mengunduh file bootstrap_4.16.05.sh. Anda harus melakukan semua langkah ini sebagai root:

  1. Buat pengguna dan grup "apigee":
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. Buat symlink dari /opt/apigee ke root penginstalan yang Anda inginkan:
    > ln -Ts /srv/myInstallDir /opt/apigee
    dengan /srv/myInstallDir adalah lokasi yang diinginkan untuk file Edge.
  3. Ubah kepemilikan root penginstalan dan symlink ke pengguna "apigee":
    > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

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 menyetel SELinux untuk sementara ke mode permisif, jalankan perintah berikut:
    1. Di sistem operasi Linux 6.x:
      echo 0 > /selinux/enforce

      Untuk mengaktifkan kembali SELinux setelah menginstal Edge:
      echo 1 > /selinux/enforce
    2. Di sistem operasi Linux 7.x:
      setenforce 0

      Untuk mengaktifkan kembali SELinux setelah menginstal Edge:
      setenforce 1
  • 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.

Instal utilitas apigee-setup Edge pada node dengan koneksi internet eksternal

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 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
    Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
  3. Nonaktifkan SELinux seperti yang dijelaskan di atas.
  4. Download file bootstrap_4.16.05.sh ke /tmp/bootstrap_4.16.05.sh:
    > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  5. Instal utilitas dan dependensi layanan Edge apigee:
    > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

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

    Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, aplikasi akan diinstal untuk Anda. Gunakan opsi JAVA_FIX untuk menentukan cara menangani penginstalan Java. JAVA_FIX menggunakan nilai berikut:

    I = Install OpenJDK 1.8 (default)
    C = Lanjutkan tanpa menginstal Java
    Q = 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*'
  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 pada node. Lihat Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.

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 repositori Apigee melalui Internet, Anda harus membuat repositori lokal, atau mencerminkan, repo Apigee. Mirror tersebut kemudian harus dapat diakses oleh semua node. Setelah dibuat, node kemudian dapat mengakses mirror lokal tersebut untuk menginstal Edge.

Catatan: Apigee tidak menghosting semua dependensi pihak ketiga di repositori publik kami. Anda harus mendownload dan menginstal dependensi ini dari repositori yang dapat diakses secara publik.

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

Membuat repositori Apigee lokal

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 menggunakan kredensial tersebut.
  2. Login ke node RedHat atau CentOS sebagai root untuk menginstal RPM Edge.
    Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
  3. Pastikan Anda memiliki yum-utils versi terbaru:
    > sudo yum update yum-utils
  4. Nonaktifkan SELinux seperti yang dijelaskan di atas.
  5. Download file bootstrap_4.16.05.sh ke /tmp/bootstrap_4.16.05.sh:
    > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  6. Instal utilitas dan dependensi layanan Edge apigee:
    > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

    dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika pWord dihapus, Anda akan diminta untuk memasukkannya.
  7. Instal utilitas apigee-mirror pada node:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  8. 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 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 lama, hapus --only-new-rpms. Anda memerlukan ruang disk sekitar 6 GB untuk download lengkap:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Anda kini memiliki salinan lokal repo Apigee. Bagian berikutnya menjelaskan cara menginstal utilitas apigee-setup Edge dari repo lokal.
  9. (Opsional) Jika ingin menginstal Edge dari repo lokal ke node yang sama dengan yang menghosting repo lokal, Anda harus menjalankan perintah berikut terlebih dahulu:
    1. Jalankan bootstrap_4.16.05.sh dari repo lokal untuk menginstal utilitas apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigeee
    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 pada node jarak jauh dari repo lokal

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

  • Buat file .tar untuk repo, salin file .tar ke node, lalu instal Edge dari file .tar.
  • 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 Anda sendiri.

Instal dari file .tar:

  1. Pada node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal menjadi satu file .tar dengan nama /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:

    > /opt/apigee/apigee-service/bin/apigee-mirror package apigee
  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, untar file ke direktori /tmp:
    > tar -xzf apigee-4.16.05.tar.gz

    Perintah ini akan membuat direktori baru, bernama repo, di direktori yang berisi file .tar. Misalnya /tmp/repos.
  5. Instal utilitas dan dependensi Edge apigee-service dari /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Perhatikan bahwa Anda menyertakan jalur ke direktori repositori dalam perintah ini.
  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 pada node. Lihat Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.

Instal 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. Untuk mengubah nilai ini
    1. Buka /opt/apigee/customer/application/mirror.properties di editor. Membuat 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 ini memerlukan nama pengguna:sandi admin:admin. Untuk mengubah kredensial ini, tetapkan variabel lingkungan berikut:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. Pada node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
  5. Di node jarak jauh, download file Edge bootstrap_4.16.05.sh ke /tmp/bootstrap_4.16.05.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o 0.4.16.05.sh dan nama pengguna.

  6. Pada node jarak jauh, instal utilitas dan dependensi layanan Edge apigee:
    > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeeprotocol=://pName.

  7. Pada 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 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.16.05.sh terbaru, lalu lakukan sinkronisasi baru:

  1. Download file Edge bootstrap_4.16.05.sh ke /tmp/bootstrap_4.16.05.sh:
    > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  2. Lakukan sinkronisasi:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  3. 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.01 dalam repo 4.16.05

Jika harus mempertahankan penginstalan untuk Edge 4.16.05 dan 4.16.01, Anda dapat mempertahankan repo yang berisi kedua versi tersebut. Dari repo tersebut, Anda dapat menginstal Edge 4.16.05 dan 4.16.01.

Untuk menambahkan 4.16.01 ke repo 4.15.05:

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

    Anda akan melihat hasilnya dalam formulir di bawah, dengan xyz adalah nomor build:
    apigee-mirror-4.
  2. Gunakan utilitas apigee-mirror untuk mendownload Edge 4.16.01 ke repo Anda. Perhatikan cara Anda memberi awalan pada perintah dengan apigeereleasever=4.16.01:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Gunakan perintah yang sama ini untuk mengupdate versi 4.016 nanti.
  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.

    Direktori apigee juga berisi direktori terpisah untuk setiap versi Edge.
  4. Untuk mengemas repo menjadi file .tar, gunakan perintah berikut:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    Perintah ini memaketkan 4.16.05 dan 4.16.01 repostar yang sama ke dalam file repostar yang sama Anda tidak dapat memaketkan hanya sebagian dari repo.

Untuk menginstal Edge dari repo lokal atau file .tar, pastikan untuk menjalankan file bootstrap yang benar menggunakan salah satu perintah berikut:

  • Jika menginstal dari file .tar, jalankan file bootstrap yang benar dari repo:
    > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Untuk menyelesaikan penginstalan, ikuti langkah-langkah yang tersisa dari "Install" dari file .tar di atas.
  • Jika menginstal menggunakan webserver Nginx, download lalu jalankan file bootstrap yang benar dari repo:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
    > bootstrap_4.16.0X.sh