40 lines
2.1 KiB
Markdown
40 lines
2.1 KiB
Markdown
# Phase 1: System Reconnaissance Guide
|
|
|
|
**Objective:** To execute the reconnaissance script that gathers essential information about the current system. This information will be used in subsequent phases to plan the file and software migration.
|
|
|
|
**Prerequisite:** Ensure you have completed **Phase 0: Full System Backup**. Do not run this script until you have a complete and verified offline backup of your data.
|
|
|
|
## Instructions for Operator (Human or AI)
|
|
|
|
### 1. Understand the Script
|
|
|
|
- **Script Location:** `scripts/01_system_recon.sh`
|
|
- **Purpose:** This script is designed to be **non-destructive**. It reads information about the system and saves it to a log file. It does not modify any files or settings.
|
|
- **Actions Performed:**
|
|
- Gathers disk, partition, and filesystem information.
|
|
- Calculates the total size of major user directories (Documents, Pictures, etc.).
|
|
- Lists installed software from `apt` and `snap`.
|
|
- Collects detailed information about the Docker setup (containers, images, volumes).
|
|
- Checks for versions of common development languages (Rust, Node, etc.).
|
|
- Looks for evidence of common servers and development workspaces (Eclipse, Arduino).
|
|
- **Output:** All findings are saved to `logs/01_system_recon.log`.
|
|
|
|
### 2. Execution
|
|
|
|
1. Open a terminal on the Ubuntu machine that is being migrated.
|
|
2. Navigate to the `nixos-migration` project directory.
|
|
3. Run the script. It may ask for a password as some commands (like inspecting Docker's data directory or listing packages) can require elevated privileges to get a complete picture.
|
|
|
|
```bash
|
|
sudo ./scripts/01_system_recon.sh
|
|
```
|
|
|
|
### 3. Review the Output
|
|
|
|
- Upon completion, the script will have created or updated the log file at `logs/01_system_recon.log`.
|
|
- Review this file to ensure the information appears correct and complete. This log is the foundation for all future planning steps.
|
|
|
|
### 4. Next Steps
|
|
|
|
Once the reconnaissance is complete and the log file has been generated, you may proceed to **Phase 2: Migration Analysis & Planning**. The data in the log file will be the primary input for this next phase.
|