Wayback Configuration

Action(edit)

The !Wayback installation under NetarchiveSuite is only tested on a pc installed with linux and in Proxy mode. Other modes should work, but no guaranties are given.

Requirements

The following applications should be running and reachable from the machine running Tomcat with Wayback.

1. JMS server.
2. FTP server.

3. Archive (eg. Standalone archive given in ./conf/wayback/standalone_archive.xml). The needed applications from NetarchiveSuite is BitarchiveApplication, BitarchiveMonitorApplication, ArcRepositoryApplication. The NetarchveSuite version should be newer than 3.10.

4. Tomcat (6.0.20)

When configuring Wayback to work with NetarchiveSuite, the above services is needed, further more it is needed to have a full source package of the NetarchiveSuite and an installation of ant.

Configuration

The configurations files that should be modified is both located in ./conf/wayback/ in the NetarchiveSuite full source package. The files are named CDXCollection.xml and wayback.xml.

wayback.xml

In this config file there are multiple settings that should be localized to make the system run correctly.

The following settings should be localized:

wayback.basedir=/tmp/wayback - The web application should be allowed to access and write to this location.

The port should be specified in the following tree lines, and be available.

• <bean name="8080:wayback" class="org.archive.wayback.webapp.AccessPoint">

• <property name="replayURIPrefix" value="http://localhost.archive.org:8080/wayback/"/>

• <bean name="8090" parent="8080:wayback">

CDXCollection.xml

This config file is describing by which method !Waybak is getting access to the CDX files, describing the content of the ARC/WARC files.

In this file it should only be necessary to change the following path to point a local CDX collection.

<value>/wayback/file.sorted.cdx</value>

Compiling Tomcat target

This can be done from the NetarchiveSuite root directory. By running the command ant -file wayback.build.xml warfile, this produces a ROOT.war file in the NetarchiveSuite root director, the ROOT.war file should be placed $TOMCAT_HOME/webapps/.

Tomcat should furthermore have access to settings.xml file. This can be done by adding the following line to $TOMCAT_HOME/bin/catalina.sh just after the first line.

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

This setting file is a NetarchiveSuite settings.xml file, and only includes the common and wayback sections.

The following settings should be modified to fit the local installation.

Change the following to match the FTP settings on the system.

        <remoteFile>
            <!-- TODO: See user documentation for NetarchiveSuite
            http://netarkivet.dk/suite/Documentation . -->
            <serverName>ftp.yourdomain.com</serverName>
            <userName>ftpuser</userName>
            <userPassword>ftppassword</userPassword>
        </remoteFile>

Update the following mail settings

        <mail>
            <server>mail.yourdomain.com</server>
        </mail>
        <notifications>
            <class>dk.netarkivet.common.utils.EMailNotifications</class>
            <sender>example@yourdomain.com</sender>
            <receiver>example@yourdomain.com</receiver>
        </notifications>

Described elsewhere

It is outside the scope of this configuration guide to describe howto harvest a ARC/WARC file. It is also outside the scope of this guide to describe howto get from an ARC/WARC collection to the CDX files needed by !Wayback.

Setting up NetarchiveSuite archive is described elsewhere and a sample setup file is given in the NetarchiveSuite source package.