Automatically configure master databases

Overview of master databases

This topic discusses how to get started with the split database solution by:

1. Installing Adobe Commerce with a single master database (named magento)
2. Creating two additional master databases for checkout and OMS (named magento_quote and magento_sales)
3. Configuring Adobe Commerce to use the checkout and sales databases

This guide assumes all three databases are on the same host as the Magento application and that they’re named magento, magento_quote, and magento_sales. However, the choice of where to locate the databases and what they’re named is up to you. We hope our examples make the instructions easier to follow.

Install the Adobe Commerce software

You can enable split databases at any time after you install the Adobe Commerce software; in other words, you can add split databases to a Adobe Commerce system that already has checkout and order data. Use the instructions in the Adobe Commerce README or the installation guide to install the Adobe Commerce software using a single master database.

Set up additional master databases

Create checkout and OMS master databases as follows:

1. Log in to your database server as any user.

2. Enter the following command to get to a MySQL command prompt:

   1
   mysql -u root -p
   

3. Enter the MySQL root user’s password when prompted.

4. Enter the following commands in the order shown to create database instances named magento_quote and magento_sales with the same usernames and passwords:

   1
   create database magento_quote;
   

   1
   GRANT ALL ON magento_quote.* TO magento_quote@localhost IDENTIFIED BY 'magento_quote';
   

   1
   create database magento_sales;
   

   1
   GRANT ALL ON magento_sales.* TO magento_sales@localhost IDENTIFIED BY 'magento_sales';
   

5. Enter exit to quit the command prompt.

6. Verify the databases, one at a time:

   Checkout database:

   1
   mysql -u magento_quote -p
   

   1
   exit
   

   Order management database:

   1
   mysql -u magento_sales -p
   

   1
   exit
   

   If the MySQL monitor displays, you created the database properly. If an error displays, repeat the preceding commands.

Configure Adobe Commerce to use the master databases

After setting up a total of three master databases, use the Magento command line to configure Magento to use them. (The command sets up database connections and distributes tables among the master databases.)

First steps

1. Log in to the Magento server as, or switch to, a user with permissions to write to the Magento file system. See switch to the file system owner.

   If you use the bash shell, you can use the following syntax to switch to the file system owner and enter the command at the same time:

   1
   su <file system owner> -s /bin/bash -c <command>
   

   If the file system owner does not allow logins, you can do the following:

   1
   sudo -u <file system owner>  <command>
   

2. To run Magento commands from any directory, add <magento_root>/bin to your system PATH.

   Because shells have differing syntax, consult a reference like unix.stackexchange.com.

   Sample bash shell for CentOS:

   1
   export PATH=$PATH:/var/www/html/magento2/bin
   

   Optionally, you can run the commands in the following ways:

   • cd <magento_root>/bin and run them as ./magento <command name>
   • <magento_root>/bin/magento <command name>
   • <magento_root> is a subdirectory of your web server docroot.

Configure the checkout database

Command syntax:

1
bin/magento setup:db-schema:split-quote --host="<checkout db host or ip>" --dbname="<name>" --username="<checkout db username>" --password="<password>"

For example,

1
bin/magento setup:db-schema:split-quote --host="localhost" --dbname="magento_quote" --username="magento_quote" --password="magento_quote"

The following message displays to confirm a successful setup:

1
Migration has been finished successfully!

Configure the OMS database

Command syntax:

1
bin/magento setup:db-schema:split-sales --host="<checkout db host or ip>" --dbname="<name>" --username="<checkout db username>" --password="<password>"

For example,

1
bin/magento setup:db-schema:split-sales --host="localhost" --dbname="magento_sales" --username="magento_sales" --password="magento_sales"

The following message displays to confirm a successful setup:

1
Migration has been finished successfully!

Related topics

Verify split databases