Release test Wayback

This test tests the setup of a Wayback installation and the cooperation between Wayback and the NetarchiveSuite archive, via the NetarchiveResourceStore. It doesn't test Wayback's functionality, which are tested by archive.org.

Paths and name are chosen to make this test as easy as possible, feel free to change these to suit your system.

The following commands (lines starting with '$' can be run directly from a terminal. *Remember to change the text in bold.

Execute step 1-3 of the quick start manual.

Download NetarchiveSuite from trunk (after code freeze) and make wayback war file:

$ svn checkout --username developername https://gforge.statsbiblioteket.dk/svn/netarchivesuite/trunk/ ~/netarchivesuite_trunk/

$ cd ~/netarchivesuite_trunk/

$ wget http://downloads.sourceforge.net/project/archive-access/wayback/1.4.2/wayback-1.4.2.tar.gz?use_mirror=dfn -O wayback-1.4.2.tar.gz

$ tar xzf wayback-1.4.2.tar.gz

$ ant jarfiles

$ ant -f wayback.build.xml warfile

Check that there are no errors.

Download Apache Tomcat http://tomcat.apache.org/, version 6.XX is recommended. And prepare wayback webapp.

Download and unpack Tomcat to ~/tomcat/

$ mv ~/netarchivesuite_trunk/ROOT.war ~/tomcat/webapps/

Make sure Tomcat loads ~/netarchivesuite_trunk/conf/wayback/settings.xml. This can be done my add the following line to ~/tomcat/bin/catalina.sh

CATALINA_OPTS='-Ddk.netarkivet.settings.file=~/tomcat/webapps/ROOT/WEB-INF/settings.xml'

$ cd ~/tomcat/bin/

Edit catalina.sh and add the above line just below #!/bin/bash or #!/bin/sh

Make/WARC ARC and CDX files and setup standalone archive.

Use the NetarchiveSuite to create sample ARC files as described in the Quick Start manual step 4 and/or 5.

Then move the ARC/WARC files to /arcs/filedir/.

Remember to make these directories readable/writable for the user conducting the test.

Make CDX files:

$ cd ~/netarchivesuite_trunk

$ ./wayback/bin/{warc-/arc--indexer} [-identity] PATH [CDX_PATH]

$ mkdir /wayback/

Remember to make /wayback/ readable/writable for the user conducting the test.

Sort cdx files, eg. by using the sort command in linux, and move the sorted file to /wayback/file.sorted.cdx. Eg. $ sort unsorted.cdx > /wayback/file.sorted.cdx.

Move created ARC files to /arcs/filedir/

Start an local JMS broker with username 'admin' and password 'admin'.

Check that there are no files(DON'T YOU MEAN errors HERE).

$ mkdir ~/standalone

$ cd ~/netarchivesuite_trunk

$ ant releasezipball

Check that there are no files (DON'T YOU MEAN errors HERE).

$ cp ~/netarchivesuite_trunk/NetarchiveSuite.zip ~/standalone

$ cp ~/netarchivesuite_trunk/conf/wayback/standalone_archive.xml ~/standalone/

Change relevant settings in standalone/standalone_archive.xml like deployGlobal.thisPhysicalLocation.deployInstallDir and deployGlobal.thisPhysicalLocation.deployMachineUserName.

Downlad RunNetarchiveSuite.sh from http://netarchive.dk/suite/Installation_Manual_3.10/AppendixC?action=AttachFile&do=get&target=RunNetarchiveSuite.sh and save it in ~/standalone/.

$ cd ~/standalone/ $ ./RunNetarchiveSuite.sh NetarchiveSuite.zip standalone_archive.xml STANDALONE

Check that std. output and log files don't report any errors. Log files lies in ~/standalone/STANDALONE/log/*.

Start Tomcat and browse the archive

$ cd ~/tomcat/ $ chmod goa+x *.sh

$ ./bin/startup.sh

Check that there are reported no errors in ~/tomcat/log/catalina.out. Furthemore the line INFO: Deploying web application archive ROOT.war should also be in the log

Goto http://localhost:8080/wayback in a browser and browser some material the the ARC/CDX files.

Clean up things

Stop Tomcat: $ ~/tomcat/

$ ./bin/shutdown.sh

Stop archive: $ cd ~/standalone/STANDALONE/

$ ./killall_NATIONAL_LIBRARY.sh

Remove installed application:

$ rm -r ~/tomcat/

$ rm -r ~/standalone

$ rm -r ~/netarchiveiute_trunk

Optional remove /arcs and /wayback.