# 🚀 START HERE - Migration Guide

## You're Working Offline? Perfect!

Everything you need is in this directory. Follow these steps:

---

## Step 1: Prepare New Server (15 minutes)

**File to read:** `NEW_SERVER_PREPARATION.md`

**Quick commands:**
```bash
# 1. SSH to new server
ssh root@vps2.scala4.com
# Password: Sun-Morning-Wind-2026

# 2. Copy preparation script (from old server)
scp /var/www/html/wordpress6/wordpress/EP/migration/prepare-new-server.sh root@vps2.scala4.com:/root/

# 3. Run preparation script (on new server)
chmod +x /root/prepare-new-server.sh
/root/prepare-new-server.sh
```

**Checklist:** Use `PREPARATION_CHECKLIST.md` to track progress

---

## Step 2: Run Inventory on Old Server (5 minutes)

**File to read:** `OFFLINE_MIGRATION_GUIDE.md` (Part 2)

**Quick commands:**
```bash
cd /var/www/html/wordpress6/wordpress/EP/migration
./inventory-applications.sh > ../inventory-report.txt
./analyze-databases.sh > ../database-analysis.txt
./find-unused-files.sh > ../unused-files-report.txt
```

---

## Step 3: Copy Migration Tools to New Server (2 minutes)

**Quick command:**
```bash
rsync -avz /var/www/html/wordpress6/wordpress/EP/migration/ root@vps2.scala4.com:/root/migration/
```

---

## Step 4: Start Migrating Applications

**File to read:** `OFFLINE_MIGRATION_GUIDE.md` (Part 4)

**Priority order:**
1. **WHMCS Billing** (most critical)
2. **Event Registration System**
3. **Main WordPress Site**

**For each application:**
- Follow the pattern in `OFFLINE_MIGRATION_GUIDE.md`
- Use `MIGRATION_CHECKLIST_TEMPLATE.md` to track progress
- Test thoroughly before DNS cutover

---

## 📚 Documentation Guide

### If you need step-by-step instructions:
→ **OFFLINE_MIGRATION_GUIDE.md** - Complete walkthrough

### If you need to prepare the server:
→ **NEW_SERVER_PREPARATION.md** - Detailed preparation guide

### If you need quick commands:
→ **QUICK_REFERENCE.md** - Cheat sheet

### If you need the big picture:
→ **SERVER_MIGRATION_PLAN.md** - Overall strategy

### If you want interactive help:
→ Run `./quick-start.sh` - Interactive helper

---

## ⚠️ Important Reminders

1. **Always backup** before migrating
2. **Test thoroughly** before DNS cutover
3. **Keep old server running** for 48-72 hours after migration
4. **One application at a time** - don't rush
5. **Document passwords** and credentials

---

## 🆘 Need Help?

### Troubleshooting
- Check `OFFLINE_MIGRATION_GUIDE.md` (Part 5: Troubleshooting)
- Check `QUICK_REFERENCE.md` (Common Issues & Fixes)
- Check logs: `journalctl -xe`, `/var/log/apache2/error.log`

### Emergency Rollback
- Revert DNS to point back to old server
- Old server is your backup - keep it running!

---

## ✅ Ready to Start?

1. Open `OFFLINE_MIGRATION_GUIDE.md`
2. Follow Step 1: New Server Preparation
3. Take it one step at a time

**Good luck! You've got this! 🎯**