Installing the MySQL JDBC connector

1 minute read

CloudBees CD does not include the MySQL JDBC connector. If you plan to perform a CloudBees CD server installation that connects to a MySQL database, you must obtain and install the MySQL JDBC Connector/J 8.

Sites upgrading from 10.0.* may continue to use MySQL JDBC Connector/J 5.1 if currently doing so. In which case, no further configuration is required. Otherwise, continue with the steps below to install MySQL JDBC Connector/J 8.

Follow these steps to install MySQL JDBC Connector/J 8:

  1. Run the installer.

    Make sure that you do not install the built-in database.

  2. After the installation completes, download the MySQL JDBC Connector/J 8:

    The last few versions of the connector (v8.0.21 is the latest as of writing) have a bug so users should use version 8.0.16 until this bug is fixed. See https://bugs.mysql.com/bug.php?id=100294 on the MySQL bug tracking site for up-to-date status.

    From https://downloads.mysql.com/archives/c-j/ download the Platform Independent (Architecture Independent),Compressed TAR Archive for version 8.0.16.

    Oracle may ask you to sign in or to create an account.
  3. Unpack the archive and rename the downloaded connector to mysql-connector-java.jar.

    This is required for the CloudBees CD server to connect to the MySQL database.

  4. Copy mysql-connector-java.jar to the <install_dir>/server/lib directory.

  5. Restart the server.

  6. From the CloudBees CD main menu select Administration  Configurations. Then, select Database configuration from the left-hand menu and configure the server for the MySQL database type.