Link IoT Edge：Instal Link IoT Edge pada Ubuntu 16.04

Untuk informasi selengkapnya tentang Link IoT Edge Edisi Pro, lihat Specifications.

Prasyarat

Lingkungan runtime Docker telah diinstal. Untuk informasi tentang cara menginstal client Docker pada Ubuntu 16.04, lihat Dokumentasi Docker. Versi Docker harus lebih baru dari V17.03.

Buat instance edge dan gateway

1. Masuk ke Link IoT Edge console.

2. Di panel navigasi sebelah kiri, klik Edge Instances.

3. Buat instance edge.

   1. Klik Create Instance. Di kotak dialog Create Instance, masukkan instance name.

      Catatan

      Instance name harus terdiri dari 1 hingga 20 karakter, dan dapat berisi huruf, angka, garis bawah (_), serta tanda hubung (-).

   2. Di bagian Gateway Products, klik Create Gateway Product untuk membuat gateway bagi instance tersebut.

      Gateway dalam Link IoT Edge menyediakan kemampuan komputasi tepi. Setiap instance harus dikaitkan dengan satu perangkat gateway. Satu perangkat gateway hanya dapat dikaitkan dengan satu instance edge dalam satu waktu.

   3. Di kotak dialog Create Product, atur parameter yang diperlukan lalu klik OK.

      Create Gateway Product di Link IoT Edge mewarisi fitur dari Devices > Products di Konsol IoT Platform. Prosedur pembuatan produk telah disederhanakan sehingga Anda dapat dengan cepat membuat produk gateway yang sesuai untuk Link IoT Edge.

      Tabel 1. Parameter

      Parameter	Description
      Product Name	Nama produk gateway. Anda dapat mencari atau mengidentifikasi produk gateway berdasarkan nama. Nama harus terdiri dari 4 hingga 30 karakter, dan dapat berisi huruf, angka, serta garis bawah (_).
      Product Description	Masukkan deskripsi produk. Deskripsi harus terdiri dari 1 hingga 100 karakter. Parameter ini opsional.

      Setelah produk dibuat, Anda akan diarahkan kembali ke kotak dialog Create Instance. Produk gateway yang baru dibuat akan muncul dalam daftar drop-down di bagian Gateway Products.

   4. Di kotak dialog Create Instance, klik Add Gateway Device di bagian Gateway Devices.

      Create Gateway Device di Link IoT Edge mewarisi fitur dari Devices > Devices di Konsol IoT Platform.

   5. Atur parameter yang diperlukan sesuai petunjuk lalu klik OK.

      Tabel 2. Parameter

      Parameter	Description
      Product	Produk gateway tempat perangkat yang ingin Anda buat berada. Sistem secara otomatis menetapkan gateway baru untuk parameter ini.
      Device Name	Nama perangkat gateway. Setiap nama perangkat harus unik dalam satu produk. Jika Anda tidak menentukan parameter ini, sistem akan menghasilkan nama perangkat secara acak. Catatan Nama perangkat harus terdiri dari 4 hingga 32 karakter, dan dapat berisi huruf, angka, tanda hubung (-), garis bawah (_), tanda @, titik (.), serta titik dua (:).

   6. Pilih spesifikasi yang diperlukan untuk produk Link IoT Edge berdasarkan lingkungan yang Anda bangun. Untuk informasi selengkapnya, lihat Specifications.

   7. Opsional. Di bagian Tag Information, klik Add Tag untuk menambahkan tag ke instance. Tag menyediakan metode efisien untuk mengidentifikasi dan mengelompokkan instance. Parameter ini opsional.

      Untuk menetapkan tag instance, Anda harus memasukkan tag key dan tag value.

      Tabel 3. Parameter

      Parameter	Description
      Tag Key	Anda harus menentukan tag key untuk setiap tag. Tag key harus terdiri dari 1 hingga 20 karakter, dan hanya boleh berisi huruf. Key setiap tag bersifat unik dalam satu instance.
      Tag Value	Anda harus menentukan tag value untuk setiap tag. Tag value harus terdiri dari 1 hingga 20 karakter, dan dapat berisi huruf, angka, garis bawah (_), serta tanda hubung (-).

