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