The Digital Archaeological Record

The Digital Archaeological Record (tDAR) is an international digital repository for archaeological investigations. tDAR’s development and maintenance are governed by Digital Antiquity, an organization dedicated to ensuring the long-term preservation of irreplaceable archaeological data and to broadening the access to these data.

For more information, please visit http://www.tdar.org

prerequisites to installing tDAR

• Postgres 9.5 (with PostGIS extensions for production)
• Java 8
• Maven 3.5
• Mercurial
• git (for npm packages)
• npm 5.6+
• Chrome (for Selenium)
• chromedriver (for selenium; in unix assumed to be in /usr/local/bin/chromedriver; if mac /Applications/chromedriver )

getting the basic environment setup

1. check out the source from http://bitbucket.org/tdar/tdar.src
2. do a first clean install mvn clean install -DskipTests
3. cd "web" to move into the "web" package
4. run mvn clean compile -Psetup-new-instance to copy template configuration files into the src/main/resources/ directory

setting up postgres

1. install postgres with postgis extensions
2. create tdar user with login permissions from localhost, tests assume password of 'tdar'
3. create the following databases with tdar as the owner:

• test_tdarmetadata
• test_tdardata
• tdarmetadata
• tdardata
• tdargis (optional, using the posgis template)

setting the tdar database

1. run mvn clean install -DskipTests -Pliquibase-setup-dev-instance

next steps

1. try running tdar in the web package: mvn clean compile jetty:run

testing tdar:

To run the entire tDAR test suite, which includes all unit tests, karma tests, and E2E/Selenium tests.

mvn clean verify -Ptest

Running the Karma tests exclusively

cd ./web
karma start

Running a Single E2E test

Execute a single integration test by using the maven -Dit.test flag. The following example runs the DatasetSeleniumWebITCase suite (and skips all front-end/karma tests):

cd ./web
mvn verify -Ptest -Dit.test=DatasetSeleniumWebITCase -DskipKarma