This guide was written for, and tested on, Ubuntu.
These are the steps: WORK IN PROGRESS!
In a shell, first change directory to the place where you want Heritrix+Umbra to be installed. Then do the following.
Now, in a browser, go to https://localhost:8443/ to test that it works.
which python and make sure that the
python there points at a python 3 and if it does not, make sure that it does.
Then, to install Umbra, do the following.
RabbitMQ should now be reachable at http://localhost:15672 (user: guest, pass: guest).
Make sure Google Chromium is installed. (If not, do a
sudo apt-get install chromium-browser)
Then run Umbra as follows:
If you want to see what Umbra does in the Chromium browser, just do a
If you want Umbra to do its stuff without seeing the browser, do
sudo X :1 (and then press <ctrl> <alt> <F7>)
and in a(nother) shell, do
export DISPLAY=:1; umbra -v&
Get the following Heritrix 3 Crawl Job Configuration File:, and
put it in
Then, still under the
myTestJob dir, create a text file called
seeds.txt with a single line saying:
Now, in a browser, go to https://localhost:8443/ and paste the path to the
myTestJob dir into the field under add existing job, and click the add button. "myTestJob" should appear at the bottom of the window, so click it.
On the page that appears, click the build button, and when it has built, click the launch button and reload the page until it says "Job is Finished: FINISHED".
Now the Umbra harvests will likely be running... but where do they actually dump the resulting files???
NOTE: Heritrix can be killed by doing a
and killing the relevant process.