Changes between Initial Version and Version 1 of IPPInstallStepByStep-2.6.1-RHEL5.1-Odyssey

Timestamp:

Feb 24, 2009, 4:23:55 PM (17 years ago)

Author:

trac

Comment:

--

IPPInstallStepByStep-2.6.1-RHEL5.1-Odyssey

@@ +1 @@
+== Warning: this installation is not yet complete! ==
+
+ * MySQL is still pending, so there is no pantasks support.
+
+== IPP User Setup on Odyssey ==
+
+ * The general description of Odyssey is here: [wiki:Odyssey_Cluster_Configuration Odyssey_Cluster_Configuration]
+ * The binaries for ipp-2.6.1 reside in /odyssey/apps/ipp/ipp-2.6.1/psconfig, with source in /odyssey/apps/src/ipp/ipp-2.6.1 .
+ * This system uses [http://www.ece.utexas.edu/it/modules/ Modules] for environment management, so there is a small change in setup compared to most IPP installations.  Instead of the usual modification to .bashrc or .cshrc, for which the .cshrc version looks like:
+
+   if (-e /path/to/psconfig.csh) then
+      alias psconfig "source /path/to/psconfig.csh"
+   else
+      alias psconfig "echo psconfig not available"
+   endif
+
+the following code suffices for both .bashrc and .cshrc:
+
+   module load hpc/ipp
+   
+ * To finish setting up the shell environment, the usual 'psconfig default' command is needed.  In addition, libcfitsio doesn't seem to work properly unless the environment variable CFITSIO points to the library itself.  Thus the user's .bashrc should include:
+
+   module load hpc/ipp
+   psconfig default
+   export CFITSIO=${PSCONFDIR}/default.linrh64/lib/libcfitsio.a
+
+.cshrc should include:
+
+   module load hpc/ipp
+   psconfig default
+   setenv CFITSIO ${PSCONFDIR}/default.linrh64/lib/libcfitsio.a
+
+ * Users must set up several config files in their home directories:
+
+   cd ${HOME}
+   cp /odyssey/apps/src/ipp/ipp-2.6.1/ippconfig/ipprc.config ./.ipprc
+   cp /odyssey/apps/src/ipp/ipp-2.6.1/ippconfig/dvo.site ./.ptolemyrc
+
+Edit ${HOME}/.ipprc to uncomment the line near the top of the file which includes $HOME/.ipp in the config search path.  These files can be customized to implement your preferred config options.
+
+<b>DO NOT</b> set the environment variable PSCONFIG in your ${HOME}/.psconfigrc file.  The <em>module load</em> command handles that for you; setting it separately in ${HOME}/.psconfigrc will interfere with the function of the <em>module</em> commands.
+
+== Build Notes ==
+
+ * The modulefile /odyssey/apps/modules-3.2.6/Modules/modulefiles/hpc/ipp is used to implement the 'module load' behavior described above.
+ * Except for the substitution of 'module load' for the edits to ${HOME}/.cshrc and ${HOME}/.bashrc, the 
+installation proceeds exactly as described in the INSTALL file in /odyssey/apps/src/ipp/ipp-2.6.1 up through
+the end of step (3).
+ * As per [wiki:CFITSIO CFITSIO], do:
+
+   export LDFLAGS=-L/odyssey/apps/ipp/ipp-2.6.1/psconfig/default.linrh64/lib
+
+before doing the 'psbuild' command of INSTALL step (4).  (Modify this appropriately if LDFLAGS is already defined).
+
+ * Errors with messages like:
+
+   libtool: link: `/odyssey/apps/ipp/default.linrh64/lib/libgsl.la' is not a valid libtool archive
+
+seem to be the result of broken libtool archive (.la) files left over from failed earlier compiles.  The fix is to remove all .la files from both the /odyssey/apps/src/ipp/ipp-2.6.1 and /odyssey/apps/ipp/ipp-2.6.1/psconfig/default.linrh64 trees and do a 'psbuild -clean -rebuild -extbuild'.
+
+== Known Problems ==
+ * There is not yet a MySQL server running, so it is not yet possible to run pantasks or simtest.
+ * We don't yet have a convention for the naming of user's data directories.
+ * It's unclear how to integrate pantasks with the queueing system.
+ * site.config needs to be kept up to date as additional data directories are established.