4. Setelah mengonfigurasi parameter yang diperlukan, klik OK.

Instal dan mulai Link IoT Edge

Setelah Anda create an edge instance and a gateway, Anda harus menginstal dan menjalankan Link IoT Edge pada gateway tersebut.

1. Di halaman Edge Instances, klik Install Software di kolom Actions pada instance edge yang diinginkan.

   

2. Atur parameter untuk perintah instalasi sesuai lingkungan Anda, lalu klik Installation Command.

   

   Tabel 1. Parameter

   Parameter	Description
   Edge Gateway CPU Architecture	Arsitektur CPU perangkat Anda. Dalam contoh ini, pilih x86-64.
   Instance Type	Edisi Link IoT Edge yang ditentukan saat membuat instance edge. Nilai parameter ini tidak dapat diubah.
   Edge Version	Versi Link IoT Edge.
   Operating System	Sistem operasi perangkat Anda. Dalam contoh ini, pilih Linux.

3. Salin perintah instalasi untuk digunakan nanti.

   

4. Masuk ke mesin Ubuntu 16.04 Anda.

5. Di direktori lingkungan runtime, jalankan perintah yang telah Anda salin pada Langkah 3.

   Anda dapat menjalankan perintah tersebut untuk mengunduh, mengonfigurasi, dan menjalankan Link IoT Edge. Setelah perintah dieksekusi, skrip link-iot-edge.sh akan diunduh dan disimpan di direktori saat ini.

   • Jika Anda menjalankan Link IoT Edge untuk pertama kalinya, periksa hal-hal berikut. Setelah pemeriksaan selesai, tekan Enter untuk menggunakan konfigurasi default.

     • Periksa versi Link IoT Edge.

     • Konfirmasi runtime Function Compute. Secara default, fungsi dijalankan dalam proses terpisah.

     • Periksa apakah fitur pemrosesan aliran telah diaktifkan. Secara default, fitur pemrosesan aliran diaktifkan.

     • Periksa apakah versi sebelumnya telah di-uninstall. Secara default, versi sebelumnya akan di-uninstall.

     Anda mungkin perlu menunggu 5 hingga 10 menit untuk menarik dan menjalankan citra Docker. Anda dapat menjalankan perintah docker ps untuk memeriksa apakah kontainer Docker telah berjalan. Jika informasi berikut muncul dalam output perintah, berarti kontainer Docker telah berjalan.

     

   • Jika Anda menjalankan Link IoT Edge bukan untuk pertama kalinya, Anda dapat menggunakan skrip link-iot-edge.sh yang telah diunduh untuk mengelola Link IoT Edge. Misalnya, Anda dapat me-restart atau menghentikan Link IoT Edge, mengambil status Link IoT Edge, atau mengubah parameter konfigurasinya. Gambar berikut menunjukkan detail perintah tersebut.

6. Masuk ke Link IoT Edge console. Di panel navigasi sebelah kiri, klik Edge Instances. Di halaman yang muncul, temukan instance edge yang telah Anda buat lalu klik View di kolom Actions. Di tab Gateways pada halaman Instance Details, periksa status gateway tersebut.

   Anda dapat melakukan manajemen gateway jarak jauh dengan mengaktifkan Remote Access. Untuk informasi selengkapnya tentang prosedurnya, lihat Remote service access.

   

