home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 28 Fixes4x / 28-Fixes4x.zip / fixt138b.txt < prev    next >
Text File  |  1998-07-02  |  19KB  |  485 lines
  1.                 Readme for Corrective Service Facility 2-B
  2.                               Version 1.38B
  3.  
  4.                       ****************************
  5.  
  6.              THIS FIXTOOL IS ONLY TO BE USED FOR WARP 4, FP 7
  7.  
  8.                       ****************************
  9.  
  10. This readme file describes the new features available with Version 1.38B of the
  11. Corrective Service Facility (referred to in this document as the FixTool).
  12. Once you use the new version of the FixTool to service a product, you will not
  13. be able to use any previous version of the FixTool because the new version
  14. modifies SYSLEVEL files and prior versions do not.
  15.  
  16. CONTENTS:
  17.  
  18. Section 1.  New Features with Version 1.38B
  19. Section 2.  Files Included in the FixTool Zip File
  20. Section 3.  How to Use the FixTool Zip File
  21. Section 4.  How to Apply Service
  22. Section 5.  How to Set Up the FixTool for Remote Installation
  23. Section 6.  How to Customize the Response File
  24. Section 7.  If You Have a Problem
  25. Section 8.  Setting Environment Variables
  26. Section 9.  Common Error Messages
  27. Section 10. Known Problems
  28.  
  29. ================================================
  30.  
  31. Section 1.  New Features with Version 1.38B
  32.  
  33. You can tell if you have Version 1.38B by running BLDLEVEL on SERVICE.EXE or
  34. FSERVICE.EXE.  You will see one of the following, depending on which version of
  35. BLDLEVEL.EXE you have.
  36.  
  37.   Signature:       @#IBM:F.138B#@ OS/2 Corrective Service Facility (C) IBM 1994
  38.   Vendor:          IBM
  39.   Revision:        0.138
  40.   File Version:    0.138
  41.   Description:     OS/2 Corrective Service Facility (C) IBM 1994
  42.  
  43.   Signature:   @#IBM:F.138B#@ OS/2 Corrective Service Facility (C) IBM 1994
  44.   Vendor:      IBM
  45.   Revision:    F.138B
  46.   Description: OS/2 Corrective Service Facility (C) IBM 1994
  47.  
  48. The new version of the FixTool updates the current CSD field in the SYSLEVEL
  49. files of the products it services.  After applying a FixPak with Version 1.38B,
  50. you will be able to run SYSLEVEL and tell what FixPaks you have applied by
  51. looking at the current field of the product's SYSLEVEL file.
  52.  
  53. This version is also compatible with Software Choice features.  If you need to
  54. use Software Choice to install new features for a product, the FixTool will
  55. integrate SYSLEVEL and archive information from the Software Choice install the
  56. next time it services that product.
  57.  
  58.  
  59. Section 2.  Files Included in the FixTool Zip File
  60.  
  61. The following files are included in the FixTool zip file:
  62.  
  63. File            Use
  64. --------------  -----------------------------------------------------------
  65. BUILD.LVL       Contains build information for this Fixtool release.
  66. CSFPANS.DLL     Used by FSERVICE
  67. SERVICE.EXE     Executable for applying service through a windowed session
  68. SERVICE.HLP     SERVICE help file
  69. SHPIINST.DLL    FixTool required DLL
  70. UNPACK.EXE      Used to unpack files being serviced
  71. UNPACK2.EXE     Used to unpack files being serviced
  72. VIOCALLS.DLL    FixTool required DLL
  73. FSERVICE.EXE    Executable for applying service through a command line
  74.                 (used with a response file).
  75. IBMCSFLK.PK@    Locked file device driver and associated files
  76.                 (packed file)
  77. PACK.EXE        Used to pack files being archived or backed up
  78. README.INF      General Installation instructions for the FixTool
  79. RESPONSE.LAN    Response file for servicing network-related products
  80. RESPONSE.WP3    Response file for servicing OS/2 Warp v3 base
  81. RESPONSE.WP4    Response file for servicing OS/2 Warp v4 base
  82. CSF_KICK        Identifier for the FixTool diskette
  83. FSERVICE.MSG    FSERVICE message file
  84. FPINST.CMD      Command file for applying service through FSERVICE
  85.                 (uses standard response files for OS/2 Warp 3, OS/2 Warp 4,
  86.                  and network-related FixPaks)
  87. NLS.DLL         FixTool required DLL
  88. FILEFIX.DL@     FixTool required DLL (packed file)
  89. READ.ME         This file
  90.  
  91. Section 3.  How to Use the FixTool Zip File
  92.  
  93. First, unzip the FixTool zip file onto a diskette or into a directory.  You can
  94. do this by copying the self-extracting zip file into a new subdirectory and
  95. then use the following commands from an OS/2 command prompt:
  96.  
  97.  
  98.         <d>:
  99.         cd <directory>
  100.         fixt138 <target>
  101.  
  102. where <d>         is the drive that you've put the FixTool zip file on,
  103.       <directory> is the directory that you've copied the self-extracting
  104.                   zip file to.
  105.       <target>    is the fully qualified path where the file is to be
  106.                   unzipped to.
  107.  
  108. If <target> is not a diskette, you can also copy all the files in <target>
  109. onto a diskette, except for FIXT138.EXE if you wish.
  110.  
  111. Next, you need OS/2 boot capability.  For this, you can use any of the
  112. following:
  113.  
  114.    - boot the install diskettes for the product you're servicing
  115.    - create utility diskettes from your system and boot these
  116.    - use a maintenance partition if you have one
  117.    - boot through Alt-F1 and go to the command prompt
  118.    - boot OS/2 as usual and then open an OS/2 session
  119.  
  120.  
  121. Section 4.  How to Apply Service
  122.  
  123. Once you have boot capability (see Section 3) and are at a command prompt,
  124. you can apply service using one of the following methods:
  125.  
  126.         Using FPINST
  127.         Using SERVICE
  128.         Using FSERVICE with a custom RESPONSE.FIL
  129.  
  130. Insert the FixTool diskette you created, and then use FPINST or FSERVICE
  131. as described in Sections 4.1 and 4.3.  To use SERVICE as described in
  132. Section 4.2, you must have OS/2 running without having booted from
  133. diskettes, maintenance partition, or via Alt-F1.
  134.  
  135. 4.1.  Using FPINST
  136.  
  137. To use FPINST, go to the diskette or directory where you have FPINST.CMD
  138. and the related files, and type
  139.  
  140.         FPINST <fixpak_type>
  141.  
  142. where   <fixpak_type> is
  143.  
  144.         WARP3     for OS/2 Warp Version 3.0 FixPak installs,
  145.         WARP4     for OS/2 Warp Version 4.0 FixPak installs, or
  146.         NETWORK   for LAN or network-related FixPak installs
  147.  
  148. This uses FSERVICE with a standard response file.  For OS/2 Base FixPaks, the
  149. response file saves an archive copy of the files it services in <boot
  150. drive>:\ARCHIVE.  For LAN or network-related FixPaks, there is no archive or
  151. backup created.  If you want to keep a backup with network-related FixPaks, use
  152. SERVICE or use FSERVICE with a custom RESPONSE.FIL.  See Section 6 for more
  153. information on customizing a response file.
  154.  
  155. 4.2.  Using SERVICE
  156.  
  157. To use SERVICE, go to the diskette or directory where you have SERVICE.EXE and
  158. the related files.  If you have copied the FixTool files to a directory, you
  159. need to use the following command to set the CSFUTILPATH environment variable.
  160. Note that CSFUTILPATH defaults to A:  drive, so this step is not needed if you
  161. are using diskettes for the FixTool.
  162.  
  163.         SET CSFUTILPATH=<d>:\<directory>
  164.  
  165. where <d> is the drive with the FixTool-related files and
  166.       <directory> is the directory structure where you put the FixTool files.
  167.  
  168. Then type
  169.  
  170.         SERVICE
  171.  
  172. The program will prompt you for required inputs.  See README.INF for more
  173. information about these panels.
  174.  
  175. NOTE:  To use SERVICE, you must have the OS/2 PM Shell running.  You cannot
  176.        run SERVICE if you have booted from install diskettes or if you pressed
  177.        Alt-F1 to get to a command prompt.
  178.  
  179. 4.3.  Using FSERVICE
  180.  
  181. To use FSERVICE from a diskette, copy your customized RESPONSE.FIL to the
  182. diskette with the FixTool files, then go to the diskette and type
  183.  
  184.         FSERVICE /R:RESPONSE.FIL
  185.  
  186. If you have copied the FixTool files into a directory, you need to use the
  187. following command from the directory with FSERVICE.EXE and the related files
  188. (including your custom RESPONSE.FIL):
  189.  
  190.         FSERVICE /R:RESPONSE.FIL /S:<d>:\<directory>
  191.  
  192. where <d> is the drive with the FixTool-related files and
  193.       <directory> is the directory structure where you put the FixTool files.
  194.  
  195. There are optional parameters that can be included on the FSERVICE command
  196. line.  See the README.INF file for more details about these parameters.
  197.  
  198.  
  199. Section 5.  How to Set Up the FixTool for Remote Installation
  200.  
  201. If you want to speed up FixPak installation or setup a FixPak on a LAN drive
  202. for use by others (Redirected Install), follow these steps.
  203.  
  204. Before you begin, I strongly recommend you go install a Virtual Floppy Disk
  205. program like SVDISK (Super Virtual Disk) or VFDISK (Virtual Floppy Disk).  Go
  206. to a Web site and search on "virtual floppy" to locate.
  207.  
  208. In the following examples, d:  is the work drive and j: is the Virtual Floppy
  209. drive.  Replace this with whatever drive letters you need to use. xr_w035 is
  210. the FixPak we are working with.
  211.  
  212. First, setup a directory to hold the Fixtool code. For example,
  213. run FIXT138.EXE D:\CSF to place the FixTool into the target directory.
  214.  
  215. Next, setup the FixPak directory using the diskette images.
  216.  
  217.         loaddskf xr_w035.1dk j: /f/y/q
  218.         xcopy j: d:\xr_w035\ /h/o/t/s/e/r/v
  219.         loaddskf xr_w035.2dk j: /f/y/q
  220.         xcopy j: d:\xr_w035\ /h/o/t/s/e/r/v
  221.         ...     ...     ...     ...
  222.         repeat for each disk image in the FixPak
  223.  
  224.  
  225. Install the FixPak by running service.exe.
  226.  
  227.         set csfutilpath=d:\csf
  228.         set csfcdromdir=d:\xr_w035
  229.         d:
  230.         cd csf
  231.         service  (or start service)
  232.  
  233. You can also apply service by running fservice.exe with a response file.
  234.  
  235.         d:
  236.         cd csf
  237.         fservice /r:d:\csf\response.wp3 /s:d:\xr_w035
  238.  
  239.         This will apply the FixPak to all servicable partitions.  If you want
  240.         to make the response file specific to a partition (drive) then you need
  241.         to change the :SYSLEVEL and :ARCHIVE lines in response.wp3:
  242.  
  243.         :SYSLEVEL \OS2\INSTALL\SYSLEVEL.OS2
  244.         :ARCHIVE \ARCHIVE
  245.  
  246.         -- to --
  247.  
  248.         :SYSLEVEL x:\OS2\INSTALL\SYSLEVEL.OS2
  249.         :ARCHIVE x:\ARCHIVE
  250.  
  251. where x: is the drive you want serviced.
  252.  
  253.  
  254. Section 6.  How to Customize the Response File
  255.  
  256. There are three standard response files included with the FixTool that can be
  257. modified for your configuration needs.  To modify a response file, copy one of
  258. the standard response files (RESPONSE.WP3, RESPONSE.WP4, or RESPONSE.LAN) to a
  259. file called RESPONSE.FIL.  Modify the RESPONSE.FIL as needed, and then run
  260. FSERVICE /R:RESPONSE.FIL.
  261.  
  262. The following sections show a few of the service actions you can take through
  263. a response file.  For more information about response files, view the README.INF
  264. file that comes with the FixTool.
  265.  
  266. 6.1.  Applying Service to a Product Without an Existing Archive
  267.  
  268. This response file can be used to apply service for the first time using
  269. FSERVICE when there is no existing archive of the product being serviced.  It
  270. will service all partitions and place an archive in each partition.  It does
  271. not take a backup of changed files.
  272.  
  273. In this case, the SERVICE.LOG file will go into the C:\OS2\INSTALL directory.
  274. Files that are read-only, hidden, system, or newer will be replaced
  275. automatically during service.  The FixPak source files are on A:. The FixTool
  276. will service all partitions where \OS2\INSTALL\SYSLEVEL.OS2 and
  277. \MMOS2\INSTALL\SYSLEVEL.MPM are found, and it will save the original files in
  278. an \ARCHIVE directory for each partition serviced.
  279.  
  280. Note that the :LOGFILE tag is optional and may be overridden by using the /L:
  281. parameter on the FSERVICE command line.  The :FLAGS and :SOURCE tags are also
  282. optional, but if used, the :SERVICE tag must be included.  The :SOURCE tag can
  283. be overridden by using the /S:  parameter on the FSERVICE command line.  You
  284. should include a :SERVICE, :SYSLEVEL, and :ARCHIVE tag for each product to be
  285. serviced.  Note that the :SERVICE, :SYSLEVEL, and :ARCHIVE tags must appear in
  286. the order shown in this example.
  287.  
  288. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  289. :FLAGS REPLACE_PROTECTED REPLACE_NEWER
  290. :SOURCE A:\
  291. :SERVICE
  292. :SYSLEVEL \OS2\INSTALL\SYSLEVEL.OS2
  293. :ARCHIVE \ARCHIVE
  294. :SERVICE
  295. :SYSLEVEL \MMOS2\INSTALL\SYSLEVEL.MPM
  296. :ARCHIVE \ARCHIVE
  297.  
  298. 6.2.  Applying Service to a Product With an Existing Archive
  299.  
  300. This response file can be used to apply service using FSERVICE when there is an
  301. existing archive of the product being serviced.  This demonstrates the ability
  302. to take a backup of changed files.
  303.  
  304. Notice that each product serviced must be backed up to a different directory.
  305. Also note the order of the :SERVICE, :SYSLEVEL, :ARCHIVE, and :BACKUP tags.
  306. These tags must appear in this order.  The :BACKUP tag is optional.
  307.  
  308. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  309. :FLAGS REPLACE_PROTECTED REPLACE_NEWER
  310. :SOURCE A:\
  311. :SERVICE
  312. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  313. :ARCHIVE C:\ARCHIVE
  314. :BACKUP C:\BACKUP
  315. :SERVICE
  316. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  317. :ARCHIVE C:\ARCHIVE
  318. :BACKUP C:\BACKUPM
  319.  
  320. 6.3.  Backing Out to the Archive Level of a Product
  321.  
  322. This is a sample response file to be used when backing out to the archive level
  323. of a product.  Note that you can only use one :TARGET tag in the response file.
  324. Also note that the :TARGET tag must appear before a :BACKOUT tag is used.
  325.  
  326. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  327. :TARGET ARCHIVE
  328. :BACKOUT
  329. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  330. :BACKOUT
  331. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  332.  
  333. 6.4.  Backing Out to the Backup Level of a Product
  334.  
  335. This is a sample response file to be used when backing out to the backup level
  336. of a product.
  337.  
  338. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  339. :TARGET BACKUP
  340. :BACKOUT
  341. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  342. :BACKOUT
  343. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  344.  
  345. 6.5.  Committing a Product
  346.  
  347. This is a sample response file to be used when committing a product.
  348.  
  349. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  350. :COMMIT
  351. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  352. :COMMIT
  353. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  354.  
  355. 6.6.  Redirecting an Archive of a Product to Another Existing Archive
  356.  
  357. This is a sample response file to be used when redirecting an archive of a
  358. product to another existing archive location.  One example of this would be for
  359. using a shared network archive.  Note that the archive directory specifies the
  360. location of an existing archive to which the current product is being
  361. redirected.  In this example the arbitrary drive shows S:, which may be a LAN
  362. drive.
  363.  
  364. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  365. :REDIRECT
  366. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  367. :ARCHIVE S:\ARCHIVE
  368. :REDIRECT
  369. :SYSLEVEL C:\MMOS2\INSTALL\SYSLEVEL.MPM
  370. :ARCHIVE S:\ARCHIVEM
  371.  
  372.  
  373. Section 7.  If You Have a Problem
  374.  
  375. If the FixPak does not install properly, there are files you can look in
  376. to find out what error occurred.  The SERVICE.LOG file is the first place
  377. to look.  The FixTool puts it in the directory where the SYSLEVEL file
  378. of the product being serviced is located.
  379.  
  380.  
  381. Section 8.  Setting Environment Variables
  382.  
  383. There are several SET statements that set environment variables for the
  384. FixTool to use.  See the table below for a list of these variables and
  385. a description of what they do.
  386.  
  387.    Environment Variable              Usage
  388.    -------------------------------   -----------------------------------
  389.    SET CSFUTILPATH=path              Allows you to run SERVICE or
  390.                                      FSERVICE from your hard drive or
  391.                                      from a redirected drive.
  392.  
  393.    SET CSFCDROMDIR=path              Allows you to install a FixPak
  394.                                      from a redirected drive or CD-ROM.
  395.  
  396.    SET REMOTE_INSTALL_STATE=0|1      If this variable is set to 1, then
  397.                                      upon termination FixTool returns
  398.                                      control to the calling process.
  399.  
  400.  
  401. Section 9.  Common Error Messages
  402.  
  403. Here are some common error messages that you may receive when running
  404. SERVICE.
  405.  
  406.     - Error message:
  407.       An error occurred while searching for files to update.
  408.       The reason may be old or corrupt CSF logfiles, CSF_SEL.000
  409.       file, or file system corruption.  See README file for more
  410.       information.
  411.  
  412.       Explanation:
  413.       You may get this if you have used the new FixTool to install
  414.       a FixPak, and then try to use the old FixTool.
  415.  
  416.       Solution:
  417.       If you are installing a LAN FixPak, you can delete all the
  418.       LOGF0000.xxx and LOGSTART.xxx files on your system, and
  419.       reapply the FixPak.  If you are installing an OS/2 FixPak,
  420.       you will also need to copy your original SYSLEVEL.OS2 file
  421.       back into the \OS2\INSTALL directory.
  422.  
  423.     - Error message:
  424.       No products were found on the target system to service.
  425.  
  426.       Explanation:
  427.       Your SYSLEVEL.xxx file does not contain the proper
  428.       pre-requisite FixPak number or product information.  In
  429.       order to install a FixPak, the number of the FixPak must
  430.       be higher than the number of the current CSD in the
  431.       SYSLEVEL.xxx file, or the product information must match.
  432.  
  433.       Solution:
  434.       Check the pre-requisites needed for the FixPak you are
  435.       trying to install.  Some FixPaks have a particular FixPak
  436.       that must be installed prior to installing that FixPak.
  437.       Also, make sure that the FixPak you are trying to install
  438.       is one that may be applied to that product.  If the product
  439.       information is incorrect, you may need to copy the product
  440.       SYSLEVEL.xxx file from the install media.
  441.  
  442. Here's a common error message that you might see when running FSERVICE.
  443.  
  444.     - Error message:
  445.       CSF257: No product has been selected.
  446.  
  447.       Explanation:
  448.       This error message is reported in several situations.  You may
  449.       not have selected a product to service in the RESPONSE.FIL, or
  450.       FSERVICE may not have found any products to service.  If FSERVICE
  451.       didn't find any products to service, either the product information
  452.       on the system did not match the product information in the FixPak,
  453.       or FSERVICE determined that the FixPak would back-level the system.
  454.  
  455.       Solution:
  456.       Check the pre-requisites for the FixPak and make sure that the
  457.       system contains the proper pre-requisites.  Also, be sure that
  458.       the FixPak you are trying to install is being applied to the
  459.       appropriate product.  If the product information is incorrect,
  460.       you may need to copy the product SYSLEVEL.xxx file from the
  461.       install media.
  462.  
  463.  
  464. Section 10.  Known Problems
  465.  
  466. Problem Description:
  467. On some systems, you may get an unpack error for the file IBMCSFLK.PK@.
  468. If this occurs, you will see the following in your SERVICE.LOG file:
  469.  
  470.    Unpack( source, destination ) failed with rc 5.
  471.    Retrying unpack for IBMCSFLK.PK@...
  472.  
  473. where source is the location of the IBMCSFLK.PK@ file, and destination
  474. is the location for the unpacking.
  475.  
  476. It will try to unpack the file several times, and then finally report:
  477.  
  478.    Error unpacking the file IBMCSFLK.PK@.
  479.  
  480. Workaround:
  481. Exit and restart service.  The error should be resolved on the second
  482. attempt.
  483.  
  484.  
  485.