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 =