Installing the MySQL JDBC Connector

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.

Follow these steps:

  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. Open the home page of the Automation Platform web UI by browsing to \https:/<cloudBees-flow-server>/commander/ and sign in.

  7. Go to the Administration > Database Configuration page and configure the server to use a MySQL database.