home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 27 Fixes20 / 27-Fixes20.zip / 21ripl.zip / README < prev    next >
Text File  |  1993-05-28  |  34KB  |  849 lines
  1.  
  2.  
  3.  
  4.                     REMOTE IPL SUPPORT FOR OS/2 2.1
  5.  
  6.  
  7.    INTRODUCTION
  8.    ------------
  9.  
  10.    OS/2 2.1 implements several system changes that require significant
  11.    changes to the LAN Server Remoteboot service.  This document describes
  12.    how to install the LAN Server upgrades, how to update the Remote
  13.    IPL (RIPL) client definitions for different display types, and how
  14.    to support multiple versions of the OS/2 operating system in the
  15.    RIPL directory structure.  Know problems are also described.
  16.  
  17.    LAN Server 2.0 or LAN Server 3.0 with the OS/2 Remote IPL service
  18.    must already be installed before applying these updates.  Updates
  19.    are provided for both LAN Server 2.0 and 3.0.  The following files
  20.    are provided on the Remote IPL Service diskette:
  21.  
  22.      - RPLMIG21.CMD        Installation/migration procedure
  23.      - IBMLS.ZIP           Updates common to LAN Server 2.0 and 3.0
  24.      - IBMLS20.ZIP         Updates specific to LAN Server 2.0
  25.      - IBMLS30.ZIP         Updates specific to LAN Server 3.0
  26.  
  27.    This version of the Remote IPL support for OS/2 2.1 is only valid for
  28.    the May Beta and GA versions of OS/2 2.1.
  29.  
  30.  
  31.    VALID OS/2 / REMOTE IPL CONFIGURATIONS
  32.    --------------------------------------
  33.  
  34.    The following table identifies valid OS/2 / Remote IPL configurations:
  35.  
  36.      ┌──────────┬───────────────────────────────────────────────────┐
  37.      │ Server   │          Operating System to be RIPLed            │
  38.      │ Operating│                       2.0+                        │
  39.      │ System   │   1.3.2     2.0    Service Pak   2.00.1      2.1  │
  40.      ├──────────┼──────────┼───────┼─────────────┼─────────┼────────┤
  41.      │ 1.3.2    │   Yes    │  Yes  │    Yes      │   Yes   │   Yes  │
  42.      │          │          │       │             │         │        │
  43.      │  2.x     │    No    │  Yes  │    Yes      │   Yes   │   Yes  │
  44.      └──────────┴──────────┴───────┴─────────────┴─────────┴────────┘
  45.  
  46.  
  47.  
  48.  
  49.    LAN SERVER REMOTE IPL SERVICE UPGRADES
  50.    --------------------------------------
  51.  
  52.    The following changes/additions have been made to Remote IPL:
  53.  
  54.       - A new rexx procedure, RPLMIG21.CMD, has been provided to install
  55.         the new Remote IPL support for OS/2 2.1.
  56.  
  57.       - The Full Screen interface was updated to default the 'File Index
  58.         Table to model' parameter to DEFALT21.FIT when a OS/2 2.1 server
  59.         record is selected.  Changes were also made to remove the 'Read'
  60.         attribute on OS/2 2.1 client INI files before attempting to
  61.         delete them.  The client file AUTOEXEC.20 is updated to reflect
  62.         the boot drive id.
  63.  
  64.       - The RPLSETD.CMD rexx procedure (shipped with LAN Server 3.0)
  65.         has been updated to support the following OS/2 RIPL client
  66.         upgrades:
  67.  
  68.             Current Client         New Client
  69.             Operating System       Operating System
  70.             ----------------       ----------------
  71.                 1.3.2              No updates supported
  72.                  2.0               2.0+SP, 2.00.1, or 2.1
  73.                 2.0+SP             2.1
  74.                 2.00.1             2.1
  75.  
  76.         The following option changes/additions have been made to RPLSETD.CMD:
  77.  
  78.           /D:  No longer a required parameter.
  79.           /O:  If not specified, the operating system directory is
  80.                determined for the client being updated.
  81.           /B:  New. Specifies the bus type of a client (MCA or ISA/EISA).
  82.           /S:  New. Specifies whether the SWAPPATH is on a local drive or
  83.                the RIPL server.
  84.  
  85.         RPLSETD.CMD has been moved from the \IBMLAN\RPL directory to
  86.         the \IBMLAN\NETPROG directory so that is can be located via the
  87.         PATH statement and executed from any directory.  The LANINST program
  88.         requires that a copy of RPLSETD.CMD be located in \IBMLAN\RPL.
  89.         For this reason, a dummy version of RPLSETD.CMD is installed in
  90.         the \IBMLAN\RPL directory.  This dummy version will invoke the
  91.         version in \IBMLAN\NETPROG.
  92.  
  93.       - Several new routines have been added to support the new RPLSETD.CMD
  94.         procedure:
  95.  
  96.           RPLRXUTL.EXE
  97.           RPLUCC20.CMD
  98.           RPLUCFIT.CMD
  99.           RPLSDMSG.CMD
  100.  
  101.       - Default 2.1 WINOS2 INI files are provided that are preconfigured
  102.         for VGA display support.  XGA and 8514 support statements are
  103.         also present but commented out.  When the /D option is specified
  104.         on RPLSETD.CMD, the client copy of the SYSTEM.INI file will be
  105.         updated to reflect the display type specified.  The /S option
  106.         will also cause the client copy of the SYSTEM.INI file to be
  107.         updated.
  108.  
  109.  
  110.  
  111.  
  112.    KNOWN PROBLEMS
  113.    --------------
  114.  
  115.    None.
  116.  
  117.  
  118.  
  119.    UPGRADING EXISTING REMOTE IPL SERVERS
  120.    -------------------------------------
  121.  
  122.    To upgrade existing RIPL servers, use the following procedure:
  123.  
  124.       1. Determine if the prior versions of OS/2 in the RIPL tree are
  125.          still required.  If they are not required, delete the appropriate
  126.          OS2.20 or OS2.20a directory tree to recovery the hardfile space.
  127.  
  128.       2. Use the OS/2 2.1 utility RIPLINST to install the OS/2 2.1 code.
  129.          Refer to the section 'OS/2 2.1 RIPLINST UTILITY' for additional
  130.          information.
  131.  
  132.       3. Install Remote IPL upgrades.  Refer to the section 'INSTALLATION
  133.          OF LAN SERVER REMOTE IPL UPGRADES' for information on installing
  134.          the upgrades.
  135.  
  136.       4. Run the LAN Server utility GETRPL.EXE.
  137.  
  138.       5. If the server will only be RIPLing OS/2 2.1 clients, use the
  139.          RPLSETD.CMD procedure to update the client DEFALT20 to support
  140.          OS/2 2.1.  Refer to the section 'RPLSETD.CMD REXX PROCEDURE'
  141.          for information on RPLSETD.CMD.
  142.  
  143.          Do not update the client DEFALT20 if prior versions of OS/2
  144.          will be RIPLed from the RIPL server.
  145.  
  146.          If the server will be supporting prior versions of OS/2 in
  147.          addition to 2.1, refer to the section 'SUPPORTING MULTIPLE LEVELS
  148.          OF THE OS/2 OPERATING SYSTEM' for details on how to support
  149.          multiple version of OS/2.
  150.  
  151.       6. Use the RPLSETD.CMD procedure to update existing RIPL clients
  152.          that are to RIPL the OS/2 2.1 operating system.  When updating
  153.          existing RIPL clients, you must specify both the /C and /D
  154.          parameters.
  155.  
  156.          When RIPL clients are updated to OS/2 2.1, all of the existing
  157.          client WINOS2 *.INI and *.GRP files must be replaced with
  158.          2.1 versions of those files.  The existing *.INI files are
  159.          renamed *.IBK and the existing *.GRP files are renamed *.GBK.
  160.          When the user is satisfied that these old files are no longer
  161.          needed for reference, they should be deleted.
  162.  
  163.       7. If you have any customized workplace shell OS2 INI files, refer
  164.          to the section 'UPDATING MASTER WORKPLACE SHELL OS2.INI FILES'
  165.          for additional information.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.    INSTALLING NEW REMOTE IPL SERVERS
  172.    ---------------------------------
  173.  
  174.    To install new RIPL servers, use the following procedure:
  175.  
  176.       1. Install the LAN Server as described in the LAN Server documentation.
  177.  
  178.       2. Follow the procedure described above for upgrading Remote IPL
  179.          servers.
  180.  
  181.       3. If you plan to support multiple versions of OS/2 in the RIPL
  182.          tree, refer to the section 'SUPPORTING MULTIPLE LEVELS OF THE
  183.          OS/2 OPERATING SYSTEM ' for additional information.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.    INSTALLATION OF LAN SERVER REMOTE IPL UPGRADES
  190.    ----------------------------------------------
  191.  
  192.    The LAN Server Remote IPL upgrades are provided on a LAN Server Remote
  193.    IPL Service diskette.  A rexx procedure, RPLMIG21.CMD, is provided
  194.    that will install the LAN Server upgrades.  The upgrades can be installed
  195.    from the diskette or the upgrades can be copied to a hardfile and
  196.    installed from the hardfile.
  197.  
  198.    The RPLMIG21.CMD procedure performs the following functions:
  199.  
  200.       1. Creates new RIPL subdirectories to support OS/2 2.1 and
  201.          OS/2 2.00.1.  The OS/2 2.00.1 subdirectories are created
  202.          even if you do not have 2.00.1 installed so that 2.00.1
  203.          could be installed and supported at a later date if required.
  204.  
  205.       2. Copies several master files from the RIPL OS/2 2.0 directories
  206.          into the new RIPL OS/2 2.1 directories.
  207.  
  208.       3. Installs the LAN Server upgrade files to the appropriate
  209.          directories.  RPLMIG21 will determine which version of LAN
  210.          Server is installed and copy the appropriate update files.
  211.  
  212.       4. Upgrades the RPL.MAP file to add server records to
  213.          support OS/2 2.1.
  214.  
  215.       5. Creates OS221*.CNF files to support the server records
  216.          created in step 4.
  217.  
  218.       6. Update the server name references in the DEFALT21.FIT file
  219.          installed as part of step 3.
  220.  
  221.       7. Update the master CONFIGRI.20 files to add the
  222.          DEVICE=Z:\OS2\TESTCFG.SYS statement required for OS/2 2.1
  223.          remote install.
  224.  
  225.       Note: RPLMIG21.CMD creates a file called \IBMLAN\RPL\RPLMIG21.$$$
  226.             which is 'Read-only'.  If RPLMIG21.CMD detects that this
  227.             file is already present, the user will be prompted to
  228.             verify whether to rerun RPLMIG21.CMD or not. The procedure
  229.             RPLSETD.CMD will not execute if the RPLMIG21.$$$ file is not
  230.             present and the client operating system is OS/2 2.1.
  231.  
  232.  
  233.    To install from the diskette, do the following:
  234.  
  235.       1. Insert the diskette in drive A.
  236.  
  237.       2. At an OS/2 prompt, enter the following command
  238.  
  239.          A:\RPLMIG21
  240.  
  241.  
  242.    To install from a hardfile, do the following:
  243.  
  244.       1. Create a subdirectory, for example d:\RPLOS221.
  245.  
  246.       2. Copy the files on the RIPL Service diskette to the
  247.          subdirectory created in step 1.
  248.  
  249.       3. At a OS/2 prompt, enter the command:
  250.  
  251.          d:\RPLOS221\RPLMIG21 /S:d:\RPLOS221
  252.  
  253.          The /S parameter specifies the path to the directory
  254.          created in step 1.
  255.  
  256.  
  257.    The complete syntax for the RPLMIG21.CMD procedure is given below:
  258.  
  259.    RPLMIG21.CMD  [ ? | /h | /H] [/S:Sourcepath] [/L:Logfile]
  260.  
  261.        where ? or /h or /H is a request for this help panel.  If specified,
  262.                it must be first parameter.
  263.  
  264.              /S:Sourcepath is the fully qualified path to the directory
  265.                 which contains the files to be installed by RPLMIG21.  The
  266.                 default value is A:\.
  267.  
  268.              /L:Logfile is the fully qualified name of a file to which all
  269.                 messages and errors are to be logged.  If Logfile is specified,
  270.                 no messages or errors will be displayed on the screen.
  271.  
  272.  
  273.  
  274.  
  275.    OS/2 2.1 RIPLINST UTILITY
  276.    -------------------------
  277.  
  278.    The RIPLINST utility used to install the OS/2 2.1 code for LAN Server
  279.    OS/2 Remote IPL is located (in packed format) on diskette 7 of the
  280.    OS/2 2.1 Installation diskettes.  Use one of the following procedures
  281.    to install and execute RIPLINST:
  282.  
  283.      a. Operating system of LAN Server is OS/2 2.1.
  284.  
  285.         1. Insert OS/2 2.1 Install diskette 7 into drive A.
  286.  
  287.         2. Install RIPLINST by entering the following command:
  288.  
  289.            UNPACK A:\RIPLINST
  290.  
  291.            The RIPLINST files will be unpacked to the \OS2\INSTALL
  292.            directory.
  293.  
  294.         3. To start the RIPLINST program go to an OS/2 window or full
  295.            screen session an enter the command:
  296.  
  297.            RIPLINST
  298.  
  299.         4. Press Enter to clear the title panel.
  300.  
  301.         5. The Change Source/Target panel is displayed.
  302.  
  303.            The Source path should be left as A:\.
  304.  
  305.            If necessary, the target directory can be updated to change
  306.            the drive id of the target.  Only the drive id should be
  307.            changed, do not change the default directory paths.  The
  308.            OS/2 2.1 code must be installed on the same drive that the
  309.            OS/2 Remote IPL support was installed on during LAN Server
  310.            Installation.
  311.  
  312.         6. Select the 'Install' button.
  313.  
  314.         7. Insert diskettes as prompted.
  315.  
  316.      b. Operating system of LAN Server is OS/2 1.3.2, 2.0, 2.0+Service Pak,
  317.         or 2.00.1.
  318.  
  319.         1. Create a temporary subdirectory by entering the command:
  320.  
  321.            MD TEMPRIPL
  322.  
  323.         2. Change to the temporary subdirectory by entering the command:
  324.  
  325.            CD TEMPRIPL
  326.  
  327.         3. Insert OS/2 diskette 2 into drive A.
  328.  
  329.         4. Copy UNPACK.EXE to TEMPRIPL by entering the command:
  330.  
  331.            COPY A:UNPACK.EXE
  332.  
  333.         5. Check the OS/2 2.1 install diskette 2.  If the file UNPACK2.EXE
  334.            is present, copy UNPACK2.EXE to TEMPRIPL by entering the
  335.            command:
  336.  
  337.            COPY A:UNPACK2.EXE
  338.  
  339.            Note: UNPACK2.EXE may or may not be present.  If is is not
  340.                  on your diskette 2, then you do not need it.
  341.  
  342.         6. Insert OS/2 diskette 7 into drive A.
  343.  
  344.         7. Install the RIPLINST files by entering the command:
  345.  
  346.            UNPACK A:\RIPLINST d:\TEMPRIPL
  347.  
  348.            where d: is the drive id where TEMPRIPL is located.
  349.  
  350.         8. Start the RIPLINST program by entering the command:
  351.  
  352.            RIPLINST
  353.  
  354.            Note: The OS/2 2.1 version of RIPLINST must use the OS/2 2.1
  355.                  version of UNPACK and UNPACK2.  Failure to do so will
  356.                  result in one of the following error conditions:
  357.  
  358.                  - RIPLINST will hang while copying the W0F0000.BIO file.
  359.                  - The system will lock up after displaying the copy
  360.                    panel.  Reboot is the only recover.
  361.  
  362.         9. Press Enter to clear the title panel.
  363.  
  364.        10. The Change Source/Target panel is displayed.
  365.  
  366.            The Source path should be left as A:\.
  367.  
  368.            If necessary, the target directory can be updated to change
  369.            the drive id of the target.  Only the drive id should be
  370.            changed, do not change the default directory paths.  The
  371.            OS/2 2.1 code must be installed on the same drive that the
  372.            OS/2 Remote IPL support was installed on during LAN Server
  373.            Installation.
  374.  
  375.        11. Select the 'Install' button.
  376.  
  377.        12. Insert diskettes as prompted.
  378.  
  379.  
  380.    Previous versions of RIPLINST had a default target install directory of:
  381.  
  382.      d:\IBMLAN\RPL\OS2.20  (OS/2 2.0 and Service Pak)
  383.  
  384.      or
  385.  
  386.      d:\IBMLAN\RPL\OS2.20a (OS/2 2.00.1)
  387.  
  388.      where d: indicates the drive where OS/2 is installed.)
  389.  
  390.    The RIPLINST for OS/2 2.1 has a new default target install directory. The
  391.    new default target install directory is:
  392.  
  393.      d:\IBMLAN\RPL\OS2.21
  394.  
  395.    This was done so that an existing ..\OS2.20 directory tree would not be
  396.    automatically overwritten.  If you wish to upgrade an existing ..\OS2.20
  397.    directory tree, the target install directory must be updated before
  398.    starting the install process.  The target directory must be on the same
  399.    drive where OS/2 Remote IPL was installed (this can be different from
  400.    where LAN Server is installed).
  401.  
  402.    After using RIPLINST to install OS/2 2.1 for Remote IPL, the updated
  403.    version of the LAN Server utility, GETRPL.EXE, must be run.  Refer to
  404.    the LAN Server documentation for information on running GETRPL.
  405.  
  406.  
  407.  
  408.  
  409.    RPLSETD.CMD REXX PROCEDURE
  410.    --------------------------
  411.  
  412.    The RPLSETD.CMD procedure provides the following functions:
  413.  
  414.       - Upgrade existing RIPL clients that use 16 bit display drivers
  415.         to use the new 32 bit VGA, XGA, and 16 bit 8514 display drivers
  416.         provided in OS/2 2.00.1, 2.0 + Service Pak.  It also supports
  417.         the 32 bit 8514 display driver in 2.1.
  418.  
  419.       - Can be used in some cases to change the display type (32 bit
  420.         VGA,XGA, or 8514) that a RIPL client is using.  RPLSETD does
  421.         not support converting from the new 32 bit drivers back to the
  422.         old 16 bit display drivers.
  423.  
  424.         If a Desktop exists for the RIPL client, changing to a higher
  425.         resolution display type can cause unpredictible results.  If
  426.         a Desktop exists, it is highly recommended that the client
  427.         definition be deleted, recreated, use RPLSETD to change to
  428.         the higher resolution display type, and then boot the client
  429.         and let it create a new Desktop.
  430.  
  431.       - Can be used to update a RIPL client to boot a different
  432.         version of OS/2 2.x.  The OS/2 2.x code must be installed
  433.         in the RIPL directory structure.  The following OS/2 2.x
  434.         versions conversions are supported:
  435.  
  436.            old version      new version
  437.                2.0             2.00.1
  438.                                2.0+Service Pak
  439.                                2.1
  440.  
  441.               2.00.1           2.0+Service Pak
  442.                                2.1
  443.  
  444.            2.0+Service Pak     2.1
  445.  
  446.         Note that there is no support for converting any of the newer
  447.         versions back to the original OS/2 2.0.  After a client is
  448.         converted to OS/2 2.1, RPLSETD cannot be used to convert back
  449.         to 2.0+Service Pak or 2.00.1.
  450.  
  451.       - Can be used to update a RIPL client to change the bus type,
  452.         i.e. MCA or ISA/EISA.
  453.  
  454.       - Can be used to update a RIPL client to specify whether the
  455.         SWAPPATH and WIN-OS2 'PagingFile' will be on a local hardfile
  456.         or on the RIPL server.
  457.  
  458.    Client definitions can be updated individually or in a group (grouped
  459.    by common attributes such as display type, bus type, and operating system).
  460.  
  461.    The client name DEFALT20 is a special client name used by the OS/2
  462.    Remote IPL support as a default when creating a new client (not
  463.    modelling an existing client). If you are supporting prior versions
  464.    of OS/2 (i.e. 2.0, 2.00.1, or 2.0 + Service Pack) in the RIPL directory
  465.    tree, do not update DEFALT20 to support OS/2 2.1.  You must leave
  466.    DEFALT20 at its current level to support the prior version(s) of OS/2.
  467.    To support OS/2 2.1 RIPL clients do the following:
  468.  
  469.      - Create a 'new' RIPL client, for example, MODEL21, using the defaults.
  470.      - Use RPLSETD to update MODEL21 to support OS/2 2.1.  Then use MODEL21
  471.        as a model client to create all future 2.1 clients.
  472.      - You may need to create multiple 2.1 models, one for each LAN type you
  473.        support.
  474.  
  475.    The client name DEFALT21 is reserved.  Do not create a client by this name.
  476.    DEFALT21 is not a complete client definition like DEFALT20.  It is used
  477.    in conjunction with DEFALT20 to support OS/2 2.1 clients. Do not
  478.    attempt to update the DEFALT21 client with RPLSETD.CMD.
  479.  
  480.    If the only version of OS/2 that will be installed in the RIPL directory
  481.    tree is OS/2 2.1, you should update the client DEFALT20.  Then all future
  482.    default clients will automatically support OS/2 2.1.
  483.  
  484.  
  485.    The syntax of RPLSETD.CMD is:
  486.  
  487.      RPLSETD  [/H] [/C:CLIENT[,CLIENT2,CLIENT3,...]] [/D:DISPLAY_DRIVER]
  488.               [/O:CURRENT_OS2] [/N:NEW_OS2] [/B:BUSTYPE] [/S:SWAPTARGET]
  489.               [/L:LOGFILE] [/R:RESPONSE_FILE]
  490.  
  491.      where:
  492.  
  493.      /H
  494.         displays the syntax on screen.  If specified, it must be the first
  495.         parameter.
  496.  
  497.      /C:CLIENT[,CLIENT2,CLIENT3,...]  (CLIENT or CLIENTLIST)
  498.         is the name of one or more OS/2 remote IPL client workstations
  499.         that are to be updated.  If multiple client names are specified,
  500.         each client name must be separated with a comma.  Imbedded blanks
  501.         are not allowed. The response file keywords CLIENT and CLIENTLIST
  502.         are equivalent to each other.  They may be specified as many times
  503.         times as necessary.  This is a required parameter if the /R
  504.         parameter is not specified.  When specified, at least one other
  505.         parameter must also be specified.
  506.  
  507.      /D:DISPLAY_DRIVER (DISPLAYDRIVER)
  508.         is the new display type for the client definition.  The following
  509.         display types are valid:
  510.  
  511.             IBMVGA32    32-bit VGA display driver
  512.             IBMXGA32    32-bit XGA display driver
  513.             IBM8514     16-bit 8514 display driver (2.0+SP or 2.00.1)
  514.                         32-bit 8514 display driver (2.1)
  515.             8514_32     Alternate 32-bit 8514 display driver name (2.1)
  516.  
  517.         This parameter is normally optional, however, it must be specified
  518.         when an existing 2.0 or 2.00.1 RIPL client is converted to 2.1
  519.         by specifying the /N parameter.
  520.  
  521.         When upgrading the display type of an existing RIPL client (it has
  522.         booted at least one time and has a Desktop) from VGA to XGA or
  523.         8514, you must delete and recreated the RIPL client and then run
  524.         RPLSETD.CMD.  If you update the existing client to a higher
  525.         resolution display type, many of the display sizing characterics
  526.         in OS2.INI do not get updated.  As a result you end up with some
  527.         objects in VGA resolution and some in the higher resolution.
  528.         If no Desktop exists for the client, it can be updated to change
  529.         to a higher resolution.  When the Desktop is created during the
  530.         first boot, it will reflect the display characteristics for
  531.         which it is configured.
  532.  
  533.      /O:CURRENT_OS2 (CURRENTOS2DIR)
  534.         is the root directory under \IBMLAN\RPL for the current version of
  535.         OS/2 2.0 that the client is using.  This parameter is case sensitive.
  536.         The /O parameter should only be specified when you want the client
  537.         operating system type verified before updating to a new operating
  538.         system type.  If /O is not specified, the current operation system
  539.         being used by the RIPL client is determined from the client.FIT file.
  540.         If the /O parameter is specified, then the /N parameter must also
  541.         be specified.
  542.  
  543.      /N:NEW_OS2 (NEWOS2DIR)
  544.         is the root directory under \IBMLAN\RPL for the version of OS/2 2.0
  545.         that the client is to be switched to.  This parameter is case
  546.         sensitive.  The default is OS2.21.  The /O and/or /N parameters
  547.         should only be specified when you need to switch a client from one
  548.         OS version to another OS version.
  549.  
  550.         When an existing RIPL client is updated to OS/2 2.1, the client
  551.         WINOS2 *.INI and *.GRP files must be replace with the 2.1 versions
  552.         of these files.  The old files are renamed to *.IBK and *.GBK.
  553.         When the user is satisfied that these old files are no longer
  554.         needed for reference, they should be deleted.
  555.  
  556.      /B:BUSTYPE (BUSTYPE)
  557.         is the type of I/O bus used by the RIPL client machine.  Valid
  558.         types are:
  559.  
  560.           MCA  - Micro-channel
  561.           ISA  - AT compatable
  562.           EISA - AT compatable
  563.  
  564.      /S:SWAPTARGET (SWAPTARGET)
  565.         is an indicator of where the SWAPPER.DAT file will reside:  Valid
  566.         values are:
  567.  
  568.            L - file will reside on local hardfile of RIPL client
  569.            S - file will reside on RIPL server
  570.  
  571.         This parameter also control the location (local/server) of the
  572.         'PagingFile' parameter in the OS/2 2.1 WIN-OS2 SYSTEM.INI file.
  573.  
  574.      /L:LOGFILE (LOGFILE)
  575.         is the drive, path, and filename of a file to which all messages and
  576.         errors are to be logged.  If this parameter is specified, the only
  577.         errors displayed on the screen will be for a failure to open the
  578.         logfile or for missing required parameters in the response file.
  579.  
  580.      /R:RESPONSE_FILE
  581.         is the drive, path, and filename of a file that contains the command
  582.         inputs in keyword form (keyword=value).  The valid keywords are
  583.         indicated above in () following each /X: syntax.  Only one keyword
  584.         can be specified per line in the response file.  The CLIENT or
  585.         CLIENTLIST parameter and at least one other parameter are required
  586.         when using a response file.  If the /R parameter is specified, all
  587.         other parameters specified on the command line are ignored.
  588.  
  589.  
  590.  
  591.    Examples:
  592.  
  593.      -  To update the DEFALT20 client to use the 32 bit VGA display driver
  594.         and switch the operating system from OS2.20 to OS2.21, type:
  595.  
  596.         RPLSETD /C:DEFALT20 /D:IBMVGA32 /N:OS2.21
  597.  
  598.         This will update the default files to support OS/2 2.1 and the new
  599.         VGA display driver.  These files are used when defining clients using
  600.         the default configuration.
  601.  
  602.         Note: If you plan to also support previous versions of OS/2 (i.e.
  603.               2.0, 2.00.1, or 2.0 + Service Pak), do not update the DEFALT20
  604.               client.
  605.  
  606.      -  To update the MACH001 client to use the 32 bit XGA display driver
  607.         and switch the operating system to OS2.21, type:
  608.  
  609.           RPLSETD /C:MACH001 /D:IBMXGA32 /N:OS2.21
  610.  
  611.      -  To update the MACH001 client to use the 32 bit XGA display driver,
  612.         verify the current operating system is OS2.20a, and switch the
  613.         operating system to OS2.21, type:
  614.  
  615.           RPLSETD /C:MACH001 /D:IBMXGA32 /O:OS2.20a /N:OS2.21
  616.  
  617.      -  To update the MACH001 client to specify a bus type of ISA and
  618.         set the SWAPPATH/PagingFile to the RIPL server, type:
  619.  
  620.           RPLSETD /C:MACH001 /B:ISA /S:S
  621.  
  622.      -  To update the MACH001 client to use the 32 bit VGA display driver,
  623.         verify the current operating system is OS2.20, switch the operating
  624.         system to OS2.21, specify a bus type of ISA, and set the SWAPPATH/
  625.         PagingFile to the RIPL server, type:
  626.  
  627.           RPLSETD /C:MACH001 /D:IBMVGA32 /O:OS2.20 /N:OS2.21 /B:ISA /S:S
  628.  
  629.      -  To update multiple clients, MACH001 and MACH002, to use the 32 bit
  630.         VGA display driver and switch the operating system to OS2.21, type:
  631.  
  632.           RPLSETD /C:MACH001,MACH002 /D:IBMVGA32 /N:OS2.21
  633.  
  634.  
  635.  
  636.  
  637.  
  638.    RPLSETD RESPONSE FILE KEYWORDS
  639.    ------------------------------
  640.  
  641.    The valid response file entries/keywords are:
  642.  
  643.       ; Comment line
  644.       [GROUP]                (this statement is optional for the first group
  645.                               and required for all subsequent groups)
  646.       DISPLAYDRIVER=
  647.       CLIENT=
  648.       CLIENTLIST=
  649.       CURRENTOS2DIR=
  650.       NEWOS2DIR=
  651.       BUSTYPE=
  652.       SWAPTARGET=
  653.  
  654.    A ';' in column 1 indicates the line is a comment.
  655.  
  656.    Leading blanks are allowed on keyword statements.
  657.  
  658.    The keywords are defined above in the RPLSETD syntax description.
  659.  
  660.    [GROUP] designates the start of a RIPL client or group of clients that
  661.    share the same configuration characteristics.  When the [GROUP]
  662.    statement is encountered, the client machine(s) in the previous group
  663.    are updated according to the specified keyword(s).  Multiple [GROUP]s
  664.    can appear in the response file. This allows a single response file
  665.    to process a number of different configurations.  The [GROUP]
  666.    statement is optional for the first group in the response file but
  667.    is required for all subsequent groups.
  668.  
  669.    CLIENT and CLIENTLIST are equivalent and multiple entries can be
  670.    specified on either.  Multiple CLIENT and CLIENTLIST keywords can
  671.    be specified per group.  Only one of each of the other keywords is
  672.    allowed per group.
  673.  
  674.    Example:
  675.  
  676.      To use the response file option, do the following:
  677.  
  678.         1. Create an ASCII file that contains the appropriate keyword
  679.            values. For example:
  680.  
  681.            [GROUP]              (optional)
  682.            ; Update existing clients to support the IBMXGA32 display driver,
  683.            ; switch from OS2.20 to OS2.21, support the MCA bus, and put the
  684.            ; swappath on a local hardfile.
  685.            CLIENT=DEFALT20
  686.            CLIENT=MACH001,MACH002
  687.            CLIENTLIST=MACH003,MACH004
  688.            DISPLAYDRIVER=IBMXGA32
  689.            CURRENTOS2DIR=OS2.20
  690.            NEWOS2DIR=OS2.21
  691.            BUSTYPE=MCA
  692.            SWAPTARGET=L
  693.  
  694.            [GROUP]               (required)
  695.            ; Update client for ISA bus and put the swappath on the RIPL
  696.            ; server (no local hardfile).
  697.            no hardfile
  698.            CLIENT=MACH005
  699.            BUSTYPE=ISA
  700.            SWAPTARGET=S
  701.  
  702.         2. Type the following command:
  703.  
  704.            RPLSETD /R:d:\path\response_filename
  705.  
  706.            where d:\path\response_filename is the fully qualified file
  707.                  name of the resonse file.
  708.  
  709.  
  710.  
  711.  
  712.    CREATING NEW OS/2 2.1 RIPL CLIENTS
  713.    ----------------------------------
  714.  
  715.    The menu interface has been updated to automatically select the
  716.    FITS\DEFALT21.FIT entry when a 'NEW' client is created using an
  717.    OS/2 2.1 server record id.  However, the master CONFIG.20 files
  718.    have not been updated to OS/2 2.1 level so that back level versions
  719.    of OS/2 can also be supported.
  720.  
  721.    The differences between an OS/2 2.0 and OS/2 2.1 CONFIG.20 file
  722.    are minor, mainly new SET statements.  In most cases the CONFIG.20
  723.    file will work for OS/2 2.1 as is.  However, if you wish to convert
  724.    the client CONFIG.20 to the OS/2 2.1 level, run the RPLSETD command
  725.    against the client.  RPLSETD will update the CONFIG.20 file to the
  726.    OS/2 2.1 level.
  727.  
  728.    A new client created using the defaults, will be configured to
  729.    support the IBMVGA32 display drivers.  If the client has an XGA
  730.    or 8514 display attached, RPLSETD must be run against the client
  731.    to reconfigure the client for the correct display type.
  732.  
  733.  
  734.  
  735.  
  736.  
  737.    UPDATING MASTER WORKPLACE SHELL OS2.INI FILES
  738.    ---------------------------------------------
  739.  
  740.    Some users have a master customized OS2.INI file that is copied to the
  741.    client directory each time the client is remote booted.  This master file
  742.    must also be update to identify the type of display driver that the client
  743.    workstation is using.  Clients with different display types (i.e. vga,
  744.    xga, 8514) MUST use different master OS2.INI files.
  745.  
  746.    To update a master OS2.INI file, enter the following command:
  747.  
  748.       RPLRXUTL  /D:DISPLAY_DRIVER  /C:INI_FILENAME
  749.  
  750.       where:
  751.  
  752.       /D:DISPLAY_DRIVER
  753.          is the same as for RPLSETD.
  754.  
  755.       /C:INI_FILENAME
  756.          is the drive, path, and filename of the master OS2.INI file to be
  757.          updated.
  758.  
  759.    For example:
  760.  
  761.      RPLRXUTL /D:IBMVGA32 /C:E:\IBMLAN\RPL\MASTER\VGAOS2.INI
  762.  
  763.    The RPLRXUTL utility will not display any error information.  It does
  764.    return with a non-zero return code if there was an error.  If you need
  765.    to verify error information, invoke RPLRXUTL from a CMD procedure (batch
  766.    file or Rexx) so that the return code can be tested.
  767.  
  768.  
  769.  
  770.  
  771.    SUPPORTING MULTIPLE LEVELS OF THE OS/2 OPERATING SYSTEM
  772.    -------------------------------------------------------
  773.  
  774.    It is possible to install and support multiple levels of the OS/2
  775.    2.x operating system on a RIPL server.  This section documents the
  776.    correct procedure to use to support such an environment.  It is
  777.    assumned that the OS/2 2.1 Remote IPL Support updates have already
  778.    been installed.
  779.  
  780.    The basic procedure is as follows:
  781.  
  782.      1. Run the OS/2 utility RIPLINST to install the OS/2 code in
  783.         the RIPL directory tree.  You must be carefully to use the
  784.         version of RIPLINST that matches the level of code to be
  785.         installed.  RIPLINST is located on diskette 7 of all
  786.         OS/2 2.x installation diskettes.  RIPLINST is unique for
  787.         each version of OS/2.
  788.  
  789.      2. After running RIPLINST for OS/2 2.1, run the RPLMIG21.CMD
  790.         procedure to install the 2.1 RIPL support.
  791.  
  792.      3. After running RIPLINST, run the LAN Server utility, GETRPL.
  793.         GETRPL uses information stored in the OS2SYS.INI file by
  794.         RIPLINST so it is very important that GETRPL be run
  795.         before using RIPLINST to install another version of OS/2.
  796.  
  797.      4. Repeat steps 1, 2, and 3 for each version of OS/2 that will be
  798.         RIPLed.
  799.  
  800.      5. Check the \IBMLAN\RPL\RPL.MAP file.  Look for the OS/2
  801.         server records, they start with yyyyyyyyyyyy or ;yyyyyyyyyyyy
  802.         and field two will contain a name like OS220*.CNF or OS221*.CNF.
  803.         A comment in column 1 indicates the record is disabled.
  804.         Make sure that the appropriate records are enabled/disabled
  805.         based on what OS/2 version(s) you installed.
  806.  
  807.      6. Determine whether the special RIPL client, DEFALT20, should
  808.         be updated by RPLSETD.  This depends on what OS/2 versions
  809.         are installed.
  810.  
  811.         OS/2 version 2.0 uses 16 bit display drivers.  OS/2 versions
  812.         2.00.1, 2.0+Service Pak, and 2.1 use 32 bit display drivers
  813.         for VGA and XGA support.  However, there are slight differences
  814.         in the XGA support between 2.00.1 and 2.0+Service Pak/2.1.
  815.  
  816.         If OS/2 2.0 is present, DEFALT20 must not be updated.  It
  817.         must remain as is to allow the creation of future 2.0 clients.
  818.  
  819.         If OS/2 2.0 is not present, then DEFALT20 could be updated
  820.         with RPLSETD to support either 2.00.1 or 2.0+Service Pak/2.1.
  821.         To update DEFALT20 to support 2.0+Service Pack, enter the command:
  822.  
  823.            RPLSETD /D:IBMVGA32 /C:DEFALT20
  824.  
  825.         To update DEFALT20 to support 2.00.1, enter the command:
  826.  
  827.            RPLSETD /D:IBMVGA32 /C:DEFALT20 /N:OS2.20a
  828.  
  829.         The /N parameter indicates that the new default target operating
  830.         system will be \IBMLAN\RPL\OS2.20a.  The RIPLINST for OS/2 2.00.1
  831.         defaulted to a target directory of \IBMLAN\RPL\OS2.20a.
  832.  
  833.         To update DEFALT20 to support 2.1, enter the command:
  834.  
  835.            RPLSETD /D:IBMVGA32 /C:DEFALT20 /N:OS2.21
  836.  
  837.         The /N parameter indicates that the new default target operating
  838.         system will be \IBMLAN\RPL\OS2.21.  The RIPLINST for OS/2 2.1
  839.         defaults to a target directory of \IBMLAN\RPL\OS2.21.
  840.  
  841.      7. Since the special RIPL client DEFALT20 must be associated with
  842.         a specific OS/2 version, it is recommended that model clients
  843.         be created for the other OS/2 versions installed in the RIPL
  844.         tree.  RPLSETD can be used to update the model client
  845.         definitions to point to the correct operating system.  Then
  846.         these model clients can be used to create future clients for
  847.         each operating system type.
  848.  
  849.