Masalah dan tindakan perbaikan¶
Halaman ini memberi tahu Anda penyebab masalah umum di LUC Analytics (LUCA) dan tindakan yang memperbaikinya.
Setiap tabel memiliki tiga kolom. "Masalah" memberikan pesan yang ditunjukkan aplikasi atau Docker, atau apa yang Anda lihat. Teks di dalam "tanda petik ganda" adalah pesan yang persis. Kontrol atau label aplikasi ditulis dengan huruf tebal. Bagian seperti {{code}} adalah nilai yang ditulis aplikasi di dalam pesan.
Docker dan kontainer¶
Untuk prosedur lengkapnya, lihat 01-install-and-start.md.
| Masalah | Penyebab | Tindakan |
|---|---|---|
docker run gagal dengan pesan bahwa perintah tersebut tidak dapat mengikat port host 127.0.0.1:8000. Di Linux, pesannya adalah address already in use. |
Program lain menggunakan port 8000 di laptop Anda. Docker membuat kontainer, tetapi tidak memulainya. | 1. Ketik docker rm luc-analytics. 2. Ketik perintah docker run lagi dengan port host yang berbeda, misalnya -p 127.0.0.1:8080:8000. 3. Di tautan dari log, ubah 8000 menjadi 8080. |
| "The container name "/luc-analytics" is already in use" (nama kontainer "/luc-analytics" sudah digunakan) | Kontainer dari perintah docker run sebelumnya sudah ada. |
Mulai kontainer tersebut dengan docker start luc-analytics. Atau hapus kontainer dengan docker rm -f luc-analytics dan ketik perintah docker run lagi. Volume dan data Anda tetap ada. |
| Docker Desktop tetap pada "Engine starting" (mesin sedang dimulai), atau menunjukkan batas waktu WSL. | Mesin Docker atau mesin virtual WSL 2-nya tidak dimulai dengan benar. | 1. Klik kanan ikon Docker di area pemberitahuan pada bilah tugas. 2. Pilih Quit Docker Desktop (keluar dari Docker Desktop). 3. Mulai Docker Desktop lagi. 4. Jika masalah berlanjut, keluar dari Docker Desktop lagi. 5. Ketik wsl --shutdown di PowerShell. 6. Mulai Docker Desktop lagi. |
docker version tidak menunjukkan bagian Server (server). |
Mesin Docker belum dimulai. | Mulai Docker Desktop. Tunggu sampai Docker Desktop menunjukkan Engine running (mesin berjalan). |
Kontainer langsung berhenti. Log, atau keluaran docker run, berisi exec format error. |
Build image (amd64 atau arm64) tidak sesuai dengan prosesor laptop Anda. | 1. Ketik $env:PROCESSOR_ARCHITECTURE di PowerShell. Di Mac, ketik uname -m di Terminal. 2. Ketik docker image inspect luc-analytics --format "{{.Architecture}}". 3. Bandingkan kedua nilai. AMD64 sesuai dengan amd64. ARM64 sesuai dengan arm64. Di Mac, x86_64 sesuai dengan amd64 dan arm64 sesuai dengan arm64. 4. Jika nilainya tidak sesuai, dapatkan file image untuk build yang benar (luc-analytics-beta-...-amd64.tar.gz atau luc-analytics-beta-...-arm64.tar.gz). 5. Ketik docker rm luc-analytics. 6. Lakukan langkah-langkah di "Memuat image" di 01-install-and-start.md dengan file yang benar. 7. Mulai kontainer lagi dengan perintah docker run. |
| Pengaturan > Memori menunjukkan "Tidak terdeteksi di host ini — masukkan batas memori mesin atau VM ini." | Aplikasi tidak dapat menemukan batas memori di dalam Docker Desktop. Selain itu, Docker mungkin memiliki terlalu sedikit memori: secara bawaan, Docker dapat menggunakan sekitar setengah dari memori laptop. | 1. Berikan Docker memori 5 GB atau lebih di file .wslconfig. 2. Ketik wsl --shutdown dan mulai Docker Desktop lagi. 3. Di Pengaturan > Memori, ketik memori Docker di Batas memori host / VM (GB). 4. Tutup program besar lainnya. |
| Aplikasi tidak menjawab di browser. | Kontainer berhenti, atau aplikasi memiliki masalah. | 1. Ketik docker ps -a untuk melihat apakah kontainer berjalan. 2. Ketik docker logs luc-analytics untuk membaca pesan dari aplikasi. 3. Jika kontainer berhenti, ketik docker start luc-analytics. |
| Aplikasi tidak menjawab setelah Anda memulai ulang Windows. | Kontainer tidak dimulai secara otomatis. | Mulai Docker Desktop. Kemudian ketik docker start luc-analytics. |
Kunci akses¶
PERINGATAN: Jangan berikan tautan dengan kunci akses kepada orang lain. Orang yang memiliki tautan tersebut dapat menggunakan aplikasi dan kredensial AWS Anda.
| Masalah | Penyebab | Tindakan |
|---|---|---|
| Browser menunjukkan "Kunci akses diperlukan". | Browser tidak memiliki kunci akses. | 1. Ketik docker exec luc-analytics cat /data/state/access-key. 2. Buka http://localhost:8000/?access_key=<key>. Gunakan kunci dari langkah 1. |
| Browser menunjukkan "Kunci akses tidak tersedia". Halaman menyatakan bahwa server "tidak dapat lagi membacanya (file kuncinya mungkin telah dihapus)". | File kunci di volume tidak ada, atau server tidak dapat membacanya. | Mulai ulang kontainer dengan docker restart luc-analytics. Aplikasi membuat kunci baru dan menulis tautan baru di log. Buka tautan baru tersebut. |
Kredensial AWS (Periksa kredensial)¶
Anda menemukan pesan-pesan ini di Pengaturan > Kredensial, setelah Anda menekan Periksa kredensial. Pemeriksaan ini tidak dikenai biaya. Untuk pengaturannya, lihat 06-settings.md.
| Masalah | Penyebab | Tindakan |
|---|---|---|
| "AWS menolak kredensial ini ({{code}}): ID kunci akses atau rahasianya salah, atau kuncinya tidak aktif. Berikutnya: masukkan keduanya lagi, lalu Periksa kredensial kembali." | ID kunci akses AWS atau kunci akses rahasia AWS salah, atau kunci AWS tidak aktif. | Ketik kedua nilai lagi. Tekan Periksa kredensial. |
| "Tidak ada kredensial AWS yang dimasukkan atau disimpan. Berikutnya: masukkan ID kunci akses dan rahasianya, lalu Periksa kredensial." | Tidak ada kredensial AWS. | Ketik ID kunci akses AWS dan kunci akses rahasia AWS. Tekan Periksa kredensial. |
| "Ada kredensial tersimpan, tetapi tidak dapat dibaca dengan kunci penyimpanan rahasia yang aktif. Berikutnya: masukkan lagi ID kunci akses dan rahasianya, lalu simpan." | Kunci penyimpanan terenkripsi berubah, atau penyimpanan rusak. | Ketik ID kunci akses AWS dan kunci akses rahasia AWS lagi. Tekan Simpan. |
| "AWS STS tidak dapat dijangkau (jaringan atau titik akhir). Ini tidak menunjukkan apa pun tentang kredensial. Berikutnya: coba lagi." | Tidak ada koneksi jaringan, atau AWS tidak menjawab. | Pastikan bahwa laptop memiliki koneksi internet. Tekan Periksa kredensial lagi. |
| "AWS STS tidak menjawab tepat waktu. Ini tidak menunjukkan apa pun tentang kredensial. Berikutnya: coba lagi." | AWS tidak menjawab dalam waktu yang diizinkan. | Tekan Periksa kredensial lagi. |
| "Masukkan ID kunci akses dan kunci akses rahasia sekaligus, atau tidak keduanya." | Anda hanya mengetik salah satu dari kedua nilai. | Ketik kedua nilai, atau kosongkan kedua bidang. |
| "Periksa kredensial terlebih dahulu. Pasangan kunci yang gagal diperiksa tidak pernah disimpan." | Anda menekan Simpan sebelum pemeriksaan berhasil. | Tekan Periksa kredensial. Saat pemeriksaan berhasil, tekan Simpan. |
Koneksi set data (Uji koneksi)¶
Anda menemukan pesan-pesan ini untuk sumber set data setelah Anda menekan Uji koneksi.
PERINGATAN: Uji koneksi membuat permintaan ke bucket WRI. AWS mengirim tagihan untuk permintaan ini ke akun AWS Anda.
| Masalah | Penyebab | Tindakan |
|---|---|---|
| "Kredensial Anda baik-baik saja. Pengaturan "Peminta membayar" set data ini nonaktif, jadi aplikasi menolak membuat permintaan berbayar. Aktifkan "Peminta membayar" di atas." | Peminta membayar mati. Tanpa pengaturan ini, aplikasi tidak membuat permintaan yang dikenai biaya. | Nyalakan Peminta membayar. Tekan Uji koneksi lagi. |
| "AWS menolak kredensial ini untuk set data ini. Kunci mungkin telah dicabut, salah, atau tidak memiliki izin. "Peminta membayar" sudah aktif, jadi ini masalah kredensial." | Kredensial AWS tidak benar, atau tidak memiliki izin. | Tekan Periksa kredensial. Jika pemeriksaan gagal, perbaiki kredensial AWS. |
| "AWS menolak kredensial ini ({{code}}) — masalahnya kredensial, bukan lokasi. Berikutnya: tekan Periksa kredensial." | AWS menolak kredensial. | Tekan Periksa kredensial. |
| "Tidak ada kredensial AWS yang tersedia untuk set data ini. Tambahkan ID kunci akses dan kunci rahasia di atas, lalu simpan dan uji lagi." | Tidak ada kredensial AWS. | Ketik dan simpan kredensial AWS. Tekan Uji koneksi lagi. |
| "Kredensial tersimpan ada tetapi tidak dapat dibaca dengan kunci penyimpanan rahasia yang aktif. Masukkan kembali ID kunci akses dan kunci rahasia di atas lalu simpan." | Aplikasi tidak dapat mendekripsi kredensial yang tersimpan. | Ketik kredensial AWS lagi dan simpan. |
| "AccessDenied ({{code}}): kuncinya valid tetapi tidak diizinkan membaca bucket ini, atau bucket menolak permintaan dengan skema peminta membayar. Berikutnya: Periksa kredensial, lalu pemeriksaan CLI di bawah." | Kunci AWS benar, tetapi tidak memiliki izin untuk membaca bucket. | 1. Tekan Periksa kredensial. 2. Lakukan pemeriksaan di Periksa sendiri dari shell Anda. 3. Berikan kunci AWS izin untuk membaca bucket. |
| "Set data tidak dapat dijangkau (kegagalan jaringan atau titik akhir). Ini tidak terkait dengan kredensial Anda atau pengaturan "Peminta membayar"." | Tidak ada koneksi jaringan, atau titik akhir tidak menjawab. | Pastikan bahwa laptop memiliki koneksi internet. Tekan Uji koneksi lagi. |
| "Uji koneksi habis waktu. Set data tidak merespons dalam waktu yang diizinkan — ini kemungkinan titik akhir yang lambat atau tidak dapat dijangkau, bukan kredensial Anda atau pengaturan "Peminta membayar"." | Titik akhir tidak menjawab dalam waktu yang diizinkan. | Tekan Uji koneksi lagi nanti. |
| "AWS menjawab {{code}} untuk {{uri}}: tidak ada apa pun di lokasi itu. Berikutnya: tekan Gunakan jalur manifes ($, satu permintaan berbayar)." | Jalur S3 set data salah atau lama. | Tekan Gunakan jalur manifes. Tindakan ini membuat satu permintaan yang dikenai biaya. |
| "Tidak ada objek di bawah {{uri}}: bucket menjawab, tetapi tidak ada yang tersimpan di prefiks itu. Berikutnya: tekan Gunakan jalur manifes ($, satu permintaan berbayar)." | Tidak ada file di jalur S3 tersebut. | Tekan Gunakan jalur manifes. Tindakan ini membuat satu permintaan yang dikenai biaya. |
| "Lokasi dapat dijangkau dan diotorisasi, tetapi tidak berisi penyimpanan Zarr yang dapat dibaca." | Jalur S3 tidak berisi set data. | Perbaiki jalur S3 set data. |
| "Bucket menjawab dari {{bucketRegion}}, bukan {{region}} — bucket WRI berada di us-east-1. Berikutnya: perbaiki datasets.upstream.region (atau regions) di config.yaml." | Region AWS di konfigurasi salah. | 1. Ubah datasets.upstream.region di /data/config.yaml menjadi us-east-1. 2. Mulai ulang kontainer. |
Kredensial penyedia peta dasar¶
Anda menemukan pesan-pesan ini di kartu untuk Planet, Google Maps dan Copernicus (CDSE) di Pengaturan > Kredensial, setelah Anda menekan Uji koneksi. Pesan dimulai dengan "Koneksi gagal:".
| Masalah | Penyebab | Tindakan |
|---|---|---|
| "Penyedia menolak kredensial ini. Periksa nilainya, atau apakah masih memiliki izin." | Kredensial salah, atau tidak memiliki izin. | Ketik nilai yang benar. Tekan Uji koneksi lagi. |
| "Penyedia tidak dapat dijangkau (kegagalan jaringan atau titik akhir). Ini tidak terkait dengan kredensial Anda." | Tidak ada koneksi jaringan, atau penyedia tidak menjawab. | Pastikan bahwa laptop memiliki koneksi internet. Tekan Uji koneksi lagi. |
| "Penyedia tidak merespons dalam waktu yang diizinkan. Kemungkinan besar titik akhir lambat atau tidak terjangkau, bukan kredensial Anda." | Penyedia tidak menjawab dalam waktu yang diizinkan. | Tekan Uji koneksi lagi nanti. |
| "Penyedia salah dikonfigurasi di server, sehingga kredensial tidak dapat diuji." | Konfigurasi server untuk penyedia ini tidak benar. | Hubungi orang yang memasang aplikasi. |
| "Uji koneksi terlebih dahulu. Koneksi yang gagal tidak pernah disimpan." | Anda menekan Simpan sebelum uji berhasil. | Tekan Uji koneksi. Saat uji berhasil, tekan Simpan. |
Mengunggah daftar¶
Untuk informasi lebih lanjut tentang daftar, lihat 02-lists.md.
| Masalah | Penyebab | Tindakan |
|---|---|---|
| "Unggahan dinonaktifkan" | ingest.upload_enabled bukan true di konfigurasi. Instalasi yang Anda tingkatkan versinya tetap menggunakan file konfigurasi lamanya. |
1. Pastikan bahwa kunci akses melindungi aplikasi. 2. Atur ingest.upload_enabled: true di /data/config.yaml. 3. Mulai ulang kontainer. |
| "Jenis berkas tidak didukung" | Aplikasi tidak dapat membaca jenis file ini. Aplikasi tidak menerima file KMZ (.kmz). |
Gunakan file CSV, Excel (.xlsx), GeoJSON, KML (.kml) atau shapefile dalam zip (.zip). Untuk menggunakan file KMZ, ekstrak file KML darinya. |
| "Berkas terlalu besar" atau "Terlalu banyak lokasi" | File lebih besar dari batas. | Bagi file menjadi file-file yang lebih kecil. Unggah setiap file sebagai daftar. |
| "Lembar kerja terlalu lebar" | Satu baris lembar kerja memiliki terlalu banyak kolom. | Hapus kolom yang tidak Anda perlukan. Unggah lagi. |
| "Tidak ada lokasi ditemukan" | File tidak memiliki baris. | Pastikan bahwa file memiliki baris. |
| "Kami tidak menemukan kolom lokasi" | Aplikasi tidak dapat menemukan kolom dengan koordinat. | Gunakan Ubah pemetaan bidang untuk memilih kolom. |
| "Kolom itu tidak ada di berkas Anda" | Kecocokan kolom menggunakan kolom yang tidak ada di file. | Perbaiki kecocokan kolom. |
| "Tidak ada lokasi valid" | Koordinat tidak benar. | Perbaiki koordinat. |
| "Arsip tidak dapat dibuka" atau "KML/KMZ tidak dapat dibaca" | File rusak. | Ekspor file dari programnya lagi. Unggah file lagi. |
| "Lokasi memerlukan ukuran" | File memiliki titik tanpa ukuran. | Berikan ukuran (luas atau jari-jari) untuk titik. |
| "Pilih satuan" | Ukuran tidak memiliki satuan. | Pilih Luas atau Jari-jari. |
| "Proyeksi peta yang mana?" atau "Proyeksi tidak dikenali" | Koordinat bukan lintang dan bujur WGS 84. | Pilih proyeksi file. |
| "Set data tidak tersedia" | Set data tidak tersedia saat ini. | Coba lagi nanti. |
| "Unggahan terputus", "Unggahan kedaluwarsa" atau "Gagal menyimpan" | Unggahan tidak selesai. | Unggah file lagi. |
| "Tidak dapat terhubung ke server" | Browser tidak dapat terhubung ke aplikasi. | Pastikan bahwa kontainer berjalan (docker ps -a). |
Ekspor¶
Untuk informasi lebih lanjut tentang ekspor, lihat 05-exports.md.
| Masalah | Penyebab | Tindakan |
|---|---|---|
| Anda tidak dapat menekan Ekspor atau ⬇ Unduh CSV. Keterangan alat menunjukkan "Ekspor CSV tersedia setelah analisis daftar ini selesai." | Analisis daftar belum lengkap. | Tunggu sampai analisis daftar lengkap. Daftar dengan label Tidak lengkap setelah Hentikan & simpan tidak menjadi lengkap. Untuk daftar seperti itu, ekspor setiap lokasi yang sudah selesai. |
| "Ekspor CSV tersedia setelah analisis daftar ini selesai." | Server menolak ekspor daftar, karena analisis daftar belum lengkap. | Tunggu sampai analisis daftar lengkap. Untuk daftar dengan label Tidak lengkap, ekspor setiap lokasi yang sudah selesai. |
| "Ekspor tidak tersedia — belum ada lokasi pada daftar ini yang dianalisis, jadi tidak ada yang bisa diekspor." | Tidak ada lokasi daftar yang sudah selesai. | Tunggu sampai analisis selesai. |
| "Ekspor tidak tersedia — analisis untuk lokasi ini belum selesai. Ekspor akan tersedia setelah semua analisisnya selesai." | Salah satu analisis lokasi ini belum selesai. | Tunggu sampai setiap analisis lokasi selesai. |
| "CSV berhasil diunduh, tetapi berkas pendamping "Data yang digunakan" (tanggal set data sumber) tidak dapat diunduh." | File kedua tidak terunduh. | Tekan tombol lagi. |
| "Ekspor PDF tidak tersedia — belum ada lokasi yang dianalisis untuk daftar ini." | Tidak ada lokasi daftar yang sudah selesai. | Tunggu sampai analisis selesai. |
| "Ekspor PDF tidak tersedia — peta dan lapisan analisis belum siap untuk ditangkap. Harap tunggu dan coba lagi." | Peta belum selesai digambar. | Tunggu sampai peta selesai digambar. Tekan Unduh PDF lagi. |
| "Ekspor PDF tidak tersedia — masih menunggu: {{items}}. Harap tunggu dan coba lagi." | Peta menunggu item di dalam pesan, misalnya ubin peta dasar. | Tunggu. Tekan Unduh PDF lagi. Jika ubin gagal dimuat, lihat "Peta" di bawah. |
| "Gagal mengekspor PDF — tampilan peta tidak dapat ditangkap. Coba lagi setelah peta selesai menggambar." | Aplikasi tidak membuat gambar peta. | Tunggu sampai peta selesai digambar. Tekan Unduh PDF lagi. |
| "Gagal mengekspor PDF — laporan tidak dapat dirangkai." atau "Gagal mengekspor PDF — permintaan ekspor tidak selesai. Silakan coba lagi." | Aplikasi tidak membuat file PDF. | Tekan Unduh PDF lagi. Jika masalah berlanjut, baca baris yang dimulai dengan "Penyebab:". |
| "Sumber data tidak dapat dimuat. Lihat DATA-ATTRIBUTION.md di repositori proyek." | Aplikasi tidak mendapatkan teks atribusi. | Baca file DATA-ATTRIBUTION.md. Buka Sumber data dan lisensi lagi nanti. |
Peta¶
Untuk informasi lebih lanjut tentang peta, lihat 04-maps.md.
| Masalah | Penyebab | Tindakan |
|---|---|---|
| "Peta tidak dapat ditampilkan" | Terjadi kesalahan di peta. Bagian lain halaman tetap berfungsi. | Coba lagi, atau muat ulang halaman. |
| "Gagal memuat data kisi peta." | Aplikasi tidak mendapatkan lapisan analisis untuk peta. | Muat ulang halaman. |
| "Lokasi ditemukan, tetapi batas peta tidak valid dan tidak dapat ditampilkan." | Batas lokasi tidak benar. | Periksa koordinat lokasi. |
| "Perbandingan tidak tersedia: peta dasar ini tidak memiliki tanggal untuk dipilih." | Peta dasar tidak memiliki tanggal. | Pilih peta dasar yang berbeda. |
| "Sel asli lebih kecil dari satu piksel layar pada tingkat zum ini. Perbesar untuk resolusi maksimum." | Anda memperkecil terlalu jauh untuk resolusi maksimum. | Perbesar. |
| "Berkas ini bukan JSON yang valid." atau "Ini bukan berkas templat legenda peta." | Anda memilih file yang bukan templat legenda peta. | Pilih file .mpky yang Anda simpan dari legenda peta. |
Daftar dan hasil¶
| Masalah | Penyebab | Tindakan |
|---|---|---|
| "Gagal memuat daftar" atau "Gagal memuat hasil" | Aplikasi tidak dapat membaca basis data hasil. | Muat ulang halaman. Jika masalah berlanjut, baca keluaran docker logs luc-analytics. |
| "Daftar tidak ditemukan" | Daftar tidak ada. Mungkin seseorang telah menghapusnya. | Pergi ke halaman daftar dan pilih daftar yang ada. |
| "Proses ini tidak selesai: {{message}}" | Proses baru daftar berhenti. | Baca pesan. Perbaiki penyebabnya. Kemudian tekan Jalankan ulang dengan data terkini. |
| "Pembaruan ini tidak selesai: {{message}}. Hasil sebelumnya tetap disimpan." | Pembaruan daftar berhenti. Aplikasi tetap menyimpan hasil sebelumnya. | Baca pesan. Mulai pembaruan lagi. |
| "Terjadi kesalahan" | Halaman mengalami kesalahan. | Coba lagi, atau muat ulang halaman. |