Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Migrasi Linux WorkSpace ke sistem operasi yang berbeda
Anda dapat memigrasikan Linux yang ada WorkSpace ke bundel sistem operasi Linux yang berbeda sambil mempertahankan direktori home, file, dan data pengguna. Migrasi menggantikan volume root (sistem operasi) dengan bundel baru sambil menjaga volume pengguna (`/home`) tetap utuh. Ini berbeda dari rebuild, yang menyegarkan volume root dengan bundel OS yang sama.
WorkSpace Fitur Migrasi menangani seluruh proses secara otomatis, termasuk koreksi kepemilikan file dan pembersihan lingkungan desktop bila diperlukan.
**Topics**
+ [Jalur migrasi yang didukung](#linux-migration-paths)
+ [Prasyarat](#linux-migration-prerequisites)
+ [Cara memigrasi WorkSpace](#linux-migration-how-to)
+ [Post-migration verifikasi](#linux-migration-verification)
+ [Apa yang terjadi selama migrasi](#linux-migration-during)
+ [Migrasi dari Amazon Linux 2](#linux-migration-from-al2)
+ [Migrasi antar distribusi modern](#linux-migration-modern-distros)
+ [Apa yang disimpan pengguna dan perubahan apa](#linux-migration-preserved)
+ [Auto-stop dan selalu aktif WorkSpaces](#linux-migration-autostop-alwayson)
+ [Keterbatasan yang Sudah Diketahui](#linux-migration-limitations)
+ [Pemecahan masalah](#linux-migration-troubleshooting)
## Jalur migrasi yang didukung
Tabel berikut menunjukkan sumber yang didukung dan sistem operasi target untuk WorkSpace migrasi Linux.
| OS Sumber | Ubuntu 22.04 | Grafik Ubuntu 22.04 | Ubuntu 24.04 | RHEL 8 | RHEL 9 | Berbatu 8 | Berbatu 9 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Amazon Linux 2 (PCoIP) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Amazon Linux 2 (WSP) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Ubuntu 22.04 | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Grafik Ubuntu 22.04 | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ |
| Ubuntu 24.04 | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ |
| RHEL 8 | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ |
| RHEL 9 | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ |
| Berbatu 8 | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ |
| Berbatu 9 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
**Amazon Linux 2** adalah sumber migrasi yang valid tetapi bukan target migrasi yang valid. Amazon Linux 2 telah mencapai akhir masa pakai dan baru WorkSpaces tidak dapat dibuat dengan bundel AL2.
Semua jalur migrasi antara Ubuntu, RHEL, dan Rocky Linux didukung di kedua arah. Anda dapat meng-upgrade (misalnya, RHEL 8 → RHEL 9), downgrade (misalnya, Ubuntu 24.04 → Ubuntu 22.04), dan bermigrasi di seluruh keluarga distribusi (misalnya, Rocky 9 → Ubuntu 24.04 atau RHEL 9 → Rocky 8). Satu-satunya batasan adalah Anda tidak dapat memigrasikan a WorkSpace ke bundel yang sama yang sudah digunakannya.
Migrasi dari Amazon Linux 2 memerlukan koreksi kepemilikan ID pengguna otomatis dan pembersihan lingkungan desktop. Migrasi antara semua distribusi lainnya (Ubuntu, RHEL, Rocky) tidak memerlukan koreksi kepemilikan karena distribusi ini semua menggunakan SSSD untuk integrasi Active Directory, yang menetapkan ID pengguna yang stabil.
## Prasyarat
Sebelum memigrasi Linux WorkSpace, verifikasi hal berikut:
+ **WorkSpace Negara** - WorkSpace harus berada di `AVAILABLE` negara bagian. Anda tidak dapat memigrasi WorkSpace yang memulai, berhenti, atau dalam status kesalahan.
+ **No Active Directory Forest Trust** — Direktori tidak boleh memiliki hubungan Forest Trust yang dikonfigurasi. WorkSpace SSSD, yang digunakan oleh semua distribusi Linux modern untuk integrasi Active Directory, tidak mendukung Forest Trust. Jika Forest Trust dikonfigurasi, migrasi akan gagal selama penyediaan.
+ **Penyimpanan EBS yang memadai** — WorkSpace Harus memiliki penyimpanan EBS yang cukup untuk operasi migrasi.
## Cara memigrasi WorkSpace
### Menggunakan AWS Konsol Manajemen
1. Buka WorkSpaces konsol Amazon di [https://console.aws.amazon.com/workspaces/](https://console.aws.amazon.com/workspaces/).
1. Di panel navigasi, pilih **WorkSpaces**.
1. Pilih yang ingin WorkSpace Anda migrasi.
1. Pilih **Tindakan**, lalu pilih **Migrasi. WorkSpace**
1. Pilih bundel sistem operasi target.
1. Pilih **Migrasikan**.
### Menggunakan AWS CLI
Gunakan `migrate-workspace` perintah untuk memigrasikan WorkSpace ke bundel yang berbeda:
```
aws workspaces migrate-workspace \
--source-workspace-id ws-1234567890abcdef0 \
--bundle-id wsb-jttwgmx20 \
--region us-east-1
```
Untuk menemukan ID bundel target yang tersedia:
```
aws workspaces describe-workspace-bundles \
--query 'Bundles[?contains(Name, `Ubuntu`) || contains(Name, `Rocky`) || contains(Name, `RHEL`)].{Name:Name,BundleId:BundleId}' \
--output table
```
### Memantau status migrasi
Migrasi biasanya memakan waktu 20-30 menit. Pantau WorkSpace statusnya:
```
aws workspaces describe-workspaces \
--workspace-ids ws-1234567890abcdef0 \
--query 'Workspaces[0].State' \
--output text
```
WorkSpace Transisi melalui keadaan berikut: `AVAILABLE` → `PENDING` → `AVAILABLE` (pada keberhasilan) atau `ERROR` (pada kegagalan). Jika migrasi gagal selama penyediaan, bidang kontrol secara otomatis mengembalikan aslinya. WorkSpace
## Post-migration verifikasi
Setelah migrasi selesai, verifikasi hal berikut:
**Periksa WorkSpace status**
WorkSpace Konfirmasikan `AVAILABLE` status di AWS Konsol atau melalui CLI.
**Verifikasi login pengguna**
Mintalah pengguna masuk ke WorkSpace dan konfirmasikan beban desktop dengan benar.
**Memeriksa log migrasi**
Untuk migrasi AL2, tinjau log migrasi untuk detail tentang apa yang diubah:
```
cat ~/workspace-migration-log-*/user-id-migration.txt
```
Log ini menunjukkan ID pengguna lama dan baru, jumlah file yang diubah di setiap fase, dan stempel waktu.
**Periksa status Fase 2**
Untuk memverifikasi apakah migrasi latar belakang telah selesai:
```
# Check if the Phase 2 service is still running
systemctl is-active ws-migrate-phase2.service 2>/dev/null
# "inactive" or "not found" means Phase 2 has completed
# "activating" means Phase 2 is still running (Type=simple service)
```
## Apa yang terjadi selama migrasi
Saat Anda memulai migrasi, langkah-langkah berikut akan terjadi:
1. Volume pengguna (`/home`) terlepas dari yang ada WorkSpace.
1. Yang WorkSpace ada dibuang.
1. WorkSpace Yang baru dibuat dari bundel sistem operasi target.
1. Volume pengguna disambungkan kembali ke WorkSpace at `/home` baru.
1. Yang baru WorkSpace disediakan: jaringan dikonfigurasi, instance bergabung dengan Active Directory, dan direktori home pengguna disiapkan.
1. Jika bermigrasi dari Amazon Linux 2, kepemilikan file diperbaiki dan konfigurasi desktop lama dibersihkan (lihat). [Migrasi dari Amazon Linux 2](#linux-migration-from-al2)
1. WorkSpace Reboot dan menjadi tersedia bagi pengguna untuk masuk.
Direktori home pengguna disimpan pada volume EBS terpisah yang dipertahankan di seluruh migrasi. Semua file `/home/{{username}}` bertahan dalam transisi, termasuk dokumen, kunci SSH, konfigurasi shell, dan data aplikasi.
## Migrasi dari Amazon Linux 2
Migrasi dari Amazon Linux 2 melibatkan langkah-langkah tambahan yang ditangani secara otomatis. Bagian ini menjelaskan apa yang terjadi dan mengapa.
### Mengapa migrasi AL2 berbeda
**Amazon Linux 2 menggunakan **Winbind** untuk integrasi Active Directory, sementara semua distribusi Linux yang lebih baru (Ubuntu, RHEL, Rocky) menggunakan SSSD.** Kedua sistem ini menetapkan ID pengguna POSIX yang berbeda ke pengguna Active Directory yang sama:
+ **Winbind** (AL2): Menetapkan ID pengguna menggunakan skema algoritmik yang tidak dapat diprediksi (misalnya, UID 1000).
+ **SSSD** (distribusi modern): Menetapkan ID pengguna stabil yang berasal dari SID Direktori Aktif (misalnya, UID 1285401133).
Setelah migrasi, semua file di direktori home pengguna dimiliki oleh Winbind UID lama. Pengguna tidak dapat mengakses file mereka sendiri sampai kepemilikan dikoreksi agar sesuai dengan UID SSSD yang baru.
**Selain itu, Amazon Linux 2 menggunakan lingkungan desktop **MATE** (GNOME 2), sedangkan distribusi yang lebih baru menggunakan GNOME 3.x.** File konfigurasi MATE bertentangan dengan GNOME 3.x dan harus dibersihkan untuk memastikan desktop berfungsi.
### Two-phase koreksi kepemilikan
Untuk menghindari batas waktu penyediaan, koreksi kepemilikan dibagi menjadi dua fase.
**Fase 1 (selama penyediaan)**
Memperbaiki kepemilikan pada file penting desktop yang diperlukan untuk login langsung:
+ Direktori Home itu sendiri
+ Kunci SSH () `~/.ssh/`
+ Konfigurasi desktop (`~/.config/`)
+ Profil shell (`.bashrc`,`.bash_profile`,`.profile`)
+ File atau direktori tingkat atas apa pun tanpa izin baca dunia
Tahap 1 selesai dengan cepat terlepas dari total ukuran direktori home, memastikan bahwa penyediaan tidak pernah gagal karena direktori home yang besar.
**Fase 2 (latar belakang, setelah reboot)**
Memperbaiki kepemilikan pada semua file yang tersisa:
+ Berjalan sebagai layanan systemd (`ws-migrate-phase2.service`) saat boot
+ Mencoba ulang resolusi pengguna hingga 10 menit jika SSSD belum siap saat boot — jika resolusi habis, layanan tetap diaktifkan dan mencoba lagi pada boot berikutnya
+ Menggunakan I/O prioritas menganggur dan prioritas CPU terendah — tidak memengaruhi pengalaman pengguna
+ Pengguna dapat masuk dan bekerja secara normal saat Fase 2 berjalan
+ Perbaikan kepemilikan untuk direktori besar (10M\+file) akan terus selesai di latar belakang
+ Self-removes file layanan systemd setelah berhasil diselesaikan
### Pembersihan lingkungan desktop
Selama migrasi dari AL2, file konfigurasi desktop MATE berikut dipindahkan ke direktori cadangan di dalam log migrasi (`~/workspace-migration-log-YYYYMMDD/removed-configuration/`):
+ `~/.config/dconf/user`— basis MATE-specific data dconf
+ `~/.gconf/`— Direktori GConf Legacy
+ `~/.config/mate-session/`— Konfigurasi sesi MATE
+ `~/.config/mate-panel/`- Konfigurasi panel MATE
+ `~/.local/share/mate-panel/`— Data aplikasi panel MATE
+ `~/.config/pluma/`— Pengaturan editor teks MATE
+ `~/.config/caja/`— Konfigurasi pengelola file MATE
+ `~/.config/marco/`— Pengaturan manajer jendela MATE
+ `~/.config/gtk-2.0/`, `~/.config/gtk-3.0/` - Konfigurasi tema GTK
+ `~/.local/share/recently-used.xbel`— Daftar file terbaru
File-file ini tidak dihapus - mereka dipindahkan ke direktori cadangan dan dapat dipulihkan jika diperlukan. Setelah pembersihan, desktop dimuat dengan tampilan GNOME 3.x default.
### Restorasi konteks SELinux
Ketika target migrasi adalah RHEL atau Rocky Linux, konteks keamanan SELinux selalu dipulihkan di seluruh direktori home pengguna (`/home/{{username}}`), terlepas dari sistem operasi sumbernya. Ini berlaku untuk semua jalur migrasi yang menargetkan SELinux-enabled distribusi, termasuk:
+ Migrasi dari sumber non-SELinux (Ubuntu, AL2), di mana file tidak memiliki label SELinux sepenuhnya.
+ Migrasi antar SELinux-enabled distribusi (misalnya, RHEL 8 → RHEL 9, Rocky 8 → Rocky 9, atau RHEL 9 → Rocky 9), karena versi kebijakan SELinux dan definisi konteks file dapat berubah di antara rilis utama.
Dalam semua kasus, restorasi konteks memastikan bahwa file memiliki label keamanan yang benar untuk kebijakan SELinux distribusi target.
Restorasi konteks berjalan dalam dua fase, sesuai dengan koreksi kepemilikan:
+ **Fase 1**: Mengembalikan konteks pada jalur kritis (`~/.ssh/`,`~/.config/`) selama penyediaan.
+ **Tahap 2**: Mengembalikan konteks pada seluruh direktori home di latar belakang setelah reboot.
### Koreksi otomatis direktori home RFC 2307
Active Directory mendukung atribut RFC 2307 (juga dikenal sebagai “Unix Attributes”), yang memungkinkan administrator untuk menentukan properti pengguna POSIX termasuk path direktori home (). `unixHomeDirectory` SSSD menghormati atribut ini, sementara Winbind di AL2 mengabaikannya dan selalu digunakan. `/home/{{username}}`
Saat bermigrasi dari AL2 ke SSSD-based distribusi, jika objek pengguna AD telah `unixHomeDirectory` disetel ke jalur yang berbeda (misalnya,`/home/CORP/jsmith`), SSSD akan menyelesaikan direktori home pengguna ke jalur tersebut. AD-specified Karena data aktual pengguna hidup `/home/{{username}}` dari era AL2, AD-specified jalur tidak ada pada volume.
Sistem migrasi mendeteksi situasi ini secara otomatis:
1. Setelah penyediaan, SSSD menyelesaikan direktori home pengguna ke jalur. AD-specified
1. Sistem migrasi memeriksa apakah jalur ini ada pada volume pengguna.
1. Jika AD-specified jalur tidak ada tetapi `/home/{{username}}` ada, sistem mengenali ini sebagai ketidakcocokan jalur RFC 2307.
1. Sistem mengatur `override_homedir=/home/%u` langsung `/etc/sssd/sssd.conf` (pada semua bagian domain) dan memulai ulang SSSD.
1. Setelah SSSD restart, direktori home pengguna menyelesaikan ke`/home/{{username}}`, di mana data benar-benar hidup.
1. Migrasi berlangsung secara normal terhadap data yang ada.
Koreksi ini bersifat permanen — `override_homedir` pengaturan tetap ada di `sssd.conf` seluruh reboot dan restart SSSD future.
### Mengaktifkan jalur direktori home RFC 2307 setelah migrasi
Jika migrasi mengoreksi jalur direktori home RFC 2307 secara otomatis dan Anda ingin SSSD menghormati `unixHomeDirectory` atribut AD di masa mendatang, Anda dapat membalikkan penggantian. Ini adalah perubahan konfigurasi lanjutan yang seharusnya hanya dilakukan jika Anda memahami implikasinya.
**Awas**
Setelah menghapus override, SSSD akan menggunakan jalur direktori AD-specified home. Anda harus memindahkan data pengguna ke jalur tersebut sebelum menghapus override, atau pengguna akan mendapatkan direktori home kosong.
Untuk memulihkan jalur direktori home RFC 2307:
**Langkah 1: Tentukan jalur direktori AD-specified home**
```
# Query the AD unixHomeDirectory attribute
ldapsearch -H ldap://your-dc.example.com -b "dc=example,dc=com" \
"(sAMAccountName=jsmith)" unixHomeDirectory
```
**Langkah 2: Pindahkan data pengguna ke AD-specified jalur**
```
sudo mkdir -p /home/CORP
sudo mv /home/jsmith /home/CORP/jsmith
```
**Langkah 3: Hapus pengaturan override\_homedir dari//sssd.conf etc/sssd**
```
sudo sed -i '/^override_homedir/d' /etc/sssd/sssd.conf
```
**Langkah 4: Mulai ulang SSSD**
```
sudo systemctl restart sssd
```
**Langkah 5: Verifikasi direktori home menyelesaikan dengan benar**
```
getent passwd jsmith
# Should show /home/CORP/jsmith as the home directory
```
**penting**
Setelah menghapus override, future WorkSpace rebuilds dan migrations akan menggunakan path. AD-specified Pastikan data berada di lokasi yang benar sebelum pembangunan kembali atau migrasi berikutnya.
### Notifikasi pengguna
Sistem migrasi menggunakan dua mekanisme notifikasi untuk memberi informasi kepada pengguna:
1. **Pemberitahuan layanan systemd fase 2** - Jika pengguna terhubung ke desktop saat Fase 2 dimulai atau selesai, mereka melihat pemberitahuan langsung dari layanan:
+ **Pada Tahap 2 mulai:** “Menyelesaikan migrasi file di latar belakang. Anda dapat terus bekerja secara normal. Beberapa file mungkin tetap tidak dapat diakses sampai migrasi selesai.
+ **Pada penyelesaian Fase 2:** “Migrasi file berhasil diselesaikan. Semua file sekarang harus memiliki kepemilikan yang benar. Lihat \~/workspace-migration-log-\* untuk detailnya.”
1. **Pemberitahuan login autostart XDG** - Entri autostart (`~/.config/autostart/ws-migration-notify.desktop`) berjalan `/usr/lib/skylight/check-migration-status` pada login pertama setelah migrasi. Ini menangani kasus di mana pengguna terhubung saat Fase 2 masih berjalan atau setelah selesai:
+ **Jika Fase 2 masih berjalan:** “Migrasi file berjalan di latar belakang. Anda dapat terus bekerja secara normal. Beberapa file mungkin tetap tidak dapat diakses sampai migrasi selesai.
+ **Jika Fase 2 telah selesai:** “Migrasi file berhasil diselesaikan. Semua file sekarang harus memiliki kepemilikan yang benar. Lihat \~/workspace-migration-log-\* untuk detailnya.”
Entri autostart dihapus setelah menampilkan pemberitahuan penyelesaian sehingga tidak berjalan pada login berikutnya.
Jika pengguna tidak terhubung (misalnya, penghentian otomatis WorkSpace yang belum diakses), Fase 2 berjalan diam-diam tanpa kesalahan.
## Migrasi antar distribusi modern
Migrasi antara distribusi Ubuntu, RHEL, dan Rocky Linux tidak memerlukan koreksi kepemilikan ID pengguna. Semua distribusi ini menggunakan SSSD untuk integrasi Active Directory, yang menetapkan ID pengguna stabil yang berasal dari AD SID. File pengguna mempertahankan kepemilikan yang benar di seluruh migrasi.
Jalur migrasi umum dalam kategori ini meliputi:
+ **Cross-family:** Ubuntu 22.04 ↔ RHEL 8/9, Ubuntu 22.04 ↔ Berbatu, RHEL ↔ Berbatu 8/9
+ **Upgrade versi:** Ubuntu 22.04 → Ubuntu 24.04, RHEL 8 → RHEL 9, Rocky 8 → Rocky 9
+ **Bundel grafis:** Sumber apa pun → Grafik Ubuntu 22.04. Ubuntu Graphics juga WorkSpaces dapat bermigrasi ke target non-grafis.
Untuk migrasi ke target RHEL atau Rocky Linux, restorasi konteks SELinux selalu berjalan untuk memastikan file memiliki label keamanan yang benar untuk kebijakan SELinux distribusi target. Ini berlaku terlepas dari distribusi sumbernya. Untuk file yang sudah memiliki label yang benar, restorasi adalah no-op.
## Apa yang disimpan pengguna dan perubahan apa
### Apa yang diawetkan
+ Semua file di direktori home (Dokumen, Unduhan, Desktop, dan sebagainya)
+ Kunci SSH dan konfigurasi () `~/.ssh/`
+ Konfigurasi shell (`.bashrc`,`.profile`,`.bash_profile`)
+ Bookmark dan profil browser (Firefox, Chrome)
+ Application-specific data dan konfigurasi (kecuali komponen desktop MATE pada migrasi AL2)
### Apa yang berubah
+ Lingkungan desktop me-reset ke tampilan GNOME 3.x default pada distribusi target.
+ Preferensi desktop lama MATE dihapus dan dicadangkan (hanya migrasi AL2).
+ Ikon desktop dan kustomisasi panel diatur ulang ke default.
+ Aplikasi yang diinstal pada volume root diganti dengan aplikasi default bundel target. Aplikasi yang diinstal oleh pengguna di direktori home mereka dipertahankan.
## Auto-stop dan selalu aktif WorkSpaces
### Auto-stop WorkSpaces
Untuk WorkSpaces dikonfigurasi dengan auto-stop (hibernasi setelah batas waktu idle):
1. Migrasi selesai dan WorkSpace reboot.
1. Layanan latar belakang Fase 2 dimulai saat boot. Jika SSSD belum siap, layanan akan mencoba resolusi pengguna hingga 10 menit sebelum melanjutkan.
1. Jika pengguna tidak terhubung dalam batas waktu idle (biasanya 1 jam), Fase 2 berjalan diam-diam di latar belakang.
1. Untuk beban kerja tipikal (kurang dari 100.000 file), Fase 2 selesai dalam batas waktu idle.
1. WorkSpace Hibernasi setelah Fase 2 selesai.
1. Ketika pengguna berikutnya terhubung, migrasi sudah selesai dan tidak ada pemberitahuan yang ditampilkan.
### Always-on WorkSpaces
Untuk selalu aktif WorkSpaces:
1. Migrasi selesai dan WorkSpace reboot.
1. Layanan latar belakang Fase 2 dimulai saat boot dan berjalan hingga selesai.
1. Pengguna dapat terhubung kapan saja dan bekerja secara normal - Fase 2 berjalan pada prioritas idle dan tidak memengaruhi kinerja.
## Keterbatasan yang Sudah Diketahui
+ **Active Directory Forest Trust:** SSSD tidak mendukung hubungan Forest Trust. WorkSpaces di direktori dengan Forest Trust yang dikonfigurasi tidak dapat dimigrasikan.
+ **Amazon Linux 2 sebagai target:** AL2 telah mencapai akhir masa pakai dan bukan target migrasi yang valid. Anda hanya dapat bermigrasi *dari* AL2, bukan *ke* AL2.
+ **Tidak ada kemunduran:** Migrasi yang telah selesai tidak dapat dikembalikan ke sistem operasi sebelumnya. Jika Anda perlu kembali ke OS sebelumnya, Anda harus memulai migrasi baru (kecuali untuk AL2, yang bukan target yang valid).
+ **Kustomisasi desktop MATE:** Saat bermigrasi dari AL2, preferensi desktop MATE dihapus. Mereka dicadangkan `~/workspace-migration-log-YYYYMMDD/removed-configuration/` tetapi tidak dapat diterapkan secara otomatis ke desktop GNOME 3.x.
+ **Direktori rumah besar:** Untuk direktori rumah dengan jutaan file, koreksi kepemilikan latar belakang Tahap 2 mungkin memakan waktu beberapa jam. Pengguna dapat bekerja secara normal selama waktu ini, tetapi beberapa file mungkin memiliki kepemilikan yang salah hingga Fase 2 selesai.
+ **Berbagi file:** Jika pengguna telah menyiapkan berbagi file (misalnya, berbagi Samba) di direktori home mereka, perubahan kepemilikan selama migrasi AL2 dapat memengaruhi izin berbagi. Konfigurasi berbagi file mungkin perlu dibuat kembali setelah migrasi.
+ **Penggantian RFC 2307:** Jika migrasi mengoreksi secara otomatis ketidakcocokan jalur direktori home RFC 2307, atribut AD akan diganti melalui in. `unixHomeDirectory` `override_homedir` `sssd.conf` Lihat [Mengaktifkan jalur direktori home RFC 2307 setelah migrasi](#linux-migration-al2-rfc2307-reverse) apakah Anda ingin SSSD menghormati AD-specified jalannya.
## Pemecahan masalah
### Migrasi gagal selama penyediaan
Jika migrasi gagal dan WorkSpace kembali ke `ERROR` status, bidang kontrol secara otomatis mencoba mengembalikan aslinya WorkSpace. Periksa log penyediaan:
```
# Connect to the WorkSpace (if accessible) and check the domain-join log
sudo cat /var/log/skylight/domain-join.log
```
Penyebab umum:
+ **Forest Trust dikonfigurasi:** SSSD tidak dapat bergabung dengan domain dengan Forest Trust. Hapus Forest Trust sebelum bermigrasi.
+ **Masalah konektivitas AD:** WorkSpace Tidak dapat mencapai pengontrol domain. Verifikasi jaringan VPC dan aturan grup keamanan.
+ **Kegagalan resolusi DNS:** WorkSpace Tidak dapat menyelesaikan domain AD. Verifikasi konfigurasi DNS.
### Pengguna tidak dapat masuk setelah migrasi
+ WorkSpace Verifikasi dalam `AVAILABLE` keadaan.
+ Periksa apakah domain bergabung berhasil diselesaikan: `sudo cat /var/lib/skylight/domain-join-status` harus berisi`true`.
+ Verifikasi pengguna dapat diselesaikan: `id {{username}}` harus mengembalikan UID dan grup pengguna.
+ Periksa status SSSD: `sudo sssctl domain-status {{domain}}` harus ditampilkan`Online status: Online`.
### Desktop tampak rusak atau memiliki tema yang salah
Ini biasanya terjadi ketika bermigrasi dari AL2 dan beberapa file konfigurasi MATE tidak dibersihkan. Untuk mengatur ulang desktop ke default:
```
# Remove remaining desktop configuration
rm -rf ~/.config/dconf/user
rm -rf ~/.gconf
# Log out and log back in
```
### File memiliki kepemilikan yang salah setelah migrasi
Jika file di direktori home tidak dapat diakses setelah migrasi AL2, Fase 2 mungkin masih berjalan:
```
# Check Phase 2 status
systemctl is-active ws-migrate-phase2.service 2>/dev/null
# Check the migration log for progress
cat ~/workspace-migration-log-*/user-id-migration.txt
```
Jika Fase 2 telah selesai tetapi beberapa file masih memiliki kepemilikan yang salah, Anda dapat memperbaikinya secara manual:
```
# Find files with the old UID and change ownership
sudo find /home/{{username}} -uid {{old-uid}} -exec chown {{username}} {} +
sudo find /home/{{username}} -gid {{old-gid}} -exec chgrp {{username}} {} +
```
### Lokasi berkas log
| Log | Lokasi | Daftar Isi |
| --- | --- | --- |
| Log bergabung dengan domain | /var/log/skylight/domain-join.log | Alur kerja penyediaan lengkap termasuk migrasi Tahap 1 |
| Ringkasan migrasi | \~/workspace-migration-log-YYYYMMDD/user-id-migration.txt | Old/new UID, jumlah file, stempel waktu untuk Fase 1 dan Fase 2 |
| Backed-up Konfigurasi MATE | \~/workspace-migration-log-YYYYMMDD/removed-configuration/ | File desktop MATE dihapus selama migrasi AL2 |
| Daftar file fase 1 | \~/workspace-migration-log-YYYYMMDD/phase1-processed-files.txt | File diproses selama Fase 1 (digunakan oleh Fase 2 untuk melewati duplikat) |