Step 2: Run SQL scripts

When upgrading from previous Pentaho versions, including 10.2.0.0 GA to 10.2.0.1 and later, you must manually initialize a new Quartz database. A new Quartz library is created in the repository database as a result. Always follow best practices and backup your data prior to proceeding. If you want to keep your existing Quartz library data, you can migrate the current tables to the new tables.

Run the SQL creation scripts.

Note: You may need administrator permissions to run these scripts on the host OS server.

1. Backup your data. See Back up your existing Pentaho products and install Pentaho 10.2.

2. If the Pentaho Server is currently running, stop it.

   For instructions on stopping the server, see Stop and start the Pentaho Server and repository.

3. Make sure that your MySQL or MariaDB instance is up and running.

4. Open a MySQL or MariaDB Command Prompt window or open the MySQL Workbench tool and then run the following SQL creation scripts in the order shown:

   1. <your pentaho directory>/pentaho-server/data/mysql/create_jcr_mysql.sql

   2. <your pentaho directory>/pentaho-server/data/mysql/create_quartz_mysql.sql

   3. <your pentaho directory>/pentaho-server/data/mysql/create_repository_mysql.sql

   4. <your pentaho directory>/pentaho-server/data/mysql/pentaho_mart_mysql.sql

   The Quartz database, Jackrabbit and MySQL or MariaDB repositories, and Pentaho Operations Mart are created. The new Quartz scheduler table prefixed with QRTZ6_ is created. Any existing QRTZ5_ scheduler database is retained. However, starting the Pentaho Server at this point will result in an empty schedule.

5. If you want to retain your existing scheduler database, using any text editor, open the migrate_old_quartz_data_mysql.sql file.

6. As needed, modify the migration script according to your existing setup for the user, password, database, and other required information and then save and close the file.

7. Run the migration script:

   <*your pentaho directory*>/pentaho-server/data/mysql/migrate_old_quartz_data_mysql.sql

The original Quartz scheduler database is migrated to the new Quartz database.

Note: The original QRTZ5_ data is retained. You can delete it at your discretion after confirming the migration was successful and complete within the Pentaho Server repository.

Note: You unpacked the Pentaho Operations Mart SQL file while preparing your environment for the archive installation process. Depending on your environment, see Prepare your Windows environment for an archive install or Prepare your Linux environment for an archive install for details.