whois/MIGRATION.md

Infrastructure Migration Documentation

Migration Date: 2025-11-12

Migration Context

Previous Infrastructure (DELETED)

• Domain: as60284.net
• Git Remote: https://git.as60284.net/AXSY/whois.git
• Status: INFRASTRUCTURE COMPLETELY DELETED - NO LONGER ACCESSIBLE
• Credentials: (Preserved in git history, now invalid)

New Infrastructure (ACTIVE)

Primary Production Server

• Domain: photon.obnh.io
• Git Remote (HTTPS): https://git.photon.obnh.io/AXSY/whois.git
• Git Remote (SSH): git@git.photon.obnh.io:AXSY/whois.git
• User: olaf
• Organization: AXSY
• API Key: 7ca0e04e56df443163657e5e83c5b2ef2794e0cf
• Status: PRIMARY - All pushes go here
• Repository Count: 24 repositories

Disaster Recovery Mirror

• Domain: git.proton.obr.sh
• Git Remote (HTTPS): https://git.proton.obr.sh/axsy/whois.git
• Git Remote (SSH): git@git.proton.obr.sh:axsy/whois.git
• User: olaf
• API Key: 151b26b25ffa4100ea776b09e2ed72a2dcb0787e
• Status: MIRROR - Automatic sync from primary
• Sync Method: Gitea pull mirroring (automatic)
• Server IPv6: 2a02:4780:41:5469::1
• Setup Date: 2025-11-08

Legacy Backup (Deprecated)

• Domain: elektron.obnh.io
• Status: BACKUP (Legacy, not actively used)
• API Key: 7d73260d408f40b8b6ab23ea6ff6941a58079244

Migration Actions Performed

1. Remote Reconfiguration

# Remove old remote pointing to deleted infrastructure
git remote remove origin

# Add new primary remote
git remote add origin git@git.photon.obnh.io:AXSY/whois.git

# Add disaster recovery mirror
git remote add mirror git@git.proton.obr.sh:axsy/whois.git

# Verify configuration
git remote -v

2. Repository Setup on New Infrastructure

• Repository created on git.photon.obnh.io under AXSY organization
• Mirror automatically configured on git.proton.obr.sh
• All 24 repositories from photon.obnh.io mirrored to proton.obr.sh

3. Documentation Updates

• Created ENVIRONMENT.md with comprehensive setup instructions
• Created this MIGRATION.md to document the transition
• Updated .gitea-config.md with current infrastructure details

4. Session Closure Commit

• Committed mwhois.log (modified)
• Committed .gitea-config.md (untracked)
• Committed ENVIRONMENT.md (new)
• Committed MIGRATION.md (new)

Workflow Changes

Before Migration

# Old workflow (NO LONGER WORKS)
git push origin master  # Pushed to git.as60284.net

After Migration

# New workflow (CURRENT)
git push origin master  # Pushes to git.photon.obnh.io
# Mirror at git.proton.obr.sh syncs automatically

Critical Notes for Continuity

For User "olaf" on New Host

1. Clone from new remote:

   git clone git@git.photon.obnh.io:AXSY/whois.git
   cd whois
   

2. Verify remotes are configured:

   git remote -v
   # Should show:
   # origin  git@git.photon.obnh.io:AXSY/whois.git (fetch)
   # origin  git@git.photon.obnh.io:AXSY/whois.git (push)
   # mirror  git@git.proton.obr.sh:axsy/whois.git (fetch)
   # mirror  git@git.proton.obr.sh:axsy/whois.git (push)
   

3. Configure git identity:

   git config user.name "Olaf"
   git config user.email "admin@obr.sh"
   

4. Development workflow unchanged:

   • Edit files as normal
   • Commit changes locally
   • Push to origin (photon.obnh.io)
   • Mirror syncs automatically

SSH Key Requirements

• Ensure SSH key is added to both git.photon.obnh.io and git.proton.obr.sh
• Test SSH access:

  ssh -T git@git.photon.obnh.io
  ssh -T git@git.proton.obr.sh
  

HTTPS Alternative

If SSH is not available, HTTPS works:

# Using API token for authentication
git clone https://olaf:7ca0e04e56df443163657e5e83c5b2ef2794e0cf@git.photon.obnh.io/AXSY/whois.git

Disaster Recovery Procedures

If Primary (photon.obnh.io) Fails

1. Verify mirror has latest commits:

   # Compare commit hashes
   git ls-remote https://git.proton.obr.sh/axsy/whois.git
   

2. Switch to mirror temporarily:

   git remote set-url origin git@git.proton.obr.sh:axsy/whois.git
   

3. Continue work:

   • Pull latest from mirror
   • Commit changes locally
   • Wait for primary restoration before pushing

4. Restore primary when available:

   git remote set-url origin git@git.photon.obnh.io:AXSY/whois.git
   git push origin master
   

If Mirror (proton.obr.sh) Fails

• Mirror is read-only disaster recovery
• Primary (photon.obnh.io) is authoritative
• Mirror will resync automatically when restored
• No action required from developers

Verification Checklist

• Old remote (git.as60284.net) removed
• New primary remote (git.photon.obnh.io) configured
• Mirror remote (git.proton.obr.sh) configured
• Documentation updated (ENVIRONMENT.md, MIGRATION.md)
• Git config (.gitea-config.md) updated
• All uncommitted changes committed
• Ready to push to new infrastructure

Post-Migration Actions Required

Immediate

1. Push all commits to new primary remote
2. Verify commits appear on git.photon.obnh.io web interface
3. Verify mirror sync to git.proton.obr.sh (automatic, within minutes)

On New Host (User "olaf")

1. Clone from git.photon.obnh.io
2. Configure git identity
3. Verify Python 3.12+ availability
4. Test mwhoisd server functionality
5. Verify all utility scripts work (add-as, add-ip, etc.)

Infrastructure Comparison

Aspect	Old (as60284.net)	New (photon.obnh.io)
Status	DELETED	ACTIVE (Primary)
Accessibility	NONE	Full access
User	olaf	olaf
Organization	AXSY	AXSY
Disaster Recovery	None	Automatic mirror to proton.obr.sh
Repository Count	N/A	24 repos
Setup Date	Unknown	Active since 2025-11-08

Lessons Learned

1. Always maintain disaster recovery mirrors - The DR mirror at proton.obr.sh proved essential
2. Document infrastructure early - .gitea-config.md was crucial for migration
3. Automate mirror sync - Gitea's automatic pull mirroring eliminates manual sync
4. Use SSH for git operations - More reliable than HTTPS with credentials
5. Keep comprehensive session documentation - Enables zero-loss transitions

Related Documentation

• ENVIRONMENT.md - Complete environment setup guide
• .gitea-config.md - Gitea instance configuration
• README.txt - Project usage documentation
• NOTICE - Legal and attribution notices

Support Contacts

• Administrator: olaf (admin@obr.sh)
• Organization: AXSY
• Primary Git: git.photon.obnh.io
• DR Mirror: git.proton.obr.sh