home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1998 February / PCOnline_02_1998.iso / filesbbs / os2 / xrgm005.arj / XRGM005.ZIP / XRGM005.1DK / README.CID < prev    next >
Encoding:
Text File  |  1996-05-20  |  9.6 KB  |  254 lines
  1.  
  2. Installing FixPaks via CID
  3.  
  4.  
  5. Kicker diskettes are required for installing OS/2 FixPaks and LAN Server
  6. (LS) Customer Service Diskettes (which are called FixPaks here). This
  7. includes installing these FixPaks via IBM's Configuration Installation
  8. Distribution (CID) process.
  9.  
  10. This README assumes that you can do a standard manual installation of a
  11. FixPak on your system, before you set up a complex CID installation and
  12. then find that the FixPak does not work on your system.
  13.  
  14. The installation kicker diskettes are different from the FixPak data
  15. diskettes. The same kicker diskettes can be used to install several
  16. different FixPaks, including all current OS/2 and LAN Server FixPaks,
  17. and certain other products such as DCAF and NetView.
  18.  
  19. The following information describes how to use these kicker diskettes to
  20. install the FixPaks.
  21.  
  22. CID Server Setup
  23. ________________
  24.  
  25. Step 1. On the CID server, create a new directory for
  26. the FixPak. Here, let's name the directory FIXPAK.
  27.  
  28. Step 2. Use the XCOPY command with the /S parameter to copy all of the
  29. FixPak data diskettes (for either OS/2 or LAN Server) into the FIXPAK
  30. directory.
  31.  
  32. Step 3. XCOPY the single LS kicker diskette into the FIXPAK directory.
  33. (You can XCOPY the second OS/2 FixPak kicker diskette into the FIXPAK
  34. directory if you do not have the LS kicker diskette.)
  35.  
  36. Create a Response File
  37. ______________________
  38.  
  39. Step 4. To install an OS/2 FixPak, create an FSERVICE response file,
  40. using the contents of RESPONSE.FIL in the FIXPAKS directory as the
  41. basis (see Figure 1).
  42.  
  43. :LOGFILE \OS2\INSTALL\SERVICE.LOG
  44. :FLAGS REPLACE_PROTECTED REPLACE_NEWER
  45. :SOURCE A:\
  46. :SERVICE
  47. :SYSLEVEL \OS2\INSTALL\SYSLEVEL.OS2
  48. :ARCHIVE \ARCHIVE
  49.  
  50. Figure 1. RESPONSE.FIL for Installing OS/2 FixPak
  51.  
  52. When modifying RESPONSE.FIL, be very careful not to resequence any of
  53. the statements. Incorrect sequencing is a common cause of problems.
  54.  
  55. To service a product that resides in a specific partition, the response
  56. file keyword :SYSLEVEL is used. For example,
  57. :SYSLEVEL D:\OS2\INSTALL\SYSLEVEL.OS2
  58. will only service the OS/2 product that already resides in the D:
  59. partition.
  60.  
  61. There is no need to change the :SOURCE statement, because the /S:
  62. command-line parameter used for the FSERVICE invokation overrides the
  63. :SOURCE keyword in the response file. Also, the /L1: command-line
  64. parameter overrides the :LOGFILE keyword.
  65.  
  66. It is okay to remove or remark out the :LOGFILE statement, but the
  67. :SOURCE statement must always be present, even if it is not used.
  68.  
  69. The default OS/2 response file does not assign drive letters to
  70. :SYSLEVEL and :ARCHIVE.  This will cause the FSERVICE exec to search
  71. all partitions to locate the OS/2 product, and update all partitions
  72. where it finds a version of OS/2 that is the correct version for the
  73. FixPak.  If you remove the parameter from :SYSLEVEL then FSERVICE will
  74. service all products found in the FixPak on all partitions where the
  75. products exist.
  76.  
  77. Executing FSERVICE
  78. __________________
  79.  
  80. Step 5. Execute FSERVICE to install the FixPak. Figure 2 lists the
  81. parameters that can be used.
  82.  
  83. /S:   the source path pointing to the FIXPAKS directory on the CID
  84.         server
  85. /R:   drive:\path\filename of the response file
  86. /L1:  drive:\path\filename of the log file
  87. /T:   (optional) drive:\path to be used if booted from the SEMAINT
  88.         environment; should be set to the same parameter value used in
  89.         the SEMAINT call
  90. /CID  (optional) to be used for unattended installation
  91. /SF:  do not use for CID install
  92.  
  93. Figure 2. FSERVICE Parameters
  94.  
  95. Figure 3 gives an example of invoking the FSERVICE exec. Depending on
  96. what the response file contains, the call in Figure 3 could be used to
  97. install a FixPak, back out a FixPak, or commit a FixPak (so that the
  98. FixPak cannot be backed out once it is installed). All code in Figure 3
  99. must be on a single command line.
  100.  
  101. x:\csd\fixpak\fservice
  102.   /s:x:\csd\fixpak
  103.   /r:x:\csd\fixpak\response.fil
  104.   /cid
  105.   /t:c:\service
  106.   /l1:x:\log\fixpak\service.log
  107.  
  108. Figure 3. Invoking FSERVICE
  109.  
  110. The /T: Parameter
  111. _________________
  112.  
  113. If you boot OS/2 from a hard drive and the environment variable
  114. REMOTE_INSTALL_STATE is set to 0 or 1, you must use the /T: parameter.
  115. If you boot from a hard drive and the REMOTE_INSTALL_STATE environment
  116. variable is not defined, you should not use the /T: parameter. If you
  117. boot from diskette, /T: is ignored.
  118.  
  119. FSERVICE uses the /T: parameter to decide whether a file should be
  120. updated. If the first part of the path to a file is equal to the /T:
  121. parameter, then FSERVICE will not update that file, because files in
  122. the maintenance directory (created by SEMAINT) should not be updated.
  123.  
  124. Whether to Run SEMAINT
  125. ______________________
  126.  
  127. The best and safest way to install an OS/2 FixPak is in a maintenance
  128. mode. You can install an OS/2 FixPak while booted in normal OS/2 PM
  129. mode, but problems may occur. If you install the FixPak while in the
  130. OS/2 PM mode you must reboot the system as soon as possible after the
  131. FixPak install completes. If you install two FixPaks in a row then
  132. reboot the system the locked file device driver will not work correctly.
  133.  
  134. There are two standard ways to enter maintenance mode -- you can use
  135. SEMAINT to generate a maintenance boot environment, or you can boot from
  136. diskette. If you are going to install several fixes at one time, using
  137. SEMAINT will save time because it requires fewer reboots and no
  138. processing of locked files.
  139.  
  140. To use SEMAINT, you must make changes to the way you invoke FSERVICE.
  141. FSERVICE cleans up a maintenance directory created by SEMAINT if the
  142. /T: parameter is used and the system is booted from a hard drive.
  143.  
  144. You should only use the /T: parameter in the first FSERVICE call you
  145. make. You need to remove or not use the /T: parameter in all other calls
  146. to FSERVICE. This is necessary because the /T: parameter may cause a
  147. file that was already updated to be restored to the original level.
  148.  
  149. If you use SEMAINT, do not use the /S2: parameter. The /S2: parameter
  150. should only be used if installing OS/2 ServicePak XR_6200 or XR_6300.
  151.  
  152. Removing an Installed FixPak
  153. ____________________________
  154.  
  155. To back out a FixPak that has already been installed, use the response
  156. file shown below.
  157.  
  158. :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  159. :TARGET ARCHIVE
  160. :BACKOUT
  161. :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  162.  
  163. When backing out a FixPak, the FSERVICE parameter /S: should point to
  164. the FIXPAK directory on the CID server, because FSERVICE needs to find
  165. the product information files for the FixPak that it will back out.
  166.  
  167. Some Troubleshooting
  168. ____________________
  169.  
  170. If problems occur during a FixPak installation, it may be necessary to
  171. delete or rename the LOGF0000.??? and the LOGFSTART.??? files from the
  172. target client system and to remove the ARCHIVE directory. These steps
  173. are frequently needed when a previous FixPak installation started but
  174. failed to finish.
  175.  
  176. The current OS/2 FixPak boot diskettes are based on OS/2 Warp code. The
  177. system can be booted from either OS/2 2.11 or OS/2 Warp to install the
  178. FixPak; however, a problem may occur if the system was booted with OS/2
  179. 2.11 when you apply a FixPak. The problem occurs if FSERVICE finds the
  180. OS/2 Warp file SHPIINST.DLL from the FixPak boot diskette. The fix for
  181. this problem is to replace the SHPIINST.DLL file in the FixPak directory
  182. with an OS/2 2.11 version.
  183.  
  184. When installing a FixPak for LS 4.0 or some other product, you may need
  185. to change the response file keyword <code> :SYSLEVEL <end code> to point
  186. to the correct SYSLEVEL.??? file for that product.
  187.  
  188. You may need to remove or remark out the response file keyword :ARCHIVE
  189. if archiving is turned off for the FixPak. This is the case for many LS
  190. FixPaks.
  191.  
  192. You can archive to a LAN drive. You can archive files for different
  193. products to the same directory.
  194.  
  195. You must always use the same archive directory for the same product. If
  196. you install an OS/2 FixPak and a previous OS/2 FixPak was installed on
  197. the system, you must use the same archive directory as used before. You
  198. can change the archive directory with a special response file keyword,
  199. :REDIRECT.
  200.  
  201. To update several products, you may need several pairs of :SERVICE and
  202. :SYSLEVEL parameters for each product.
  203.  
  204. Using NvDM/2 and LCU
  205. ____________________
  206.  
  207. Users of NetView Distribution Manager for OS/2 (NvDM/2), IBM's premier
  208. CID process, should refer to Figure 4 for a sample profile. For users
  209. of LAN CID Utility (LCU), the standard CID process, see the REXX command
  210. file product definition example in Figure 5.
  211.  
  212. TargetDir = "C:\SERVICE"
  213. CompNameLen = 4
  214.  
  215. Section Catalog
  216. Begin
  217.   ObjectType = SOFTWARE
  218.   GlobalName = FIXPAK.WARP.17.C.REF.1.0
  219.   Description = WARP FixPak 17 on C:
  220. End
  221.  
  222. Section Install
  223. Begin
  224.   Program = SA:\IMG\FIXW17\FSERVICE.EXE
  225.   Parms = "/S:$(SourceDir) /T:$(TargetDir)
  226.     /R:$(SA)\IMG\FIXW17\SERVICEC.RSP /L1:$(Logfile1)"
  227.   SourceDir =  SA:\IMG\FIXW17
  228.   LogFile1 = SB:\LOGS\OS2\$(WorkStatName).FIX
  229. End
  230.  
  231. Figure 4. NvDM/2 Profile Example
  232.  
  233.  
  234. x.fixpak = 9
  235. x.9.name='WARP FixPak 17'
  236. x.9.statevar = 'CAS_' || x.9.name
  237. x.9.instprog = 'x:\img\fixw17\fservice.exe ',
  238.                '/S:x:\img\fixw17 ',
  239.                '/L1:y:\logs\os2\' || client || '.fix ',
  240.                '/CID ',
  241.                '/R:'
  242. x.9.rspdir = 'x:\img\fixw17'
  243. x.9.default = 'response.fil'
  244.  
  245. Figure 5. LCU REXX Example
  246.  
  247. SERVICE/FSERVICE Differences
  248. ____________________________
  249.  
  250. The Fixtool utility SERVICE will not work from a LAN drive.  This is
  251. working as designed. SERVICE will only work from "removable" media
  252. such as floppy diskette and CDROM.  FSERVICE is designed to work from
  253. floppy diskette, CDROM, hard drive, LAN drive, etc.
  254.