home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / unix-faq / unixware / autoconfig next >
Encoding:
Text File  |  1997-08-10  |  34.2 KB  |  908 lines

  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!newsxfer3.itd.umich.edu!howland.erols.net!cpk-news-hub1.bbnplanet.com!news.bbnplanet.com!dispatch.news.demon.net!demon!tamarix.demon.co.uk!tamarix!andrew
  2. From: andrew@#nospam#tamarix.demon.co.uk (Andrew Josey)
  3. Newsgroups: comp.unix.unixware.misc,comp.answers,news.answers
  4. Subject: UnixWare Frequently Asked Questions (Autoconfiguration)
  5. Supersedes: <ECw2Ht.13D@tamarix.demon.co.uk>
  6. Date: Sun, 10 Aug 1997 07:46:02 GMT
  7. Organization: Home.
  8. Sender: news@tamarix.demon.co.uk
  9. Approved: news-answers-request@MIT.EDU
  10. Expires: Mon, 15 Sep 1997 00:00:00 GMT
  11. Message-ID: <EEotKq.wH@tamarix.demon.co.uk>
  12. NNTP-Posting-Host: localhost
  13. Summary: Answers to questions frequently asked about SCO's UnixWare product
  14. X-NNTP-Posting-Host: tamarix.demon.co.uk [158.152.252.110]
  15. X-Newsreader: TIN [version 1.2 PL2]
  16. Lines: 889
  17. Xref: senator-bedfellow.mit.edu comp.unix.unixware.misc:23573 comp.answers:27519 news.answers:109422
  18.  
  19. Archive-name: unix-faq/unixware/autoconfig
  20. Posting-Frequency: monthly
  21. Last-modified: May 12, 1996
  22. Version: 2.02
  23.  
  24. UnixWare« Frequently Asked Questions List (Autoconfiguration)
  25.  
  26. For more information about the files which compose the total UnixWare
  27. FAQ, see the "FAQ Overview" file posted regularly on the Internet newsgroup
  28. comp.unix.unixware.misc.
  29.  
  30. INTRODUCTION
  31.  
  32. The purpose of this document is to give answer frequently asked questions
  33. on the hardware configuration, the new administration tools, and common
  34. tasks using the autoconfiguration feature in UnixWare 2.
  35.  
  36. Its maintainer is Rob Dinoff (rdinoff@novell.com).  Suggestions and
  37. contributions welcome.
  38.  
  39. This document and the other FAQ files may be found on the world wide web at
  40. http://www.freebird.org/faq/
  41.  
  42. This document may also be obtained by anonymous ftp from the freebird
  43. archive at
  44.  
  45.    * ftp.freebird.org:/unixware/freebird/hints/FAQ/autoconfig
  46.    * ftp1.freebird.org:/pub/mirror/freebird/hints/FAQ/autoconfig
  47.    * ftp2.freebird.org:/pub/unixware/freebird/hints/FAQ/autoconfig
  48.  
  49. Small print: This file is Copyright 1996 freebird.org. Permission is granted
  50. for copying for non-commercial use. Many proper names of companies and
  51. software mentioned in these files are trademarks of their respective owners.
  52. All views are those of the individual contributors and not of their
  53. employers.
  54.  
  55. This article is posted monthly around the middle of the month.
  56.  
  57. ----------------------------------------------------------------------------
  58.  
  59. TABLE OF CONTENTS
  60.  
  61. Section 1: Overview of Autoconfiguration
  62.  
  63. A1) What is the Autoconfiguration feature?
  64. A2) What does Autoconfiguration mean to me?
  65. A3) What are the new Administration tools provided as part
  66.     of autoconfiguration?
  67. A4) How do I invoke the DCU ?
  68.  
  69. Section 2: Administration using the DCU
  70.  
  71. 2.1 ISA Board Specific Administration
  72.  
  73. A5) How do I Change the IRQ, IOADDRs, MEMADDRs, or DMA?
  74. A6) How do I Add an ISA board?
  75. A7) How do I Delete an ISA board?
  76. A8) How do I Add an internal modem?
  77. A9) How do I Add a dual serial board?
  78. A10) How do I Add a parallel port board?
  79.  
  80. 2.2 General Administration Section
  81.  
  82. A11) How do I Bind a driver to a specific CPU (MP systems only)?
  83. A12) How do I Change the UNIT parameter?
  84. A13) How do I Disable a board?
  85. A14) How do I Enable a previously disabled board?
  86.  
  87. 2.3 Special Case Administration Section
  88.  
  89. A15) How do I Determine Board ID's?
  90. A16) How do I Determine resmgr keys?
  91. A17) How do I Change the Boot HBA ?
  92. A18) How do I Move a board?
  93.  
  94. Section 3. Trouble Shooting.
  95.  
  96. A19) Trouble Shooting Problems during Installation.
  97. A20) Trouble Shooting Problems on an Installed System.
  98.  
  99. Section 4. Acknowledgements.
  100.  
  101. RELATED INFORMATION:
  102.  
  103. For additional information on the autoconfiguration feature, see
  104. the following related documents:
  105.  
  106.     o Installation Handbook.
  107.     o System Owner Handbook: Chapter 6.
  108.     o Device Driver Programming Guide: Chapter 3.
  109.     o Device Driver Reference Manual
  110.  
  111. ----------------------------------------------------------------------------
  112.  
  113. Section 1: Overview of Autoconfiguration
  114.  
  115. Subject: A1) What is the Autoconfiguration feature?
  116.  
  117. The autoconfiguration feature in UnixWare 2 incorporates several
  118. new kernel modules, changes to device driver initialization,
  119. and introduces several new administration tools.  From an
  120. administrator's perspective, the primary impact of autoconfiguration
  121. is related to how configuration changes are made, and if and when
  122. kernel rebuilds are needed.
  123.  
  124. In UnixWare 1.x, the configuration parameters for an expansion
  125. board are input by the user when installing the driver package
  126. and were stored in /etc/conf/sdevice.d/* files.  When the
  127. kernel was built using idbuild(1M), these configuration parameters
  128. were built into the resulting kernel.  If the administrator
  129. needed to change any of these parameters they had to edit these
  130. sdevice files, rebuild the kernel, and reboot the system.
  131.  
  132. In UnixWare 2, on EISA, MCA and PCI systems, the configuration
  133. parameters are read from Non-Volatile RAM (NVRAM).  Only ISA
  134. cards still require the user to enter this information.  The
  135. /etc/conf/sdevice.d/* (see System(4)) files still accurately
  136. reflect the configuration parameters, but they are no longer
  137. used to configure the drivers.  The configuration parameters
  138. are stored in /stand/resmgr, a binary file used to initialize
  139. a new kernel module, the resource manager.  Drivers then query
  140. the resource manager for their configuration parameters.
  141.  
  142. For EISA, MCA and PCI systems, hardware configuration changes
  143. are made using the Hardware Configuration Utility that came
  144. with the system and are then picked up automatically by UnixWare.
  145. For ISA cards, administrators change configuration parameters by
  146. changing the values within the resource manager.  The new
  147. administration tools discussed in a following section are used to
  148. make these changes, and then synchronize these changes with
  149. /stand/resmgr and the /etc/conf/sdevice.d/* files.  Rebuilding
  150. the kernel is rarely required.
  151.  
  152. Subject: A2) What does Autoconfiguration mean to me?
  153.  
  154. Autoconfiguration means different things to different people, to some
  155. it applies to every aspect of the hardware, main memory, display device,
  156. expansion boards, modems, etc.  In UnixWare 2.0, Autoconfiguration
  157. applies to bus expansion boards and the software that supports them.
  158. Let's clarify what we mean by "bus expansion boards and the software
  159. that supports them".
  160.  
  161. Bus expansion boards are cards that plug into slots within your
  162. computer.  Examples include networking cards, SCSI host bus adapters
  163. and modem cards.  Expansion boards are designed to provide access to
  164. different kinds of "devices".  We use the term "devices" loosely; in
  165. the case of SCSI host bus adapters, devices are just that, hard disks,
  166. cd-roms, tape drives, etc.  In the case of networking and modem cards,
  167. "devices" refer to "the computer network" and "the telephone network"
  168. respectively.
  169.  
  170. Hardware boards by themselves are useless without supporting software.
  171. The software modules supporting these boards are generally called
  172. "device drivers".  In order for the device driver to provide access to
  173. the expansion board, both the device driver and hardware must be
  174. "in-sync" with respect to the board's configuration parameters.  When we
  175. talk about "configuration parameters" we mean interrupt vector (IRQ),
  176. memory address range, I/O address range, direct memory access (DMA)
  177. channel, etc.
  178.  
  179. Two important definitions:
  180.  
  181. Autodetection: this is the ability to automatically determine information
  182. about the hardware, how much memory's installed, the bus type, disk
  183. capacity, presence of expansion boards, etc.  In the case of expansion
  184. boards, autodetection can range from simply identifying that a specific
  185. brand of ethernet card is installed (i.e XYZ Brand), or better yet,
  186. identifying the specific card installed (i.e. XYZ Ethernet 16), to the
  187. ability to glean some or possibly all configuration parameters relevant
  188. to the board's operation.
  189.  
  190. Autoconfiguration: this is the ability to automatically configure the
  191. system so the hardware is accessible.  There are two parts to
  192. autoconfiguration, configuring the software and configuring the
  193. hardware.  The simplest case here would be to simply accept the
  194. configuration parameters from the user, check for conflicts and then "do
  195. whatever's required" with the information to produce a running system.
  196. Obviously this functionality falls far short of most people's
  197. expectation regarding autoconfiguration, although in some cases (ISA
  198. boards in an ISA bus) that is the best we are able to provide.  The next
  199. level of functionality would be to configure the software dynamically
  200. based on information gleaned during autodetection without asking the user
  201. for configuration parameters.  The ideal case would be to automatically
  202. change hardware settings and/or software configuration such that no
  203. action whatsoever from the user was required.
  204.  
  205. For UnixWare 2.O, the Autoconfiguration Feature supports autodetecting
  206. the boards and their configuration parameters (if and when possible) and
  207. using these configuration parameters to autoconfigure the device
  208. drivers.  We do NOT currently support autoconfiguring the hardware
  209. itself.
  210.  
  211. It would be nice if autoconfiguration in UnixWare 2.0 would address all
  212. aspects of hardware configuration, however it is not a panacea.  It is
  213. important that you understand what autoconfiguration will NOT provide.
  214.  
  215. Autoconfiguration for UnixWare 2.0 does not provide the following:
  216.  
  217.     o Automatic resolution of ISA expansion board configuration conflicts.
  218.  
  219. Most ISA boards are configured via dip switches and jumpers.  If you
  220. do not configure these boards correctly before they are installed, the
  221. only solution will be for you to re-configure the boards to remove any
  222. conflicts.  You will also have to enter the correct configuration
  223. parameters when prompted.  Autoconfiguration does provide functionality
  224. to help identify which boards and configuration parameters are conflicting,
  225. The DCU will allow you to change the software configuration parameters
  226. in the event wrong information was inadvertently input during package
  227. installation.
  228.  
  229. When you invoke the DCU you will get a warning message about which
  230. boards and configuration parameters are conflicting, you can then go modify
  231. the parameters to the appropriate values.  See section 2.1 for more
  232. on modifying the IRQ, IOADDRs, MEMADDRs, or DMA.
  233.  
  234.    o Configuring hardware attached to ports (i.e serial, parallel, PS/2)
  235.  
  236. The DCU configures hardware controllers, not devices attached to them.
  237. The tools to configure these types of hardware devices should already be
  238. available.  For example, to configure the mouse use mouseadmin(1).
  239.  
  240.    o Replacing one expansion board with another and expecting the system
  241.      to reboot into the same operational state.
  242.  
  243. A simple example would be to replace your networking board.  Unless you
  244. replace your old board with the exact same board, or another board
  245. supported by the same driver, your networking will not be working when
  246. you reboot.  Any time you exchange boards, you will need to install the
  247. appropriate software to support the new board.  Even if the correct
  248. software was installed, other "network specific" software configuration
  249. is required.  Autoconfiguration does NOT provide the additional software
  250. configuration; the necessary tools are provided in the network package.
  251.  
  252.    o For those expansion boards that support hardware configuration via
  253.      non-volatile RAM (NVRAM), UnixWare 2 does not assign configuration
  254.      parameters to boards by writing NVRAM.
  255.  
  256. This functionality is already provided by the hardware vendors with their
  257. Hardware Configuration Utility.
  258.  
  259. Subject: A3) What are the new Administration tools provided as part
  260.               of autoconfiguration?
  261.  
  262.     Several new administration tools were introduced in UnixWare 2
  263.     to support the Autoconfiguration feature.
  264.  
  265.     o /sbin/dcu(1M): the Device Configuration Utility (DCU) is the
  266.       primary interface into the Autoconfiguration system.  The DCU
  267.       provides the ability to map hardware instances to device drivers,
  268.       detect parallel and serial ports, view or edit the current
  269.       configuration, and detect hardware conflicts that would
  270.       subsequently cause idbuild(1M) failures.  It also provides a way
  271.       to modify the configuration, should a board be added, removed or
  272.       configured.  In the case of EISA/MCA/PCI machines, most of the
  273.       configuration can be determined automatically.
  274.  
  275.       However, the DCU is not intended to be the primary method for
  276.       configuration.  It is assumed that on these machines, the hardware
  277.       will be properly configured via the Hardware Configuration Utility
  278.       that is provided with the machine.  If a board needs to be
  279.       reconfigured, it will be necessary to rerun the Hardware Configuration
  280.       Utility and UnixWare 2, will attempt to automatically incorporate the
  281.       change.  Basically, UnixWare 2, will read information from NVRAM but
  282.       will not write information out to NVRAM.
  283.  
  284.       In addition, the DCU is not intended as the mechanism for installing
  285.       drivers.  Drivers will continue to be provided as packages that
  286.       can be installed via the standard packaging utilities.
  287.  
  288.     o /sbin/resmgr(1M): the resmgr command provides a raw interface
  289.       into the resource manager kernel module.  It can be used to
  290.       make unrestricted changes to the in-core database.  If at all
  291.       possible, use the DCU to make configuration changes.  This tool
  292.       should be used cautiously; it provides unrestricted/un-validated
  293.       access to the resource manager's database.
  294.  
  295.     o /etc/conf/bin/idconfupdate(1M): this command is primarily
  296.       used to synchronize the resource manager's in-core database with
  297.       /stand/resmgr and the /etc/conf/sdevice.d/* files.  The DCU
  298.       command automatically calls this to synchronize up everything unless
  299.       you opt to cancel your changes when you exit.  The resmgr command
  300.       does NOT synchronize anything.  If you make changes to the in-core
  301.       resource manager database, AND you want these changes to be
  302.       permanent, you need to call idconfupdate to synchronize up all the
  303.       files.
  304.  
  305.       See the manual pages for a complete description of these commands.
  306.  
  307. Subject: A4) How do I invoke the DCU?
  308.  
  309. As you use/read this document, many of the instructions start
  310. with "Invoke the DCU."  The DCU can be invoked several ways.
  311. During installation, "Invoking the DCU" is very specific, it
  312. can be invoked once and only once, if you miss your opportunity,
  313. the only alternative is to restart the installation.  During
  314. Installation, after you choose your keyboard type, you'll have
  315. the opportunity to install HBA floppies (if required) once you
  316. are done installing one or more HBA's, you will be given the choice
  317. of either continuing the installation, or "Enter the DCU", with the
  318. default being to continue.  To invoke the DCU, hit the <DOWN ARROW>
  319. key and then hit <RETURN> or <ENTER>.
  320.  
  321. If you need to invoke DCU on a running system, there are three ways:
  322.  
  323.    1.  From the Desktop, select Admin_tools, then open
  324.        Hardware_setup.
  325.  
  326.    2.  From the Desktop, open an terminal window, su(1M) to root,
  327.        and then type dcu.
  328.  
  329.    3.  Log in at the "Console Login:" prompt as root, and
  330.        type dcu.
  331.  
  332.        Note: you have to be root to execute the DCU or know the root
  333.        password if using Hardware_setup.
  334.  
  335. Section 2: Administration using the DCU
  336.  
  337. This section is broken up into three parts:
  338.  
  339.     o ISA Board Specific Administration
  340.  
  341.     o General Administration
  342.  
  343.     o Special Case Administration
  344.  
  345. 2.1 ISA Board Specific Administration
  346.  
  347. Subject: A5) How do I Change the IRQ, IOADDRs, MEMADDRs, or DMA?
  348.  
  349. This only applies to ISA boards. The entries for EISA, MCA
  350. and PCI are read-only, you need to use the Hardware
  351. Configuration utility that came with the system to make changes
  352. on those systems.
  353.  
  354.    1.  Invoke the DCU.
  355.  
  356.    2.  Select "Hardware Device Configuration" and hit <ENTER>.
  357.  
  358.    3.  Move the cursor to the line for the entry you want
  359.        change.
  360.  
  361.    4.  Mover the cursor to the field you want to change and
  362.        enter the new value.
  363.  
  364.    5.  Hit F10 to exit form.
  365.  
  366.    6.  Hit F10 again to return to main menu.
  367.  
  368.    7.  Select "Apply Changes & Exit DCU"
  369.  
  370. Subject: A6) How do I Add an ISA board?
  371.  
  372.    1.  If the driver supporting the board you want to add is
  373.        NOT installed, install it using pkgadd(1M).
  374.  
  375.    2.  Invoke the DCU.
  376.  
  377.    3.  Select "Software Device Drivers" and hit <ENTER>.
  378.  
  379.    4.  Select the category of driver you want or "All" for a
  380.        list of all the drivers available.
  381.  
  382.    5.  Page Up/Down to the driver that supports the new ISA board.
  383.  
  384.    6.  Use the <SPACEBAR> to select the driver.
  385.  
  386.    7.  Hit F5 to create a new instance.
  387.  
  388.    8.  Enter all the correct configuration information for
  389.        the board.
  390.  
  391.    9.  Hit F10 to create the new entry.
  392.  
  393.   10.  Hit <ENTER> to return to the "Software Drivers" menu.
  394.  
  395.   11.  Select "Return to the DCU Main Menu"
  396.  
  397.   12.  Select "Apply Changes & Exit DCU"
  398.  
  399. Subject: A7) How do I Delete an ISA board?
  400.  
  401.    1.  Invoke the DCU.
  402.  
  403.    2.  Select "Hardware Device Configuration" and hit <ENTER>
  404.  
  405.    3.  Move the cursor to the line for the entry you want to delete.
  406.  
  407.    4.  Mover the cursor to the first field and change the "Y"
  408.        to "N".
  409.  
  410.    5.  Hit F10 again to return to main menu.
  411.  
  412.    6.  Select "Apply Changes & Exit DCU"
  413.  
  414. Subject: A8) How do I Add an internal modem?
  415.  
  416. To add an internal modem, follow the instructions in the
  417. section "Add an ISA board" and create a new entry for the asyc
  418. driver (Communications Card Driver).
  419.  
  420. Subject: A9) How to I add a dual serial board?
  421.  
  422. To add a dual serial board, follow the instructions in the
  423. section "Add an ISA board" and create two new entries for the asyc driver.
  424.  
  425. Subject: A10) How do I Add a parallel port board?
  426.  
  427. To add a  parallel port, follow the instructions in the section
  428. "Add an ISA board" and create a new entry for the mfpd driver.
  429.  
  430. 2.2 General Administration Section
  431.  
  432. Subject: A11)  How do I Bind a driver to a specific CPU (MP systems only)?
  433.  
  434.    1.  Invoke the DCU.
  435.  
  436.    2.  Select "Hardware Device Configuration" and hit <ENTER>
  437.  
  438.    3.  Move the cursor to the line for the entry you want to
  439.        bind to a specific CPU.
  440.  
  441.    4.  Hit F7 to edit the advanced parameters
  442.  
  443.    5.  Change the BindCPU value to the CPU you want to bind
  444.        the driver to.
  445.  
  446.    6.  Hit F10 to exit form.
  447.  
  448.    7.  Hit F10 again to return to main menu.
  449.  
  450.    8.  Select "Apply Changes & Exit DCU"
  451.  
  452. Subject: A12) How do I Change the UNIT parameter?
  453.  
  454.    1.  Invoke the DCU.
  455.  
  456.    2.  Select "Hardware Device Configuration" and hit <ENTER>
  457.  
  458.    3.  Move the cursor to the line for the entry you want to change.
  459.  
  460.    4.  Hit F7 to edit the advanced parameters.
  461.  
  462.    5.  Change the  UNIT field to the value you want.
  463.  
  464.    6.  Hit F10 to exit form.
  465.  
  466.    7.  Hit F10 again to return to main menu.
  467.  
  468.    8.  Select "Apply Changes & Exit DCU"
  469.  
  470. Subject: A13) How do I Disable a board?
  471.  
  472.    1.  Invoke the DCU.
  473.  
  474.    2.  Select "Hardware Device Configuration" and hit <ENTER>
  475.  
  476.    3.  Move the cursor to the line for the entry you want to disable.
  477.  
  478.    4.  If you plan to re-enable the board later, make note of
  479.        the current Device Name.
  480.  
  481.    5.  Mover the cursor to the Device Name field and enter "unused".
  482.  
  483.    6.  Hit F10 to exit form.
  484.  
  485.    7.  Hit F10 again to return to main menu.
  486.  
  487.    8.  Select "Apply Changes & Exit DCU"
  488.  
  489. Subject: A14) How do I Enable a previously disabled board?
  490.  
  491.    1.  Invoke the DCU.
  492.  
  493.    2.  Select "Hardware Device Configuration" and hit <ENTER>.
  494.  
  495.    3.  Move the cursor to the line for the entry you want re-enable.
  496.  
  497.    4.  Mover the cursor to the Device Name and enter the name
  498.        of the driver.  If needed, hit F2 for choices.
  499.  
  500.    5.  Hit F10 to exit form.
  501.  
  502.    6.  Hit F10 again to return to main menu.
  503.  
  504.    7.  Select "Apply Changes & Exit DCU".
  505.  
  506. 2.3 Special Case Administration Section
  507.  
  508. This section covers scenarios that should rarely be
  509. encountered.  From a hardware perspective, independent of
  510. UnixWare, changing boot HBA's is NOT guaranteed to work, but
  511. if you are willing to try, this might/should work.
  512.  
  513. Just to be safe, you should save a copy of the current kernel
  514. and resmgr file before you start.
  515.  
  516.     cp /stand/unix /stand/unix.good
  517.     cp /stand/resmgr /stand/resmgr.good
  518.  
  519. If the following instructions do not work, you need to go back to the
  520. old board, or reinstall from scratch with the new board.   If
  521. you want to go back to the old board, restore your original
  522. board using the same configuration parameters, then from the
  523. interactive boot(1M) set RESMGR=resmgr.good and KERNEL=unix.good.
  524.  
  525. If these instructions do work, it is important that you
  526. recreate your Emergency Recovery Diskette (emergency_disk(1M) or from
  527. the desktop) with the new configuration.
  528.  
  529. Subject: A15) How do I Determine Board ID's?
  530.  
  531. Some of the instructions in the following sections require
  532. changing the BRDID parameter in the resource manager database.
  533. The new board id you will need is different depending on the
  534. bus type.
  535.  
  536.        EISA: the board id is a 7 character string (e.g. "CPQ6100").
  537.  
  538.        MCA: the board id is EXACTLY a 4-digit hex number of the form
  539.             "0x1234".  Use 0's to  pad to four digits if needed,
  540.             "0x0123" is correct, "0x123" is wrong.
  541.  
  542.        PCI: the board id is an 8-digit hex number of the form
  543.             "0x12345678".  Do NOT pad a PCI board id with 0's.
  544.  
  545.        ISA: these cards have no board id.
  546.  
  547. It is not always easy to determine the board id for a given
  548. board.  In the case of EISA boards, the documentation that came
  549. with the board may or may not clearly indicate the board id.
  550. For MCA and PCI, the board id is something we have defined for
  551. UnixWare and it will not be clearly documented in the materials
  552. that came with the board.  A good place to start is
  553. the Drvmap(4) file for the driver that supports the new board.
  554. The Drvmap files are located in /etc/conf/drvmap.d/*.  If the
  555. new board is not listed in the Drvmap file, shutdown the
  556. system, insert the new board, but DO NOT remove the current
  557. board and DO NOT attach the boot device to the new board.   On
  558. an EISA or MCA system you will need to run the Hardware
  559. Configuration Utility.  Then reboot, login, and run /sbin/resmgr
  560. from  the shell.  The new board should be the last line and it
  561. should include the board id you need to complete the steps
  562. below.
  563.  
  564. Subject: A16) How do I Determine resmgr keys?
  565.  
  566. Some of the steps below require knowing the resource manager key
  567. for a specific entry.  To determine the key you need, run the the
  568. resmgr(1M) command.  The key is the first column of the output.
  569.  
  570. 2 fd 1 4 2 6 3f0 3f7 - - 2 - - - - 1
  571. KEY=2
  572.  
  573. Subject: A17) How do I Change the Boot HBA?
  574.  
  575. If you are replacing an ISA HBA with an ISA HBA:
  576.  
  577.    1.  Make sure the new board is using the exact same
  578.        configuration parameters as the current board, or use the DCU
  579.        to update the resmgr entry for the current board to reflect
  580.        the settings of the new board.  If you use the DCU to update
  581.        the existing resmgr entry, you MUST do it before you shutdown
  582.        and swap boards.
  583.  
  584.    2.  If the new HBA requires a different driver, make sure
  585.        the new driver is installed, or install it using pkgadd(1M).
  586.        Then:
  587.  
  588.        o If you had to use pkgadd to install the new driver, a new default
  589.          entry may have been added to the resource manager.  This entry
  590.          must be removed before you continue.  Run resmgr to check if a
  591.          default entry was added (it will be the last line of output).  If
  592.          so, delete this entry using "resmgr -r -k new_key".
  593.  
  594.        o Execute "resmgr -k key -p MODNAME -v modname"
  595.          where key is the key corresponding to the current ISA entry
  596.          and modname is the driver that supports the new board.
  597.  
  598.        o Run /etc/conf/bin/idconfupdate to synchronize up this
  599.          change with /stand/resmgr and the sdevice file.
  600.  
  601.        o Add $static to /etc/conf/sdevice.d/modname and
  602.          change the second field from "N" to "Y" if needed.
  603.  
  604.        o Execute /etc/conf/bin/idbuild -B to rebuild the kernel.
  605.  
  606.    3.  Shutdown your system.
  607.  
  608.    4.  Swap the boards.
  609.  
  610.    5.  Reboot the system.
  611.  
  612. If you are replacing a non-ISA (EISA or PCI) with an ISA HBA:
  613.  
  614.    1.  Update the parameters of the current resmgr entry for the
  615.        non-ISA board to match the new ISA board:
  616.  
  617.        resmgr -k key -p IRQ -v irq
  618.  
  619.        resmgr -k key -p IOADDR -v "sioaddr eioaddr"
  620.        resmgr -k key -p MEMADDR -v "smemaddr ememaddr"
  621.        resmgr -k key -p DMA -v dma
  622.  
  623.        Where:  key is the key for the current non-ISA board,
  624.                irq is the irq for the ISA board,
  625.                sioaadr and eioaddr are the start i/o address and
  626.                end i/o address for the ISA board,
  627.                smemaddr and ememaddr are the start memory address and
  628.                end memory address for the ISA board,
  629.                dma is the DMA channel for the ISA board.
  630.  
  631.    2.  Execute "resmgr -k key -p BRDBUSTYPE -v 1" to change
  632.        the bus type, where key is the key corresponding to the
  633.        current non-ISA entry.
  634.  
  635.    3.  Use the resmgr command to delete some non-ISA specific
  636.        params:
  637.  
  638.        resmgr -k key -p BRDID -v "" resmgr -k key -p SLOT -v ""
  639.        resmgr -k key -p CA_DEVCONFIG,n -v ""
  640.  
  641.    4.  If the new board is supported by the same driver,
  642.        execute:  resmgr -k key -p ITYPE -v 1.
  643.  
  644.    5.  Run /etc/conf/bin/idconfupdate to synchronize up these
  645.        changes with /stand/resmgr and the sdevice files.
  646.  
  647.    6.  If  the new  HBA requires a different driver, make sure
  648.        the new driver is installed, or install it using pkgadd(1M).
  649.        Then:
  650.  
  651.        o If you had to use pkgadd to install the new driver, a new
  652.          default entry may have been added to the resource manager.
  653.          This entry must be removed before you continue.  Run resmgr(1M)
  654.          to check if a default entry was added (it will be the last line
  655.          of output).  If so, delete this entry using
  656.          resmgr -r -k new_key
  657.  
  658.        o Execute "resmgr -k key -p MODNAME -v modname"
  659.          where key is the key corresponding to the current non-ISA
  660.          entry and modname is the driver that supports the new board.
  661.  
  662.        o Add $static to /etc/conf/sdevice.d/modname and
  663.          change the second field from "N" to "Y" if needed.
  664.  
  665.        o Execute "resmgr -k key -p ITYPE -v itype" where
  666.          itype is the fifth field of the last line in the sdevice file.
  667.  
  668.        o Execute /etc/conf/bin/idbuild -B to rebuild your kernel.
  669.  
  670.    7.  Shutdown the system.
  671.  
  672.    8.  Remove the non-ISA board.
  673.  
  674.    9.  Run the Hardware Configuration Utility if needed.
  675.  
  676.   10.  Insert the new ISA board and attach SCSI devices.
  677.  
  678.   11.  Reboot your system.
  679.  
  680. If you are replacing an ISA HBA with an non-ISA HBA (EISA or PCI):
  681.  
  682.    1.  Shutdown your system.
  683.  
  684.    2.  Install the non-ISA board, but do NOT remove the current board
  685.        and do NOT move your boot disk.
  686.  
  687.        Note: if the ISA boot controller is controlling the floppy,
  688.        you need to disable the floppy controller on the non-ISA board.
  689.        This may require changing a jumper or dip switch,
  690.        or it may require the Hardware Configuration Utility.
  691.  
  692.    3.  Run the Hardware Configuration Utility if needed, to
  693.        configure your new board.
  694.  
  695.        Note: the ROM BIOS address of the new boot controller must be
  696.        set to a value that does not conflict with any HBAs in the
  697.        system, AND must be less than any secondary HBA controllers that
  698.        exist in the machine.  Otherwise, when the original boot
  699.        controller is removed, the BIOS will try to boot from the
  700.        secondary controller, instead of the new boot controller.
  701.  
  702.    4.  Reboot the system.
  703.  
  704.    5.  Login and execute the following:
  705.  
  706.        resmgr -k key -p BOOTHBA -v 1 resmgr -k key -p UNIT -v 0
  707.        resmgr -r -k different_key
  708.  
  709.        Where key is the key corresponding to the new non-ISA entry and
  710.        different_key is the key corresponding to the current ISA entry.
  711.  
  712.    6.  Run /etc/conf/bin/idconfupdate to synchronize up these
  713.        changes with /stand/resmgr and the sdevice files.
  714.  
  715.    7.  If the new HBA requires a different driver, make sure the
  716.        new driver is installed, or install it using pkgadd(1M).  Then:
  717.  
  718.        o If you had to use pkgadd to install the new driver, a new default
  719.          entry may have been added to the resource manager.  This entry
  720.          must be removed before you continue.  Run resmgr to check if a
  721.          default entry was added (it will be the last line of output).
  722.          If so, delete this entry using "resmgr -r -k new key".
  723.  
  724.        o Execute "resmgr -k key -p MODNAME -v modname"
  725.          where key is the key corresponding to the new non-ISA entry
  726.          and modname is the driver that supports the new board.
  727.  
  728.        o Add $static to /etc/conf/sdevice.d/modname and change the
  729.          second field from "N" to "Y" if needed.
  730.  
  731.        o Execute /etc/conf/bin/idbuild -B to rebuild your kernel.
  732.  
  733.    8.  Shutdown your system again.
  734.  
  735.    9.  Remove the old ISA HBA.
  736.  
  737.   10.  Insert the SCSI cable into the new board.
  738.  
  739.        If you disabled the floppy controller on the new board in
  740.        step 2 above, you need to re-enable it now.
  741.  
  742.   11.  Reboot the system.
  743.  
  744. For the following cases, use these instructions:
  745.  
  746.      EISA <=> EISA
  747.      EISA <=> PCI
  748.      PCI <=> PCI
  749.      PCI <=> MCA
  750.      MCA <=> MCA
  751.  
  752.    1.  Execute "resmgr -k key -p BRDID -v brdid" where key is
  753.        the key of the current HBA, and brdid is the board id for the
  754.        new board.
  755.  
  756.    2.  If the new  board is a different bus type, execute
  757.        "resmgr -k  key -p BRDBUSTYPE -v bustype" where bustype is  a
  758.        numeric value representing the bus type of the new board.
  759.  
  760.        EISA   2
  761.        PCI    4
  762.        MCA    32
  763.  
  764.    3.  Run /etc/conf/bin/idconfupdate to synchronize up this
  765.        change with /stand/resmgr and the sdevice files.
  766.  
  767.    4.  If the new HBA requires a different driver, make sure the
  768.        new driver is installed, or install it using pkgadd.  Then:
  769.  
  770.        o If you had to use pkgadd to install the new driver,
  771.          a new default entry may have been added to the resource manager.
  772.          This entry must be removed before you continue.  Run resmgr to
  773.          check if a default entry was added (it will be the last line of
  774.          output).  If so, delete this entry using resmgr -r -k new key.
  775.  
  776.        o Execute "resmgr -k key -p MODNAME -v modname"
  777.          where key is the key corresponding to the current ISA entry
  778.          and modname is the driver that supports the new board.
  779.  
  780.        o Run /etc/conf/bin/idconfupdate to sync up this
  781.          change with /stand/resmgr and the sdevice file.
  782.  
  783.        o Add $static to /etc/conf/sdevice.d/modname and
  784.          change the second field from "N" to "Y" if needed.
  785.  
  786.        o Execute /etc/conf/bin/idbuild -B to rebuild your kernel.
  787.  
  788.    5.  Shutdown the system.
  789.  
  790.    6.  Swap the boards (use same slot to be safe).
  791.  
  792.    7.  Reboot the system.
  793.  
  794. Subject: A18) How do I Move a board?
  795.  
  796.    1.  Shutdown the system.
  797.  
  798.    2.  Move the board.
  799.  
  800.    3.  Reboot.
  801.  
  802. Section 3. Trouble Shooting.
  803.  
  804. Subject: A19) Trouble Shooting Problems during Installation
  805.  
  806. There are many different types of problems you could encounter
  807. during  installation.  Most of these problems are covered in the
  808. Trouble Shooting section of the Installation Handbook and you
  809. are directed there for solutions to those problems.
  810.  
  811. One problem not covered in the Installation Handbook involves
  812. problems loading HBA drivers.  On some platforms, attempting to
  813. load a driver for a board that is not installed on your system
  814. can mess-up your system and cause the installation  to fail.
  815. If this happens, you have to disable loading of that particular
  816. driver during installation.
  817.  
  818.    1.  Invoke the DCU.
  819.  
  820.    2.  Select "Software Device Drivers".
  821.  
  822.    3.  Select "Host Bus Adapters".
  823.  
  824.    4.  Page Up/Down until you find the driver that is causing
  825.        you problems.  If you are not sure which driver is causing the
  826.        trouble, try switching vt's with <alt><sysreq> H and look for
  827.        the driver name in the error messages.  To switch back to the
  828.        desktop <alt><sysreq> <F1>
  829.  
  830.    5.  De-select the driver using the <SPACEBAR>
  831.  
  832.    6.  Hit <ENTER> to exit menu.
  833.  
  834.    7.  Select "Return to DCU Main Menu".
  835.  
  836.    8.  Select "Apply Changes & Exit DCU".
  837.  
  838. Subject: A20) Trouble Shooting Problems on an Installed System
  839.  
  840. Problems are more likely to be encountered when boards are
  841. added, rather than when they are removed.  The exception to
  842. this is the removal of an ISA board.  If you remove an ISA
  843. board, you must use the DCU to free-up the configuration
  844. parameters for the board.  (See the section "Delete an ISA
  845. Board" earlier in this document.)
  846.  
  847. The first step to trouble shooting is to understand the true
  848. nature of the problem.  Here are some questions to ask:
  849.  
  850.    1.  What type of board are you having trouble with ?
  851.  
  852.        ISA cards must be added using the DCU and the configuration
  853.        parameters you specify must match the settings on the board.
  854.  
  855.        EISA, MCA and PCI boards should automatically be detected by
  856.        UnixWare.  To verify this, run the DCU, select "Hardware Device
  857.        Configuration", and verify the new board was found.
  858.  
  859.        If a new entry is not there, run the hardware configuration
  860.        floppy that came with the system to verify it can find the new
  861.        board.  If it detects the board, save the configuration
  862.        information, and reboot the system.  If it fails to find the
  863.        board also, try pulling the board, and reinserting it and
  864.        rerunning the Hardware Configuration Utility again.
  865.  
  866.    2.  Was the driver correctly assigned to the board?
  867.  
  868.        1.  Invoke the DCU.
  869.  
  870.        2.  Select "Hardware Device Configuration".
  871.  
  872.        3.  Check the "Device Name" field for the new entry.  If the
  873.            entry  is UNKNOWN, then no driver was assigned to the board.
  874.  
  875.        4.  If the entry is UNKNOWN or incorrect, move the cursor to
  876.            the Device Name field and hit F2 for a list of drivers to
  877.            choose from.
  878.  
  879.        5.  Select the driver for the new board and hit <RETURN>.
  880.  
  881.        6.  Hit F10 to return to the main menu.
  882.  
  883.        7.  Select "Apply Changes & Exit DCU"
  884.  
  885.        8.  Reboot your system.
  886.  
  887.        One reason a driver might not be correctly  assigned to a board
  888.        is if the driver's drvmap(4) file does not contain the board id of
  889.        the new board.  See section 2.3.1 for more on board ids.
  890.  
  891.    3.  Is the driver that supports the board installed?
  892.  
  893.        Run pkginfo(1) to list the packages that are installed on the
  894.        system and verify the required driver is installed.
  895.  
  896. ----------------------------------------------------------------------------
  897.  
  898. Section 4. Acknowledgements.
  899.  
  900. I would like to thank Les Temple for writing this FAQ.  Also
  901. Andrew Josey, Dave Ballman, Dean Flamberg and Evan Leibovitch for
  902. providing comments and suggestions.
  903.  
  904. --
  905. Andrew Josey, To email remove #nospam from From: line.
  906. Disclaimer: Any views expressed are not those of my employer, either past, 
  907. present or future.
  908.