Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Info

Valid from 6.0

The documentation below is valid from Datafari v6.0 upwards

Note

Datafari v6.0 has only be tested and is only compatible with JCIFS-NG 2.1.7 ! Lower version WILL NOT WORK and Upper versions MAY NOT WORK

Due to licences issues, we do not have the right to package the JCIFS-NG library with Datafari. So you have to download it on your own and to add it to Datafari.

If you want to add the JCIFS-NG connector to the list of existing connectors, here it is the procedure in order to do it. We distinct 2 cases :

  • CASE 1 : you just downloaded Datafari and you NEVER launched it

  • CASE 2 : you have an existing Datafari running

The beginning is the same for the two cases. If you are in the second case, you just need to follow few more steps that we will detail.

CASE 1 

You need to do it before launch the script init-datafari.sh. If you have already your instance of Datafari that is running, go to case 2.

  1. Download the JCIFS NG jar version 2.1.7 here : https://repo1.maven.org/maven2/eu/agno3/jcifs/jcifs-ng/2.1.7/jcifs-ng-2.1.7.jar
    For example you can use wget :

    Code Block
    wget https://repo1.maven.org/maven2/eu/agno3/jcifs/jcifs-ng/2.1.7/jcifs-ng-2.1.7.jar
  2. Copy the JAR to /opt/datafari/mcf/mcf_home/connector-lib-proprietary folder

    Image Added
  3. Change the permissions to the JAR file that you just downloaded :  

    Code Block
    chmod 775 /opt/datafari/mcf/mcf_home/connector-lib-proprietary/jcifs*.jar
    chown datafari /opt/datafari/mcf/mcf_home/connector-lib-proprietary/jcifs*.jar
  4. Edit the file /opt/datafari/mcf/mcf_home/connectors.xml and uncomment the line :

    Code Block
    <!--  <repositoryconnector name="Windows shares" class="com.francelabs.datafari.connectors.share.SharedDriveConnector"/> -->


    You are done, you can launch init-datafari.sh now.

CASE 2 

  1. Stop Datafari :  

    Code Block
    cd /opt/datafari/bin
    bash stop-datafari.sh
  2. Download the JCIFS NG jar version 2.1.7 here : https://repo1.maven.org/maven2/eu/agno3/jcifs/jcifs-ng/2.1.7/jcifs-ng-2.1.7.jar
    For example you can use wget :

    Code Block
    wget https://repo1.maven.org/maven2/eu/agno3/jcifs/jcifs-ng/2.1.7/jcifs-ng-2.1.7.jar
  3. Copy the JAR to /opt/datafari/mcf/mcf_home/connector-lib-proprietary folder

    Image Added
  4. Change the permissions to the JAR file that you just downloaded :  

    Code Block
    chmod 775 /opt/datafari/mcf/mcf_home/connector-lib-proprietary/jcifs*.jar
    chown datafari /opt/datafari/mcf/mcf_home/connector-lib-proprietary/jcifs*.jar
  5. Edit the file /opt/datafari/mcf/mcf_home/connectors.xml and uncomment the line :

    Code Block
    <!--<repositoryconnector name="Windows shares" class="com.francelabs.datafari.connectors.share.SharedDriveConnector"/>

    image-20240627-115141.pngImage Added

  6. Start Datafari

    Code Block
    cd /opt/datafari/bin
    bash start-datafari.sh
  7. initialize the connectors in MCF by lauching the script initialize.sh :

    Code Block
    cd /opt/datafari/mcf/mcf_home
    bash initialize.sh

    You will see that the connector is now in the list of MCF connectors :

    Image Added

In the repository menu of MCF, the new connector is now present :

...

...

Note

The JCIFS-NG version MUST BE the 2.1.3 ! Upper or lower versions are NOT SUPPORTED by the connector !

Info

Valid from 4.3 to 5.1

The documentation below is valid from Datafari v4.3.0 upwardsto Datafari v5.1. If you are using a newer version, please consider the v6 documentation !

Due to licences issues, we do not have the right to package the JCIFS-NG library with Datafari. So you have to download it on your own and to add it to Datafari.

...

The beginning is the same for the two cases. If you are in the second case, you just need to follow few more steps that we will detail.

CASE 1 

You need to do it before launch the script init-datafari.sh. If you have already your instance of Datafari that is running, go to case 2.

  1. Download the JCIFS NG jar version 2.1.3 here : https://repo1.maven.org/maven2/eu/agno3/jcifs/jcifs-ng/2.1.3/jcifs-ng-2.1.3.jar
    For example you can use wget :

    Code Block
    wget https://repo1.maven.org/maven2/eu/agno3/jcifs/jcifs-ng/2.1.3/jcifs-ng-2.1.3.jar
  2. Copy the JAR to /opt/datafari/mcf/mcf_home/connector-lib-proprietary folder

    Image Modified

  3. Change the permissions to the JAR file that you just downloaded :  

    Code Block
    chmod 775 /opt/datafari/mcf/mcf_home/connector-lib-proprietary/jcifs*.jar
    chown datafari /opt/datafari/mcf/mcf_home/connector-lib-proprietary/jcifs*.jar
  4. Edit the file /opt/datafari/mcf/mcf_home/connectors.xml and uncomment the line :

    Code Block
    <!--repositoryconnector name="Windows shares" class="org.apache.manifoldcf.crawler.connectors.sharedrive.SharedDriveConnector"/>

    Image Modified
    You are done, you can launch init-datafari.sh now.

CASE 2 

  1. Stop Datafari :  

    Code Block
    cd /opt/datafari/bin
    bash stop-datafari.sh
  2. Download the JCIFS NG jar version 2.1.3 here : https://repo1.maven.org/maven2/eu/agno3/jcifs/jcifs-ng/2.1.3/jcifs-ng-2.1.3.jar
    For example you can use wget :

    Code Block
    wget https://repo1.maven.org/maven2/eu/agno3/jcifs/jcifs-ng/2.1.3/jcifs-ng-2.1.3.jar
  3. Copy the JAR to /opt/datafari/mcf/mcf_home/connector-lib-proprietary folder

...

  1. Image Added

  2. Change the permissions to the JAR file that you just downloaded :  

    Code Block
    chmod 775 /opt/datafari/mcf/mcf_home/connector-lib-proprietary/jcifs*.jar
    chown datafari /opt/datafari/mcf/mcf_home/connector-lib-proprietary/jcifs*.jar
  3. Edit the file /opt/datafari/mcf/mcf_home/connectors.xml and uncomment the line :

    Code Block
    <!--repositoryconnector name="Windows shares" class="org.apache.manifoldcf.crawler.connectors.sharedrive.SharedDriveConnector"/>
    Image Modified
  4. Start Datafari

    Code Block
    cd /opt/datafari/bin
    bash start-datafari.sh
  5. initialize the connectors in MCF by lauching the script initialize.sh :

    Code Block
    cd /opt/datafari/mcf/mcf_home
    bash initialize.sh

    You will see that the connector is now in the list of MCF connectors :

    Image Modified

In the repository menu of MCF, the new connector is now present :

...