Memecahkan masalah jaringan

Artikel
07/08/2024

Masalah jaringan bisa sangat sulit untuk didiagnosis dan diselesaikan. Misalnya, Anda mungkin menemukan bahwa jaringan Wi-Fi Anda berfungsi dengan baik secara lokal, tetapi terputus dari internet. Dalam kasus seperti itu, Anda mungkin menemukan bahwa perangkat Azure Sphere Anda tidak diperbarui dengan benar. Topik ini memberikan beberapa saran yang dapat membantu mendiagnosis masalah jaringan.

Periksa status antarmuka jaringan

Buka antarmuka baris perintah menggunakan PowerShell, Windows Command Prompt, atau shell perintah Linux.

Jalankan az sphere device network list-interfaces untuk mencantumkan detail antarmuka jaringan untuk perangkat yang terpasang.

Output menampilkan semua antarmuka yang disiapkan untuk perangkat Anda. Untuk setiap antarmuka pada perangkat, output menunjukkan hal berikut:

[
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": null,
    "interfaceName": "azspheresvc",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": [
      "192.168.35.2"
    ],
    "ipAssignment": null
  },
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": "b2:30:bb:f0:d1:44",
    "interfaceName": "eth0",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": null,
    "ipAssignment": "dynamic"
  },
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": null,
    "interfaceName": "lo",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": [
      "127.0.0.1"
    ],
    "ipAssignment": null
  },
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": "00:02:b5:03:69:ea",
    "interfaceName": "wlan0",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": null,
    "ipAssignment": "dynamic"
  }
]

Verifikasi bahwa pengaturan berikut untuk antarmuka adalah True.

Antarmuka jaringan ke atas. Jika pengaturan ini False:
- Periksa apakah perangkat lokal yang menggunakan titik akses tersambung. Untuk informasi selengkapnya, lihat Fungsi Networking_IsNetworkingReady.
- Periksa apakah antarmuka jaringan diaktifkan. Anda dapat mengaktifkan antarmuka yang diperlukan dengan menggunakan perintah az sphere device network enable atau dengan menggunakan Networking_SetInterfaceState Function API.
Tersambung ke jaringan. Jika pengaturan ini False:
- Jalankan az sphere device wifi show-status untuk memeriksa apakah nilai Wi-Fi SSID cocok dengan pengaturan Wi-Fi perangkat.
- Pindai jaringan untuk memverifikasi bahwa SSID di pengaturan perangkat cocok dengan SSID di jaringan Anda. Untuk informasi selengkapnya, lihat perintah pemindaian wifi.
- Jika SSID untuk jaringan Wi-Fi Anda disembunyikan dan aplikasi Anda bergantung pada pemindaian yang ditargetkan, periksa apakah pemindaian yang ditargetkan diaktifkan.
Alamat IP yang diperoleh. Jika pengaturan ini False:
- Tunggu hingga koneksi dibuat.
- Periksa jaringan Anda untuk melihat apakah titik akses dan perangkat lain di jaringan tersambung sepenuhnya. Untuk informasi selengkapnya, lihat Fungsi Networking_IsNetworkingReady.
- Periksa rentang alamat IP yang diizinkan atau batas koneksi yang diizinkan pada titik akses dan jaringan Anda.
Terhubung ke internet. Jika pengaturan ini False:
- Periksa apakah jaringan Anda tersambung ke internet.

Memverifikasi status Wi-Fi

Buka antarmuka baris perintah menggunakan PowerShell, Windows Command Prompt, atau shell perintah Linux.
Jalankan az sphere device wifi show-status untuk melihat informasi tentang koneksi Wi-Fi saat ini pada perangkat.

Anda akan melihat output yang mirip dengan hal berikut:

 az sphere device wifi show-status
{
  "SSID": "MSFTGUEST",
  "configurationState": "enabled",
  "connectionState": "connected",
  "frequency": 5660,
  "ipAddress": "10.106.106.40",
  "keyManagement": "NONE",
  "macAddress": "00:02:b5:03:69:ea",
  "mode": "station",
  "securityState": "open",
  "wpaState": "COMPLETED"
}

Jika status Koneksi diatur ke terputus, aktifkan Wi-Fi di perangkat Anda.

Memverifikasi Status Jaringan

Jalankan az sphere device network show-status untuk melihat status jaringan untuk perangkat yang terpasang.

Anda akan melihat output yang mirip dengan hal berikut:

az sphere device network show-status
{
  "deviceAuthenticationIsReady": false,
  "networkTimeSync": "incomplete",
  "proxy": "disabled"
}

Jika Apakah autentikasi perangkat siap menampilkan False,
- Mulai ulang perangkat Anda dan coba perintah lagi.
- Pastikan jaringan Anda dikonfigurasi untuk mengizinkan lalu lintas masuk dan keluar. Untuk informasi selengkapnya, lihat Port dan Protokol.
Jika status Sinkronisasi waktu jaringan mengembalikan Tidak Lengkap,
- Tunggu hingga koneksi dibuat.
- Pastikan jaringan Anda dikonfigurasi untuk mengizinkan lalu lintas masuk dan keluar. Untuk informasi selengkapnya, lihat Port dan Protokol.

