Changeset 1369 for tags

Timestamp:

05/03/07 10:53:03 (18 years ago)

Author:

mar637

Message:

Forgot to update the INSTALL instructions

File:

• tags/asap2.2.0/INSTALL (modified) (1 diff)

tags/asap2.2.0/INSTALL

@@ -1 @@
-Requirements
-============
+= Installing ASAP and dependencies from source =
 
-* scons
+ * You need '''scons, flex, bison, g++, g77/gfortran, cfitsio''' to build ASAP. These should be available as system packages (e.g. rpm, deb etc.)
+ * You will also need '''ipython, matplotlib, numpy''' to run ASAP
 
-Installation
-============
+ * '''rpfits'''
+  Download [ftp://ftp.atnf.csiro.au/pub/software/rpfits/rpfits.tar.gz rpfits]
+{{{
+   tar zxvf rpfits.tar.gz; cd rpfits/linux
+   make install
+}}}
 
-scons has several targets. It is recommended to execute them sequentially.
-The normal install procedure is as follows:
-   . <path_to_casa_asap>/aipsinit.sh
-   scons
-   # Do this if you haven't got a data directory already
+ * '''wcslib'''
+  Download [ftp://ftp.atnf.csiro.au/pub/software/wcslib/wcslib.tar.gz wcslib]
+{{{
+   tar zxvf wcslib.tar.gz; cd wcslib
+   touch C/*.l
+   make install
+}}}
+
+ * '''casacore''' (aips++)
+  Download [http://casacore.googlecode.com/files/casacore-0.1.1.tar.bz2 casacore-0.1.1])
+{{{
+   tar jxvf casacore-0.1.1.tar.bz2; cd casacore-0.1.1
+   python setup.py prefix=/usr/local install
+}}}
+  Patience...
+
+ * ASAP
+  (You need to have subversion installed)
+{{{
+   svn co http://sourcecode.atnf.csiro.au/repos/asap/tags/asap2.2.0
+   cd asap2.2.0
+}}}
+
+  You need to have the scons package installed (see o/s specific notes)
+{{{
+   scons mode=release casacoreroot=/usr/local
+}}}
+
+  Now it's probably best to get the asap data repository.
+{{{
    export ASAPDATA=.
    ./bin/asap_update_data
-   #
-   scons install
+   unset ASAPDATA
+}}}
 
+  Install it to the default location:
+{{{
+   su
+   scons mode=release casacoreroot=/usr/local install
+}}}
 
-Obtaining the data directory
-============================
-The data repository can be obtained seperately after installing ASAP.
-Before you run asap for the first time simply run
-    asap_update_data
-This will install the data repository into the correct location.
+ * ASAP Data
+{{{
+   su
+   asap_update_data
+}}}
 
-There are several ways to do this. 
-a) If you already hae the 'data' directory, copy it to the root directory and run the normal install procedure.
-   scons
-   scons install
+Now you can test it by executing:
+{{{
+   asap
+}}}
 
-b) You can obtain the data repository from the ftp site.
-   Simply run 
-        export ASAPDATA=.
-        ./bin/asap_update_data
-   This will retrieve and unpack the data directory.
-   After this run: 
-        scons install
+To make a binary release to help out others with the same operating system, replace 
+<identifier> with something identifying your platform, e.g. '''fc5''' for fedora core 5, or '''fc5_x86_64''' for the 64bit version of fc5 and run the following
+{{{
+scons mode=release casacoreroot=/usr/local makedist=<identifier>
+}}}
+Then email the rsyulting tarball in the dist subdirectory to mailto:Malte.Marquarding@csiro.au
 
-Creating a binary distribution
-==============================
-
-after building using 'scons', you can create a compressed tarball of the binaries. This is done via the target 'makedist='. The argument should be an obvious identifier for the system you want to support, e.g. 'sarge' or 'fc5-x86_64'
-
-    scons makedist=sarge
-
-This will create an archive in the subdirectory 'dist' named 'asap-X.Y.Z-sarge.tar.bz2', where X,Y,Z are the version numbers e.g 2.1.0.