Page Comparison

We have prepared a bash shell script that starts all the necessary components on one machine. We will use this script throughout this quickstart manual to allow you to get a feel for what the system can do and how it works without having to deal with issues of distributing to other servers.

Base system required

For the quick startup, NetarchiveSuite requires:

...

• start a terminal login to the linux system as a ordinary user

• check java version is version 1.6.0_19 (or higher) by writing:

  Code Block
  $ java -version

  you should then see something like

  Code Block
  linux>java -version java version "1.6.0_19" Java(TM) SE Runtime Environment (build 1.6.0_19-b04) Java HotSpot(TM) Server VM (build 16.2-b04, mixed mode)

...

Download of the newest release is described here

• Create a directory for the download e.g. directory

  Code Block
  $ mkdir netarchive

• Download the relevant NetarchiveSuite zip and put it in the netarchive directory you created earlier.

...

• Open this link in a browser window http://mqdownload.dev.java.net/downloads.htmlmq/open-mq/4.4u1/b7-final/
• Click the Linux Link under version 4.4 Binary Downloads to download a file openmq4_4-installer-Linux_X86.zip (or later version)
• Save the download file to the netarchive directory you created earlier 

• Goto the directory

  Code Block
  $ cd ~/netarchive

• Unpack the zip file (this creates a directory openmq4_4-installer), and run the X-Windows installer. The installer ask you to choose an install-home (choose netarchive/MessageQueue), and a JDK.

  Code Block
  $ unzip openmq4_4-installer-Linux_X86.zip $ cd openmq4_4-installer; ./installer

• Set necessary environment variables: IMQ_HOME, IMQ_VARHOME, IMQ_ETCHOME)

  Code Block
  $ export IMQ_HOME=$HOME/netarchive/MessageQueue/mq $ export IMQ_VARHOME=$IMQ_HOME/var $ export IMQ_ETCHOME=$IMQ_HOME/etc

• Run imqbroker in order to create settings file

  Code Block
  $ chmod +x $IMQ_HOME/bin/imqbrokerd $ $IMQ_HOME/bin/imqbrokerd

• check that

  Code Block
  imqbrokerd

  starts and that the last message is

  Code Block
  "Broker <localhost>:7676 ready"

• stop the imqbroker by pressing

  Code Block
  control-C

• edit settings to allow for enough listeners to a queue by doing
  edit

  Code Block
  $IMQ_VARHOME/mqvar/instances/imqbroker/props/config.properties

• uncomment and specify count=20 for listeners by changing line

  Code Block
  # imq.autocreate.queue.maxNumActiveConsumers

  to

  Code Block
  imq.autocreate.queue.maxNumActiveConsumers=20

To start it, do the following:

$ cd netarchive
$ $IMQ_HOME/bin/imqbrokerd &

...

When the installation script is run it will unpack the installation files into the netarchive/deploy directory and install NetarchiveSuite into the /home/test/QuickStart directory (using ssh). It assumes that user 'test' already exists. Remember to check, that a Sun JVM is in the path for the test (instead of GNU java compiler, that is default with some Linux'es.). If you already have a Quickstart installation, the existing bitarchive, database and admin.data files will be untouched. You must explicit remove any previous installation, if you want a clean empty installation.

$ chmod +x RunNetarchiveSuite.sh
$ ./RunNetarchiveSuite.sh NetarchiveSuite.zip deploy_standalone_example.xml deploy/

...

• Start a web browser. Note that it is important that the browser is started on the same machine as the simple harvest script is run on

• Anchor
  proxy proxy

  Setup the browser to proxy on port 8070 and exclude localhost and the hostname (used by the Heritrix GUI) e.g. in firefox:

Choose in the firefox toolbar:
Edit->Preferences->Advanced->Network->Settings
Checkmark:
Manual Proxy Configuration
and add:
Proxy: localhost
Port: 8070
No Proxy for: localhost

• Write following url in the started browser http://localhost:8074/HarvestDefinition
• You can now see the webinterface in the browser. You can now create, run and browse according to the following or the User Manual
• You can stop and start the entire NAS system with:

ssh test@localhost
cd QUICKSTART
./conf/killall.sh
./conf/startall.sh

• If you want to try other deploy examples, then go to "Examples of deploy configuration files" in the Installation Manual.