Page tree
Skip to end of metadata
Go to start of metadata

Overview

The /scripts/migrate_legacy_wordpress_to_modern_wordpress converts legacy cPAddon WordPress® installations to the RPM-based WordPress cPAddon.

Script functions

The /scripts/migrate_legacy_wordpress_to_modern_wordpress script performs the following actions for each specified WordPress installation:

  1. Scans the cPanel account's home directory for the cPanel::Blogs::WordPress.yaml file.
  2. Verifies that the WordPress version is greater than 3.7.
  3. Removes the cpaddons-site-software WordPress plugin.
  4. Updates the WordPress installation to use the RPM-based WordPress cPAddon.

Run the /scripts/migrate_legacy_wordpress_to_modern_wordpress script

To use this script, run the following command as the root user:

/scripts/migrate_legacy_wordpress_to_modern_wordpress [arguments] user instance

User and installation selection

Use the following arguments to target the installations to convert:

ArgumentDescription
--all
Converts all legacy cPAddon WordPress installations to the RPM-based WordPress cPAddon.
--user
Converts all legacy cPAddon WordPress installations for the specified cPanel accounts to the RPM-based WordPress cPAddon.
--instanceConverts a single legacy cPAddon WordPress installations for the specified cPanel account and instance to the RPM-based WordPress cPAddon.

Other options

You can use the following options with the /scripts/migrate_legacy_wordpress_to_modern_wordpress script:

ArgumentDescription
--no-colorRemoves the colorized output that the script provides.
--dryrunOnly reports information about the currently installed legacy WordPress installations.
--helpReturns the script help documentation.
--verboseReturns additional information in the script's output.

Script examples

To convert all legacy WordPress sites on the server, run the following command:

/scripts/migrate_legacy_wordpress_to_modern_wordpress --all

To convert all the legacy WordPress sites for the cPanel account frank, run the following command:

/scripts/migrate_legacy_wordpress_to_modern_wordpress --user frank

To convert all the legacy WordPress sites for the cPanel accounts frank, tommy, and jenny, run the following command:

/scripts/migrate_legacy_wordpress_to_modern_wordpress --user frank --user tommy --user jenny

To convert a specific legacy WordPress site for the cPanel account frank, run the following command:

/scripts/migrate_legacy_wordpress_to_modern_wordpress --user frank --instance /home/frank/.cpaddons/cPanel::Blogs::WordPress.1.yaml

Additional documentation

There is no content with the specified labels

There is no content with the specified labels