home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 17 Fixes30 / 17-Fixes30.zip / csf140.zip / os2serv.inf (.txt) < prev    next >
OS/2 Help File  |  1998-11-23  |  31KB  |  340 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Users Guide ΓòÉΓòÉΓòÉ
  3.  
  4.                   OS2SERV v1.35 November 23, 1998 by Dick Kurtz
  5.  
  6.                         NCSD Fix Distribution; Austin, Tx
  7.  
  8.      (c) Copyright International Business Machines Corporation, 1996, 1998.
  9.                               All rights Reserved.
  10.  
  11.  
  12. ΓòÉΓòÉΓòÉ 2. Overview ΓòÉΓòÉΓòÉ
  13.  
  14. This program will install or backout a OS/2 Base or LAN FixPak. 
  15.  
  16. The only information you may be asked for is where to save files that are 
  17. replaced by a FixPak and this only if you have never applied a FixPak before. 
  18.  
  19. You select the partition or partitions you want to service based on what is 
  20. presented to you in the "Serviceable Products" window. 
  21.  
  22. You can check the "Advanced" checkbox to use SERVICE.EXE rather than 
  23. FSERVICE.EXE if you want to have more control over the FixPak process. 
  24.  
  25. You then press "Install" or "Uninstall" to begin. 
  26.  
  27. If you are using "Advanced" then SERVICE.EXE is called and you use it's GUI to 
  28. Install (Apply) or Uninstall (Backout) a FixPak.  Otherwise a response file is 
  29. built and passed to FSERVICE.EXE. 
  30.  
  31. SERVICE or FSERVICE do the actual FixPak processing and return to OS2SERV.EXE 
  32. when done. 
  33.  
  34. Before SERVICE or FSERVICE is called, the free space on your harddisk is 
  35. checked to make sure there is enough room to apply this FixPak to one or more 
  36. partitions. 
  37.  
  38. This program is provided "ASIS". There is no official support. 
  39.  
  40.  
  41. ΓòÉΓòÉΓòÉ 2.1. Revisions ΓòÉΓòÉΓòÉ
  42.  
  43. 1.00 - 1st release. 
  44. 1.01 - First release for Internet use. 
  45. 1.02 - Cleanup and add "Advanced" option. 
  46. 1.03 - Add Menu pulldown selections. 
  47. 1.04 - Fix bug in freespace calculations. 
  48. 1.05 - v1.08 info lost. 
  49. 1.09 - Correct bug in SRV_PROD processing. 
  50. 1.10 - v1.19 Skipped, jumped to v1.20 due to major change. 
  51. 1.20 - Support CSF F.138 build changes in SRV_PROD file. 
  52. 1.21 - Support target drive as 3rd parameter. 
  53. 1.22 - Enforce NLS character restrictions. 
  54. 1.23 - Handle multiple SYSLEVEL.xxx files on same drive in different dirs. 
  55. 1.24 - Add message about Ctrl+Esc if using FSERVICE. 
  56. 1.25 - ? 
  57. 1.26 - Limit multiple syslevel error to OS2 only. 
  58. 1.27 - Correct message about Ctrl+Esc. 
  59. 1.28 - Y2K use date(S) for 4 digit year in Logger. 
  60. 1.29 - use common Wincent routine. 
  61. 1.30 - added more debug log entries. 
  62. 1.31 - allow Backup if Archiving off for fixpak. 
  63. 1.32 - add /B:x to FSERVICE call (x is the boot drive). 
  64. 1.33 - implement use of csfdriveapply variable. 
  65. 1.34 - Use SysDriveMap instead of FDISK which Aurora no longer supports. 
  66. 1.35 - Force "Cleanup" to start over. 
  67.  
  68.  
  69. ΓòÉΓòÉΓòÉ 3. Requirements ΓòÉΓòÉΓòÉ
  70.  
  71. You can point to your own directory to install a FixPak from as long as you 
  72. follow the guidelines for directory structure and content described in Creating 
  73. the FixPak Source and CSF Source directories 
  74.  
  75. Place all the OS2SERV files in the same directory: 
  76.  
  77.    OS2SERV.EXE
  78.    OS2SERV.MSG
  79.    OS2SERV.INF
  80.    OS2SERV.ICO
  81.  
  82. You then call OS2SERV and pass it the following parameters: 
  83.  
  84.     OS2SERV x:\path x:\aaa\bbbbbbb s:
  85.  
  86.     "x:\path" is where the Corrective Service Facility files are located.
  87.     This must be the first parameter passed to OS2SERV.
  88.  
  89.     "x:\aaa\bbbbbbb" is the path of the FixPak you want to apply.
  90.     "aaa"            is either OS2 or LAN.
  91.     "bbbbbbb"        is the name of the FixPak
  92.     This must be the second parameter passed to OS2SERV.
  93.  
  94.     "s:" is the drive you want to service. This is an optional parameter.
  95.     If not specified all drives are searched for products supported by this
  96.     FixPak.
  97.  
  98. So, if you put the CSF code in G:\CSF and the Fixpak in G:\FIXPAK\XR_W033 you 
  99. would enter: 
  100.  
  101.     OS2SERV G:\CSF G:\FIXPAK\XR_W033
  102.  
  103. This will search all drives for serviceable products. 
  104.  
  105. If you know you want to service only the E: drive then you could enter: 
  106.  
  107.     OS2SERV G:\CSF G:\FIXPAK\XR_W033 E:
  108.  
  109. OS2SERV.EXE is used by the Remote Software Update application available with 
  110. Warp 3 and Warp 4. It allows you to download a FixPak from the Internet and 
  111. have it applied to your system directly, rather than having to make diskettes. 
  112. OS2SERV is the installation program that is called by RSUINST.EXE once all the 
  113. FixPak files have been download and unzipped. 
  114.  
  115. When called without the above parameters, it expects the CSF and FixPak 
  116. directories to be on the same drive as OS2SERV and nested one directory deeper 
  117. (under) where OS2SERV is running.  For RSU this will be: 
  118.  
  119.   $pmtusr$\os2serv.exe
  120.   $pmtusr$\os2serv.msg     Message file. Can be translated for NLS use
  121.   $pmtusr$\os2serv.inf     The file you are viewing
  122.   $pmtusr$\os2serv.ico     Icon file
  123.   $pmtusr$\os2serv         FixPak base directory
  124.   $pmtusr$\os2serv\fix
  125.   $pmtusr$\os2serv\fix\os2.1  1st OS2 product in fixpak
  126.   $pmtusr$\os2serv\fix\os2.2  2nd OS2product in fixpak
  127.   $pmtusr$\os2serv\fix\os2.n  nth OS2 product in fixpak
  128.   $pmtusr$\os2serv\fix\mpm.n  nth MMOS2 product in fixpak
  129.   $pmtusr$\csf\.........   Corrective Service Facility files
  130.  
  131. By passing parameters to OS2SERV, you can maintain your own set of FixPaks, 
  132. perhaps on a LAN drive, and allow others to install from that LAN drive. 
  133.  
  134.  
  135. ΓòÉΓòÉΓòÉ 4. Features ΓòÉΓòÉΓòÉ
  136.  
  137.  1. Archive/Backup paths extracted from previous FixPak service if available. 
  138.     Also checked to make sure they exist since FSERVICE.EXE will die if they 
  139.     are indicated as available when not really there. 
  140.  
  141.  2. New Archive/Backup paths created if they do not exist. 
  142.  
  143.  3. Backout to previous BacKup or Archive level. 
  144.  
  145.  4. Adds additional information to \OS2\INSTALL\SERVICE.LOG on the boot drive 
  146.     about what you have done. 
  147.  
  148.  5. Provides a display of existing free disk space when asking you to choose 
  149.     where to place saved files. 
  150.  
  151.  6. Prechecks harddisk freespace before running FSERVICE.EXE. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 5. Installing a Fixpak to one or more partitions ΓòÉΓòÉΓòÉ
  155.  
  156. Follow these steps to install a FixPak to one or more partitions on your 
  157. harddisk. 
  158.  
  159. When the FixPak Installation window appears and the Install button has been 
  160. enabled (this can take a few minutes), select one or more products from the 
  161. "Serviceable Products" window then press the "Install" button to begin. 
  162.  
  163. You can use "Advanced" to use SERVICE.EXE rather than FSERVICE.EXE if you 
  164. prefer. 
  165.  
  166.  
  167. ΓòÉΓòÉΓòÉ 6. Backing out a FixPak from one partition ΓòÉΓòÉΓòÉ
  168.  
  169. Follow these steps to backout a FixPak from one partition. 
  170.  
  171. When the FixPak Installation window appears and the Uninstall button has been 
  172. enabled (this can take a few minutes), select one or more products from the 
  173. "Serviceable Products" window then press the "Uninstall" button to begin. 
  174.  
  175. You can use "Advanced" to use SERVICE.EXE rather than FSERVICE.EXE if you 
  176. prefer. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 7. Error recovery ΓòÉΓòÉΓòÉ
  180.  
  181. If you experience any of these problems, follow the recovery procedure outlined 
  182. to get your system back to a normal, working state. 
  183.  
  184.  
  185. ΓòÉΓòÉΓòÉ 7.1. Application Interrupted ΓòÉΓòÉΓòÉ
  186.  
  187. Something happened during the application of a previous FixPak. You need to 
  188. complete that installation before starting another. 
  189.  
  190. You can use this program to continue (RETRY) the interrupted FixPak apply. The 
  191. correct program (SERVICE.EXE or FSERVICE.EXE) will be called. 
  192.  
  193. If this fails then you need to resolve the problem causing the failure before 
  194. continuing. 
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ 7.2. Previous FixPak not complete ΓòÉΓòÉΓòÉ
  198.  
  199. The previous FixPak completed but there were files deferred until you reboot 
  200. your system at which time the IBM Locked File Device Driver (IBMCSFLK) would 
  201. copy the deferred files from the staging area to the correct location on your 
  202. harddisk. 
  203.  
  204. You must reboot before you can attempt any other FixPak services. Shutdown your 
  205. system and press Ctrl+Alt+Del and let this occur. 
  206.  
  207.  
  208. ΓòÉΓòÉΓòÉ 7.3. Syntax error on line n of response file ΓòÉΓòÉΓòÉ
  209.  
  210. This is usually caused by not specifying a fully qualified path for the Archive 
  211. and/or Backup directories.  Since this program handles this for you, you should 
  212. never see this message.  The only time it would occur is if you have manually 
  213. edited the response file before doing a RETRY run or you used the "Advanced" 
  214. method and did specified a Archive and/or Backup directory incorrectly. 
  215.  
  216.  
  217. ΓòÉΓòÉΓòÉ 8. Components of the FixPak Installation window ΓòÉΓòÉΓòÉ
  218.  
  219. This is what the OS2SERV window looked like when installing Warp 4 FixPak 7 to 
  220. my work system. 
  221.  
  222. Window Component                  Component Description 
  223.  
  224. View Readme                       Uses the E editor (E.EXE) to look at 
  225.                                   README.1ST of the FixPak being installed. 
  226.  
  227. View Log                          Uses the E editor (E.EXE) to look at 
  228.                                   \OS2\INSTALL\SERVICE.LOG file.  This is where 
  229.                                   all FixPak activity is recorded. 
  230.  
  231. About                             Displays the build version and date 
  232.                                   information for this program. 
  233.  
  234. Status window                     Keeps you informed of what is currently going 
  235.                                   on.  It will also prompt you when necessary. 
  236.  
  237. Serviceable Products window       Displays the list of products found on your 
  238.                                   harddrive(s) that can be serviced by a this 
  239.                                   FixPak.  Select the product or products you 
  240.                                   want to apply this FixPak to then press 
  241.                                   "Install" or "Uninstall" button. 
  242.  
  243. Advanced check box                Select this box to use the SERVICE.EXE GUI 
  244.                                   rather than run FSERVICE.EXE with a response 
  245.                                   file.  This allows you a little more control 
  246.                                   over the Fixpak Install or Uninstall process. 
  247.  
  248. Replace Newer check box           Select this box to automatically replace 
  249.                                   files on your harddisk which have a later 
  250.                                   date/time or revision level.  Leave unchecked 
  251.                                   to not replace newer files.  (This option is 
  252.                                   not available yet, waiting on a CSF change to 
  253.                                   support it.) 
  254.  
  255. Install button                    Disabled until all preliminary work has been 
  256.                                   done.  Checks to make sure you have enough 
  257.                                   free space on the required drives, builds a 
  258.                                   response file and calls FSERVICE.EXE.  See 
  259.                                   the README.1St file of each FixPak for 
  260.                                   harddisk space requirements. 
  261.  
  262. Uninstall button                  Disabled until all preliminary work has been 
  263.                                   done.  Only enabled if there is a 
  264.                                   Archive/Backout directory that alredy exists 
  265.                                   from a previous FixPak install on one of the 
  266.                                   drives where a supported product was found. 
  267.  
  268.                                   Builds a response file and calls 
  269.                                   FSERVICE.EXE.  If there is an existing 
  270.                                   Backout directory then it will backout to 
  271.                                   that level.  If not then it will backout to 
  272.                                   the Archive directory level. 
  273.  
  274. Help button                       Displays this online INF file via the View 
  275.                                   command. 
  276.  
  277. Exit button                       Closes the window and exits the program. 
  278.  
  279.  
  280. ΓòÉΓòÉΓòÉ 9. Creating the FixPak Source and CSF Source directories ΓòÉΓòÉΓòÉ
  281.  
  282. The easiest way to create the FixPak source and CSF source directories is to 
  283. LOADDSKF each FixPak disk image to a VFDISK (Virtual Floppy Disk) then XCOPY 
  284. the VFDISK to a partition on your harddisk. 
  285.  
  286. VFDISK is available internally from the OS2TOOLS repository.  Externally there 
  287. are several VFDISK-like programs available. 
  288.  
  289.  In these examples, I:  is the VFDISK, F:\FIXPAKS is the root directory where 
  290. the OS2SERV and CSF code will be placed and XR_W036 is a FixPak we are working 
  291. with. 
  292.  
  293.  Follow these steps to create the FixPak directory: 
  294.  
  295.     1. LOADDSKF XR_W036.1DK I: /f/y/q
  296.     2. XCOPY I:\*.* F:\FIXPAKS\XR_W036\ /h/o/t/s/e/r/v
  297.     3. LOADDSKF XR_W036.2DK I: /f/y/q
  298.     4. XCOPY I:\*.* F:\FIXPAKS\XR_W036\ /h/o/t/s/e/r/v
  299.     5. repeat for remainder of FixPak disks
  300.  
  301. Follow these steps to create the CSF redirected install directory: 
  302.  
  303. CSF F.137B build: 
  304.  
  305.     1. LOADDSKF CSFBOOT.1DK I: /f/y/q
  306.     2. XCOPY I:\*.* F:\FIXPAKS\CSF\ /h/o/t/s/e/r/v
  307.     3. LOADDSKF CSFBOOT.2DK I: /f/y/q
  308.     4. XCOPY I:\*.* F:\FIXPAKS\CSF\ /h/o/t/s/e/r/v
  309.  
  310. CSF F.138B build: 
  311.  
  312.     1. Copy FIXT138B.EXE to the F:\FIXPAKS\CSF directory
  313.     2. Enter FIXT138B
  314.     3. Delete FIXT138B.EXE
  315.  
  316. This will end up creating a directory structure that looks like this: 
  317.  
  318.     F:\FIXPAKS\                    Holds OS2SERVICE files
  319.     F:\FIXPAKS\CSF                 Holds CSF code
  320.     F:\FIXPAKS\XR_W036             Root of FixPak 36, readmes
  321.     F:\FIXPAKS\XR_W036\FIX
  322.     F:\FIXPAKS\XR_W036\FIX\OS2.1   Common files
  323.     F:\FIXPAKS\XR_W036\FIX\OS2.2   UNI files
  324.     F:\FIXPAKS\XR_W036\FIX\OS2.3   Warp for Windows (red) files
  325.     F:\FIXPAKS\XR_W036\FIX\OS2.4   Warp with WINOS2 (blue) files
  326.     F:\FIXPAKS\XR_W036\FIX\OS2.5   SMP files
  327.     F:\FIXPAKS\XR_W036\FIX\MPM.6   Multimedia files
  328.     F:\FIXPAKS\XR_W036\FIX\OS2.7   WINOS2 UNI files
  329.     F:\FIXPAKS\XR_W036\FIX\OS2.8   ULS/Registry UNI files
  330.  
  331. For a Warp 4 FixPak like 7, the directory structure would be: 
  332.  
  333.     F:\FIXPAKS\                    Holds OS2SERVICE files
  334.     F:\FIXPAKS\CSF                 Holds CSF code
  335.     F:\FIXPAKS\XR_M007             Root of FixPak 7, readmes
  336.     F:\FIXPAKS\XR_M007\FIX
  337.     F:\FIXPAKS\XR_M007\FIX\OS2.1   Common files
  338.     F:\FIXPAKS\XR_M007\FIX\OS2.2   Warp 4 (Merlin) files
  339.     F:\FIXPAKS\XR_M007\FIX\OS2.3   WSOD files
  340.