Menginstal utilitas penyiapan apigee Edge

Edge for Private Cloud v. 4.17.05

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 mau, 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 lainnya komponen. Jika perlu, setelah menginstal Edge, Anda dapat mengaktifkan kembali SELinux.

  • Untuk menetapkan SELinux ke mode permisif untuk sementara, jalankan perintah berikut 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 secara permanen menonaktifkan SELinux atau menetapkannya ke mode permisif:
    1. Buka /etc/sysconfig/selinux di .
    2. Setel 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 setel SELINUX=enabled.

Prasyarat: Aktifkan repo EPEL

Anda harus mengaktifkan Paket Tambahan untuk Enterprise Linux (atau EPEL) untuk menginstal atau mengupdate Edge. Perintah yang digunakan bergantung pada pada versi RedHat/CentOS Anda:

  • Untuk RedHat/CentOS 7.x:
    &gt; wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; {i>sudo rpm -ivh<i} epel-release-latest-7.noarch.rpm
  • Untuk RedHat/CentOS 6.x:
    &gt; wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; {i>sudo rpm -ivh<i} epel-release-latest-6.noarch.rpm

Instal Edge utilitas apigee-setup 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 username:password untuk situs FTP Apigee, Anda dapat menggunakannya memiliki kredensial yang lengkap.
  2. Login ke node Anda sebagai root untuk menginstal RPM Edge
    Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan Edge konfigurasi tanpa akses {i>root<i}.
  3. Nonaktifkan SELinux seperti yang dijelaskan di atas.
  4. Aktifkan repositori EPEL seperti yang dijelaskan di atas.
  5. Download file Edge bootstrap_4.17.05.sh ke /tmp/bootstrap_4.17.05.sh:
    &gt; curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  6. Instal utilitas dan dependensi layanan Edge apigee:
    &gt; {i>sudo bash<i} /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

    dengan 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 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:
    &gt; kucing /etc/yum.repos.d/apigee.repo

    Untuk melihat konten repo, gunakan perintah:
    &gt; {i>sudo yum -v repolist<i} 'apigee*'
  7. (Khusus CentOS-6.x dan RedHat-6.x) Pada semua node Qpid, jalankan perintah berikut untuk memastikan Anda mendownload versi Qpid yang benar:
    &gt; yum install apigee-qpidd --disablerepo=epel
  8. Gunakan apigee-service untuk menginstal utilitas apigee-setup:
    &gt; /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 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:

  1. Dapatkan nama pengguna dan sandi dari Apigee yang Anda gunakan untuk mengakses repositori Apigee. Jika sudah memiliki username:password untuk situs FTP Apigee, Anda dapat menggunakannya memiliki kredensial yang lengkap.
  2. Login ke node RedHat atau CentOS sebagai root untuk menginstal RPM Edge.
    Catatan: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan Edge konfigurasi tanpa akses {i>root<i}.
  3. Pastikan Anda memiliki yum-utils versi terbaru:
    &gt; pembaruan {i>sudo yum<i} yum-utils
  4. Nonaktifkan SELinux seperti yang dijelaskan di atas.
  5. Aktifkan repositori EPEL seperti yang dijelaskan di atas.
  6. Download file Edge bootstrap_4.17.05.sh ke /tmp/bootstrap_4.17.05.sh:
    &gt; curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  7. (Khusus CentOS-6.x dan RedHat-6.x) Jalankan perintah berikut untuk memastikan Anda mendownload versi Qpid yang benar:
    &gt; yum install apigee-qpidd --disablerepo=epel
  8. Instal utilitas dan dependensi layanan Edge apigee:
    &gt; {i>sudo bash<i} /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

    dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.
  9. Menginstal apigee-mirror utilitas pada node:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

    Catatan: Jika Anda mengupdate repo yang sudah ada ke versi 4.17.05, Anda hanya perlu mengupdate apigee-mirror:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  10. Menggunakan apigee-mirror untuk menyinkronkan repo Apigee ke /opt/apigee/data/apigee-mirror/repos/ saat ini.

    Untuk meminimalkan ukuran repo, sertakan --only-new-rpms untuk mendownload file terbaru RPM. Anda memerlukan ruang disk sekitar 1,6 GB untuk mendownload:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Jika Anda ingin mendownload seluruh repositori, termasuk RPM yang lebih lama, hapus --only-new-rpms. Anda membutuhkan sekitar 6 GB ruang disk untuk download lengkap:
    &gt; /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 repo lokal.
  11. (Opsional) Jika Anda ingin menginstal Edge dari repositori lokal ke yang menghosting repositori lokal, Anda harus menjalankan perintah berikut terlebih dahulu:
    1. Menjalankan bootstrap_4.17.05.sh dari lokal repositori untuk menginstal utilitas apigee-service:
      &gt; {i>sudo bash<i} /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Menggunakan apigee-service untuk instal apigee-setup utilitas:
      &gt; /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 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 gunakan, atau Anda dapat menggunakan server web dengan server web

