• Installing ICA AtoM on a Raspberry Pi

    Date: 18.07.2012 | Category: Cataloguing, ICA-AtoM, Open Source | Tags:

    The Raspberry Pi is the latest in ‘must have’ gadgetry so after receiving my £25 computer the size of a credit card, I set about finding out what it could do.

    Followers of the blog will know that I posted a video tutorial on how to install the open source archival cataloguing software ICA AtoM in Windows, so I wondered if I could do the same thing under Linux on the Raspberry Pi. Linux is an open source operating system that is free to install and can be run on any desktop computer, indeed I run it on my home PC alongside a standard Windows 7 installation. Unlike Windows, which utilises a graphical interfaces for installing software and other administrator level operations, Linux encourages you to use text based ‘commands’ to get things done.

    Whereas the instructions for installing ICA AtoM under Windows were fairly straightforward, there are a few more things to configure and install in a Linux environment, so I’ve put together what I hope is a comprehensive walkthrough of installing it on a shiny new Raspberry Pi.

    While it’s not the fastest thing ever, I can certainly see potential in a £25 server the size of credit card appealing to small repositories looking for a cheap and easy way of testing and tinkering with an open source cataloguing solution.

    You will need;
    A Raspberry Pi computer
    An SD card with ‘Debian Squeeze’ (operating system) installed on it
    A sense of adventure…

    NOTE – The instructions below are specific to Debian Squeeze, although I’ve noticed that there is a new recommended image (Raspbian Wheezy) available direct from the official Raspberry Pi website. I will try to replicate these instructions using the new image asap and update if necessary. In theory though, the instructions below should also work with Raspbian Wheezy.

    Installation Instructions

    1. Boot up your Raspberry Pi and Login

      login: pi

      password: raspberry

    2. Install the webserver elements required to run ICA AtoM – apache, php and mysql. do this by typing the following into the command prompt;

      sudo apt-get install apache2 php5 mysql-server php5-mysql

    3. The packages will then begin downloading and installing.
    4. You will be prompted to install packages and asked to confirm installation by typing y for ‘Yes’.
    5. Once mysql has been installed you will be prompted to provide to set the ‘password for sql root user’. Make a note of the password you use as you will need it when setting up ICA AtoM.
    6. Wait patiently for everything to finish installing and return you to a blinking cursor in the command prompt.

      NOTE – At the end of the installation, apache may throw up an error ‘bad group name www-data’. To fix this, create the group in the command line by typing

      sudo addgroup www-data

    7. Reboot the Pi by typing

      sudo reboot

    8. Once the Pi has rebooted and you have logged in again, navigate to the folder where apache looks for web files by typing

      cd /var/www

    9. Once you are in the folder (prompt changes to pi@raspberrypi:/var/www$) download the zip file for installing ICA AtoM by typing;

      sudo wget http://pear.qubit-toolkit.org/get/icaatom-1.2.1.tgz

    10. Wait for the file to download and then unpack (unzip) the archive by typing:

      sudo tar -zxpvf icaatom-1.2.1.tgz

    11. ICA AtoM will now install and a vast amount of text will scroll past you on the screen. Wait until you are returned to a blinking cursor.
    12. Once ICA AtoM is installed, change the permissions on the folder to enable changes to be made and files to be created. Do this by typing:

      sudo chmod -R 777 icaatom-1.2.1

    13. Now you’re ready to create the sql database that will contain all the data entered into ICA AtoM. To do this, type:

      sudo myqsl -p (enter the root password you created earlier)

    14. At the mysql> prompt type:

      create database [database name]; where [database name] is your chosen database name

    15. You are now ready to move to another computer to finish setting up your ICA AtoM installation. Before doing this, you’ll need to find out the IP address (web address) of the Raspberry Pi. Do this by typing:

      ifconfig and making a note of the number after inetaddr that should start in either 192.168 or 10.1

    16. Move to another computer, open the browser and navigate to:

      [IP address of Pi]/icaatom-1.2.1

      where [IP address of Pi] is the address you found in step 15.

    17. You will now see the installer working through system checks. Once it has reached 100% click ‘Continue’.
    18. Enter the root password you set up in step 5 and leave the rest of the fields as default.
    19. Click continue and wait.

      NOTE – I waited around 30 minutes before deciding the installation had crashed and rebooted the Pi by pulling the power lead. Ideally if you have this problem, you should return to the Pi and type sudo reboot rather than pulling the power, but I had ‘low memory’ problems so couldn’t reboot cleanly.

    20. Wait for the Pi to boot up again and then return to the other computer and refresh the browser. This should move the page onto the next screen where you choose a name for your site and input username and password details.
    21. This completes the installation and you can then click on the link to ‘visit your new site’.

    Admittedly, it isn’t the quickest installation of ICA AtoM ever, but it works! I’d welcome any additions to this walkthrough or suggestions on how to speed it up a bit, but I hope this outline is of use.

    And there you have it…a fully fledged archival cataloguing system running on a £25 computer :-).