%----------------------------------------------------------------------- %; Copyright (C) 1996, 1997 %; Associated Universities, Inc. Washington DC, USA. %; %; This program is free software; you can redistribute it and/or %; modify it under the terms of the GNU General Public License as %; published by the Free Software Foundation; either version 2 of %; the License, or (at your option) any later version. %; %; This program is distributed in the hope that it will be useful, %; but WITHOUT ANY WARRANTY; without even the implied warranty of %; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the %; GNU General Public License for more details. %; %; You should have received a copy of the GNU General Public %; License along with this program; if not, write to the Free %; Software Foundation, Inc., 675 Massachusetts Ave, Cambridge, %; MA 02139, USA. %; %; Correspondence concerning AIPS should be addressed as follows: %; Internet email: aipsmail@nrao.edu. %; Postal address: AIPS Project Office %; National Radio Astronomy Observatory %; 520 Edgemont Road %; Charlottesville, VA 22903-2475 USA %----------------------------------------------------------------------- % README File FOR AIPS Release 15OCT96 % This File describes the patches to known bugs in 15OCT96. See also % the patches.html file; it MUST contain the same information. % placed under RCS control by Pat Murphy; aipspgmr group should have access. % most recent modification $Date: 1999/04/21 13:57:04 $ (UT) % IMPORTANT: If you performed a binary "load-and-go" installation, and you % do *not* have any Fortran compiler (or your revision of the % compiler predates ours, you will most likely not be able to % apply most of these patches. In particular, under SunOS or % Solaris, Sun Fortran SC2.0.1 or later is required. % Unfortunately, the NRAO AIPS group is unable at this time to provide % binary replacements for the affected tasks. Tasks and other things for which patches have been made: 1. Network Services 2. INSTEP1 refused valid hosts for TPHOSTS file 3. Linux tape drives 4. INDXR model recalculation for VLBA subarray data =============================================================================== ------------------------------------------------------------------------ ID: 1. Task: Network Services Summary: Using network service names in upper case letters exposes bugs in operating systems. In particular, a NIS/YP server running SunOS 5.5 was found to reject connects for service names (in getservbyname) in uppercase. The solution is to make all service name references in AIPS lowercase, and ensure the /etc/services file or YP (NIS or NIS+) services map has the first reference to each AIPS service in lowercase also. NOTE: while XAS.SHR has been fixed, the older and seldom- used XVSS.SHR and SSS.SHR servers have not. Caveat emptor. * NOTE ALSO: You will most likely NOT need to make these * changes if your TV, Tekserver, Message server, and remote * tape daemons (TPMON) are currently working. It is only * necessary if they are FAILING due to your network * providing a NIS/YP services map on a SunOS 5.x server. Files: /15OCT96/APL/DEV/UNIX/ZSSSO2.C /15OCT96/APL/DEV/UNIX/ZVTPO2.C /15OCT96/APL/DEV/UNIX/ZVTPO3.C /15OCT96/APL/DEV/ZMOUNT.FOR /15OCT96/APL/DEV/ZTPOPR.FOR /15OCT96/APL/DEV/ZVTPRO.FOR /15OCT96/APL/DEV/ZVTPO2.FOR /15OCT96/AIPS/PGM/NOTST/TPMON.FOR /15OCT96/Y/SERVERS/XAS.SHR /15OCT96/SYSTEM/UNIX/TVDEVS.SH /15OCT96/services.part Fix: 1. Fetch the files and put them in their correct locations (all but the last one). If your copy of TVDEVS.SH in $AIPS_ROOT is not a symlink to the $SYSUNIX version (it should be, or to TVDEVS.KLUDGE), integrate the changes in this copy too. 2. Compile the subroutines: COMRPL $APLUNIX/ZSSSO2 $APLUNIX/ZVTPO2 $APLUNIX/ZVTPO3 COMRPL $APLGEN/ZMOUNT $APLGEN/ZTPOPR $APLGEN/ZVTPRO COMRPL $APLGEN/ZVTPO2 3. Re-make the XAS TV server: cd $YSERV; mkdir XAS; cd XAS ln -s ../UNSHR.FOR unshr.f f77 -o UNSHR unshr.f (xlf on AIX) ./UNSHR ../XAS.SHR make xas make install (Refer to the AIPS Installation Summary for 15OCT96 for more detailed instructions on how to make XAS). Note that you do not need to re-make UNSHR if INSTEP1 already did it for you. 4. Re-link all TV and tape tasks: COMLNK $AIPPGM/AIPS COMLNK $YPGM/*.FOR COMLNK $YPGNOT/*.FOR COMLNK $QYPGM/*.FOR COMLNK $QYPGNOT/*.FOR COMLNK $APGNOT/FITTP $APGNOT/FITLD $APGNOT/UVLOD $APGNOT/IMLOD $AIPPGM/AIPS $APLPGM/PRTTP $APGNOT/MK3IN $APGNOT/FILLM $APLPGM/AVTP $APGNOT/BAKLD $APGNOT/BAKTP $APGNOT/FILLR $APGNOT/GSCAT $AIPNOT/TPMON $APLPGM/TCOPY $AIPNOT/GR2TEX $AIPNOT/GRITP $AIPNOT/RDFITS $APGNOT/MK3TX 5. Remove any TPMON1, TPMON2, etc. files from $LOAD, kill and restart your TPMON daemons. 6. Make the appropriate changes to your /etc/services file(s) and/or your NIS or NIS+ services map; see the services.part file for an example. Documentor: Patrick P. Murphy Date: 1996.11.26, updated 1996.12.04 with list ot tape tasks; Updated 1996.12.11 to add TPMON.FOR and daemon restart. ------------------------------------------------------------------------ ID: 2. Task: INSTEP1 Summary: Two fixes: allow the installer to specify zero (0) disks as a valid number; this can be correct if .dadevs files are being used. Also, fix the checking of the hostnames or IP addresses entered for inclusion in TPHOSTS; the logic was failing and is now removed. Any non-blank string will be inserted in the file now. NOTE: you can also directly edit the $NET0/TPHOSTS file to insert or correct any entries. ALSO NOTE: you do NOT need to re-do INSTEP1. If you have not started the installation, use this revised script. If you have started, just edit the TPHOSTS file directly. Files: /15OCT96/SYSTEM/UNIX/INSTALL/INSTEP1 Fix: 1. Fetch the file and put it in $INSUNIX 2. Proceed with your installation. Documentor: Patrick P. Murphy Date: 1996.11.26, updated 1996.12.05 ------------------------------------------------------------------------ ID: 3. Task: Linux tape drives Summary: Ensures that block size for SCSI tape drives is set to 0 at mount, and restores previous block size at dismount. This eliminates a block size related problem that some users were experiencing, primarily when attempting to use 8mm (Exabyte) tape drives. NOTE: This patch is only useful on Linux systems. Files: /15OCT96/APL/DEV/UNIX/BELL/LINUX/ZMOUN2.C Fix: 1. Fetch the file and put it in $APLLINUX 2. Compile the subroutine: COMRPL $APLLINUX/ZMOUN2 3. Recompile the main AIPS task: COMLNK $AIPPGM/AIPS Documentor: Jeffrey A. Uphoff Date: 1997.02.03 ------------------------------------------------------------------------ ID: 4. Task: INDXR model recalculation for VLBA subarray data Summary: Corrects an INDXR error when using model recalculation for VLBA data (CPARM(4) > 0). This only affects data with separate subarrays. Files: /15OCT96/APL/SUB/NOTST/GETDEL.FOR Fix: 1. Fetch the file and put it in $APLNOT 2. Compile the subroutine: COMRPL $APLNOT/GETDEL 3. Recompile/link the affected AIPS task: COMLNK $APGNOT/INDXR Documentor: A. Kemball Date: 1997.02.10 ------------------------------------------------------------------------ ID: 5. Task: Summary: Files: /15OCT96/ Fix: 1. Fetch the file and put it in 2. Compile and link it with: COMLNK Documentor: Date: ------------------------------------------------------------------------