Installing & configuring Java in readiness for local migrations

Follow

If you want to use our Java migration tool, then you will need to install the Java Runtime (JRE) on your local machine. Which version you install will depend on your operating system (we support Windows 7 and Windows 8 primarily).

The appropriate JRE will be available on the Oracle Java website. Note that it is crucial that you install a 32-bit version, due to limitations with Domino's Java implementation.

Run the install wizard.

LDC Via makes use of cryptography, so you may need to upgrade the policy files as Oracle ship Java with only the basic crypto policies.

NOTE If you see errors like this when running LDC Via, you will definitely need to upgrade:

java.security.InvalidKeyException: Illegal key size
at javax.crypto.Cipher.checkCryptoPerm(Cipher.java:1024)

To upgrade your policies, download the Cryptography Extension (JCE) files for the relevant version of Java you have installed:

Java 6 JCE

Java 7 JCE 

Java 8 JCE

Extract the files and copy the US_Export_Policy.jar and Local_Policy.jar files to <java-jre-home>/lib/security replacing the existing files. It is important to note that this is for the JRE, not and JDK that you may have installed.

Now we need to make sure that the notes.jar and ncso.jar are on the classpath for Java.

(You may wish to restart your machine so that all these changes are picked up).

It is possible that you will encounter an error "java.lang.UnsatisfiedLinkError: no nlsxbe in java.library.path". If this happens, add the following switch to your command line when executing the migration: "-Djava.library.path=c:\IBM\Notes" where the path parameter is the path to your Notes installation.

Example Configuration of Environment Variables

When installing Java, you will need to make sure that your environment variables are set up correctly. Below are the typical settings for an installation running on Windows 7:

Variable Value
User Variables
CLASSPATH c:\IBM\Notes
JAVA_HOME C:\Program Files (x86)\Java\jre1.8.0_25\bin
PATH C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;c:\IBM\Notes
System Variables
CLASSPATH C:\IBM\Notes\jvm\lib\ext\Notes.jar;C:\IBM\Notes\data\domino\java\NCSO.jar
Path C:\ProgramData\Oracle\Java\javapath;C:\Program Files (x86)\Parallels\Parallels Tools\Applications;%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\;C:\IBM\Notes;C:\Program Files (x86)\Java\jre1.8.0_25\bin
Have more questions? Submit a request

Comments

Powered by Zendesk