Pemecahan masalah kode kesalahan eksekusi pekerjaan Storage Mover

Agen Azure Storage Mover menggunakan kode status string untuk status yang disampaikan kepada pengguna akhir. Semua kode status memiliki awalan AZSM diikuti oleh empat digit desimal. Digit desimal pertama menunjukkan cakupan status tingkat tinggi. Setiap kode status harus termasuk dalam salah satu cakupan berikut:

• Status yang berlaku untuk seluruh agen.
  Kode-kode ini menggunakan digit 0cakupan , dan oleh karena itu dan memiliki awalan AZSM0.
• Status yang berlaku untuk pekerjaan tertentu yang dijalankan oleh agen.
  Kode-kode ini menggunakan digit 1 cakupan dan oleh karena itu memiliki awalan AZSM1.
• Status yang mungkin ditetapkan oleh agen pada file atau direktori tertentu yang ditransfer oleh pekerjaan yang dijalankan oleh agen.
  Kode-kode ini menggunakan digit 2 cakupan dan oleh karena itu memiliki awalan AZSM2.

Masing-masing cakupan ini selanjutnya membagi status menjadi kategori dan subkataan. Setiap subkataan biasanya mencadangkan 20 kode status untuk mengakomodasi ekspansi di masa mendatang.

Tip

AZSM0000 adalah kode status lingkup-agnostik khusus yang menunjukkan keberhasilan operasi dan harus digunakan untuk menandakan operasi yang berhasil pada cakupan/tingkat apa pun.

