home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / tux013.exe / RELNOTES.TXT next >
Text File  |  1994-08-03  |  8KB  |  235 lines
  1. TUXEDO(r) System Release 4.2 Update 1 Release Notes
  2. ====================================================
  3.  
  4. These release notes describe the first update release for
  5. TUXEDO System Release 4.2 ("Red Box 1").  There are two
  6. versions of Update 1--one for the TUXEDO Runtime product
  7. and another for the TUXEDO Development Environment product.
  8. You must have TUXEDO 4.2 installed on your system before
  9. installing Update 1.
  10.  
  11. Topics addressed by these release notes include
  12.  
  13.     - contents of the update package
  14.     - pre-installation procedures
  15.     - installation instructions
  16.     - post-installation procedures
  17.     - fixes provided in Update 1
  18.  
  19. If you have difficulty installing Update 1, please contact
  20. Novell Customer Support at 800-NETWARE or by e-mail at
  21. devtux@novell.com.
  22.  
  23.  
  24. Package Names and Contents
  25. ==========================
  26.  
  27. For UNIX(r) systems, Update 1 is packaged as a separate tar file per
  28. UNIX platform and TUXEDO product.  On UNIX systems these files are
  29. named as follows:
  30.  
  31.     tux001.tar - TUXEDO Runtime for UnixWare(tm) 1.0 on Intel 386/486(tm)
  32.     tux002.tar - TUXEDO Runtime for SVR4 on NCR 34xx
  33.     tux003.tar - TUXEDO Runtime for Solaris(tm) 2.2 on Sparc
  34.     tux004.tar - TUXEDO Runtime for AIX(tm) 3.2 on RS/6000
  35.     tux005.tar - TUXEDO Runtime for HP-UX(tm) 9.0 on HP 9000/800
  36.  
  37.     tux006.tar - TUXEDO Development Environment for UnixWare 1.0
  38.     tux007.tar - TUXEDO Development Environment for NCR SVR4
  39.     tux008.tar - TUXEDO Development Environment for Solaris 2.2
  40.     tux009.tar - TUXEDO Development Environment for AIX 3.2
  41.     tux010.tar - TUXEDO Development Environment for HP-UX 9.0
  42.  
  43. Each tar file contains several files, some of which are compressed.
  44.  
  45. For DOS, Windows(tm), and OS/2(tm), Update 1 is packaged as a separate
  46. self-extracting executable file per platform and TUXEDO product.
  47. The files are named as follows:
  48.  
  49.     tux011.exe - TUXEDO Runtime for DOS or Windows(tm) with LAN WorkPlace
  50.     tux012.exe - TUXEDO Runtime for Windows with Winsock
  51.     tux013.exe - TUXEDO Runtime for OS/2(tm)
  52.  
  53.     tux014.exe - TUXEDO Development Environment for DOS or Windows
  54.                 with LAN WorkPlace
  55.     tux015.exe - TUXEDO Development Environment for Windows with Winsock
  56.     tux016.exe - TUXEDO Development Environment for OS/2
  57.  
  58.  
  59. Pre-Installation Procedures
  60. ===========================
  61.  
  62. Your existing TUXEDO system must be a Novell "Red Box" product running
  63. Release 4.2.  To verify this on UNIX systems, execute
  64.  
  65.     tmadmin -v
  66.  
  67. which should report a line like this on the first line of output
  68.  
  69.     INFO: TUXEDO(r) System Release 4.2.2 V1 <platform>
  70.  
  71. where <platform> is uw, ncr, ibm, sun, or hp.  If, instead, tmadmin
  72. reports an "Invalid option" message or another release number, you
  73. are not running the TUXEDO Red Box product--do not install the Update!
  74.  
  75. Because the Update 1 installation procedure updates your existing
  76. TUXEDO 4.2 system in place by replacing selected files, we strongly
  77. recommend that you back up your TUXEDO 4.2 system--by copying all
  78. files under your root directory (ROOTDIR)--before installing Update 1.
  79.  
  80. Also, before installing Update 1, shut down all TUXEDO applications
  81. running on the system to be updated.
  82.  
  83.  
  84. Installing Update 1 on a UNIX System
  85. ====================================
  86.  
  87. To install Update 1 on a UNIX system, do this:
  88.  
  89. 1.  Copy the appropriate tar file into an empty directory on the system
  90. where the TUXEDO 4.2 installation resides.  The tar files are named
  91. as described above.  Make sure that you have enough free space for the
  92. tar file and that you have permission to create a file of that size.
  93.  
  94. For example, to retrieve Release 4.2 Update 1 for the TUXEDO Development
  95. Environment on UnixWare, execute
  96.  
  97.     mkdir <newdir>
  98.     cd <newdir>
  99.  
  100.     # Check for space
  101.     df -k .
  102.  
  103.     # Invoke ftp to retrieve the update
  104.     ftp ftp.summit.novell.com
  105.     Name: anonymous
  106.     Password:<your e-mail address>
  107.     ftp> cd tuxedo/rel42upd1
  108.     ftp> binary
  109.     ftp> ls
  110.     ftp> get tux006.tar
  111.     ftp> quit
  112.  
  113. 2.  Extract all files from the tar file.  On AIX, make sure that you
  114. extract the files into a directory on a local file system so that
  115. file ownership is set properly.
  116.  
  117. For example, if you are installing Update 1 for the TUXEDO Development
  118. Environment on UnixWare, execute
  119.  
  120.     tar xvf tux006.tar
  121.  
  122. One of the extracted files is named INSTALL.
  123.  
  124. 3.  Using the login id of the owner of the files in the existing TUXEDO
  125. 4.2 system, invoke the installation script:
  126.  
  127.     sh INSTALL
  128.  
  129. INSTALL will prompt you for the root directory (ROOTDIR) of your existing
  130. TUXEDO 4.2 system.  INSTALL will also ask whether you want to install the
  131. complete TUXEDO system or only the /WS client software.  Your existing
  132. TUXEDO 4.2 system must be licensed in order for INSTALL to succeed.
  133.  
  134.  
  135. Installing Update 1 on a DOS, Windows, or OS/2 Workstation
  136. ==========================================================
  137.  
  138. To install Update 1 on a DOS, Windows, or OS/2 workstation, do this:
  139.  
  140. 1.  Copy the appropriate self-extracting file (.exe file) into the
  141. root directory (ROOTDIR) of your existing TUXEDO 4.2 system.  The .exe
  142. files are named as described above.  Make sure that you have enough
  143. free space for the .exe file.
  144.  
  145. 2.  Change directory to ROOTDIR.  Extract all files, making sure
  146. to overwrite existing files.  For example, if ROOTDIR is \tuxedo
  147. and you are installing Update 1 for the TUXEDO Runtime on DOS, invoke
  148.  
  149.     c:\> cd \tuxedo
  150.     c:\tuxedo> tux011
  151.  
  152.  
  153. Post-Installation Procedures
  154. ============================
  155.  
  156. After installing Update 1, we recommend that you verify the installation
  157. by configuring and running the sample application Simpapp located in
  158. $ROOTDIR/apps/simpapp.  Follow the instructions in
  159. $ROOTDIR/apps/simpapp/README.
  160.  
  161. After verifying the installation, you must rebuild all application clients
  162. and servers before rebooting your TUXEDO applications.
  163.  
  164. To retrieve the version information for Update 1, invoke
  165.  
  166.     tmadmin -v
  167.  
  168. which should now report (first line only)
  169.  
  170.     INFO: TUXEDO(r) System Release 4.2.2 V2
  171.  
  172.  
  173. Fixes Provided by Update 1
  174. ==========================
  175.  
  176. The following faults have been fixed in Update 1:
  177.  
  178. * An AUTOTRAN service that invoked tpforward() did not propagate the
  179. transaction information correctly.  The caller of the original service
  180. got a good return back, but the commit failed, and the AUTOTRAN transaction
  181. timed out.
  182.  
  183. * Tmshutdown core dumped if it was invoked when there were dead servers
  184. that had not yet been cleaned up by the BBL.
  185.  
  186. * The tpurcode variable was not being set in /WS clients when calling
  187. conversational services.
  188.  
  189. * COBOL servers could not be built on the platforms without shared
  190. libraries, i.e. HP-UX and AIX.
  191.  
  192. * The tx_open() function did not work in native client programs.
  193. Thus, the tx interface itself was not usable in clients.
  194.  
  195. * A global transaction that was begun and then aborted, without ever having
  196. called a service, was never cleaned up in the bulletin board's Global
  197. Transaction Table.
  198.  
  199. * If a SHM-mode TUXCONFIG file was unloaded and a NETWORK section was
  200. added to it, the file could not be reloaded.
  201.  
  202. * The Frealloc() function sometimes caused a core dump if it was used to
  203. shrink the buffer.
  204.  
  205. * The child process that tmadmin forks to run the pager command
  206. invoked tpterm() when it exited.  Because this process never invoked
  207. tpinit(), but nevertheless carried state information from its parent,
  208. it caused unusual userlog errors to be reported from tmadmin.
  209.  
  210. * The /Q functions were not exported from the TUXEDO Windows DLL,
  211. and could not be used.
  212.  
  213. * A tpcall() or tpacall() to a service that was suspended returned
  214. TPESYSTEM instead of TPENOENT.  Although the return code for the function
  215. under these conditions was never defined clearly, TPESYSTEM was certainly
  216. not appropriate.
  217.  
  218. * A /WS tpgetrply() with TPNOBLOCK was sometimes unnecessarily slow, due
  219. to a race condition between the client layer and the network layer of
  220. software.
  221.  
  222. * A server that received a message for a timed-out transaction went
  223. into an infinite loop.
  224.  
  225. * The tmadmin loadtlog command sometimes overwrote existing TLOG records
  226. when it recovered a TLOG from a dead machine onto an active machine.
  227.  
  228. * A tpdequeue() done by message-id or correlation-id did not work.
  229.  
  230. * View32 buffers could not be sent between machine types (or from /WS
  231. clients) because the typed buffer encode/decode function did not work
  232. properly.
  233.  
  234. [@(#)relnotes.txt    1.8]
  235.