Chapter 12. Optional Installation Steps

This chapter describes optional installation steps for items not specified in the previous sections.

Support for SMB 2.x and 3.x

Since version 4.7.0 M2, CloverETL supports the SMB 2.x and 3.x protocol. It utilizes the smbj library dependent on Bouncy Castle.

Below, you can find Bouncy Castle installation instructions for CloverETL Designer and CloverETL Server.

Before you start, you have to download a required .jar file:

  1. Go to the official Latest Bouncy Castle Java Releases page.

  2. Locate the section "SIGNED JAR FILES" and download the latest release.

    The filename consists of the name bcprov-jdk15on, followed by a version number, for example:

    bcprov-jdk15on-158.jar

  3. After you download the .jar file, add it to CloverETL Designer or CloverETL Server by following these instructions:

CloverETL Designer

There are two ways of adding Bouncy Castle to CloverETL Designer:

  • Recommended:

    Rename the .jar file to bcprov-jdk15on.jar and copy the renamed file into the CloverETL Designer's installation directory (e.g. C:\Program Files\CloverETL Designer\ on MS Windows or CloverETL Designer.app/Contents/Eclipse on Mac OS).

  • Alternative:

    Edit the CloverETLDesigner.ini file and specify the path to the .jar file using the parameter:

    -Dcloveretl.smb2.bouncycastle.jar.file=/path/to/bcprov-jdk15on-XYZ.jar

Now restart CloverETL Designer for the changes to take effect.

CloverETL Server

There are two ways of adding Bouncy Castle to CloverETL Server, as well:

  • Recommended:

    Set the system property cloveretl.smb2.bouncycastle.jar.file pointing to the location of the .jar file.

    Example for Apache Tomcat:

    1. Edit the setenv.bat file located in the \Apache_Tomcat\bin\ directory.

    2. Set the system property by adding the following line:

      set JAVA_OPTS=%JAVA_OPTS% "-Dcloveretl.smb2.bouncycastle.jar.file=path/to/bcprov-jdk15on-XYZ.jar"

    [Note]Note

    The instructions for setting up the system property may differ depending on the application container.

  • Alternative:

    Put the .jar file on the application container's classpath (e.g. C:\CloverETLServer.4.9.0.Tomcat-8.0.47\lib\).

    [Warning]Warning

    This option may noticeably slow down the server startup; therefore, it is not recommended.

Now restart CloverETL Server for the changes to take effect.