Madge Token Ring Driver for Solaris - User's Guide ================================================== This document provides information on: * Solaris Driver Information * Installation and configuration of the Solaris driver. * Common Problem Diagnostics * Software user instructions for Connectionless DLPI Stream Interface Contents -------- 1. Solaris Driver Information 1.1 Drivers 1.2 Adapters Supported 2. Installation and configuration of the Solaris driver. 2.1 Preparing for Installation 2.2 Removing Existing Drivers 2.3 Installing the Package 2.4 Removing the Package 2.5 Getting Help 2.6 Error Messages 3. Common Problem Diagnostics 4. Software User Instructions for Connectionless DLPI Stream Interface =============================================================================== 1. Solaris Driver Information: ----------------------------- 1.1 Drivers ----------- The drivers that are provided for Solaris are: * Low Speed Token Ring Driver - 'trp' This driver supports only the 16/4 token ring adapters. Please refer to the 'Adapters Supported' for a detailed list of supported adapters. Driver for Solaris 8 - 's8trp.tar' Driver for Solaris 9 - 's9trp.tar' * High Speed Token Ring Driver - 'trphs' This driver supports only the 100/16/4 token ring adapters. Please refer to the 'Adapters Supported' for a detailed list of supported adapters. Driver for Solaris 8 - 's8trphs.tar' Driver for Solaris 9 - 's9trphs.tar' 1.2 Adapters Supported ---------------------- The Low Speed Token Ring Driver package supports the following Madge Token-Ring adapters: # Madge Smart 16/4 PCI Ringnode Mk3 # Madge Presto PCI The High Speed Token Ring Driver package supports the following Madge Token-Ring adapters: # Madge Smart 100/16/4 PCI-HS Ringnode # Smart MK4 PCI Adapter (was Madge Smart 100/16/4 PCI Ringnode) =============================================================================== 2. Installation and Configuration --------------------------------- 2.1 Preparing for Installation ------------------------------ a) Log into your Solaris system as "root". b) Copy the respective package archive into the directory: /var/spool/pkg The package archive here refers to the driver distribution, for example 's9trphs.tar' c) In the above directory execute the command: # tar -xf package.tar Example: Considering that a high speed driver is installed on Solaris 9, execute the following command: # tar -xf S9trphs.tar If you do not know which package to use, please refer to section 1.1 and select the appropriate driver distribution based on the adapter being used and the platform being run. d) You may now delete the archive file. 2.2 Removing Existing Drivers ----------------------------- If you wish to remove an existing Madge High Speed Token-Ring driver and replace it with a more recent version a) Log into your Solaris system as "root". b) Execute the commands: # pkgrm PACKAGENAME Here the PACKAGENAME refers to the name of the package being removed. FOr Example: If removing a high speed driver # pkgrm MDGtrphsd # pkgrm MDGtrphsu OR if removing a low speed driver # pkgrm MDGtrpd # pkgrm MDGtrpu c) You will be asked to confirm that you wish to remove the "MDG" packages and to confirm that you are willing to execute the removal scripts which have super-user permission. Answer "y" to both questions. d) The existing Madge Token-Ring adapter driver will now be removed. 2.3 Installing the Package -------------------------- a) Make sure that your Madge Token-Ring adapter(s) is present in your machine and that it is attached to a Token-Ring LAN. b) Log into your Solaris system as "root". c) Execute the commands: # cd /var/spool/pkg # pkgadd -d . d) Add both the MDG packages. e) Execute the command: # prtconf f) The Token-Ring adapter(s) will be listed along with an instance number. Make a note of this number. For example: After executing the 'prtconf' command, there would be a description like the following, pci, instance #1 token-ring, instance #0 Here the Madge adapters would be listed as a 'token-ring' adapter. '#0' refers to the instance description and '0' refers to the instance number. Make a note of this number. g) Execute the command: # cd /etc h) Using a text editor, create a new text file for every instance of the Token Ring Adapter you are installing. Each file must contain the adapter's interface name and IP address, and the title of each file must be of the form "hostname.DRIVERNAMEX" ("hostname.trphsX" for High speed drivers & "hostname.trpX" for low speed drivers), where DRIVERNAME is the name of the driver and "X" is a digit corresponding to the instance number of the adapter. In the following examples, a high speed driver 'trphs' has been considered. Please replace with 'trp' if using a low speed driver. Examples: - If a sparc station called 'desktop' were set up containing one card with an IP address of 123.45.67.11 then: A file 'hostname.trphs1' (located in /etc) would need to contain the following text: desktop The file 'hosts' (located in /etc) would need to contain the following text: 127.0.0.1 localhost 123.45.67.11 loghost - If three cards were installed in 'desktop' with IP addresses of 123.45.67.11, 123.45.67.12, and 123.45.67.13, respectively, then: A file 'hostname.trphs1' (located in /etc) would need to contain the following text: desktop A file 'hostname.trphs2' (located in /etc) would need to contain the following text: desktop-2 A file 'hostname.trphs3' (located in /etc) would need to contain the following text: desktop-3 The file 'hosts' (located in /etc) would need to contain the following text: 127.0.0.1 localhost 123.45.67.11 desktop loghost 123.45.67.12 desktop-2 123.45.67.13 desktop-3 i) Execute the following commands and check that the hosts file contains an IP # cd /etc # more hosts j) Re-boot your machine to bring up TCP/IP stacks. 2.4 Removing the Package ------------------------ a) Execute the commands: If removing a high speed driver # pkgrm MDGtrphsd # pkgrm MDGtrphsu OR if removing a low speed driver # pkgrm MDGtrpd # pkgrm MDGtrpu b) Remove the "hostname.trphsX" OR "hostname.trpX" files, depending on the driver installed from the /etc directory. 2.5 Getting Help ---------------- The installation process installs a manual page for the driver package. To view the manual page execute the command: For High Speed driver # man trphs For Low Speed driver # man trp If the man pages do not work, please add the path name to the MANPATH environment variable. For High Speed driver # setenv MANPATH "/opt/MDGhstr/trphs/man:$MANPATH" For Low Speed driver # setenv MANPATH "/opt/MDGtr/trp/man:$MANPATH" 2.6 Error Messages ------------------ "unix: ip_rput: DL_ERROR_ACK for 29, errno 1,unix 0 unix: ip: joining multicasts failed on trphsX - will use link layer" where X is the instance number that has been assigned to the adapters, You will see this message when your system boots. Ignore it since it simply means that the TCP/IP stack has tried to enable an Ethernet multicast address that is not valid under Token-Ring. Ring status messages will be passed up to the console should a major event occur. These will take the form of: "Ring status has changed to 0xXXXX" RING_STATUS_PRESTO_WATCHDOG 0x0001 RING_STATUS_RING_RECOVERY 0x0020 RING_STATUS_SINGLE_STATION 0x0040 RING_STATUS_COUNTER_OVERFLOW 0x0080 RING_STATUS_REMOVE_RECEIVED 0x0100 RING_STATUS_AUTO_REMOVAL 0x0400 RING_STATUS_LOBE_FAULT 0x0800 RING_STATUS_TX_BEACON 0x1000 RING_STATUS_SOFT_ERROR 0x2000 RING_STATUS_HARD_ERROR 0x4000 RING_STATUS_SIGNAL_LOSS 0x8000 If two events occur simultaneously the error code will be additive. For further information on configuring the adapters please refer to the man pages for the following For High Speed driver # man trphs # man trphs.conf (Also refer to the trphs.conf file in the /kernel/drv directory) # man mver # man trpsr For Low Speed driver # man trp # man trp.conf (Also refer to the trp.conf file in the /kernel/drv directory) # man mver # man trpsr =============================================================================== 3. Common Problem Diagnostics ----------------------------- Q. Unable to install the packages. A. Verify if you are the super-user. You can install the packages only if you have super-user privileges. ------------------------------------------------------------------------------- Q. I installed the packages. But I still find that the drivers are not attached to the adapters. OR Unable to bind the driver to the adapter. A. Verify that the drivers being installed support the adapters for which the driver is being installed. Refer to section 1.1 & section 1.2 for more information. ------------------------------------------------------------------------------- Q. Unable to remove the older package before installing the newer package. A. Verify the older package being used. You might be using an older version of the driver that has a different package name. Try # pkgrm SUNWtrpd # pkgrm SUNWtrpu ------------------------------------------------------------------------------- Q. Unable to view driver MAN pages. A. The path appropriate to the MAN directory might not have been set. Refer to section 2.5 for more information. ------------------------------------------------------------------------------- Q. I am getting an error message. A. Refer section 2.6 for a detailed desciption for error messages. =============================================================================== 4. Software User Instructions for Connectionless DLPI Stream Interface ---------------------------------------------------------------------- The Madge Token ring drivers use the streams architecture and also support DLPI. The Madge token ring devices can be used by opening the '/dev/trphs' for high speed devices or '/dev/trp' for low speed devices. Example: open ("/dev/trphs", O_RDWR) for opening the token ring device for reading and writing. Using the DLPI requires the use of streams messages and opening a stream to a specific interface. The PPA for the connection is the device instance number obtained during driver installation. Data can be read and written into the stream by using the 'getmsg' and 'putmsg' interfaces. The DLPI commands are to be encapsulated into the stream message blocks, and data in the streams data blocks. ( Please refer to DLPI Specification and Solaris Streams Programming Guide for further information ) ========================== * END OF USER GUIDE * ==============================