7. Opsional. Di halaman Instance Details, periksa penggunaan CPU, penggunaan memori, dan penggunaan penyimpanan, lalu berikan otorisasi agar proses instance dapat mengakses CloudMonitor.

   1. Tambahkan role atau sambungkan role yang sudah ada. Pastikan role tersebut memiliki izin yang diperlukan untuk mengelola CloudMonitor. Untuk informasi selengkapnya, lihat Access resources of other Alibaba Cloud services.

   2. Klik tab Monitoring lalu aktifkan sakelar CloudMonitor Status, seperti yang ditunjukkan pada gambar berikut.

      

      Setelah sakelar CloudMonitor Status diaktifkan, Anda dapat melihat informasi pemantauan gateway di halaman Monitoring.

8. Opsional. Berikan otorisasi kepada pengguna Alibaba Cloud lain untuk melakukan operasi yang diperlukan pada instance tersebut.

   Di halaman Edge Instances, klik Authorize di pojok kiri atas halaman. Di kotak dialog yang muncul, klik Add Authorization. Di kotak dialog berikutnya, atur parameter yang diperlukan sesuai petunjuk.

   Tabel 6. Parameter

   Parameter	Description
   Authorized User UID	ID akun Alibaba Cloud pengguna yang ingin Anda beri otorisasi.
   Authorized Instance	Instance edge tempat Anda memberikan otorisasi kepada akun Alibaba Cloud untuk melakukan O&M jarak jauh.

Operasi tambahan pada Link IoT Edge

• Konfigurasi ulang Link IoT Edge.

  Jalankan perintah berikut untuk mengubah konfigurasi Link IoT Edge versi tertentu:

  ./link-iot-edge.sh --reconfig {Version}

  Ganti {Version} dengan versi Link IoT Edge yang ingin Anda ubah konfigurasinya. Misalnya, jika versinya V1.8.2, jalankan perintah ./link-iot-edge.sh --reconfig V1.8.2.

• Hentikan Link IoT Edge.

  Jalankan perintah berikut untuk menghentikan semua kontainer yang menjalankan Link IoT Edge. Namun, kontainer tersebut tidak dihapus.

  ./link-iot-edge.sh --stop

• Mulai ulang Link IoT Edge.

  Jika kontainer tersedia tetapi tidak sedang berjalan, jalankan perintah berikut untuk me-restart Link IoT Edge:

  ./link-iot-edge.sh --restart {Version}

  Ganti {Version} dengan versi Link IoT Edge yang ingin Anda restart. Misalnya, jika versinya V1.8.2, jalankan perintah ./link-iot-edge.sh --restart V1.8.2.

• Bersihkan Link IoT Edge.

  Jalankan perintah berikut untuk membersihkan kontainer yang menjalankan Link IoT Edge serta menghapus semua citra, volume, dan file konfigurasi startup yang telah diinstal.

  ./link-iot-edge.sh --clean

• Ekstrak log Link IoT Edge.

  Jalankan perintah berikut untuk mengemas semua log Link IoT Edge dan menyalin paket tersebut ke direktori saat ini:

  ./link-iot-edge.sh --packagelog

Langkah selanjutnya

Setelah lingkungan dibangun, Anda dapat menghubungkan perangkat Anda ke Link IoT Edge. Untuk informasi selengkapnya, lihat Device access. Anda juga dapat mengalokasikan sumber daya tambahan ke instance edge untuk mengelola perangkat Anda. Sumber daya tersebut mencakup sumber daya Function Compute dan entri rute pesan.

Setelah Anda menghubungkan perangkat ke Link IoT Edge atau mengalokasikan sumber daya tambahan ke instance edge, lakukan langkah-langkah berikut untuk menerapkan instance edge tersebut:

1. Di pojok kanan atas halaman Instance Details, klik Deploy. Di pesan yang muncul, klik OK untuk menerapkan instance edge tersebut.

2. Jika status instance edge adalah Deployed, artinya instance edge telah diterapkan. Anda dapat mengklik View Logs untuk melihat detail penerapan. Anda juga dapat mengklik View Deployment Logs di pojok kanan atas halaman Instance Details untuk melihat riwayat penerapan.