Installing

Installing could be done in several ways, differ on your environment, your development preferences and purpose of installing even.

For Use in Production

For Development

1). With Netbeans

Open the Maven project with Netbeans ( Netbeans 8.0 or higher recommended ), do a build with dependencies and then you can Run, netbeans will deploy the application to the Glassfish server. You will also be required to create the necessary MySQL database for the application to run. To do this, go to db/README.md and read it up. It gives detailed instructions from start to end.

Netbeans should automatically create the JDBS connections and connection pools, JMS Resources, JMS Factories, etc.
If this is not the case, then you have to configure them manually. Note: For Netbeans to do this; you will be required to run Netbeans in sudo mode, to give it the required permissions. This is how you go about this:

1. As Netbeans is a GUI, sudo Netbeans won't work. Install gksu using:

sudo apt-get install gksu

2. Then, you cd to the bin folder in Netbeans and run

gksu ./netbeans

Once done, everything should work.

Use Open Required Projects option to open the ear, ejb and web projects.

2). Manual installation process

Installing Packages

For setting up and deploying the app you need several packages, you can see how to install them here.

Fixing seluth kit dependency

Use the following code to fix seluth kit dependency .

mvn install:install-file -Dfile=sleuthkit/bindings/java/dist/Tsk_DataModel.jar -DgroupId=org.sleuthkit -DartifactId=Tsk_DataModel -Dversion=4.1.3 -Dpackaging=jar

Then do a mvn clean install.

Setting up the database

Create a user with "OpenDFU" user name @ localhost that identified by 123.

Check to see whether all the tables inside the OpenDF database is already created and whether they are visible to the user OpenDFU. If the tables are missing use the sql statements inside db/OpenDF.sql file to create the tables manually.

Then use opendf and grant all on opendf to that user.

Detailed instructions for setting up the database including all necessary commands can be found in db/README.md.

Building the sleuthkit

1. Open a terminal in the root OpenDF directory.
2. Run cd scripts/ && ./build_sleuthkit

                OR

1. Open a terminal and change the directory to the sleuthkit directory.
2. Run the following commands one by one.

./bootstrap

./configure

make

sudo make install

Deploying OpenDF

Start a glassfish domain:

asadmin start-domain

wget http://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.38.zip

unzip mysql-connector-java-5.1.38.zip

asadmin add-library --type ext mysql-connector-java-5.1.38/mysql-connector-java-5.1.38-bin.jar

asadmin restart-domain

Deploy OpenDF to the Glassfish server:

asadmin add-resources "OpenDF-ejb/src/main/setup/glassfish-resources.xml"

asadmin add-resources "OpenDF-web/src/main/setup/glassfish-resources.xml"

asadmin deploy "OpenDF-ear/target/OpenDF-ear-1.0-SNAPSHOT.ear"

You can access to the OpenDF web app by going to: http://localhost:8080/OpenDF-web/

Should you get any errors when analyzing the files check whether you have the file libtsk.so inside sleuthkit/tsk/.libs and if so add the directory path as a PATH variable.

If u are using bash,the command should be

echo 'export PATH=$PATH:/your_path_to_libtsk.so' >> ~/.bashrc

Then deploy the OpenDF-ear.

For Just Sneak Peek

1). Using Vagrant

You can simply use the Vagrant to spawn an OpenDF instance on a Virtualbox VM. If you have Vagrant you can charm the vagrant up command.