home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 36 Tips / 36-Tips.zip / NEWADA.FAX < prev    next >
Text File  |  1994-11-28  |  14KB  |  399 lines
  1. Customizing LS30 Ripl Servers to support n      4/20/94
  2.  
  3. HOW TO CUSTOMIZE AN EXISTING IBM OS/2 LAN SERVER
  4. VERSION 3.0 RIPL SERVER TO SUPPORT NEW NDIS-TYPE ADAPTERS
  5.  
  6.  
  7. DESCRIPTION OF SYMPTOMS:
  8.     Need to customize an existing IBM OS/2 LAN Server Version
  9.     3.0 RIPL server to support new NDIS-type adapters.
  10.  
  11. SUMMARY OF RESOLUTION:
  12.     Follow the instructions below.
  13.  
  14. DETAILS OF RESOLUTION:
  15.  
  16.    ****NOTE:  Throughout this document some code strings are
  17.               presented on two lines because of space constraints.
  18.               They are indicated by "(con't on next line)".
  19.               When copying these lines, they should be written
  20.               as one continous line.
  21.  
  22. This document describes how to customize an existing OS/2 LAN
  23. Server version 3.0 RIPL server to attempt to support new
  24. NDIS-type adapters.  This document does not imply that IBM
  25. will officially support such new adapters.  The only adapters
  26. that are officially supported are those listed in the "IBM
  27. OS/2 Network Administrator Reference Volume 1:  Planning and
  28. Installation Version 3.0".
  29.  
  30. The following description uses "IBM16TR" to represent the new
  31. adapter being added to the RIPL support.
  32.  
  33.     1.   Create the following new subdirectories:
  34.  
  35.          \IBMLAN\RPL\DOS\IBM16TR
  36.          \IBMLAN\RPL\IBMCOM\IBM16TR
  37.  
  38.          NOTE: The subdirectory name can be anything that is
  39.                unique.  "IBM16TR" is used here for example
  40.                purposes.
  41.  
  42.     2.   From the adapter Diagnostics diskette, copy the
  43.          following files (for example purposes, the device
  44.          driver name is assumed to be "IBM16TR" and the
  45.          drive is assumed to be "C"):
  46.  
  47.          a)   from the \DOS subdirectory copy the DOS device
  48.               driver file(s):
  49.  
  50.               IBM16TR.DOS
  51.                   (copy to C:\IBMLAN\RPL\DOS subdirectory)
  52.               IBM16TR.MSG
  53.                   (copy to C:\IBMLAN\RPL\DOS subdirectory)
  54.  
  55.          b)   from the \OS2 subdirectory copy the OS/2 device
  56.               driver file(s)
  57.  
  58.               IBM16TR.OS2
  59.                   (copy to C:\IBMLAN\RPL\IBMCOM\MACS subdirectory)
  60.               IBM16TR.MSG
  61.                   (copy to C:\IBMLAN\RPL\IBMCOM subdirectory)
  62.               IBM16TRH.MSG
  63.                   (copy to C:\IBMLAN\RPL\IBMCOM subdirectory)
  64.  
  65.               NOTE:  Some adapter might not have *.MSG files.
  66.  
  67.     3.  Create a new DOS PROTOCOL.INI file in the subdirectory
  68.         created in step 1.  A sample PROTOCOL.INI for the
  69.         IBM16TR adapter follows:
  70.  
  71.         PROTMAN_MODU
  72.             DriverName = PROTMAN$
  73.         DXMAIDXCFGU
  74.             DXME0_MOD = DXME0.NIF
  75.             IBM16TR_MOD = IBM16TR.NIF
  76.         DXME0_MODU
  77.             DriverName = DXME0$
  78.             Bindings = IBM16TR_NIF
  79.         IBM16TR_NIFU
  80.             DRIVERNAME = IBM16TR$
  81.             (Add any additional parameters required by the new
  82.             adapter.)
  83.  
  84.     4.  Copy the file CONFIG.20 from the \IBMLAN\RPL\IBMCOM\IBM16TR
  85.         directory into the \IBMLAN\RPL\IBMCOM\IBM16TR directory.
  86.  
  87.     5.  Edit C:\IBMLAN\RPL\IBMCOM\IBM16TR\CONFIG.20 file and make
  88.         the following change:
  89.  
  90.         -   Locate the following statement:
  91.  
  92.                 DEVICE=Z:\IBMCOM\MACS\IBMTOK.OS2
  93.  
  94.             and change it to
  95.  
  96.                 DEVICE=Z:\IBMCOM\MACS\IBM16TR.OS2
  97.  
  98.     6.  Create a new OS/2 PROTOCOL.INI file in the
  99.         \IBMLAN\RPL\IBMCOM\IBM16TR directory.  A sample
  100.         PROTOCOL.INI file follows:
  101.  
  102.         PROT_MANU
  103.             DriverName = PROTMAN$
  104.  
  105.         IBMLXCFGU
  106.             IBM16TR_nif = IBM16TR.nif
  107.             LANDD_nif = LANDD.nif
  108.             NETBEUI_nif = NETBEUI.nif
  109.  
  110.         ;*----------------------------------------------*
  111.         ;*------------- PROTOCOL SECTION ---------------*
  112.         ;*----------------------------------------------*
  113.  
  114.         LANDD_nifU
  115.             DriverName = LANDD$
  116.             Bindings = IBM16TR_nif
  117.             ETHERAND_TYPE = "I"
  118.             SYSTEM_KEY = 0x0
  119.             OPEN_OPTIONS = 0x2000
  120.             TRACE = 0x0
  121.             LINKS = 8
  122.             MAX_SAPS = 3
  123.             MAX_G_SAPS = 0
  124.             USERS = 3
  125.             TI_TICK_G1 = 255
  126.             T1_TICK_G1 = 15
  127.             T2_TICK_G1 = 3
  128.             TI_TICK_G2 = 255
  129.             T1_TICK_G2 = 25
  130.             T2_TICK_G2 = 10
  131.             IPACKETS = 250
  132.             UIPACKETS = 100
  133.             MAXTRANSMITS = 6
  134.             MINTRANSMITS = 2
  135.             TCBS = 64
  136.             GDTS = 30
  137.             ELEMENTS = 800
  138.  
  139.         NETBEUI_nifU
  140.             DriverName = netbeui$
  141.             Bindings = IBM16TR_nif
  142.             ETHERAND_TYPE = "I"
  143.             USEADDRREV = "YES"
  144.             SESSIONS = 40
  145.             NCBS = 85
  146.             NAMES = 17
  147.             SELECTORS = 5
  148.             USEMAXDATAGRAM = "NO"
  149.             ADAPTRATE = 1000
  150.             WINDOWERRORS = 0
  151.             TI = 30000
  152.             T1 = 500
  153.             T2 = 200
  154.             MAXIN = 1
  155.             MAXOUT = 1
  156.             NETBIOSTIMEOUT = 500
  157.             NETBIOSRETRIES = 8
  158.             NAMECACHE = 0
  159.             PIGGYBACKACKS = 1
  160.             DATAGRAMPACKETS = 2
  161.             PACKETS = 350
  162.             PIPELINE = 5
  163.             MAXTRANSMITS = 6
  164.             MINTRANSMITS = 2
  165.             DLCRETRIES = 5
  166.  
  167.         ;*----------------------------------------------*
  168.         ;*--------------- MAC SECTION ------------------*
  169.         ;*----------------------------------------------*
  170.  
  171.         IBM16TR_nifU
  172.             DriverName = IBM16TR$
  173.             (add any addition parameters needed by the adapter)
  174.  
  175.     7.  Edit the file \IBMLAN\RPL\NDISDD.PRO and add an entry for
  176.         the IBM16TR adapter.  If the new entry is added to the
  177.         end of the file, add a blank line as the last record in
  178.         the file.
  179.  
  180.         A sample entry follows:
  181.  
  182.              IBM16TR.DOS  IBM16TR
  183.  
  184.              >>>> NOTE:  Be sure you add a blank line at the <<<<        <<
  185.              >>>>        end of this file as stated above.   <<<<        <<<<<<<
  186.  
  187.         The first field is the name of the DOS device driver.
  188.         The second field is the name of the directories that
  189.         contain the default configuration information for the
  190.         adapter.  In this case,
  191.  
  192.             \IBMLAN\RPL\DOS\IBM16TR
  193.                 (contains DOS PROTOCOL.INI)
  194.             \IBMLAN\RPL\IBMCOM\IBM16TR
  195.                (contains OS2 CONFIG.20 and PROTOCOL.INI files)
  196.  
  197.         NOTE:  The assumption is that each adapter has a unique
  198.                DOS device driver name.
  199.  
  200.     8.  In the C:\IBMLAN\RPL directory, create a new DOS CNF
  201.         file for the adapter.  It is recommended that the first
  202.         three characters of the name be 'DOS'.  A sample CNF file,
  203.         called DOSND16T.CNF, follows for the IBM16TR adapter:
  204.  
  205.         ; DOS Boot Block Configuration (adapter xxxxxxx)
  206.         BASE 7C0H
  207.         RPL DOS\RPLBOOT.SYS
  208.         LDR DOS\RPLLOADR.COM ~
  209.         EXE d:\IBMLAN\DOSLAN\LSP\NETBIND.COM ~ ~
  210.         DAT DOS\IBM16TR\PROTOCOL.INI
  211.         DAT DOS\IBM16TR.MSG
  212.         DAT d:\IBMLAN\DOSLAN\LSP\DXM.MSG
  213.         DRV d:\IBMLAN\DOSLAN\LSP\DXMT0MOD.SYS (con't on next line)
  214.             PBA=0~S=12~ST=12~C=14~O=N ~
  215.         DRV d:\IBMLAN\DOSLAN\LSP\DXME0MOD.SYS ~ 10 ~
  216.         DRV d:\IBMLAN\DOSLAN\LSP\DXMA0MOD.SYS ccc ~ ~
  217.         DRV DOS\IBM16TR.DOS ~ n ~
  218.         DRV d:\IBMLAN\DOSLAN\LSP\PROTMAN.DOS /I: ~ ~
  219.  
  220.         d:  =  the drive id where IBMLAN is installed,
  221.         ccc =  the country code and
  222.         n   =  the amount of optional additional memory
  223.                required by the device driver.  If no additional
  224.                memory is required, replace n with the '~' (tilde)
  225.                character.  This value, if required, will have to
  226.                be determined by trial and error.
  227.  
  228.         The statement 'DAT DOS\IBM16TR.MSG' is only needed if
  229.         *.MSG files exist for the device driver.
  230.  
  231.     9.  In the C:\IBMLAN\RPL directory, create a new OS2 CNF
  232.         file for the adapter.  The following naming convention
  233.         should be used:
  234.  
  235.         a.  First three characters, 'OS2'.
  236.         b.  Characters 4 and 5 identify the OS/2 operating
  237.             system type:
  238.  
  239.             20 - OS/2 2.0
  240.             2A - OS/2 2.00.1
  241.             21 - OS/2 2.1
  242.  
  243.         c.  Characters 6-8 can be any unique characters.
  244.  
  245.         A sample CNF file, called OS22116T.CNF, follows for the
  246.         IBM16TR adapter:
  247.  
  248.         ; OS/2 Boot Block Configuration (Adapter IBM16TR)
  249.         ;
  250.         RPL DOS\RPLBOOT.SYS
  251.         DAT DOS\MFSD20.SYS
  252.         ORG 1000H
  253.         LDR OS2.20\OS2LDR ~ OS2LDR UFSD.SYS MFSD20.SYS
  254.         DAT DOS\UFSD.SYS
  255.         DAT DOS\IBM16TR\PROTOCOL.INI
  256.         DAT DOS\IBM16TR.MSG
  257.         DAT d:\IBMLAN\DOSLAN\LSP\DXM.MSG
  258.         EXE d:\IBMLAN\DOSLAN\LSP\NETBIND.COM ~ ~ ~
  259.         DRV d:\IBMLAN\DOSLAN\LSP\DXMT0MOD.SYS PBA=0~O=N ~ ~
  260.         DRV d:\IBMLAN\DOSLAN\LSP\DXME0MOD.SYS ~ 6 ~
  261.         DRV d:\IBMLAN\DOSLAN\LSP\DXMA0MOD.SYS ccc ~
  262.         DRV DOS\IBM16TR.DOS ~ n ~
  263.         DRV d:\IBMLAN\DOSLAN\LSP\PROTMAN.DOS /I: ~ ~
  264.  
  265.         d:  = the drive id where IBMLAN is installed
  266.         ccc = the country code
  267.         n   = the amount of optional additional memory required
  268.               by the device driver.  If no additional memory is
  269.               required, replace n with the '~' (tilde) character.
  270.               This value, if required, will have to be determined
  271.               by trial and error.
  272.  
  273.         The statement 'LDR OS2.21\OS2LDR ~ OS2LDR UFSD.SYS
  274.         MFSD21.SYS' should be updated to reflect the approriate
  275.         type OS/2 operating system, i.e. OS2.20, OS2.20a, or OS2.21.
  276.  
  277.         The statement 'DAT DOS\IBM16TR.MSG' is only needed if *.MSG
  278.         files exist for the device driver.
  279.  
  280.    10.  Edit the \IBMLAN\RPL\RPL.MAP file and add both DOS and OS2
  281.         server records to the file.
  282.  
  283.         The following is a sample DOS server record:
  284.  
  285.         yyyyyyyyyyyy dosnd16T.cnf  3 10 N (con't on next line)
  286.               IBMLAN$ DOS~IBM~16/4~II  ~ ~ ,,, Z R_DIBM16TR  ~ ~
  287.  
  288.             'dosnd16T.cnf' =  the CNF file created in step 9.
  289.  
  290.                 'DOS~new~adapter~description' can be any
  291.                 descriptive string you want.  It is recommended
  292.                 that the first three characters be 'DOS'.
  293.                 Embedded blanks are not allowed and must be
  294.                 replaced with the '~' (tilde) character.
  295.  
  296.                 'R_DIBM16TR' is a unique string that does not
  297.                 appear in any other field 12 server record.
  298.                 The first three characters should be 'R_D'.
  299.                 The remaining characters can be anything you wish.
  300.  
  301.         The following is a sample OS2 server record:
  302.  
  303.         yyyyyyyyyyyy os22116T.cnf  3 10 N ~  (con't on next line)
  304.               OS2~IBM~16/4~II  ~ ~ ,,, ~ R_21_O16 ~ ~
  305.  
  306.             'os22116T.cnf' = the CNF file created in step 9.
  307.  
  308.             'OS2~new~adapter~description' can be any descriptive
  309.             string you want.  It is recommended that the first
  310.             three characters be 'OS2'.  Embedded blanks are not
  311.             allowed and must be replace with the '~' (tilde)
  312.             character.
  313.  
  314.             'R_20_OIBM16TR' is a unique string that does not appear in
  315.             any other field 12 server record.  The first six
  316.             characters should be 'R_21_O' where 21 indicates the
  317.             OS/2 operating system type, i.e. 20, 2A, or 21.
  318.             The remaining characters can be anything you wish.
  319.  
  320.     Note: The sample server records have been split into two lines
  321.           for readablility.  The server record in RPL.MAP must be
  322.           a single line of data.
  323.  
  324.     It will now be possible to select the new server records when
  325.     defining RIPL clients.  The server record selected determines
  326.     what files are used to configure the RIPL client.
  327.  
  328.     Default RIPL clients are configured for family 2(MCA) machines
  329.     with VGA displays.  If the adapter added is for an ISA/EISA
  330.     type machine, then do the following:
  331.  
  332.     a.  Create a RIPL client model machine for the adapter.  For
  333.         example, MODEL16T.
  334.  
  335.     b.  If you do not have the new RIPL Support updates for OS/2 2.1,
  336.         do the following:
  337.  
  338.         -   Update the file \IBMLAN\RPL\FITS\MODEL16T.FIT. Locate the
  339.             following entries:
  340.  
  341.             ; PS/2 MACHINES
  342.             ; d:\OS2\MDOS\VDMA.SYS   OS2.2x\OS2\MDOS\VDMAPS2.SYS
  343.             ; AT MACHINES
  344.             ; d:\OS2\MDOS\VDMA.SYS   OS2.2x\OS2\MDOS\VDMAAT.SYS
  345.  
  346.             and change them to:
  347.  
  348.             ; PS/2 MACHINES
  349.             ; d:\OS2\MDOS\VDMA.SYS   OS2.2x\OS2\MDOS\VDMAPS2.SYS
  350.             ; AT MACHINES
  351.             ; d:\OS2\MDOS\VDMA.SYS   OS2.2x\OS2\MDOS\VDMAAT.SYS
  352.  
  353.             d: = the RIPL boot drive id
  354.             OS2.2x identifies the OS/2 being booted
  355.  
  356.     -   Update the file \IBMLAN\RPL\MACHINES\MODEL16T\CONFIG.20.
  357.         Locate the following entries:
  358.  
  359.         REM SELECT EITHER THE FAMLIY 1 OR PS/2 BASE DEVICE DRIVERS,...
  360.         REM BASE DEVICE DRIVER STATEMENTS FOR IBM FAMILY 1 AND ...
  361.         REM BASEDEV=PRINT01.SYS
  362.         REM BASEDEV=IBM1FLPY.ADD
  363.         REM BASEDEV=IBM1S506.ADD
  364.  
  365.         REM BASE DEVICE DRIVER STATEMENTS FOR IBM PS/2 COMPUTERS ONLY:
  366.         BASEDEV=PRINT02.SYS
  367.         BASEDEV=IBM2FLPY.ADD
  368.         BASEDEV=IBM2ADSK.ADD
  369.         BASEDEV=IBM2SCSI.ADD /LED
  370.  
  371.         and change them to:
  372.  
  373.         REM SELECT EITHER THE FAMLIY 1 OR PS/2 BASE DEVICE DRIVERS,...
  374.         REM BASE DEVICE DRIVER STATEMENTS FOR IBM FAMILY 1 AND ...
  375.         BASEDEV=PRINT01.SYS
  376.         BASEDEV=IBM1FLPY.ADD
  377.         BASEDEV=IBM1S506.ADD
  378.  
  379.         REM BASE DEVICE DRIVER STATEMENTS FOR IBM PS/2 COMPUTERS ONLY:
  380.         REM BASEDEV=PRINT02.SYS
  381.         REM BASEDEV=IBM2FLPY.ADD
  382.         REM BASEDEV=IBM2ADSK.ADD
  383.         REM BASEDEV=IBM2SCSI.ADD /LED
  384.  
  385.     c.  If you do have the new RIPL Support updates for OS/2 2.1,
  386.         then use the RPLSETD.CMD procedure to update the client
  387.         definition for MODEL16T.  For example,
  388.  
  389.         RPLSETD /C:MODEL16T /B:ISA
  390.  
  391.  
  392. Authored by LS
  393. Date last updated:  03/31/94
  394. XA25027
  395.  
  396.  
  397.  
  398. 12/31/99
  399.