Up: [wiki:IPPatTheROE IPP at The ROE]

= Installation of IPP at the ROE =

There instructions are particular to 32/64bit machines with the ROE's default Debian (Lenny 5.0.3) distribution, but there may be stuff applicable to other systems.

Items in italics can be ignored. They are there for my own benefit.

== Directory structure ==

I'm a firm believer in the `$HOME/local` directory, which can be treated like the user's personal `/usr/local`.

`$HOME/local` can be a symbolic link to a directory on a data drive, since you might hit your quota on `/home` if you install a large amount on software. For example, my `/home/ert/local` points to
`/garve/ert/local` .

The following installation procedure will require < 80MB, however.

In `$HOME/local`, the extra, non-IPP-specific perl modules will be installed in `$HOME/local` and the IPP-specific code will be installed in `$HOME/local/ipp` .

== Installing ipp ==

1) Submit a helpdesk ticket to have the extra Debian packages installed. The list of packages to install can be found at `/home/ert/ipp/ExtraDebianPackages.lst` (also listed at the bottom of this page). Note that this list will generate further dependencies that the Debian package installer should resolve.

Installation of the packages can be as easy as:

    * {{{apt-get install `cat /home/ert/ipp/ExtraDebianPackages.lst`}}}
    * or for more control:
{{{
foreach i ( `cat /home/ert/ipp/ExtraDebianPackages.lst` )
apt-get install $i
end
}}}

Tell them to disable apache:

    * `/etc/init.d/apache2 stop`
    * `rm /etc/rc?.d/*apache2`

2) Create the base directory structure if needed.

    * `mkdir -p $HOME/local`

3) Find an appropriate directory in which to compile IPP. Up to 1 GB of space will be required. Change to that directory. I'll call it `$SRCDIR`.

4) Inform your environment of the location of the IPP configuration files

    * Add to your `.tcshrc` / `.cshrc` / `.paths` file:
{{{
if (-e $HOME/local/ipp/psconfig.csh) then
alias psconfig "source $HOME/local/ipp/psconfig.csh"
psconfig default
else
echo "psconfig not available"
endif
# Check your perl version with: perl --version
set PERLVER=5.10.0
# SYS is either linux (32bit) or lin64 (64bit)
set SYS=lin64
setenv PERL5LIB $HOME/local/lib/perl5
setenv PERL5LIB ${PERL5LIB}:$HOME/local/lib/perl/$PERLVER
setenv PERL5LIB ${PERL5LIB}:$HOME/local/share/perl/$PERLVER
setenv PERL5LIB ${PERL5LIB}:$HOME/local/ipp/lib/perl5
setenv PERL5LIB ${PERL5LIB}:$HOME/local/ipp/lib/perl/$PERLVER
setenv PERL5LIB ${PERL5LIB}:$HOME/local/ipp/lib/perl5/auto
setenv PERL5LIB ${PERL5LIB}:$HOME/local/ipp/lib/perl/$PERLVER/auto
setenv PERL5LIB ${PERL5LIB}:$HOME/local/ipp/share/perl/$PERLVER
setenv PERL5LIB ${PERL5LIB}:$HOME/local/ipp/default.$SYS/lib
setenv PERL5LIB ${PERL5LIB}:$HOME/local/ipp/default.$SYS/lib/perl5
}}}

5) Re-source your environment. Best to log out and log back in to your terminal window.

6) Get the source code:

    * `cd $SRCDIR`
    * `svn co http://svn.pan-starrs.ifa.hawaii.edu/repo/ipp/trunk`

7) Get the extra perl packages (in the same directory as you were in step 4):

    * `cd $SRCDIR`
    * `tar xzf /home/ert/ipp/extperl-ROE.tgz`

8) Build the extra perl packages:

    * `cd $SRCDIR/extperl-ROE`
    * `./INSTALL-all.csh`

9) Choose your installation directory and add it to ipp's rc file:

    * `echo set PSCONFDIR = $HOME/local/ipp > ~/.psconfigrc`
    * Note, the directory doesn't need to exist. A following step will do it.

10) Configure the IPP source

    * `cd $SRCDIR/trunk/psconfig` (or `ipp/psconfig`, depending on from where you got IPP)
    * `./psbuild -bootstrap $HOME/local/ipp`

11) Build any outstanding perl modules:

    * `cd $SRCDIR/trunk/psconfig`
    * `./pscheckperl -build`

12) (Optional) Verify the installation of the perl modules:

    * `./pscheckperl`

13) Add a `pkg-config` file for `cfitsio` library:
{{{
mkdir -p $HOME/local/ipp/default.lin64/lib/pkgconfig
cat << EOF >> $HOME/local/ipp/default.lin64/lib/pkgconfig/cfitsio.pc
prefix=/usr
exec_prefix=/usr
libdir=${exec_prefix}/lib
includedir=${prefix}/include

Name: cfitsio
Description: FITS File Subroutine Library
Version: 3.006
Libs: -L${libdir} -lcfitsio -lm
Cflags: -I${includedir}
EOF
}}}

14) Build IPP

    * `./psbuild -dev -extbuild -optimize >& Build.log`

    The last line of Build.log should be `** psbuild: finished **`

15) Install configuration files
    * `cd $SRCDIR/trunk/ippconfig`
    * `./configure --prefix=/disk1/ps1/ert/local/ipp`
    * `make`
    * `make install`

== The Apache issue ==

Apache is required, but security policy at the ROE forbids web servers on machines other than those specifically designated.

So what requires Apache and why?

Apache is required by the perl module, `Apache2-SOAP`, a package included in IPP's `extperl` directory.

== Added Debian packages (Lenny 5.0.3) ==
For my own benefit

    * synaptic
    * locate

For IPP

    * apache2-threaded-dev
    * autoconf
    * automake
    * libapache2-mod-perl2
    * libapache2-mod-perl2-dev
    * libarray-compare-perl
    * libattr1-dev
    * libcache-memcached-perl
    * libcache-perl
    * libclass-accessor-perl
    * libclass-factory-perl
    * libdata-validate-domain-perl
    * libdatetime-format-iso8601-perl
    * libdatetime-perl
    * libdbd-mysql-perl
    * libdigest-md5-file-perl
    * libdigest-sha1-perl
    * libfile-find-rule-perl
    * libfile-nfslock-perl
    * libfilesys-df-perl
    * libgsl0-dev
    * libheap-perl
    * libio-string-perl
    * libipc-run3-perl
    * libjpeg62-dev
    * liblog-log4perl-perl
    * libmysqlclient15-dev
    * libncurses5-dev
    * libnet-domain-tld-perl
    * libnet-server-perl
    * libnumber-compare-perl
    * libparams-validate-perl
    * libpng12-dev
    * libreadline5-dev
    * libsoap-lite-perl
    * libstatistics-descriptive-perl
    * libsub-uplevel-perl
    * libtemplate-perl
    * libtest-class-perl
    * libtest-cmd-perl
    * libtest-pod-coverage-perl
    * libtest-pod-perl
    * libtest-warn
    * libtext-glob-perl
    * libtimedate-perl
    * libtool
    * libtree-dagnode-perl
    * libxml-writer-perl
    * libyaml-perl
    * m4
    * pkg-config

-- EricTittley - 2009-11-06