Halaman ini diterjemahkan oleh Cloud Translation API.

Menginstal utilitas penyiapan apigee Edge

Untuk menginstal Edge di node, Anda harus menginstal utilitas penyiapan apigee 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 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 untuk 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. 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 menetapkan SELINUX=enabled.

Prasyarat: Aktifkan repo EPEL

Anda harus mengaktifkan Extra Packages for Enterprise Linux (atau EPEL) untuk menginstal atau mengupdate Edge, atau membuat repo lokal. Perintah yang Anda gunakan bergantung pada versi RedHat/CentOS Anda:

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: Periksa versi library libdb4 di RedHat 7.4 dan CentOS 7.4

Di RedHat 7.4 dan CentOS 7.4, periksa versi RPM libdb4 sebelum menginstal. Edge memerlukan versi 4.8 dan beberapa versi RedHat 7.4 dan CentOS 7.4 dikirimkan dengan versi yang lebih baru. Jika Anda memiliki versi yang lebih baru, uninstal versi tersebut dan penginstal Edge akan menginstal versi 4.8.

Anda dapat menggunakan perintah berikut untuk memeriksa versi Anda:

rpm -qa | grep libdb4

Jika Anda melihat bahwa versi RPM libdb4 lebih baru dari versi 4.8, uninstal RPM tersebut.

Menginstal utilitas penyiapan apigee Edge di node dengan koneksi internet eksternal

Untuk menginstal Edge di node dengan koneksi internet eksternal:

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 menggunakan kredensial tersebut.
Login ke node sebagai root untuk menginstal RPM Edge

CATATAN: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.

Instal yum-utils dan yum-plugin-priorities:

sudo yum install yum-utils
sudo yum install yum-plugin-priorities

Nonaktifkan SELinux seperti yang dijelaskan di atas.
Aktifkan repo EPEL seperti yang dijelaskan di atas.
Periksa versi libdb4 Anda seperti yang dijelaskan di atas.
Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Jika Anda menginstal di AWS, jalankan perintah yum-configure-manager berikut:

yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Download file bootstrap_4.50.00.sh Edge ke /tmp/bootstrap_4.50.00.sh:

curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

Instal utilitas dan dependensi layanan Edge apigee:
```
sudo bash /tmp/bootstrap_4.50.00.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 tidak, aplikasi akan menginstalnya untuk Anda. Gunakan opsi JAVA_FIX untuk menentukan cara menangani penginstalan Java. JAVA_FIX menggunakan nilai berikut:
- I: Menginstal OpenJDK 1.8 (default)
- C: Lanjutkan 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*'
```

Gunakan apigee-service untuk menginstal utilitas apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup install

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 salah 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 penyelesaian untuk error ini:

Jenis Kesalahan	Kemungkinan Penyelesaian
Sandi mengandung karakter yang buruk	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 berikut ini: Connection to software.apigee.com 443 port [tcp/https] succeeded! Jika `nc` belum terinstal, Anda dapat menjalankan perintah `telnet` berikut: telnet software.apigee.com 443 Jika perintah berhasil, Anda dapat menggunakan CTRL+C untuk membatalkan koneksi yang 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: Menambahkan konfigurasi proxy HTTP di `/etc/yum.conf` Menambahkan konfigurasi proxy HTTP global di `/etc/environment`

Menginstal utilitas penyiapan apigee Edge di node tanpa koneksi internet eksternal

Jika node Edge Anda berada di balik firewall, atau dengan cara lain dilarang mengakses internet, Anda harus membuat beberapa repositori, atau mirror, yang berisi file yang akan Anda perlukan selama penginstalan. Mirror 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:

Repositori Apigee Edge: Seperti yang dijelaskan dalam Membuat repositori Apigee lokal.
Repo Yum (untuk utilitas seperti yum-utils dan yum-plugin-priorities): Tim operasi Anda seharusnya dapat menyiapkannya untuk Anda.
Paket Tambahan untuk Enterprise Linux (atau EPEL): Tim operasi Anda harus dapat menyiapkannya untuk Anda.

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:

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.
Login ke node sebagai root untuk menginstal RPM Edge.

CATATAN: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
Nonaktifkan SELinux seperti yang dijelaskan di atas.

Download file bootstrap_4.50.00.sh Edge ke /tmp/bootstrap_4.50.00.sh:

curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

