The DataSync Agent SDK contains Java classes that simplify the process of writing Sharers and Subscribers or Producers and Consumers of replicated data leveraging the Perspectium Replication Framework.
Procedures
To set up the DataSync Agent with SDK, follow these steps:
Installation
Once you have obtained your Perspectium DataSync SDK Account from Perspectium Support, you will need to add the Perspectium Maven Repository URL and login credentials to your Maven settings.xml file and your SDK project pom.xml file.
Setting up settings.xml
Since the Perspectium Nexus server requires authentication, you will also need to place your credentials in the Maven settings.xml in a servers element. There are two locations where a settings.xml file may live:
Maven install: $M2_HOME/conf/settings.xml
User’s install: ${user.home}/.m2/settings.xml
Here's a sample servers element using the default username and password for the deployment user:
<servers>
<server>
<id>perspectiumRepo</id>
<username>your_username</username>
<password>your_password</password>
</server>
</servers>
Setting up pom.xml
Next, create a pom.xml file for your SDK project. The pom.xml will look similar to this:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.yourcompany</groupId>
<artifactId>test-perspectium-sdk</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>com.perspectium</groupId>
<artifactId>perspectium-replicator-agent</artifactId>
<version>5.0.0</version>
</dependency>
</dependencies>
<repositories>
<repository>
<id>perspectium</id>
<name>Perspectium</name>
<url>https://nexus.perspectium.net/repository/public/</url>
</repository>
</repositories>
</project>