Memverifikasi pengaturan firewall

Jika aplikasi Anda gagal terhubung ke host jarak jauh:

Periksa pengaturan firewall aplikasi. Manifes aplikasi harus menentukan nama host atau alamat IP tempat aplikasi diizinkan untuk terhubung, dengan mengatur AllowedConnections kemampuan.
Jika aplikasi telah dikonfigurasi untuk melakukan penemuan layanan, selain entri dalam manifes aplikasi, titik akhir yang ditemukan juga harus tercantum dalam konfigurasi firewall.

Jika host jarak jauh tidak dapat tersambung ke aplikasi server Anda:

Periksa pengaturan firewall aplikasi. Manifes aplikasi harus menentukan port UDP dan TCP tempat aplikasi terbuka untuk koneksi masuk, dengan mengatur AllowedTcpServerPortskemampuan , dan AllowedUdpServerPorts .

Jika Anda masih mengalami kesulitan:

Jalankan az sphere device network list-firewall-rules dan verifikasi bahwa alamat IP dalam aturan firewall dan file manifes aplikasi cocok.
Periksa apakah koneksi default sistem ada secara default.

Mendapatkan diagnostik jaringan

Ketika kegagalan jaringan terjadi, Anda bisa mendapatkan informasi diagnostik tentang kegagalan dengan dua cara: melalui panggilan ke API WifiConfig dan dari baris perintah.

Aplikasi tingkat tinggi dapat memanggil WifiConfig_GetNetworkDiagnostics untuk mengumpulkan informasi tentang masalah tersebut. Fungsi ini mengembalikan WifiConfig_NetworkDiagnostics struktur yang berisi detail tentang kegagalan terbaru pada jaringan yang ditentukan. Gabungkan informasi dari struktur diagnostik dengan tips yang mengikuti untuk mendiagnosis dan memulihkan dari kegagalan jaringan umum.

Sampel WiFi_HighLevelApp menunjukkan cara menggunakan diagnostik.

Anda juga dapat menggunakan perintah az sphere device network show-diagnostics untuk menampilkan informasi diagnostik tentang kesalahan terakhir.

Koneksi jaringan salah

Jika perangkat Anda tersambung ke jaringan yang salah atau terhubung tetapi dengan atribut yang salah, pastikan konfigurasi jaringan sudah benar. Jika Anda mengubah konfigurasi, Anda harus memuat ulang konfigurasi tersebut. Dalam aplikasi, panggil WifiConfig_ReloadConfig atau pada baris perintah, gunakan perintah az sphere device wifi reload-config untuk memuat ulang konfigurasi saat ini. Untuk memastikan bahwa konfigurasi jaringan tetap ada di seluruh boot ulang, aplikasi dapat memanggil WifiConfig_PersistConfig.

Masalah saat memperbarui sertifikat CA Akar

Jika perangkat Anda tidak dapat tersambung ke jaringan EAP-TLS setelah memperbarui sertifikat CA Akar, mulailah dengan status yang dikembalikan oleh fungsi WifiConfig_SetNetworkEnabled.

Jika status menunjukkan kesalahan sertifikat CA Akar, salah satu hal berikut ini mungkin menjadi penyebabnya:

Apakah Root CA1 lama kedaluwarsa atau berubah pada server RADIUS selama proses pembaruan? Jika demikian, Root CA2 baru mungkin salah.
Apakah beberapa kegagalan lain terjadi di sisi server? Tanyakan kepada administrator jaringan Anda. Administrator mungkin telah menggunakan otoritas sertifikat yang berbeda atau salah, dan mungkin perlu memperbaikinya secara terpusat.

Jika status menunjukkan kesalahan sertifikat klien:

Apakah konfigurasi Network2 baru tidak sinkron dengan properti Network1? Jika properti berubah pada Jaringan 1 tetapi Anda mencoba menyambungkan menggunakan properti yang sudah kedaluarsa di Network2, Network2 mungkin gagal tersambung. Pastikan bahwa properti kunci identik untuk dua jaringan.
Apakah sertifikat klien berubah selama proses pembaruan jaringan? Periksa sertifikat yang terkait dengan Network1 dan Network2 dan pastikan sertifikat tersebut sama. Aplikasi dapat menggunakan fungsi di CertStore API untuk memeriksa detail sertifikat.

Jika CA Akar dan sertifikat klien benar, kegagalan dapat terkait dengan titik akses Wi-Fi Anda atau beberapa masalah lainnya.

Lanjutkan untuk memeriksa data yang dikembalikan oleh WifiConfig_GetNetworkDiagnostics setelah setiap upaya yang gagal untuk mempelajari lebih lanjut tentang masalah tersebut.

Masalah saat memperbarui sertifikat klien

Jika perangkat Anda tidak dapat tersambung ke jaringan EAP-TLS setelah memperbarui sertifikat klien, mulailah dengan status yang dikembalikan oleh fungsi WifiConfig_SetNetworkEnabled.