Kode Kesalahan	Pesan kesalahan	Langkah/Mitigasi Detail/Pemecahan Masalah
AZSM1001	Gagal memasang jalur sumber	Verifikasi nama server atau alamat IP yang disediakan valid, atau lokasi sumber sudah benar. Jika menggunakan SMB, verifikasi nama pengguna dan kata sandi yang disediakan sudah benar.
AZSM1002	Mengalami kesalahan saat memindai sumber	Coba lagi atau buat tiket dukungan.
AZSM1003	Gagal mengakses folder sumber karena masalah izin	Verifikasi bahwa agen telah diberikan izin ke berbagi file sumber.
AZSM1004	Jalur sumber yang disediakan tidak valid	Buat titik akhir baru dengan jalur berbagi sumber yang valid dan perbarui definisi pekerjaan dan coba lagi.
AZSM1020	Kesalahan lain-lain saat mengakses sumber	Kesalahan ini dilaporkan karena alasan apa pun yang menyebabkan kegagalan baca file/folder sumber. Beberapa kesalahan bisa berupa "tidak ada file atau direktori seperti itu", "izin ditolak", "kesalahan input/output", dll. Pastikan bahwa koneksi jaringan antara agen dan berbagi sumber berfungsi dengan baik. Share sumber/folder/file harus ada dan agen harus memiliki akses baca ke share sumber tersebut.
AZSM1021	Gagal mengakses folder target karena masalah izin	Coba lagi atau buat tiket dukungan.
AZSM1022	Jalur target yang disediakan tidak valid	Buat titik akhir baru dengan kontainer dan jalur target yang valid dan perbarui definisi pekerjaan dan coba lagi.
AZSM1023	Sewa kedaluwarsa untuk agen ini pada kontainer target	Coba lagi atau buat tiket dukungan.
AZSM1024	Kegagalan otorisasi mengakses lokasi target	Agen tidak memiliki izin yang memadai untuk mengakses lokasi target. Penetapan peran RBAC (kontrol akses berbasis peran) dilakukan secara otomatis saat sumber daya dibuat menggunakan portal Azure. Jika Anda menggunakan API, cmdlet PowerShell, atau SDK, buat penetapan peran secara manual untuk identitas terkelola agen untuk mengakses lokasi target. Untuk target kontainer Penyimpanan Blob, gunakan penetapan peran Kontributor Data Blob Penyimpanan. Untuk Azure File Share sebagai target, gunakan Storage File Data Privileged Contributor. Sebagai contoh, untuk menetapkan peran RBAC, lihat artikel Menetapkan peran Azure untuk akses ke data blob .
AZSM1025	Kegagalan autentikasi mengakses lokasi sumber	Verifikasi bahwa agen memiliki izin ke lokasi sumber.
AZSM1026	Jenis target tidak didukung oleh agen	Jenis target ini tidak didukung oleh agen Storage Mover saat ini.
AZSM1027	Lokasi target sibuk	Agen tidak dapat mengklaim saham target atau kontainer karena ada sewa aktif. Sewa mungkin karena pekerjaan migrasi lain atau pekerjaan yang dibatalkan sebelumnya masih memegang klaim pada file "AZURE_STORAGE_MOVER_MARKER". Pastikan tidak ada pekerjaan lain yang dijalankan untuk target ini. Jika tidak ada yang berjalan, hidupkan kembali agen dan coba lagi; jika masalah berlanjut, hubungi layanan dukungan.
AZSM1028	Kegagalan akses Key Vault	Kesalahan ini dapat terjadi jika identitas terkelola agen tidak memiliki akses RBAC "Pengguna Rahasia Brankas Kunci", jika firewall atau ACL jaringan memblokir koneksi ke titik akhir brankas kunci, atau jika rahasia yang hilang. Untuk kesalahan "RESPONSE 403", periksa penetapan peran dan aturan firewall apa pun pada brankas kunci yang dapat membatasi lalu lintas. Untuk kesalahan lain, gunakan opsi menu xdmsh "5) Uji konektivitas titik akhir tunggal" di bawah "2) Konfigurasi jaringan" untuk memverifikasi keterjangkauan titik akhir.
AZSM1029	Tipe titik akhir sumber tidak didukung oleh versi agen ini	Jenis sumber ini tidak didukung oleh agen Storage Mover saat ini.
AZSM1030	Tidak dapat memverifikasi jenis akun penyimpanan	Verifikasi bahwa akun penyimpanan dan kontainer ada, dan bahwa agen telah diberikan izin kepada mereka.
AZSM1031	Gagal mengatasi host target	Periksa konfigurasi jaringan untuk mengonfirmasi firewall, atau ACL tidak memblokir akses ke titik akhir akun penyimpanan. Gunakan opsi menu xdmsh "5) Uji konektivitas titik akhir tunggal" di bawah "2) Konfigurasi jaringan" untuk memverifikasi keterjangkauan titik akhir.
AZSM1040	Kesalahan lain-lain saat mengakses target	Kemungkinan kesalahan ini bersifat sementara. Coba lagi pekerjaan migrasi. Jika masalah berlanjut, buat tiket dukungan untuk bantuan lebih lanjut.
AZSM1041	Gagal mengirim kemajuan pekerjaan	Kemungkinan kesalahan ini bersifat sementara. Coba lagi pekerjaan migrasi. Jika masalah berlanjut, buat tiket dukungan untuk bantuan lebih lanjut.
AZSM1042	Gagal membuat pekerjaan	Kesalahan ini dapat terjadi karena berbagai alasan, seperti agen tidak dapat mencapai titik akhir akun penyimpanan, firewall, atau ACL jaringan yang memblokir koneksi, lalu lintas dari agen yang dirutekan melalui IP publik ketika titik akhir privat dikonfigurasi pada akun penyimpanan, atau proksi yang memodifikasi sertifikat. Untuk memverifikasi keterjangkauan titik akhir akun penyimpanan, gunakan opsi menu xdmsh "5) Uji konektivitas titik akhir tunggal" di bawah "2) Konfigurasi jaringan". Jika kesalahan yang dilaporkan adalah "x509: sertifikat yang ditandatangani oleh otoritas yang tidak dikenal," itu menunjukkan bahwa jaringan lokal mencegat dan mengubah sertifikat SSL (Intersepsi SSL) untuk lalu lintas ke titik akhir yang diperlukan, menyebabkan Agen tidak mengenali sertifikat yang diterima. Menambahkan sertifikat ke Agen biasanya dapat mengatasi masalah ini, namun fitur ini saat ini tidak didukung. Agar Agent dapat mengakses titik akhir ini, pertimbangkan untuk menambahkannya ke daftar yang diizinkan untuk menghindari intersepsi SSL.
AZSM1043	Gagal melanjutkan pekerjaan	Coba lagi atau buat tiket dukungan.
AZSM1044	Gagal menyelesaikan pekerjaan.	Coba lagi atau buat tiket dukungan.
AZSM1045	Pekerjaan dibatalkan saat masih berjalan.	Coba lagi atau buat tiket dukungan.
AZSM1060	Kesalahan lain-lain selama eksekusi pekerjaan.	Kesalahan ini dapat terjadi karena berbagai alasan. Tinjau kesalahan yang dilaporkan dan ambil tindakan korektif berdasarkan detailnya seperti yang diuraikan di bawah ini. Jika kesalahan menunjukkan: 1) "InvalidResourceName": Periksa apakah nama folder dan file mengikuti konvensi penamaan yang didukung. Misalnya, "con" bukan nama direktori yang valid. 2) "Saham yang ditentukan penuh": Verifikasi kapasitas saham sasaran. 3) "pendeskripsi file buruk": Konfirmasikan bahwa koneksi jaringan SMB antara agen dan sumber berfungsi dengan baik, dan bahwa server SMB responsif terhadap permintaan baca. 4) "403 Permintaan ini tidak berwenang untuk melakukan operasi ini": Jika titik akhir privat dikonfigurasi untuk akun penyimpanan target, periksa apakah DNS dikonfigurasi dengan benar dan verifikasi tidak ada kesalahan rute DNS atau konfigurasi penyeimbang muatan yang menyebabkan resolusi IP yang salah. 5) Untuk kesalahan lain, coba lagi pekerjaan; jika masalah berlanjut, buat tiket dukungan.
AZSM2021	Tipe file tidak didukung oleh target.	Tipe target ini tidak mendukung berkas tipe ini. Mereferensikan skalabilitas dan target performa untuk Azure Files dan Azure Blob Storage untuk informasi tambahan.
AZSM2024	Panjang jalur sumber lebih panjang dari maks yang didukung oleh target.	Lihat panduan dalam artikel Penamaan dan referensi berbagi, direktori, file, dan metadata .
AZSM2026	File sumber memiliki ukuran yang lebih besar dari maks yang didukung oleh target.	Lihat panduan dalam artikel Penamaan dan referensi berbagi, direktori, file, dan metadata .
AZSM2027	Deskriptor keamanan file sumber memiliki properti yang tidak didukung	Tinjau izin file atau folder.
AZSM2061	Kesalahan Tidak Diketahui ditemui saat memindai sumber.	Mungkin kesalahan sementara. Jalankan ulang pekerjaan migrasi.
AZSM2062	Gagal membaca file sumber karena masalah izin.	Verifikasi bahwa agen memiliki izin ke lokasi sumber.
AZSM2063	Terjadi kesalahan I/O saat membaca file sumber.	Kemungkinan kesalahan ini bersifat sementara. Coba lagi pekerjaan migrasi. Jika masalah berlanjut, buat tiket dukungan untuk bantuan lebih lanjut.
AZSM2069	Gagal membaca file target karena masalah izin.	Verifikasi bahwa agen telah diberikan izin ke lokasi target.
AZSM2070	Tidak dapat menulis blob karena memiliki sewa aktif	Kesalahan ini mungkin disebabkan oleh agen lain yang menulis ke lokasi. Pastikan tidak ada pekerjaan lain yang berjalan terhadap target. Coba lagi atau buat tiket dukungan.
AZSM2071	File sumber dimodifikasi selama transfer	Kemungkinan kesalahan ini bersifat sementara. Coba lagi pekerjaan migrasi. Jika masalah berlanjut, buat tiket dukungan untuk bantuan lebih lanjut.
AZSM2080	Penyalinan gagal karena kesalahan yang tidak diketahui	Kemungkinan kesalahan ini bersifat sementara. Coba lagi pekerjaan migrasi. Jika masalah berlanjut, buat tiket dukungan untuk bantuan lebih lanjut.

