Skip to content

Manually launch a site on a multisite

The Network Site launch tool in the VIP Dashboard is strongly recommended for launching sites on a WordPress multisite.

Launching a site is also possible by completing the VIP-CLI commands and WordPress Network Admin updates that are outlined below.

Professional Service Upgrade

Customers who add WordPress VIP Launch Day Services to their support package will have a Technical Account Manager (TAM) assigned to them to ensure a smooth launch for their site on the VIP Platform. VIP TAMs will draft and confirm a launch plan for the site, guide customers through the necessary steps leading up to and including the site launch, and advise customers on any last-minute issues that may arise.

Prerequisites

1. Change the site URL

  • Log in to any site on the multisite.
  • Hover over the “My Sites” label in the upper left hand corner of the WordPress Admin dashboard to access the flyout menu and select:
    My Sites > Network Admin > Sites
  • On the “Sites” page of the multisite Network Admin, hover over the site to be launched and select the “Edit“ link.
  • Select the “Info” tab.
  • Update the Site Address (URL) to the final production URL. This should match the domain that was mapped in the Prepare for launch steps.
  • Select “Save Changes.”

Note

Updating the Site Address (URL) will also update the home and siteurl values, as well as the entry in wp_blogs.

In this screenshot example, the Site Address has been updated to the final production URL “https://www.mysite.com”.

2. Dry-run search-replace from current URL to production URL

VIP-CLI command examples

For demonstration purposes, the <app-alias> value mytestsite and the <env> value production are used in the VIP-CLI command examples below. Read more about how to target environments in VIP-CLI commands.

Target search-replace on tables specific to the site

The search-replace operation will update the URLs (including content and media URLs) that exist in the site’s database from the old domain (usually the VIP convenience domain) to the new mapped production domain. Run the search-replace command first with the --dry-run option in order to review the qualifying changes without altering the database.

vip @mytestsite.production -- wp search-replace mysite.go-vip.net/site www.mysite.com --all-tables-with-prefix --report-changed-only --url=www.mysite.com --dry-run

Caution

The above command performs a targeted search-replace within the site tables corresponding to the URL specified (to the value that was updated in the previous step). Verify that the output shows only the tables prefixed with the correct site ID, for example wp_2_posts.

Run search-replace on all tables of the multisite

To perform a search-replace across all tables of the multisite, adjust the command similar to this example:

vip @mytestsite.production -- wp search-replace mysite.go-vip.net/site www.mysite.com --all-tables --report-changed-only --dry-run

Caution

Depending on the size of the database, a search-replace across the entire database may take a long time to complete and add extra load. Contact VIP Support if assistance is needed to run a search-replace across the entire database or if there are related questions.

3. Run final search-replace

An example of the search-replace command to update the current URL to a production URL by removing the --dry-run option:

vip @mytestsite.production -- wp search-replace mysite.go-vip.net/site mysite.com --all-tables-with-prefix --report-changed-only --url=www.mysite.com

4. Flush object cache

An example of a command to flush the object cache:

vip @mytestsite.production -- wp cache flush --url=www.mysite.com

5. Complete the launch

Complete the site launch by following the detailed completing a site launch guide.

Last updated: April 03, 2023

Relevant to

  • WordPress