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

Open a terminal on the Ubuntu machine that is being migrated.
Navigate to the nixos-migration project directory.
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.
```
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.

2.1 KiB Raw Blame History