REMOTE IPL WORKSTATION WITH LAN SERVER
Support Bulletin: 5110. Rev: E
This document contains instructions on creating remote IPL workstations with LAN Server 2.0 above using Racore 16/4Mbs Token Ring Adapters. The first section contains instructions on setting up a DOS IPL station, and the second section contains instructions on setting up an OS/2 IPL station.
Creating a DOS Remote IPL Workstation
1. Ensure that OS/2 version 1.3 or above is installed on the server.
NOTE: Because of the large amount of disk access required on the RIPL server, using the High Performance File System, HPFS, is suggested.
2. Ensure that IBM LAN Server version 2.0 or above is also installed on the server, and the following selections have been made.
A. Select "Advanced Installation" at the "Basic or Advanced Installation/Configuration" window.
B. Mark the "DOS IPL Service" to be installed at the "Install and Remove" window.
C. At the "Copy Programs" window, select "DOS LAN Requester", "LAN Support Program", and the DOS version you wish to RIPL with.
If you chose a version of MS-DOS to be installed, you will be prompted to enter in the number of disks to be copied.
3. Create a new Boot Block Configuration file modeled after DOSBBTR.CNF.
A. Copy DOSBBTR.CNF, located in the \IBMLAN\RPL subdirectory, to a new filename.
Example:
COPY DOSBBTR.CNF RAC_DOS.CNF
B. Edit the new file replacing the DXMC0MOD.SYS driver with the RTR16ASI.SYS driver.
C. On the DRV RTR16ASI.SYS line, replace the second ~ with a 10.
Example:
DRV RTR16ASI.SYS ~ 10 M
An example of a DOS Boot Block Configuration file can be found in Appendix A.
4. Copy the RTR16ASI.SYS driver from the \ASI\ subdirectory on the Racore Driver Diskette that accompanied your adapter, to the \IBMLAN\DOSLAN\LSP\ subdirectory on your server's hard drive.
5. Edit the RPL.MAP file adding an additional server record. The fields in the new server record should contain the same values as the default DOS Token-Ring server record, DOS~TOKR, with the following exceptions.
Field 2 should contain the file name of the Racore Boot Block Configuration file. This is the file that was created in step #3.
Field 7 should contain a descriptive comment for this server record.
Field C, Server Record Identifier, should contain a unique name indicating workstation type. This field must begin with the character r.
An example of a RPL Map file can be found in Appendix B.
6. Log onto the network with an Administrator ID, and then run the "GETRPL" utility by typing GETRPL at an OS/2 command prompt.
The "RemoteBoot" service must NOT be running for "GETRPL" to complete successfully.
7. Start the "RemoteBoot" service. This can be done by typing NET START RIPL at the OS/2 command prompt or selecting "Network Services" from the "Actions" menu of the full screen interface.
8. Create a Machine Definition by selecting "Machine Parameters..." from the "Definitions" menu of the full screen interface. Ensure that the Server Record Identifier created in step 5 is chosen, and the correct DOS version is selected for the Image ID.
Creating an OS/2 Remote IPL Workstaion
This section contains instructions on how to set-up a Remote IPL workstation running OS/2 2.X.
1. Ensure that OS/2 version 1.3 or above is installed on the server.
NOTE: Because of the large amount of disk access required on a RIPL server, using the HighPerformance File System, HPFS, is suggested.
2. Ensure that IBM LAN Server version 2.0 or above is also installed on the server, the latest CSDs have been applied to the IBM LAN Server software, and the following selections have been made.
A. Select "Advanced Installation" at the "Basic or Advanced Installation/Configuration" window.
B. Mark the "OS/2 IPL Service" to be installed at the "Install and Remove" window.
C. At the "Copy Programs" window, select the "DOS LAN Requester" and the "LAN Support Program".
NOTE: The "RIPLINST" utility can be found on Diskette #7 of the OS/2 2.X installation diskette set. To copy it to the server, type UNPACK A:RIPLINST at the OS/2 command prompt.
3. Run the "RIPLINST" utility by typing RIPLINST at the OS/2 command prompt. This will copy the OS/2 2.X files from diskette to the server's hard disk, and is required even if OS/2 2.X is running as the server's operating system.
NOTE: If you will be RIPLing an IBM PS/2 Model 56, you must update your OS/2 BIOS drivers to include SF838XX.BIO. This can be done by completing the following:
a. Copy the SF838XX.BIO file from the Model 56 Reference Diskette to the server in the \IBMLAN\RPL\OS2.2x\OS2 subdirectory.
b. Edit the ABIOS.SYS file, found in the \IBMLAN\RPL\OS2.2x\OS2 subdirectory, and add the line SF838XX.BIO to the top of the file.
4. Create a new Boot Block Configuration file modeled after OS220TR.CNF (for OS/2 2.0) or OS221TR.CNF (for OS/2 2.1).
A. Copy OS221TR.CNF, located in the \IBMLAN\RPL subdirectory, to a new filename.
Example:
COPY OS221TR.CNF RAC_OS2.CNF
B. Edit the new file replacing the DXMC0MOD.SYS driver with the RTR16ASI.SYS driver.
C. On the DRV RTR16ASI.SYS line, replace the second ~ with a 10.
Example:
DRV RTR16ASI.SYS ~ 10
An example of an OS/2 Boot Block Configuration file can be found in Appendix C.
A. Copy the RTR16ASI.SYS driver from the \ASI\ subdirectory on the Racore Driver Diskette that accompanied your adapter, to the \IBMLAN\DOSLAN\LSP\ subdirectory on your server's hard drive.
B. Edit the RPL.MAP file located in the \IBMLAN\RPL\ subdirectory adding an additional server record. The fields in the new server record should contain the same values as the default OS/2 Token-Ring server record, OS2~20~TOKR (for OS/2 2.0) or OS2~21~TOKR (for OS/2 2.1), with the following exceptions.
Field 2 should contain the file name of the Racore Boot Block Configuration file. This is the new file that was created in step #3.
Example:
change OS221TR.CNF to RAC_OS2.CNF
Field 7 should contain a descriptive comment for the server record. This comment can be anything that will indicate to you that this is the Racore server record.
Example:
change OS2~21~TOKR to OS2~21~RAC
Field C, the Server Record Identifier, should contain a unique name indicating workstation type.
This field must begin with the character R. This identifier can be anything that will indicate to you that this is the Racore server record.
Example:
change R_21_OTK to R_21_RAC
An example of a RPL Map file can be found in Appendix B.
7. If the server is not currently started, start it by typing NET START SERVER at the OS/2 command prompt. Log onto the network with an Administrator ID, and then run the "GETRPL" utility by typing GETRPL at an OS/2 command prompt.
The "RemoteBoot" service must NOT be running for "GETRPL" to complete successfully.
8. Start the "RemoteBoot" service. This can be done by typing NET START RIPL at the OS/2 command prompt or selecting "Network Services" from the "Actions" menu of the full screen interface.
9. For each workstation you want to RIPL, you must create a Machine Definition. This is best done from the full screen interface (typing NET at the OS2 command prompt).
A. Select "Definitions" from the main menu.
B. Select "Machine Parameters..." from the definitions menu.
C. After selecting the -NEW- definition, choose "Actions" and then "Create" to begin the Machine Definition creation process.
D. At Machine Type prompt, select "Remote IPL Workstation".
E. Provide a parameter for Machine ID, Network Adapter Number, and Remote IPL Server
For additional information and parameter requirements, press F1 (Help) or F4 (List) while the cursor is in the appropriate field.
F. For the Server Record Identifier, select R_20_OTK (for OS/2 2.0) or R_21_OTK (for OS/2 2.1).
G. When prompted for the File Index Table (FIT) file to model, press F4 and select the DEFALT20.FIT (for OS/2 2.0) or DEFALT21.FIT (for OS/2 2.1) file.
10. After creating a Machine Definition for each workstation you want to RIPL, edit the RPL.MAP file located in the IBMLAN\RPL subdirectory. For each Machine Definition that was created, a Workstation Record was created and appended to the bottom of the RPL.MAP file. For each of these new Workstation Records, change the Server Record pointers (R_20_OTK or R_21_OTK) to the Racore Server Record pointer that you created in step #7.
An example of a RPL Map file can be found in Appendix B.
11. Copy the RTR16NDS.OS2 abd RTR16NDS.NIF files to the \IBMLAN\RPL\IBMCOM\MACS\ subdirectory on your server's hard drive, and copy the RTR16NDS.MSG file to your server's hard drive in the \IBMLAN\machine_id\ subdirectory where machine_id is the name you chose in step 9- E..
The RTR16NDS.* files can be found in the \IBMCOM.OS2\ subdirectory of the Racore Drivers Diskette that accompanied your adapter.
13. Edit the CONFIG.20 file located in the \IBMLAN\RPL\MACHINES\machine_id\ subdirectory, where machine_id is the name you chose in step 9-E. Replace the
DEVICE=C:\IBMCOM\MACS\IBMTOK.OS2 line with
DEVICE=C:\IBMCOM\MACS\RTR16NDS.OS2.
An example of a CONFIG.20 file can be found in Appendix D.
NOTE: Ensure that you are using the correct device drivers for your machine type and video display in your CONFIG.20 and machine_id.FIT files. Refer to the IBM Administrators Reference for more information on machine type and video display drivers.
14. Edit the PROTOCOL.INI file located in the \IBMLAN\RPL\MACHINES\machine_id\ subdirectory. Add the statement RTR16NDS_NIF=RTR16NDS.nif to the [IBMLXCFG] section. Change the bindings statements in each protocol section to read BINDINGS=RTR16NDS_NIF, and add the following MAC section:
[RTR16NDS_NIF]
DRIVERNAME=RTRNDS$
RPL =
An example of a PROTOCOL.INI file can be found in Appendix E.
Appendix A - RAC_DOS.CNF
; DOS Boot Block Configuration (Racore Token Ring)
BASE 7C0H
RPL DOS\RPLBOOT.SYS
LDR DOS\RPLLOADR.COM ~
DAT C:\IBMLAN\DOSLAN\LSP\DXM.MSG
DRV C:\IBMLAN\DOSLAN\LSP\DXMT0MOD.SYS PBA=0~S=12~ST=12~C=14~O=Y ~
DRV C:\IBMLAN\DOSLAN\LSP\RTR16ASI.SYS ~ 10 M
DRV C:\IBMLAN\DOSLAN\LSP\DXMA0MOD.SYS 001 ~ M
Appendix B - RPL.MAP
; server record fields:
; 1 = ;yyyyyyyyyyyy
; 2 = boot block configuration file (.cnf)
; 3 = number of retries before default boot
; 4 = time window for retries (in seconds)
; 5 = acknowledge (A,N)
; 6 = loader parameters (~ for os2, image share name for dos)
; 7 = descriptive comment
; 8,9, = ~
; A = ,,,
; B = ~
; C = workstation type; first letter is always R
; D,E = ~
; server records for os2
yyyyyyyyyyyy rac_os2.cnf 3 10 N ~ OS2~21~RAC ~ ~ ,,, ~ R_21_RAC~ ~
yyyyyyyyyyyy os221tr.cnf 3 10 N ~ OS2~21~TOKR ~ ~ ,,, ~ R_21_OTK~ ~
; server records for dos
yyyyyyyyyyyy rac_dos.cnf 3 10 N IBMLAN$ DOS~RAC ~ ~ ,,, Z R_RAC~ ~
yyyyyyyyyyyy dosbbtr.cnf 3 10 N IBMLAN$ DOS~TOKR ~ ~ ,,, Z R_DTK~ ~
yyyyyyyyyyyy pcinit.cnf 3 10 N PCNET INTERNAL~USE~ONLY ~ ~ ,,,~ R_PCINIT ~ ~
; workstation record fields:
; 1 = adapter id (12 hex digits)
; 2 = workstation name
; 3 = ~
; 4 = image file for dos (.img), fit file for os2 (.fit)
; 5 = name of rpl server
; 6 = boot drive for OS2, domain name for DOS
; 7,8,9 = parameters for device drivers 1,2,3
; A = additional memory for device drivers 1,2,3. Default: ,,,
; B = ~ for os2, Z for dos
; C = workstation type; first letter is R -> enabled, D -> disabled
; D = ~
; E = volumeid string
; F = P for OS/2 PCNet clients only
; default workstation records
100FFFFFFFFF DEFAULT ~ imagefile LS_HPFS DOMAIN ~ ~ ~ ,,, ZR_DTK ~ ~
1000FFFFFFFF DEFAULT ~ FITS\DEFAULT LS_HPFS ~ ~ ~ ~ ,,, ~R_20_OTK ~ ~
10005A255CD4 RAC_AT ~ FITS\IBM_AT LS_HPFS Z ~ ~ ~ ,,, ~ R_21_RAC~ ~ ~
10005A384184 IBM_P2 ~ FITS\IBM_P2 LS_HPFS Z ~ ~ ~ ,,, ~ R_21_OTK~ ~ ~
10001A00BC3D RECEPT ~ STD3550 LS_HPFS DOMAIN ~ ~ ~ ,,, Z R_RAC~ ~
Appendix C - RAC_OS2.CNF
; OS/2 Boot Block Configuration (Racore Token Ring)
;
RPL DOS\RPLBOOT.SYS
DAT OS2\MFSD20.SYS
ORG 1000H
LDR OS2.21\OS2LDR ~ OS2LDR UFSD.SYS MFSD20.SYS
DAT DOS\UFSD.SYS
DAT C:\IBMLAN\DOSLAN\LSP\DXM.MSG
DRV C:\IBMLAN\DOSLAN\LSP\DXMT0MOD.SYS PBA=0~O=Y~ ~
DRV C:\IBMLAN\DOSLAN\LSP\RTR16ASI.SYS ~ 10
DRV C:\IBMLAN\DOSLAN\LSP\DXMA0MOD.SYS 001 ~
Appendix D - CONFIG.20
PROTSHELL=Z:\OS2\PMSHELL.EXE
DEVICE=Z:\IBMCOM\LANMSGDD.OS2 /I:Z:\IBMCOM
DEVICE=Z:\IBMCOM\PROTMAN.OS2 /I:Z:\IBMCOM
DEVICE=Z:\IBMCOM\MACS\RTR16NDS.OS2
DEVICE=Z:\IBMCOM\PROTOCOL\LANDD.OS2
DEVICE=Z:\IBMCOM\PROTOCOL\NETBEUI.OS2
DEVICE=Z:\IBMCOM\PROTOCOL\LANDLLDD.OS2
RUN=Z:\IBMCOM\PROTOCOL\LANDLL.EXE
RUN=Z:\IBMCOM\LANMSGEX.EXE
DEVICE=Z:\IBMLAN\NETPROG\RDRHELP.200
IFS=Z:\IBMLAN\NETPROG\NETWKSTA.200 /I:Z:\IBMLAN
IFS=Z:\OS2\HPFS.IFS /CACHE:512 /CRECL:4 /AUTOCHECK:C
DEVICE=Z:\IBMCOM\PROTOCOL\NETBIOS.OS2
SET USER_INI=Z:\OS2\OS2.INI
SET SYSTEM_INI=Z:\OS2\OS2SYS.INI
SET OS2_SHELL=Z:\OS2\CMD.EXE
SET AUTOSTART=PROGRAMS,TASKLIST,FOLDERS
SET RUNWORKPLACE=Z:\OS2\PMSHELL.EXE
SET COMSPEC=Z:\OS2\CMD.EXE
LIBPATH=.;Z:\OS2\DLL;Z:\IBMLAN\NETLIB;Z:\MUGLIB\DLL;PS\DLL
SET PATH=Z:\OS2;Z:\OS2\SYSTEM;Z:\IBMLAN\NETPROG;Z:\MUGLIB;2\APPS
SET DPATH=Z:\OS2;Z:\OS2\SYSTEM;Z:\IBMLAN\NETPROG;Z:\IBMCOM;\APPS
SET PROMPT=$i[$p]
SET HELP=Z:\OS2\HELP;Z:\OS2\HELP\TUTORIAL;Z:\IBMLAN\HELP;
SET GLOSSARY=Z:\OS2\HELP\GLOSS;
PRIORITY_DISK_IO=YES
FILES=20
DEVICE=Z:\OS2\TESTCFG.SYS
DEVICE=Z:\OS2\DOS.SYS
DEVICE=Z:\OS2\PMDD.SYS
BUFFERS=30
IOPL=YES
rem DISKCACHE=64,LW
MAXWAIT=3
MEMMAN=SWAP,PROTECT
REM Use the following statement for SWAPPER.DAT on server:
SWAPPATH=Z:\OS2\SYSTEM 4096 1024
REM Use the following statement for SWAPPER.DAT on workstation:
REM SWAPPATH=C:\ 1024 2048
BREAK=OFF
THREADS=512
PRINTMONBUFSIZE=134,134,134
COUNTRY=001,Z:\OS2\SYSTEM\COUNTRY.SYS
SET KEYS=ON
SET DELDIR=Z:\DELETE,512;
REM Select either the Family 1 or PS/2 Base Device Drivers, not
REM Base Device Driver Statements for IBM Family 1 and compatible
REM BASEDEV=PRINT01.SYS
REM BASEDEV=IBM1FLPY.ADD
REM BASEDEV=IBM1S506.ADD
REM Base Device Driver Statements for IBM PS/2 computers only:
BASEDEV=PRINT02.SYS
BASEDEV=IBM2FLPY.ADD
BASEDEV=IBM2ADSK.ADD
BASEDEV=IBM2SCSI.ADD /LED
SET BOOKSHELF=Z:\OS2\BOOK;Z:\IBMLAN\BOOK;
SET EPATH=Z:\OS2\APPS
BASEDEV=OS2SCSI.DMD
BASEDEV=OS2DASD.DMD
PROTECTONLY=NO
SHELL=Z:\OS2\MDOS\COMMAND.COM Z:\OS2\MDOS /P
FCBS=16,8
RMSIZE=640
DEVICE=Z:\OS2\MDOS\VEMM.SYS
REM DEVICE=Z:\OS2\MDOS\VMOUSE.SYS
DOS=LOW,NOUMB
DEVICE=Z:\OS2\MDOS\VDPX.SYS
DEVICE=Z:\OS2\MDOS\VXMS.SYS /UMB
DEVICE=Z:\OS2\MDOS\VDPMI.SYS
DEVICE=Z:\OS2\MDOS\VWIN.SYS
DEVICE=Z:\OS2\MDOS\VCDROM.SYS
DEVINFO=SCR,VGA,Z:\OS2\VIOTBL.DCP
DEVICE=Z:\OS2\MDOS\VVGA.SYS
REM Use the following 4 statements for workstations with XGA
DEVICE=Z:\OS2\XGARING0.SYS
DEVICE=Z:\OS2\MDOS\VXGA.SYS
SET VIDEO_DEVICES=VIO_XGA
SET VIO_XGA=DEVICE(BVHVGA,BVHXGA)
REM Use the following 2 statements for workstations with VGA
rem SET VIDEO_DEVICES=VIO_VGA
rem SET VIO_VGA=DEVICE(BVHVGA)
DEVICE=Z:\OS2\POINTDD.SYS
DEVICE=Z:\OS2\MOUSE.SYS
DEVICE=Z:\OS2\COM.SYS
DEVICE=Z:\OS2\MDOS\VCOM.SYS
CODEPAGE=437,850
DEVINFO=KBD,US,Z:\OS2\KEYBOARD.DCP
RUN=Z:\IBMLAN\NETPROG\LSDAEMON.EXE
Appendix E - PROTOCOL.INI
[PROT_MAN]
DriverName = PROTMAN$
[IBMLXCFG]
RTR16NDS_nif = RTR16NDS.nif
LANDD_nif = LANDD.nif
NETBEUI_nif = NETBEUI.nif
;*------------------------------------------------------------*
;*------------- PROTOCOL SECTION ---------------*
;*------------------------------------------------------------*
[LANDD_nif]
DriverName = LANDD$
Bindings = RTR16NDS_nif
ETHERAND_TYPE = "I"
SYSTEM_KEY = 0x0
OPEN_OPTIONS = 0x2000
TRACE = 0x0
LINKS = 8
MAX_SAPS = 3
MAX_G_SAPS = 0
USERS = 3
TI_TICK_G1 = 255
T1_TICK_G1 = 15
T2_TICK_G1 = 3
TI_TICK_G2 = 255
T1_TICK_G2 = 25
T2_TICK_G2 = 10
IPACKETS = 250
UIPACKETS = 100
MAXTRANSMITS = 6
MINTRANSMITS = 2
TCBS = 64
GDTS = 30
ELEMENTS = 800
[NETBEUI_nif]
DriverName = netbeui$
Bindings = RTR16NDS_nif
ETHERAND_TYPE = "I"
USEADDRREV = "YES"
SESSIONS = 40
NCBS = 85
NAMES = 17
SELECTORS = 5
USEMAXDATAGRAM = "NO"
ADAPTRATE = 1000
WINDOWERRORS = 0
TI = 30000
T1 = 500
T2 = 200
MAXIN = 1
MAXOUT = 1
NETBIOSTIMEOUT = 500
NETBIOSRETRIES = 8
NAMECACHE = 0
PIGGYBACKACKS = 1
DATAGRAMPACKETS = 2
PACKETS = 350
PIPELINE = 5
MAXTRANSMITS = 6
MINTRANSMITS = 2
DLCRETRIES = 5
;*-------------------------------------------------------*
;*--------------- MAC SECTION ------------------*
;*-------------------------------------------------------*
[RTR16NDS_nif]
DriverName = RTRNDS$
RPL =