Pemecahan Masalah RBAC pada Storage Mover

Selama pekerjaan berjalan, penugasan RBAC otomatis terjadi. Jika ada kegagalan dalam penugasan, tambahkan penetapan peran yang diperlukan secara manual.

1. Navigasikan ke sumber daya yang sesuai - Key Vault, File Share, atau Kontainer Blob.
2. Navigasi ke Kontrol Akses (IAM).
3. Menambahkan penetapan peran baru: Menetapkan peran Azure menggunakan portal Microsoft Azure - Azure RBAC | Microsoft Learn.
4. Di panduan Menambahkan Penugasan Peran, cari peran yang sesuai dalam tabel di bawah ini untuk jenis sumber daya yang dipilih di langkah 1. Dalam contoh di bawah ini, sumber dayanya adalah Key Vault.

Jenis Sumber Daya	Peran diperlukan
Key Vault	Pengguna Rahasia Key Vault
Bagikan File	Kontributor dengan Hak Istimewa File Data Penyimpanan
Kontainer Blob	Kontributor Data Blob Penyimpanan Berkewenangan

i. Akses harus ditetapkan untuk "Identitas Terkelola".
Ii. Di panel kanan, pilih jenis Identitas Terkelola sebagai Mesin – Azure Arc.
iii. Pilih busur mesin dari daftar. Namanya sama dengan agen.
iv. Selesaikan penugasan.