Archtea - archive viewer

Build

Set up ANT environment

Download ANT from http://ant.apache.org/ .

Build war file from source code.

Unzip source code. If you need to access internet via proxy server, please create build.properties at the same directory as build.xml. If you proxy server is proxy.domain and port is 80, please create the following file.

  ------ build.properties ------
  proxyhost=proxy.domain
  proxyport=80
  ------ end of build.properties ------

And then, run ant.

  $ unzip archive-<version>.zip
  $ cd archive-<version>
  $ ant

If the build works well, you will get archtea.war file in build/lib/.

Get a default configuration

Copy the created archtea.war file to ${TOMCAT_HOME}/webapps. And then access to http://tomcathost:port/archtea/. If there is not any problems, a default configuration file are created in ${TOMCAT_HOME}/webapps/archtea/archtea-config.

Set directory to view from Archtea

The following configuration files are in ${TOMCAT_HOME}/webapps/archtea-config Open folder-config.xml and then set the following value.

  <root-path path="Set Directory here">

For example,

  <root-path path="/home/archtea/archives">

If you don't want to show extensions of archives like ".zip", Please set the following property like this:

  <property name="archtea.config.hideArchiveExtension" value="true"/>

If there are the same name in the same directory, this option cannot use. If you would like to hide root directories of archives when there is only one directory in the root directory of archives, Please set the following property.

  <property name="archtea.config.hideArchiveOneSubdir" value="true"/>

If there is hoge.zip and the archive contains foo/fo/bar.txt only, the property hide the root directory "foo".

Index configuration

Open search-config.xml , and then set an index dir to <index path="../archtea-index"/> . If you don't change the directory, index files will be created in ${TOMCAT_HOME}/webapps/archtea/archtea-index . If you create indexes for local files, set local directory, index directory and name in <search-config name="serachName"> . The name should be uniqe name in the file. If you would like to use Open Search, set entries like the following entry:

  ... snip ...
    <search-config name="main">
        ... snip ...
    </search-config>
    <search-config name="main2">
      <open-search-description>
        <path>main2-opensearch-description.xml</path>
        <url>http://localhost:8080/archtea/web/search?path=%2F&amp;format=osd10&amp;target=main</url>
      </open-search-description>
    </search-config>
  ... snip ...

The configuration file is XML. So, you have to set & instead of & for query strings in the url. The URL have to return OpenSearch Description 1.0 or 1.1.

Create index

Run ${TOMCAT_HOME}/webapps/archtea/WEB-INF/lib/archtea-indexer.jar to use indexer for this application.

  $ java -jar ${TOMCAT_HOME}/webapps/archtea/WEB-INF/lib/archtea-indexer.jar archtea-config.xml
  ... (snip) ...
  Adding filename ...
  Optimizing...
  792 total seconds
  Skip indexing for main2

If you can see messages like the above lines, the indexer finished. The reason why main2 is skipped is "main2" is for OpenSearch .

Restart Tomcat

If you cannot confirm your changes, try to restart Tomcat.

  $ cd ${TOMCAT_HOME}/bin
  $ ./shutdown.sh
  $ ./startup.sh

Access to Archtea

Access Tomcat like this:

  http://localhost:8080/archtea/