Documentation > Installing arand

This document lists the steps required to install arand and its supporting software. After you have installed arand, see the configuring arand page for directions on how to generate and install the certificates arand will use. If you want to run arand on an iPAQ or a Sharp Zaurus or similar device, see the notes at the bottom of the Install arand section for a note regarding cross compilation. Also, see the notes related to installing arand on the iPAQ or the Zaurus.

What you need

You will need the arand code. You can find it on the download page. You will also need the following:

• Linux kernel 2.4 or higher and access to kernel source
• OpenSSL Library
• Ad-hoc support library (libASL)

Installation instructions:

1. Install the route_check kernel module
2. Install the Ad-hoc Support Library
3. Set up the Linux TUN/TAP device
4. Install OpenSSL
5. Install arand

1. route_check kernel module installation

   Note: You will need access to your kernel source.

   1. untar ASL package

      tar -xzvf ASL-x.x.tar.gz

   2. switch to the route_check directory

      cd ASL-x.x/route_check

   3. compile the route_check module

      make

   4. become superuser

      su

   5. install the module in your kernel module tree

      make install

2. libASL installation

   1. untar the ASL package (if you haven't done so already)

      tar -xzvf ASL-x.x.tar.gz

   2. switch to the ASL-x.x directory

      cd ASL-x.x

   3. configure the sources

      ./configure

   4. compile the library

      make

   5. become superuser

      su

   6. install the library

      make install

   So libASL recgonized properly by applications that use it, edit /etc/ld.so.conf and make sure there is a line that reads "/usr/local/lib". If that line is not in the file, add it and then run '/sbin/ldconfig'

3. Set up the Linux TUN/TAP device

   Note: See /usr/src/linux/Documentation/networking/tuntap.txt for more info.

   1. Create the device:

      mknod /dev/net/tun c 10 200

   2. Add the following to /etc/modules.conf:

      alias char-major-10-200 tun

   3. Update module dependencies:

      /sbin/depmod -a

4. Install OpenSSL

   Note: These are generic instructions. Please follow the instructions that come with the OpenSSL package.

   1. untar the OpenSSL package

      tar -xzvf openssl-x.x.x.tar.gz

   2. switch to the openssl-x.x.x directory

      cd openssl-x.x.x

   3. configure the sources

      ./configure

   4. compile the library

      make

   5. test the library

      make test

   6. install the library

      make install

5. Install arand

   1. untar the arand package

      tar -xzvf arand-x.x.tar.gz

   2. switch to the arand-x.x directory

      cd arand-x.x

   3. make a directory to build in

      mkdir build

   4. switch to the build directory

      cd build

   5. configure the package

      ../configure

   6. build the package

      make

   7. install the package

      make install

   Note: If you want to compile arand for use on an iPAQ or Zaurus using a cross-compiler, you will need a cross compiler toolchain installed on your machine as well as versions of libASL and OpenSSL compiled for ARM. You would use commands like the following to in place of the "configure" step above:

   ../configure CC=/skiff/local/bin/arm-linux-gcc LD=/skiff/local/bin/arm-linux-ld \
                                                    --build=i686-linux --host=arm-linux \
                                                    --with-include-path=/skiff/local/include \
                                                    --with-lib-path=/skiff/local/lib

   CC is the cross compiler, LD is the cross linker, --build sets the system you are building the package on, --host sets the system the package will be run on, --with-include-path is the path to the header files for the OpenSSL library and the Ad hoc support library, --with-lib-path is the path to the ARM compiled versions of the OpenSSL library and Ad hoc support libraries