CAPipedia Sandbox:Updating CAPipedia: Difference between revisions
Created page with "# Test the new version deployment prior to upgrading in production 1. Download and uncompress the new version's distribution from mediawiki.org 2. Run the `refresh-sandbox.sh` script from the user home directory 3. Replace the distribution files using the command: `cp -pR mediawiki-[version]/* sandbox.capmembers.wiki` 4. From the `sandbox.capmembers.wiki` directory, run the command: `php maintenance/run.php update` 5. Browse to https://sandbox.capmembers.wiki/wiki/Speci..." |
No edit summary |
||
| Line 1: | Line 1: | ||
* Test the new version deployment prior to upgrading in production | |||
1. Download and uncompress the new version's distribution from mediawiki.org | 1. Download and uncompress the new version's distribution from mediawiki.org | ||
| Line 8: | Line 8: | ||
6. Check that the following operations work as expected: | 6. Check that the following operations work as expected: | ||
a. Viewing pages | |||
b. Editing pages | |||
c. Uploading a file | |||
* Backup the production site | |||
1. Place production site in read only mode by uncommenting the `$wgReadOnly` variable in the `LocalSettings.php` file of the old directory | 1. Place production site in read only mode by uncommenting the `$wgReadOnly` variable in the `LocalSettings.php` file of the old directory | ||
| Line 18: | Line 18: | ||
3. Run `backup-prod.sh` | 3. Run `backup-prod.sh` | ||
* Create a new production site | |||
1. Duplicate the production folder using the command: `cp -pR capipedia-[old_version] capipedia-[new_version]` | 1. Duplicate the production folder using the command: `cp -pR capipedia-[old_version] capipedia-[new_version]` | ||
| Line 28: | Line 28: | ||
7. From the new capipedia version directory, run the command: `php maintenance/run.php update` | 7. From the new capipedia version directory, run the command: `php maintenance/run.php update` | ||
* Switch the production hostname to the new site | |||
1. From the [https://panel.dreamhost.com DreamHost Web Panel], browse to **Websites**/**Manage Websites**/**Settings**/**Directories: Modify** and change the root web directory to the new version | 1. From the [https://panel.dreamhost.com DreamHost Web Panel], browse to **Websites**/**Manage Websites**/**Settings**/**Directories: Modify** and change the root web directory to the new version | ||
| Line 36: | Line 36: | ||
4. Check that the following operations work as expected: | 4. Check that the following operations work as expected: | ||
a. Viewing pages | |||
b. Editing pages | |||
c. Uploading a file | |||
Revision as of 11:20, 16 April 2025
- Test the new version deployment prior to upgrading in production
1. Download and uncompress the new version's distribution from mediawiki.org 2. Run the `refresh-sandbox.sh` script from the user home directory 3. Replace the distribution files using the command: `cp -pR mediawiki-[version]/* sandbox.capmembers.wiki` 4. From the `sandbox.capmembers.wiki` directory, run the command: `php maintenance/run.php update` 5. Browse to https://sandbox.capmembers.wiki/wiki/Special:Version and verify the upgrade took effect and the page fully loads without errors 6. Check that the following operations work as expected:
a. Viewing pages b. Editing pages c. Uploading a file
- Backup the production site
1. Place production site in read only mode by uncommenting the `$wgReadOnly` variable in the `LocalSettings.php` file of the old directory 2. Return to the user home directory 3. Run `backup-prod.sh`
- Create a new production site
1. Duplicate the production folder using the command: `cp -pR capipedia-[old_version] capipedia-[new_version]` 2. Replace the distribution files using the command: `cp -pR mediawiki-[version]/* capipedia-[new_version]` 3. From the DreamHost Web Panel, browse to **Websites**/**MySQL Databases** 4. Create a new database with a database name that matches the new directory name and new username of `cap_wiki_root` 5. Upload the backup database file to the database by running the command: `mysql -ucap_wiki_root -p -hmysql.sandbox.capmembers.wiki [new_db_name] < [backup_sql_file]` 6. Change the `$wgDBname` variable in the `LocalSettings.php` file of the new directory to the new database name 7. From the new capipedia version directory, run the command: `php maintenance/run.php update`
- Switch the production hostname to the new site
1. From the DreamHost Web Panel, browse to **Websites**/**Manage Websites**/**Settings**/**Directories: Modify** and change the root web directory to the new version 2. Wait for **Updating Web Options...** to complete 3. Browse to https://sandbox.capmembers.wiki/wiki/Special:Version and verify the upgrade took effect and the page fully loads without errors 4. Place production site back in write mode by commenting the `$wgReadOnly` variable in the `LocalSettings.php` file of the new directory 4. Check that the following operations work as expected:
a. Viewing pages b. Editing pages c. Uploading a file