Instal 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.17.05.tar.gz:

    &gt; /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 pada direktori baru {i>node<i}.
  3. Pada node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
  4. Pada node baru, untar file ke direktori /tmp:
    &gt; {i>tar -xzf<i} apigee-4.17.05.tar.gz

    Perintah ini membuat direktori baru, bernama {i>repos<i}, dalam direktori yang berisi file {i> .tar<i}. Misalnya /tmp/repos.
  5. Instal utilitas dan dependensi layanan Edge apigee dari /tmp/repos:
    &gt; {i>sudo bash<i} /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.
  6. Menggunakan apigee-service untuk instal apigee-setup utilitas:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. Gunakan apigee-setup untuk menginstal dan mengkonfigurasi komponen Edge pada node. Lihat Menginstal komponen Edge pada node untuk informasi selengkapnya.

Instal dari repo menggunakan server web Nginx:

  1. Instal server web Nginx pada node repo:
    &gt; 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 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:
      &gt; /opt/nginx/scripts/apigee-nginx mulai ulang
  3. Secara default, repo memerlukan nama pengguna:sandi dari 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. Pada node jarak jauh, download file Edge bootstrap_4.17.05.sh ke /tmp/bootstrap_4.17.05.sh:
    &gt; /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

    dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas untuk dan remoteRepo adalah alamat IP atau nama DNS repo {i>node<i}.
  6. Di node jarak jauh, instal utilitas dan dependensi layanan Edge apigee:
    &gt; {i>sudo bash<i} /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    dengan uName:pWord adalah nama pengguna repo dan {i>password<i}.
  7. Di node jarak jauh, gunakan apigee-service untuk menginstal utilitas apigee-setup:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Gunakan apigee-setup untuk menginstal dan konfigurasi 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.17.05.sh terbaru, lalu lakukan yang baru sinkronisasi:

  1. Download file Edge bootstrap_4.17.05.sh ke /tmp/bootstrap_4.17.05.sh:
    &gt; curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  2. Jalankan file bootstrap_4.17.05.sh Edge:
    &gt; {i>sudo bash<i} /tmp/bootstrap_4.17.05.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 masukkan teks tersebut.
  3. Memperbarui apigee-mirror:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Lakukan sinkronisasi:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Jika Anda ingin mendownload seluruh repo:
    &gt; /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

Tambahkan atau perbarui Edge 4.16.01/4.16.05/4.16.09/4.17.01 dalam repo 4.17.05

Jika Anda harus mempertahankan instalasi untuk Edge 4.16.0x atau 4.17.01 dalam repo 4.17.05, 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.01 ke repo 4.17.05:

  1. Pastikan Anda telah menginstal utilitas apigee-mirror versi 4.17.05:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror versi

    Anda akan melihat hasil dalam formulir di bawah, dengan xyz adalah build nomor:
    apigee-mirror-4.17.05-0.0.xyz
  2. Menggunakan apigee-mirror utilitas untuk mengunduh Edge 4.16.01/4.16.05/4.16.09/4.17.01 ke repo Anda. Perhatikan bagaimana Anda memberikan awalan perintah dengan versi yang diinginkan:
    &gt; apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Gunakan perintah yang sama untuk memperbarui repo 4.16.05/4.16.09/4.17.01 dengan menentukan nomor versi yang diperlukan.
  3. Periksa /opt/apigee/data/apigee-mirror/repos untuk melihat struktur file:
    &gt; 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 pihak ketiga

    Perhatikan bahwa Anda memiliki file bootstrap untuk semua versi Edge. Direktori apigee juga berisi komponen yang berbeda untuk setiap versi Edge.
  4. Untuk memaketkan repo ke dalam file .tar, gunakan perintah berikut:
    &gt; apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service paket apigee-mirror

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

  • Jika menginstal dari file .tar, jalankan file bootstrap yang benar dari repo:
    &gt; {i>sudo bash<i} /tmp/repos/bootstrap_4.16.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:
    &gt; /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.01.sh -o /tmp/bootstrap_4.16.01.sh
    &gt; sudo bash /tmp/bootstrap_4.16.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.