Getting started (Remote migration)

Until our new NSF Utility is generally available, we provide some command line software, written in Java, which will migrate your Domino data to LDC Via in the cloud. This will allow you to continue to use document level security, and also use our REST API to access the data along with the admin website, and standard templates for applications such as Discussions and Email.

In order to use the Java utility, you will need to follow these steps:

1. Install a Java runtime on your local machine.
2. Download the LDC Via JAR file.
3. Gather together the required configuration data for the migration:
   a) Your email address
   b) Your LDC Via API key (provided to you by LDC Via)
   c) Your LDC Via licence key (provided to you by LDC Via)
   d) Target MongoDB username and password
   e) Address (host name or IP address) of the target MongoDB server
4. Ensure that the migration utility “knows” where your Notes JAR file is. There are a few ways of addressing this, according to personal preference:
   1. Run the LDC Via Java utility in the same directoy as the notes.jar file (e.g. “C:\Program Files\IBM\Lotus\Notes\jvm\lib\ext”).
   2. Alternatively, copy and paste an instance of the notes.jar file into the same folder from which you are running the LDC Via Java utility.
   3. Add the Java “ext” library folderin IBM Lotus Notes to the PATH of your workstation (i.e. something like this is added to the PATH environment variable: “C:\Program Files\IBM\Lotus\Notes\jvm\lib\ext”). Detailed instructions for editing your machine’s PATH can be found here: http://www.computerhope.com/issues/ch000549.htm.

To access your personal API and organisational licence keys, log into the LDC Via website and follow the steps shown below:

An example configuration file is shown at the bottom of this article.

It is easiest if the JAR file provided to you by LDC Via and the config file you created are in the same directory. Open a command prompt to this directory and enter the following command:

java -jar ldcvia.jar config-remote.txt

(Note that this should be run from a machine that has the IBM Notes client installed and configured on it).

The migration will run when you hit return, progress will be logged in the command window and will also be written to the “runlog” referenced in the config file.

To examine the migrated data, log into the LDC Via website and go to the DB Viewer page, this will show a list of all databases you have access to, and give you the opportunity to view documents, download file attachments, export to Excel and more. You can also begin to use the REST API against your migrated data at this point.