Menginstal Edge Microgateway

Anda melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Edge Microgateway v. 2.3.x

Audiens

Gunakan panduan ini jika Anda perlu menginstal atau meng-uninstal Edge Microgateway.

Prasyarat

  • Anda harus menginstal Node.js versi 4.5 LTS atau yang lebih baru di sistem Anda. Lihat petunjuk Node.js tambahan di bawah.
  • Windows mengharuskan OpenSSL diinstal dan ditambahkan ke PATH.
  • Jika Anda menggunakan Apigee Edge Private Cloud untuk mengonfigurasi dengan Edge Microgateway, Anda harus menjalankan Private Cloud versi 4.15.07 atau yang lebih baru.

Menginstal Node.js

Anda harus menginstal Node.js versi 4.5 atau yang lebih baru di sistem Anda. Anda dapat memeriksanya dengan menjalankan:

node -v

Ada banyak cara untuk mendapatkan atau mengupdate Node.js. Misalnya, Anda dapat menggunakan HomeBrew, yum, atau mendownloadnya langsung dari situs Node.js: https://nodejs.org/download.

Menginstal Edge Microgateway jika Anda memiliki koneksi internet

Bagian ini menjelaskan cara menginstal Edge Microgateway dan menginisialisasi konfigurasi default.

  1. Instal Edge Microgateway versi terbaru dengan npm menggunakan perintah berikut. Perintah ini menginstal software dan menempatkan executable edgemicro di jalur Anda. Untuk mengetahui lokasi penginstalan Edge Microgateway oleh perintah berikut, lihat Di mana Edge Microgateway diinstal?. 
    npm install edgemicro -g

    Untuk menginstal Edge Microgateway versi tertentu, Anda harus menentukan nomor versi dalam perintah penginstalan. Jika Anda tidak menentukan nomor versi, versi terbaru akan diinstal. Misalnya, untuk menginstal versi 2.3.1, gunakan perintah berikut. 

    npm install edgemicro@2.3.1 -g
  2. Lihat nomor versi aplikasi. Misalnya, jika Anda menginstal versi 2.3.5: 
    edgemicro --version
current nodejs version is v6.1.0
current edgemicro version is 2.3.5
  3. Jalankan perintah ini untuk membuat file konfigurasi default di direktori utama Anda. 
    edgemicro init
  4. (Opsional) File konfigurasi bernama default.yaml ditempatkan di direktori utama Anda dalam subdirektori bernama .edgemicro. Periksa sekarang untuk memastikan file ini ada: 
    ls ~/.edgemicro
default.yaml

    Catatan: Dalam dokumen Edge Microgateway, kami merujuk ke direktori utama dengan tilde (~), yang merupakan pintasan UNIX. Jika Anda menggunakan Windows, jika Anda menjalankan shell yang tidak mendukung tilde, Anda harus mengganti variabel lingkungan yang sesuai untuk tilde dalam perintah yang mereferensikan direktori utama. Misalnya: %USERPROFILE%/.edgemicro.

  5. Ikuti langkah-langkah di Menginstal Edge Microgateway.

Mengoperasikan Edge Microgateway di Windows sebagai Layanan

Anda dapat mengoperasikan Edge Microgateway di Windows sebagai layanan. Untuk mengetahui detailnya, lihat Praktik terbaik untuk pengelolaan operasional Microgateway (edgemicro) di Windows di Komunitas Apigee.

Dapatkah saya menginstal Edge Microgateway tanpa koneksi internet?

Di situs yang tidak memiliki akses internet siap pakai, administrator dapat menginstal dan mengelola registry npm pribadi di jaringan internal Anda. Petunjuk untuk menyiapkan registry npm pribadi berada di luar cakupan panduan ini; namun, Anda dapat menelusuri dan menemukan petunjuk yang bermanfaat. Dengan registry npm pribadi yang diinstal, Anda dapat mengikuti petunjuk penginstalan yang diberikan di atas.

Memulai

Jika Anda baru menggunakan Edge Microgateway, Menginstal Edge Microgateway adalah tempat terbaik untuk memulai setelah Anda menyelesaikan penginstalan. Panduan penyiapan dan konfigurasi mencakup semua langkah yang perlu Anda lakukan untuk menginstal, mengonfigurasi, memulai, dan menggunakan instance Edge Microgateway.

Di mana Edge Microgateway diinstal?

Saat Anda menggunakan npm dengan opsi global (npm install -g edgemicro), software akan diinstal di [prefix]/lib/node_modules/edgemicro. Anda dapat menemukan nilai [prefix] dengan perintah ini:

npm config get prefix

Nilai [prefix] dapat dikonfigurasi. Lihat npm-folders untuk mengetahui informasi selengkapnya.

Meng-uninstal Edge Microgateway

Jika Anda perlu menghapus Edge Microgateway:

  1. Hapus atau arsipkan direktori penginstalan [prefix]/lib/node_modules/edgemicro, dengan [prefix] adalah awalan npm seperti yang dijelaskan di Di mana Edge Microgateway diinstal?
  2. Hapus atau arsipkan file log. Secara default, edgemicro-*.log file berada di /var/tmp/, tetapi lokasi ini dapat dikonfigurasi. Periksa file konfigurasi jika ragu, seperti yang dijelaskan dalam "Mengelola file log."
  3. Hapus atau arsipkan file konfigurasi runtime dan konfigurasi cache: 
    ~/.edgemicro/*.yaml