Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

NetarchiveSuite uses JMS for inter-process communication. JMS is the Java Messaging Service, which provides asynchronous communication between processes. You do not need any knowledge of JMS to use NetarchiveSuite. However you need to make sure that there are not already JMS brokers running on your system using PORT 7676.

Currently only the open-source version of Sun's JMS implementation is supported, since some functionality of other implementations does not match our assumptions well.

To download and install it, do the following:

  • Create a new dir for the messagebus broker in the netarchive dir:

    Code Block
    $ cd ~/netarchive 
    $ mkdir broker
  • Open this link in a browser window http://mq.java.net/downloads.html
  • Click the Linux Link under version 4.5 binary Downloads to download a file openmq4_5-binary-Linux_X86.zip (or later version)
  • Save the download file to the broker directory.
  • Unpack the zip file.
  • Set necessary environment variables: IMQ_HOME, IMQ_VARHOME, IMQ_ETCHOME:

    Code Block
    $ export IMQ_HOME=$HOME/netarchive/broker/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 Download the openmq installation script into the netarchive dir.

  • Install the openmq broker with:

    Code Block
    sh mq.sh install

    This will download openmq, install and start it.

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

    Code Block
    $IMQ_VARHOMEHOME/var/mq/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

...

Code Block
$ cd netarchive
$ $IMQ_HOME/mq/bin/imqbrokerd &

Installation

...