You can configure your Perspectium DataSync Agent to share data from ServiceNow or Salesforce to a MySQL database by changing some additional configurations in your agent.xml file.
Prerequisites
First, you will need to install a DataSync Agent.
You will also need to create a ServiceNow dynamic share/bulk share or create a Salesforce dynamic share/bulk share.
Make sure to stop running your DataSync Agent before making any Agent configuration changes.
Procedure
To set up your DataSync Agent to share application data to a MySQL database, follow these steps:
Install and configure your DataSync Agent
Follow the steps to install the DataSync Agent or the DataSync for Salesforce Agent and make sure that your agent.xml file is configured correctly.
Access your agent.xml configuration file
Navigate to the directory where you saved your agent.xml file when installing your DataSync Agent.
Update database directives to point to MySQL
Open your agent.xml file in a text editing application. Then, locate the <task> directive(s) within your <subscribe> directive, and update the following database-related directives:
| Directive | Value to enter |
|---|---|
| <database_type> | mysql |
| <database_server> | URL for your MySQL database. If your database is installed on your local machine, set this value to localhost. |
| <database_port> | 3306 |
| <database_user> | Username used to access your MySQL database |
| <database_password> | Password used to access your MySQL database |
Your agent.xml file should look similar to the example shown below:
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<config>
<agent>
<share/>
<subscribe>
<task instances="4">
<task_name>datasyncforservicenow_to_mysql_subscribe</task_name>
<message_connection password="encrypted:vlOtU71yu8N/EFIJH85SSBtaIt7qEEfvqiqft9VZyYE=" queue="psp.out.replicator.testqueue" user="admin">https://testperspectium.net</message_connection>
<instance_connection password="encrypted:vlOtU71yu8N/EFIJH85SSPN9aF0P5/YViVwPEVFcGW4=" user="test.user">https://myinstance.service-now.com</instance_connection>
<handler>com.perspectium.replicator.sql.SQLSubscriber</handler>
<decryption_key>The cow jumped over the moon</decryption_key>
<database_type>mysql</database_type>
<database_server>localhost</database_server>
<database_port>3306</database_port>
<database_user>root</database_user>
<database_password>encrypted:vlOtU71yu8N/EFIJH85SSMoilKLTeJHQrNZPJ7c5tFU=</database_password>
<database_parms>characterEncoding=UTF-8 & useSSL=false & serverTimezone=UTC</database_parms>
<database_column_max_size>251</database_column_max_size>
<database>psp_repl</database>
</task>
</subscribe>
<max_reads_per_connect>4000</max_reads_per_connect>
<polling_interval>5</polling_interval>
<skip_message_set_processing/>
</agent>
</config>
NOTE: For MySQL8 in the <database_parms> directive, parameters need to be separated by a space, an ampersand, and a following space ("parm=value & parm=value").
Save your agent.xml file
Save the changes you made to your agent.xml file and close the file.
Set your timezone (optional)
You only need to do this step if your MySQL is not configured correctly
Set the global timezone in your MySQL configuration using the SQL command shown below:
SET Global time_zone = "-7:00";
NOTE: The number corresponds to the time difference from UTC. For any timezone you are in, relative to UTC, you will need to subtract or add the time difference.
For example, if you are in the east coast, you would use "-4:00".
Run your DataSync Agent
After configuring your agent.xml file to support replication to your MySQL database, start running your DataSync Agent again.
