This document describes step by step how to install the DataCurrent pack into an existing Yellowfin installation.   To obtain a DataCurrent license contact sales@blacklightsolutions.com.

As always, a backup of your folders is recommended so that the application is simple to restore if something goes wrong.

1. Download the latest distribution at http://portal.blacklightsolutions.com/datacurrent.zip and unzip the file in a temporary directory [temp].

2. In your Yellowfin Installation, navigate to the appserver directory. If this is a new installation, create a directory called plugins and copy the contents of [temp]/plugins to it.   If this is a DataCurrent update, simply copy the contents of [temp]/plugins to the plugins directory already in your appserver directory.  Also copy the [temp]/terms folder to your appserver directory.

3. Stop your Yellowfin instance.  

4. Copy the [temp]/datacurrent.war file into Yellowfin Installation/appserver/webapps.  At this point the DataCurrent server is installed.   If you are updating DataCurrent, delete the datacurrent folder so that the application update will deploy.

5. Copy the contents of [temp]/jdbc to [Yellowfin Installation]/appserver/webapps/ROOT/WEB-INF/lib. Add the DataCurrent-JDBCDriver.jar file as a new JDBC Driver in Yellowfin through the instructions here : http://www.yellowfinbi.com/YFForum-How-to-add-a-new-JDBC-drivers-for-use-in-Yellowfin-?thread=108357    The name of the JDBC Driver is com.adl.axon.jdbc.JDBCDriver . If you are updating DataCurrent, then overwrite or delete the existing DataCurrent-JDBCDriver.jar file.

6. Start Yellowfin and your installation is complete.

If you already have DataCurrent installed

Previous versions of DataCurrent had been installed directly into the Yellowfin application.   Before following the instructions above, if you have a DataCurrent installation prior to v2.0 then after stopping Yellowfin simply navigate to [Yellowfin Install]/appserver/webapps/ROOT/WEB-INF/lib and delete the DataCurrent.jar file.   Also, open your [Yellowfin Install]/appserver/webapps/WEB-INF/web.xml file and remove the lines between <!-- Initiate DataCurrent --> and <!-- Initiated DataCurrent -->.  As always a backup of your folders is recommended.