Knowledgebase

Introduction

This guide explains how you can migrate your AWS Cloud Database to RCS with minimal downtime to the source database applications. RCS's Managed Databases for MySQL offer reduced costs, easy management and backups, scheduled updates, quick scaling, straightforward monitoring, and automated failover to replica nodes in case of database failures.

You can migrate your source RDS or Aurora MySQL database to a RCS Managed Database for MySQL with the mysqldump command line tool or MySQL Workbench for a graphical migration process.

Prerequisites

Before your start, make sure you:

• Verify that your source AWS Cloud Database accepts connections from any source 0.0.0.0/0.

• Deploy a fresh RCS Managed Database for MySQL with the same size as your AWS database.

Migrate with mysqldump

mysqldump is a database backup program pre-installed with the MySQL client. To successfully export your source database for migration, mysqldump uses the following syntax.

     $ mysqldump -h [remotehost] -u [username] -p [database-name] > [backup file name]

1. Open a new terminal window, and verify that mysqldump is available on your computer with the following command.

    $ mysqldump --version
   

   Your output should look like the one below.

    mysqldump  Ver 8.0.31-0ubuntu0.22.04.1 for Linux on x86_64 ((Ubuntu))
   

2. Export your source database to a single file. Replace example with your actual source database details.

    $ mysqldump -h example.amazonaws.com -u example_user -p exampledb > migratetoRCS.sql
   

   Enter your password when prompted.

   To export all databases, add the --all-databases flag instead of your database name after the password prompt -p.

3. When complete, verify that the file exists in your working directory.

   Linux/macOS terminal:

    $ ls
   

   Windows PowerShell:

    > dir *
   

4. If you are importing a single database, log in to your RCS MySQL database.

    $ mysql -h RCS-prod.RCSdb.com -u example-user -p
   

   Enter your password when prompted.

5. Create the target database with the same name as your source database.

    mysql> CREATE DATABASE example-db;
   

6. Exit the console.

    mysql> EXIT
   

7. Import the source database file to your RCS Managed Database for MySQL.

    $ mysql -h RCS-prod.RCSdb.com -u example-user -p < migratetoRCS.sql
   

   Enter your password when prompted.

   For more information on mysqldump, visit the official documentation.

Migrate with MySQL Workbench

• Download and Install MySQL Workbench on your computer.

  Depending on your source database size and internet connection, it's recommended to deploy a temporary Windows Server on RCS, install MySQL Workbench, and use it to migrate your database with a reliable connection.

1. Open the MySQL Workbench application.

2. Click the Migration button on the left navigation bar in the main Application window.

   

3. At the bottom of the Overview section, click Start Migration.

4. In the Source & Target section, keep MySQL selected as the Database System and Standard (TCP/IP) as the connection method.

5. Within the Parameters section, enter your source database host in the Hostname: field.

6. Enter the database port in the Port section, by default, MySQL port 3306.

7. In the Username field, enter the database administrator username, then click Store in keychain to enter the database user password. Click OK to close the popup window.

8. Click Next to save your source database settings.

9. On the Target selection step, keep Standard (TCP/IP) as the connection method.

10. Enter your RCS database hostname in the Hostname: field.

11. Fill in your RCS database port in the Port: field.

12. Enter the RCS database administrator username, then click Store in Keychain to paste the RCS database user password. Click OK to close the popup window.

13. Click Next to test the connection between your source database and the target RCS database.

14. When the fetch schema and connection test tasks are successful, click Next to proceed.

15. Select all databases (schemata) you intend to migrate. To choose all, click the select all button in the bottom right corner.

    

16. Click Next to start reverse engineering the selected database schema so that it matches the target RCS database structure.

17. In the Object Migration section, keep all Table, View, and Routine objects selected.

18. Click Next to prepare objects from the source database.

19. When the object conversion is successful, click Next to proceed to the Manual Editing step.

20. If no migration errors display, click Next to proceed to the Target creation options step.

21. Keep Create schema in target RDMS checked. In the Options section, check the Keep schemas if they already exist option, then click Next to start migrating your source database to the target RCS database.

    

    If you receive an existing tables prompt, click Yes to proceed.

    If you receive a The schemas SYS, INFORMATION_SCHEMA, PERFORMANCE_SCHEMA, MYSQL will be dropped in the target MySQL Server warning, click Back and check the Keep schemas if they already exist option, or navigate back to the Schema selection step, and deselect sys, information_schema, performance_schema, mysql databases to avoid any database write warning errors.

22. When successful, click Next to review the database migration results.

23. Verify that the schema creation report is successful, then click Next to set up data transfer options.

24. In the Data copy section, keep Online copy of table data to target RDBMS selected, then click Next to view the migration report.

25. Click Finish to complete the migration process.

Test the MySQL Migration

1. Using the MySQL client, log in to your RCS database.

    $ mysql -h RCS-prod.RCSdb.com -u example-user -p
   

2. Show available databases.

    mysql> SHOW DATABASES;
   

3. Switch to your imported database.

    mysql> USE exampledb;
   

4. Display database tables.

    mysql> SHOW TABLES;
   

5. Select columns from any of the tables to verify that all data matches your source database.

    mysql> SELECT * FROM example-table;
   

6. Exit the MySQL shell.

    mysql> EXIT
   

Update Applications

Depending on the applications using your source database, cut over requests to your new database by editing the application's configuration files. For example, if you migrated from an RDS MySQL database and have active WordPress installations using the database, follow the instructions below.

1. Switch to the WordPress application files directory.

    $ cd /var/www/html/
   

2. Make a copy of the wp-config.php file.

    $ sudo cp wp-config.php wp-config.ORIG
   

3. Edit the wp-config.php file.

    $ sudo nano wp-config.php
   

4. Find the following section, and replace the values to represent your RCS MySQL database as below.

    /** The name of the database for WordPress */
   
    define('DB_NAME', 'exampledb');
   
   
   
    /** MySQL database username */
   
    define('DB_USER', 'example-user');
   
   
   
    /** MySQL database password */
   
    define('DB_PASSWORD', 'example-pass');
   
   
   
    /** MySQL hostname */
   
    define( 'DB_HOST', 'RCS-prod.RCSdb.com' );
   

   Save and close the file.

5. Restart your Web server for changes to take effect.

    $ sudo systemctl restart apache2
   
   
   
    $ sudo systemctl restart nginx
   

For any other applications running on platforms such as NodeJS, Python, and PHP, please refer to their official documentation on how to edit your database connection settings.

Conclusion

In this article, you have migrated an AWS MySQL database to a RCS Managed Database. Depending on your database size, you can choose between the command line or graphical tools to safely migrate your database with no downtime to the applications using your database. For each migrated database, you can access logs and available databases through the RCS customer portal. For more information about RCS Managed Databases for MySQL, see the Reference Guide