Installation and Configuration

Installation

Teleporter is out-of-the-box both in Community and Enterprise Edition, so you don't need any configuration or modification. But beware: in Community Edition you can migrate your source relational database but you cannot enjoy the synchronize feature, only available in the Enterprise Edition.

You can run the tool through the script as described in the Home page or just execute it via OrientDB Studio as described here.

Driver Configuration.

Automatic Driver Configuration

Teleporter provides an automaic driver configuration: when the application starts, it looks for the required driver. If the driver is not found the application will download it and it will automatically configure the classpath, not delegating anything to the end user.
So when you run Teleporter you just have to indicate the name of the DBMS you want to connect. Teleporter is compatible with Oracle, MySQL, PostgreSQL and HyperSQL products, thus you have to type one of the following parameters (not case sensitive):

  • Oracle
  • SQLServer
  • MySQL
  • PostgreSQL
  • HyperSQL

Teleporter will search for the correspondent driver in the $ORIENTDB_HOME/lib folder and if it's not present, it will download the latest available driver version. If a driver is already present in the folder, then it will be used for the connection to the source DB. Therefore if you want use a new driver version, you just have to delete the older version and run Teleporter which will download and configure for you the latest available version.

./oteleporter.sh -jdriver postgresql -jurl jdbc:postgresql://localhost:5432/testdb 
                -juser username -jpasswd password -ourl plocal:$ORIENTDB_HOME/databases/testdb 
                -s naive -nr java -v 2

Manual Driver configuration

It's possible to perform a manual configuration downloading own favourite driver version and properly defining the classpath in the application. Below are reported the last driver tested versions with some useful information for download, configuration and use.

DriverLast Tested VersionPath patternPath ExampleLink for download
Oracle12cjdbc:oracle:thin:@HOST:PORT:SIDjdbc:oracle:thin:@localhost:1521:orclhttp://www.oracle.com/technetwork/database/features/jdbc/default-2280470.html
SQLServerSQLServer 2014jdbc:sqlserver://HOST:PORT;databaseName=DBjdbc:sqlserver://localhost:1433;databaseName=testdb; (*)http://www.java2s.com/Code/JarDownload/sqljdbc4/sqljdbc4-2.0.jar.zip
MySQL5.1.35jdbc:mysql://HOST:PORT/DBjdbc:mysql://localhost:3306/testdbhttp://dev.mysql.com/downloads/connector/j/
PostgreSQL9.4-1201jdbc:postgresql://HOST:PORT/DBjdbc:postgresql://localhost:5432/testdbhttps://jdbc.postgresql.org/download.html
HyperSQL2.3.2jdbc:hsqldb:hsql://HOST:PORT/DB OR jdbc:hsqldb:file:FILEPATHjdbc:hsqldb:hsql://localhost:9500/testdb OR jdbc:hsqldb:file:testdbhttp://central.maven.org/maven2/org/hsqldb/hsqldb/2.3.3/hsqldb-2.3.3.jar

(*) If the source database contains spaces in the name you have to use a URL like this:

“Source DB” → -jurl “jdbc:sqlserver://localhost:1433;databaseName={Source DB};”