home *** CD-ROM | disk | FTP | other *** search
/ Enter 2000 January / ENTER1_1.iso / OS2 / FIX11PL / readme.cid < prev    next >
Encoding:
Text File  |  1999-11-12  |  13.7 KB  |  501 lines
  1. <        CID and OS/2 Warp
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.         
  18.  
  19.         
  20.         
  21.  
  22.  
  23.  
  24.         July 9, 1998
  25.  
  26.         
  27.         
  28.         
  29.         
  30.         OS/2 Fix Distribution
  31.         Network Computing Software
  32.         Austin, Tx
  33.         
  34.         
  35.         
  36.         
  37.         
  38.         (c) Copyright International Business Machines Corporation, 1997.
  39.         All rights Reserved.
  40.  
  41.         July 9, 1998 - Warp CID
  42.  
  43.  
  44.  
  45.  
  46.                             July 9, 1998 - Warp CID
  47.  
  48.    CONTENTS
  49.  
  50.  
  51.      1.0 Installing FixPaks via CID  . . . . . . . . . . . . . . . . . . . 1
  52.      1.1  CID Server Setup   . . . . . . . . . . . . . . . . . . . . . . . 1
  53.      1.2  Create a Response File   . . . . . . . . . . . . . . . . . . . . 1
  54.      1.3 Executing FSERVICE  . . . . . . . . . . . . . . . . . . . . . . . 2
  55.        1.3.1 The /T: Parameter   . . . . . . . . . . . . . . . . . . . . . 3
  56.      1.4 Whether to Run SEMAINT  . . . . . . . . . . . . . . . . . . . . . 3
  57.      1.5 Removing an Installed FixPak  . . . . . . . . . . . . . . . . . . 4
  58.      1.6 Some Troubleshooting  . . . . . . . . . . . . . . . . . . . . . . 4
  59.      1.7 Using NvDM/2 and LCU  . . . . . . . . . . . . . . . . . . . . . . 5
  60.      1.8 SERVICE/FSERVICE Differences  . . . . . . . . . . . . . . . . . . 6
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.    
  101.                                                                 Contents  ii
  102.  
  103.  
  104.                             July 9, 1998 - Warp CID
  105.  
  106.    FIGURES
  107.  
  108.      Figure 1. RESPONSE.FIL for Installing OS/2 FixPak   . . . . . . . . . 1
  109.      Figure 2. FSERVICE Parameters   . . . . . . . . . . . . . . . . . . . 2
  110.      Figure 3. Invoking FSERVICE   . . . . . . . . . . . . . . . . . . . . 3
  111.      Figure 4. NvDM/2 Profile Example  . . . . . . . . . . . . . . . . . . 5
  112.      Figure 5. LCU REXX Example  . . . . . . . . . . . . . . . . . . . . . 6
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.    
  159.                                                                 Figures  iii
  160.  
  161.  
  162.                             July 9, 1998 - Warp CID
  163.  
  164.    1.0 INSTALLING FIXPAKS VIA CID
  165.  
  166.    Kicker diskettes are required for installing OS/2 FixPaks and LAN Server
  167.    (LS) Customer Service Diskettes (which are called FixPaks here). This
  168.    includes installing these FixPaks via IBM's Configuration Installation
  169.    Distribution (CID) process.
  170.  
  171.    This README assumes that you can do a standard manual installation of a
  172.    FixPak on your system, before you set up a complex CID installation and
  173.    then find that the FixPak does not work on your system.
  174.  
  175.    The installation kicker diskettes are different from the FixPak data
  176.    diskettes. The same kicker diskettes can be used to install several
  177.    different FixPaks, including all current OS/2 and LAN Server FixPaks, and
  178.    certain other products such as DCAF and NetView.
  179.  
  180.    The following information describes how to use these kicker diskettes to
  181.    install the FixPaks.
  182.  
  183.  
  184.  
  185.    1.1  CID SERVER SETUP
  186.  
  187.    ■  On the CID server, create a new directory for the FixPak. Here, let's
  188.       name the directory FIXPAK.
  189.    ■  Use the XCOPY command with the /S parameter to copy all of the FixPak
  190.       data diskettes (for either OS/2 or LAN Server) into the FIXPAK
  191.       directory.
  192.    ■  XCOPY the single LS kicker diskette into the FIXPAK directory.  (You
  193.       can XCOPY the second OS/2 FixPak kicker diskette into the FIXPAK
  194.       directory if you do not have the LS kicker diskette.)
  195.  
  196.  
  197.  
  198.  
  199.    1.2  CREATE A RESPONSE FILE
  200.  
  201.    ■  To install an OS/2 FixPak, create an FSERVICE response file, using the
  202.       contents of RESPONSE.FIL in the FIXPAKS directory as the basis (see
  203.       Figure 1).
  204.  
  205.    ─────────────────────────────────────────────────────────────────────────
  206.    :LOGFILE \OS2\INSTALL\SERVICE.LOG
  207.    :FLAGS REPLACE_PROTECTED REPLACE_NEWER
  208.    :SOURCE A:\
  209.    :SERVICE
  210.    :SYSLEVEL \OS2\INSTALL\SYSLEVEL.OS2
  211.    :ARCHIVE \ARCHIVE
  212.  
  213.    Figure 1. RESPONSE.FIL for Installing OS/2 FixPak
  214.    ─────────────────────────────────────────────────────────────────────────
  215.  
  216.    
  217.                                                Installing FixPaks via CID  1
  218.  
  219.  
  220.                             July 9, 1998 - Warp CID
  221.  
  222.    When modifying RESPONSE.FIL, be very careful not to resequence any of the
  223.    statements. Incorrect sequencing is a common cause of problems.
  224.  
  225.    To service a product that resides in a specific partition, the response
  226.    file keyword :SYSLEVEL is used. For example,
  227.  
  228.       :SYSLEVEL D:\OS2\INSTALL\SYSLEVEL.OS2
  229.  
  230.  
  231.    will only service the OS/2 product that already resides in the D:
  232.    partition.
  233.  
  234.    There is no need to change the :SOURCE statement, because the /S:
  235.    command-line parameter used for the FSERVICE invocation overrides the
  236.    :SOURCE keyword in the response file. Also, the /L1: command-line
  237.    parameter overrides the :LOGFILE keyword.
  238.  
  239.    It is okay to remove or remark out the :LOGFILE statement, but the
  240.    :SOURCE statement must always be present, even if it is not used.
  241.  
  242.    The default OS/2 response file does not assign drive letters to :SYSLEVEL
  243.    and :ARCHIVE.  This will cause the FSERVICE exec to search all partitions
  244.    to locate the OS/2 product, and update all partitions where it finds a
  245.    version of OS/2 that is the correct version for the FixPak.  If you
  246.    remove the parameter from :SYSLEVEL then FSERVICE will service all
  247.    products found in the FixPak on all partitions where the products exist.
  248.  
  249.  
  250.  
  251.    1.3 EXECUTING FSERVICE
  252.  
  253.    ■  Execute FSERVICE to install the FixPak. Figure 2 lists the parameters
  254.       that can be used.
  255.  
  256.    ─────────────────────────────────────────────────────────────────────────
  257.    /S:   the source path pointing to the FIXPAKS directory on the CID
  258.              server.
  259.    /R:   drive:\path\filename of the response file
  260.    /L1:  drive:\path\filename of the log file
  261.    /T:   (optional) drive:\path to be used if booted from the SEMAINT
  262.              environment; should be set to the same parameter value used in
  263.              the SEMAINT call
  264.    /CID  (optional) to be used for unattended installation
  265.    /SF:  do not use for CID install
  266.  
  267.    Figure 2. FSERVICE Parameters
  268.    ─────────────────────────────────────────────────────────────────────────
  269.  
  270.    Figure 3 on page 3 gives an example of invoking the FSERVICE exec.
  271.    Depending on what the response file contains, the call in Figure 3 on
  272.    page 3 could be used to install a FixPak, back out a FixPak, or commit a
  273.  
  274.    
  275.                                                Installing FixPaks via CID  2
  276.  
  277.  
  278.                             July 9, 1998 - Warp CID
  279.  
  280.    FixPak (so that the FixPak cannot be backed out once it is installed).
  281.    All code in Figure 3 must be on a single command line.
  282.  
  283.    ─────────────────────────────────────────────────────────────────────────
  284.    x:\csd\fixpak\fservice
  285.      /s:x:\csd\fixpak
  286.      /r:x:\csd\fixpak\response.fil
  287.      /cid /t:c:\service
  288.      /l1:x:\log\fixpak\service.log
  289.  
  290.    Figure 3. Invoking FSERVICE
  291.    ─────────────────────────────────────────────────────────────────────────
  292.  
  293.  
  294.  
  295.  
  296.    1.3.1 THE /T: PARAMETER
  297.  
  298.    If you boot OS/2 from a hard drive and the environment variable
  299.    REMOTE_INSTALL_STATE is set to 0 or 1, you must use the /T: parameter.
  300.    If you boot from a hard drive and the REMOTE_INSTALL_STATE environment
  301.    variable is not defined, you should not use the /T: parameter. If you
  302.    boot from diskette, /T: is ignored.
  303.  
  304.    FSERVICE uses the /T: parameter to decide whether a file should be
  305.    updated. If the first part of the path to a file is equal to the /T:
  306.    parameter, then FSERVICE will not update that file, because files in the
  307.    maintenance directory (created by SEMAINT) should not be updated.
  308.  
  309.  
  310.  
  311.    1.4 WHETHER TO RUN SEMAINT
  312.  
  313.    The best and safest way to install an OS/2 FixPak is in a maintenance
  314.    mode. You can install an OS/2 FixPak while booted in normal OS/2 PM mode,
  315.    but problems may occur. If you install the FixPak while in the OS/2 PM
  316.    mode you must reboot the system as soon as possible after the FixPak
  317.    install completes. If you install two FixPaks in a row then reboot the
  318.    system the locked file device driver will not work correctly.
  319.  
  320.    There are two standard ways to enter maintenance mode -- you can use
  321.    SEMAINT to generate a maintenance boot environment, or you can boot from
  322.    diskette. If you are going to install several fixes at one time, using
  323.    SEMAINT will save time because it requires fewer reboots and no
  324.    processing of locked files.
  325.  
  326.    To use SEMAINT, you must make changes to the way you invoke FSERVICE.
  327.    FSERVICE cleans up a maintenance directory created by SEMAINT if the /T:
  328.    parameter is used and the system is booted from a hard drive.
  329.  
  330.  
  331.  
  332.    
  333.                                                Installing FixPaks via CID  3
  334.  
  335.  
  336.                             July 9, 1998 - Warp CID
  337.  
  338.    You should only use the /T: parameter in the first FSERVICE call you
  339.    make. You need to remove or not use the /T: parameter in all other calls
  340.    to FSERVICE. This is necessary because the /T: parameter may cause a file
  341.    that was already updated to be restored to the original level.
  342.  
  343.    If you use SEMAINT, do not use the /S2: parameter. The /S2: parameter
  344.    should only be used if installing OS/2 ServicePak XR_6200 or XR_6300.
  345.  
  346.  
  347.  
  348.    1.5 REMOVING AN INSTALLED FIXPAK
  349.  
  350.    To back out a FixPak that has already been installed, use the response
  351.    file shown below.
  352.  
  353.       :LOGFILE C:\OS2\INSTALL\SERVICE.LOG
  354.       :TARGET ARCHIVE
  355.       :BACKOUT
  356.       :SYSLEVEL C:\OS2\INSTALL\SYSLEVEL.OS2
  357.  
  358.  
  359.    When backing out a FixPak, the FSERVICE parameter /S: should point to the
  360.    FIXPAK directory on the CID server, because FSERVICE needs to find the
  361.    product information files for the FixPak that it will back out.
  362.  
  363.  
  364.  
  365.    1.6 SOME TROUBLESHOOTING
  366.  
  367.    If problems occur during a FixPak installation, it may be necessary to
  368.    delete or rename the LOGF0000.??? and the LOGFSTART.??? files from the
  369.    target client system and to remove the ARCHIVE directory. These steps are
  370.    frequently needed when a previous FixPak installation started but failed
  371.    to finish.
  372.  
  373.    The current OS/2 FixPak boot diskettes are based on OS/2 Warp code. The
  374.    system can be booted from either OS/2 2.11 or OS/2 Warp to install the
  375.    FixPak; however, a problem may occur if the system was booted with OS/2
  376.    2.11 when you apply a FixPak. The problem occurs if FSERVICE finds the
  377.    OS/2 Warp file SHPIINST.DLL from the FixPak boot diskette. The fix for
  378.    this problem is to replace the SHPIINST.DLL file in the FixPak directory
  379.    with an OS/2 2.11 version.
  380.  
  381.    When installing a FixPak for LS 4.0 or some other product, you may need
  382.    to change the response file keyword <code> :SYSLEVEL <end code> to point
  383.    to the correct SYSLEVEL.??? file for that product.
  384.  
  385.    You may need to remove or remark out the response file keyword :ARCHIVE
  386.    if archiving is turned off for the FixPak. This is the case for many LS
  387.    FixPaks.
  388.  
  389.  
  390.    
  391.                                                Installing FixPaks via CID  4
  392.  
  393.  
  394.                             July 9, 1998 - Warp CID
  395.  
  396.    You can archive to a LAN drive. You can archive files for different
  397.    products to the same directory.
  398.  
  399.    You must always use the same archive directory for the same product. If
  400.    you install an OS/2 FixPak and a previous OS/2 FixPak was installed on
  401.    the system, you must use the same archive directory as used before. You
  402.    can change the archive directory with a special response file keyword,
  403.    :REDIRECT.
  404.  
  405.    To update several products, you may need several pairs of :SERVICE and
  406.    :SYSLEVEL parameters for each product.
  407.  
  408.  
  409.  
  410.    1.7 USING NVDM/2 AND LCU
  411.  
  412.    Users of NetView Distribution Manager for OS/2 (NvDM/2), IBM's premier
  413.    CID process, should refer to Figure 4 for a sample profile. For users of
  414.    LAN CID Utility (LCU), the standard CID process, see the REXX command
  415.    file product definition example in Figure 5 on page 6.
  416.  
  417.    ─────────────────────────────────────────────────────────────────────────
  418.    TargetDir = "C:\SERVICE"
  419.    CompNameLen = 4
  420.  
  421.    Section Catalog
  422.    Begin
  423.      ObjectType = SOFTWARE
  424.      GlobalName = FIXPAK.WARP.17.C.REF.1.0
  425.      Description = WARP FixPak 17 on C:
  426.    End
  427.  
  428.    Section Install
  429.    Begin
  430.      Program = SA:\IMG\FIXW17\FSERVICE.EXE
  431.      Parms = "/S:$(SourceDir) /T:$(TargetDir)
  432.        /R:$(SA)\IMG\FIXW17\SERVICEC.RSP /L1:$(Logfile1)"
  433.      SourceDir =  SA:\IMG\FIXW17
  434.      LogFile1 = SB:\LOGS\OS2\$(WorkStatName).FIX
  435.    End
  436.  
  437.    Figure 4. NvDM/2 Profile Example
  438.    ─────────────────────────────────────────────────────────────────────────
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.    
  449.                                                Installing FixPaks via CID  5
  450.  
  451.  
  452.                             July 9, 1998 - Warp CID
  453.  
  454.    ─────────────────────────────────────────────────────────────────────────
  455.  
  456.    x.fixpak = 9
  457.    x.9.name='WARP FixPak 17'
  458.    x.9.statevar = 'CAS_' || x.9.name
  459.    x.9.instprog = 'x:\img\fixw17\fservice.exe ',
  460.                   '/S:x:\img\fixw17 ',
  461.                   '/L1:y:\logs\os2\' || client || '.fix ',
  462.                   '/CID ',
  463.                   '/R:'
  464.    x.9.rspdir = 'x:\img\fixw17'
  465.    x.9.default = 'response.fil'
  466.  
  467.    Figure 5. LCU REXX Example
  468.    ─────────────────────────────────────────────────────────────────────────
  469.  
  470.  
  471.  
  472.  
  473.    1.8 SERVICE/FSERVICE DIFFERENCES
  474.  
  475.    The Fixtool utility SERVICE will not work from a LAN drive.  This is
  476.    working as designed. SERVICE will only work from "removable" media such
  477.    as floppy diskette and CDROM.  FSERVICE is designed to work from floppy
  478.    diskette, CDROM, hard drive, LAN drive, etc.
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.    
  507.                                                Installing FixPaks via CID  6
  508.  
  509.