Instal utilitas dan dependensi layanan apigee Edge:
```
sudo bash /tmp/bootstrap_4.50.00.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.
Instal utilitas apigee-mirror pada node:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
```
CATATAN: Jika Anda mengupdate repo yang sudah ada ke 4.50.00, Anda hanya perlu mengupdate apigee-mirror:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
```
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 sekarang memiliki salinan lokal repo Apigee. Bagian berikutnya menjelaskan cara menginstal utilitas apigee-setup Edge dari repo lokal.
(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.50.00.sh dari repo lokal untuk menginstal utilitas apigee-service:
```
sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.50.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:

Buat file .tar repo, salin file .tar ke node, lalu instal Edge dari file .tar.
Instal server web di node dengan repo lokal agar 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:

Di node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.50.00.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
Salin file .tar ke node tempat Anda ingin menginstal Edge. Misalnya, salin ke direktori /tmp di node baru.
Di node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
Di node baru, pastikan Anda dapat mengakses repo utilitas Yum lokal dan repo EPEL.
Periksa kembali apakah semua repositori internet eksternal dinonaktifkan (seharusnya demikian karena Anda menginstal di komputer tanpa akses internet):
```
sudo yum repolist
```
Semua repo eksternal harus dinonaktifkan, tetapi repo Apigee lokal dan repo internal Anda harus diaktifkan.
Di 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 repo lokal agar Anda dapat menginstal alat Yum.
Pada node baru, periksa versi libdb4 Anda seperti yang dijelaskan di atas.
Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut:
```
sudo yum-config-manager --enable ol7_optional_latest
```

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

Di node baru, ekstrak file ke direktori /tmp:
```
tar -xzf apigee-4.50.00.tar.gz
```
Perintah ini akan membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya /tmp/repos.
Instal utilitas layanan apigee Edge dan dependensi dari /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
Perhatikan bahwa Anda menyertakan jalur ke direktori repo dalam perintah ini.

Gunakan apigee-service untuk menginstal utilitas apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup install

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:

Instal server web Nginx di node repo:

opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig

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
```
Secara default, repo memerlukan nama pengguna:sandi admin:admin. Untuk mengubah kredensial ini, tetapkan variabel lingkungan berikut:
```
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
```

Pada node baru, instal yum-utils dan yum-plugin-priorities:

sudo yum install yum-utils
sudo yum install yum-plugin-priorities

Pada node baru, nonaktifkan SELinux seperti yang dijelaskan di atas.
Di node baru, pastikan repositori EPEL lokal diaktifkan.
Di node baru, periksa versi libdb4 Anda seperti yang dijelaskan di atas.
Di node jarak jauh, download file Edge bootstrap_4.50.00.sh ke /tmp/bootstrap_4.50.00.sh:
```
curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.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.

Pada node jarak jauh, instal utilitas dan dependensi Edge apigee-service:

sudo bash /tmp/bootstrap_4.50.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

Dengan uName:pWord adalah nama pengguna dan sandi repo.

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

Memperbarui repositori Apigee lokal

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

Untuk memperbarui repo:

Download file bootstrap_4.50.00.sh Edge ke /tmp/bootstrap_4.50.00.sh:

curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

Jalankan file bootstrap_4.50.00.sh Edge:
```
sudo bash/tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.

Memperbarui apigee-mirror:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

Lakukan sinkronisasi:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

Jika Anda ingin melihat 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

Menambahkan atau memperbarui Edge 4.16.0x/4.17.0x di repo 4.50.00

Jika Anda harus mempertahankan penginstalan untuk Edge 4.16.0x atau 4.17.0x di repo 4.50.00, Anda dapat mempertahankan repo yang berisi semua versi. Dari repo tersebut, Anda dapat menginstal versi Edge apa pun.

Untuk menambahkan 4.16.0x/4.17.0x ke repo 4.50.00:

Pastikan Anda telah menginstal utilitas apigee-mirror versi 4.50.00:
```
/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.50.00-0.0.xyz
```
Gunakan utilitas apigee-mirror untuk mendownload Edge 4.16.0x/4.17.0x ke repo Anda. Perhatikan cara Anda memberi awalan pada 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 repo 4.16.0x/4.17.0x nanti dengan menentukan nomor versi yang diperlukan.
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
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. Direktori apigee juga berisi direktori terpisah untuk setiap versi Edge.
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 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 yang tersisa 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 yang tersisa dari "Instal dari repo menggunakan server web Nginx" di atas.