Quick Connect for Base Systems 2.4 - Administration Guide

Creating a MySQL database connection

To create a new connection

1. Make sure that on the One Identity Quick Connect Sync Engine computer you install Connector/Net, an ADO.NET driver for MySQL.

   For supported versions of Connector/Net, see the System Requirements section in the Release Notes supplied with this version of One Identity Quick Connect for Base Systems.

2. In the Quick Connect Administration Console, open the Connections tab.
3. Click Add connection, and then use the following options:
   • Connection name. Type a descriptive name for the connection.
   • Use the specified connector. Select MySQL Connector.
4. Click Next.
5. On the Specify connection settings page, use the following options:
   • MySQL server. Type the fully qualified domain name of the MySQL server that hosts the MySQL database that you want to participate in data synchronization operations.
   • Access MySQL server using. Type the user name and password of the account with which you want to access MySQL server. Ensure the account has sufficient permissions to perform operations (Read, Write) on objects in the database to which you want to connect.
   • Connect to database. Type the name of the database to which you want to connect on the MySQL server.
   • Advanced. Click this button to specify additional parameters you want to add to the connection string that will be used to access the MySQL server. In the dialog box that opens, click the Add Parameter button to specify the name and value of the parameter you want to add to the connection string.
   • Test Connection. Click this button to verify the specified connection settings.
6. Click Next.
7. On the Specify how to select and modify data page, use the following options:
   • Use data from this table. Allows you to select the database table that includes the data you want to participate in the synchronization operations. You can click Preview to preview the database table you have selected.
   • Use an SQL query to specify data. Allows you to compose an SQL query that provides a more flexible way for specifying data that will participate in the synchronization operations. For example, you can use this option to specify multiple database tables. Select this option, and then click the Configure Query button to type your SQL query.
   • Configure Settings. Click this button to configure settings for modifying data in the connected system during synchronization operations. For example, you can specify the database tables in which you want to insert, update, or delete data during synchronization operations.
8. Click Next.
9. On the Specify attributes to identify objects page, use the following options:
   • Available attributes. Lists the attributes that are available in the external data system. Use this list to select the attributes whose values you want to use to generate a unique identifier for each object in the external data system. You can filter attributes by typing in the text box at the top of this list. To select multiple attributes, hold down CTRL and click to select attributes in the list.
   • UniqueID attributes. Lists the attributes whose values are currently used to generate a unique identifier for each object in the external data system.
   • Add->. Moves the selected attributes from the Available attributes list to the UniqueID attributes list.
   • <-Remove. Moves the selected attributes from the UniqueID attributes list to the Available attributes list.
   • Constructed UniqueID. Displays a combination of the attributes whose values will make up a unique identifier for each object in the external data system.
10. Click Finish to create a connection to MySQL database.

Modifying an existing MySQL database connection

To modify connection settings

1. In the Quick Connect Administration Console, open the Connections tab.
2. Click Connection settings below the existing MySQL database connection you want to modify.
3. On the Connection Settings tab, click an appropriate item to expand it and use the options it provides.

   You can expand the following items:

   • Specify connection settings
   • Specify how to select and modify data
   • Advanced
   • Specify attributes to identify objects

   See the next subsections for the descriptions of these items.

4. When you are finished, click Save.

Specify connection settings

This expandable item provides the following options that allow you to modify the connection settings:

• MySQL server. Type the fully qualified domain name of the MySQL server that hosts the MySQL database that you want to participate in data synchronization operations.
• Access MySQL server using. Type the user name and password of the account with which you want to access MySQL server. Ensure the account has sufficient permissions to perform operations (Read, Write) on objects in the database to which you want to connect.
• Connect to database. Type the name of the database to which you want to connect on the MySQL server.
• Advanced. Click this button to specify additional parameters you want to add to the connection string that will be used to access the MySQL server. In the dialog box that opens, click the Add Parameter button to specify the name and value of the parameter you want to add to the connection string.
• Test Connection. Click this button to verify the specified connection settings.

Specify how to select and modify data

This expandable item provides the following options that allow you to specify the data you want to participate in the synchronization:

• Use data from this table. Allows you to select the database table that includes the data you want to participate in the synchronization operations. You can click Preview to preview the database table you have selected.
• Use an SQL query to specify data. Allows you to compose an SQL query that provides a more flexible way for specifying data that will participate in the synchronization operations. For example, you can use this option to specify multiple database tables. Select this option, and then click the Configure Query button to type your SQL query.
• Configure Settings. Click this button to configure settings for modifying data in the connected system during synchronization operations. For example, you can specify the database tables in which you want to insert, update, or delete data during synchronization operations.