docs: clarify ImportBackup usage

This commit is contained in:
uprightbass360
2025-11-09 02:55:00 -05:00
parent acf2364294
commit 6f91685319
3 changed files with 16 additions and 7 deletions

View File

@@ -422,8 +422,11 @@ open http://localhost:8081
docker exec -it ac-mysql mysql -u root -p docker exec -it ac-mysql mysql -u root -p
# Manual backup operations # Manual backup operations
./scripts/bash/backup-export.sh [output_dir] # Export user accounts & characters # Export user accounts & characters to a named directory
./scripts/bash/backup-import.sh [backup_dir] # Import user data from backup ./scripts/bash/backup-export.sh storage/backups/ExportBackup_manual_$(date +%Y%m%d_%H%M%S)
# Import data from a directory that contains the SQL dumps
./scripts/bash/backup-import.sh --backup-dir storage/backups/ImportBackup --password azerothcore123
# View available backups # View available backups
ls -la storage/backups/ ls -la storage/backups/

View File

@@ -127,10 +127,14 @@ ExportBackup_YYYYMMDD_HHMMSS/
Restores user accounts and characters from backup while preserving world data. Restores user accounts and characters from backup while preserving world data.
```bash ```bash
./scripts/bash/backup-import.sh # Import from ImportBackup/ ./scripts/bash/backup-import.sh --backup-dir storage/backups/ImportBackup --password azerothcore123
./scripts/bash/backup-import.sh /path/to/backup # Import from specific directory
# Restore directly from an ExportBackup archive you just unpacked
./scripts/bash/backup-import.sh --backup-dir ExportBackup_20241029_120000 --password azerothcore123 --all
``` ```
> The importer always requires `--backup-dir`. A common workflow is to extract an `ExportBackup_*` archive into `storage/backups/ImportBackup/` and pass that directory to the script, but you can point to any folder that contains the SQL dumps.
**Required Files:** **Required Files:**
- `acore_auth.sql[.gz]` - User accounts (required) - `acore_auth.sql[.gz]` - User accounts (required)
- `acore_characters.sql[.gz]` - Character data (required) - `acore_characters.sql[.gz]` - Character data (required)
@@ -401,4 +405,4 @@ sudo chown -R $USER:$USER storage/
--- ---
For additional help and troubleshooting information, refer to the main README.md file or check the project repository issues. For additional help and troubleshooting information, refer to the main README.md file or check the project repository issues.

View File

@@ -105,10 +105,12 @@ ExportBackup_YYYYMMDD_HHMMSS/ # Created by scripts/bash/backup-export.sh
├── acore_characters.sql.gz # Character data ├── acore_characters.sql.gz # Character data
└── manifest.json └── manifest.json
ImportBackup/ # Used by scripts/bash/backup-import.sh ImportBackup/ # Optional staging area (use with --backup-dir)
├── acore_auth.sql[.gz] # Required: accounts ├── acore_auth.sql[.gz] # Required: accounts
├── acore_characters.sql[.gz] # Required: characters ├── acore_characters.sql[.gz] # Required: characters
└── acore_world.sql[.gz] # Optional: world data └── acore_world.sql[.gz] # Optional: world data
Place extracted dumps from any `ExportBackup_*` archive into this directory (or any other directory you prefer) and pass it to `scripts/bash/backup-import.sh --backup-dir <path>` when performing a manual restore.
``` ```
--- ---
@@ -124,4 +126,4 @@ ImportBackup/ # Used by scripts/bash/backup-import.sh
For additional support: For additional support:
1. Check the [AzerothCore Wiki](https://www.azerothcore.org/wiki/home) 1. Check the [AzerothCore Wiki](https://www.azerothcore.org/wiki/home)
2. Visit the [AzerothCore Discord](https://discord.gg/gkt4y2x) 2. Visit the [AzerothCore Discord](https://discord.gg/gkt4y2x)
3. Review [GitHub Issues](https://github.com/azerothcore/azerothcore-wotlk/issues) for known problems 3. Review [GitHub Issues](https://github.com/azerothcore/azerothcore-wotlk/issues) for known problems