Copyright (c) 1990-2001 Dolphin Interconnect Solutions, Inc. All Rights Reserved. RPM (RedHat Package Manager) installation notes for DIS PCI-SCI Adapters ------------------------------------------------------------------------ This release contains the Dolphin PCI-SCI adapter drivers for the PSB32, PSB64, and PSB66 adapters in RPM (RedHat Package Manager) package format. These packages are built using the RPM build utility. The RPM format is 3.04, and is compatible with RPM versions 3 and versions 4. RPM packages are provided in both source (.src.rpm) and binary forms (.i386.rpm, .alpha.rpm, etc.). A binary RPM package contains the drivers and driver installation scripts needed to install or remove a version of the PCI-SCI drivers from your Linux systems. The source RPM package contains the source code and build scripts needed to rebuild the binary RPM packages for a target system. If you are using modversioned kernels, you will need to rebuild the binary packages for your system against the source RPM package. All commercial Linux distributions use the RPM tools to administer packages and verify dependencies and version matches required to support a particular package. If you are using a system that does not support RPM, please visit Dolphin's Website at www.dolphinics.com for a copy of the latest .tar.gz or tar version of the PCI-SCI drivers for your Unix or Linux system. This release consists of the following RPM packages note: %{version} is the RPM package version release number: RPM source package: pci-sci-%{version}.src.rpm RPM binary packages: Intel X86: pci-sci-PSB32-%{version}.i386.rpm pci-sci-PSB64-%{version}.i386.rpm pci-sci-PSB66-%{version}.i386.rpm Sparc: pci-sci-PSB32-%{version}.sparc.rpm pci-sci-PSB64-%{version}.sparc.rpm pci-sci-PSB66-%{version}.sparc.rpm pci-sci-PSB32-%{version}.sparc64.rpm pci-sci-PSB64-%{version}.sparc64.rpm pci-sci-PSB66-%{version}.sparc64.rpm Alpha: pci-sci-PSB32-%{version}.alpha.rpm pci-sci-PSB64-%{version}.alpha.rpm pci-sci-PSB66-%{version}.alpha.rpm Installing RPM source and binary packages ----------------------------------------- It is recommended that you rebuild the .src.rpm if you are using a kernel build with modversions enabled, and install the binary RPM packages created from this build. You must have a valid and properly configured kernel build sources tree located in the /usr/src/linux directory on your system in order to rebuild the PCI-SCI drivers. Please consult the /usr/src/Linux/Documentation directory or the /usr/src/Linux/README file for specific instructions on setting up your kernel build tree. To rebuild a source RPM on a target system, enter the following command: rpm --rebuild pci-sci-%{version}.src.rpm This command will install the source files into the RPM build tree on your system and rebuild all the binary packages. This tree is always found at /usr/src/($distribution)/ and contains BUILD, SOURCES, SPECS, SRPMS, and RPMS subdirectories. ($distribution) is the name of your Linux distribution. For example, if your Linux distribution is Red Hat, then this directory would be located at /usr/src/redhat/. If your distribution is Caldera Linux, the this directory would be located at /usr/src/OpenLinux/. It's a good idea to simply list the contents of /usr/src/ to locate your particular RPM build tree for your commercial Linux distribution. The recompiled binary RPM packages will be found after the build finishes at /usr/src/($distribution)/RPMS/($arch). ($arch) is the architecture of the system on which you are building. If you are rebuilding the source RPM package on an Intel System on RedHat 6.2, then this directory would be /usr/src/redhat/RPMS/i386. If you are rebuilding the source RPM package on an Alpha System on RedHat 6.2, then this directory would be /usr/src/redhat/RPMS/alpha. To install either the pre-built or the rebuilt RPM binary packages simply type the following command dpending on which PCI-SCI adapter is in your system (PSB32, PSB64, PSB66): rpm -i pci-sci-PSB64-%{version}.i386.rpm You can also force RPM to overwrite previously installed versions of the pci-sci drivers with this command: rpm -i --force pci-sci-PSB64-%{version}.i386.rpm You should see several messages on the system console detailing the progress of the PCI-SCI driver installtion. They should look something like this: # # # rpm -i pci-sci-PSB64-1.0-1.i386.rpm pci-sci reports this system has 1 processor(s) (LINUX) Installing Dolphin PCI-SCI adapter drivers ... Command:add Adapter:PSB64 SMP: NOSMP Creating /etc/rc.d/init.d/sci_irm_sisci for PSB64-2.2.18-27-NOSMP Reading IRM driver configuration informaiton from /opt/DIS-1.0/sbin/..//lib/modules/pcisci.conf Done. # # The /var/log/messages file should also contain entries similiar to the following if your SCI hardware initialized properly: Jan 24 22:37:52 nwfs kernel: SCI Driver : Linux SMP support disabled Jan 24 22:37:52 nwfs kernel: SCI Driver : using MTRR Jan 24 22:37:52 nwfs kernel: PCI SCI Bridge - device id 0xd665 found Jan 24 22:37:52 nwfs kernel: 1 supported PCI-SCI bridges (PSB's) found on the system Jan 24 22:37:52 nwfs kernel: Define PSB 1 key: Bus: 0 DevFn: 72 Jan 24 22:37:52 nwfs kernel: Key 1: Key: (Bus: 0,DevFn: 72), Device No. 1, irq 9 Jan 24 22:37:52 nwfs kernel: Mapping address space CSR space: phaddr f3100000 sz 32768 out of 32768 Jan 24 22:37:52 nwfs kernel: Mapping address space CSR space: vaddr c40ae000 Jan 24 22:37:52 nwfs kernel: Mapping address space IO space: phaddr d0000000 sz 268435456 out of 268435456 Jan 24 22:37:52 nwfs kernel: Mapping address space IO space: vaddr c40b7000 Jan 24 22:37:52 nwfs kernel: SCI Driver : version Dolphin IRM 1.10.2 ( Beta 1 2000-12-18 ) initializing Jan 24 22:37:52 nwfs kernel: SCI Driver : 32 bit mode Compiled Jan 24 2001 : 22:35:50 Jan 24 22:37:52 nwfs kernel: Interrupt 9 function registered Jan 24 22:37:52 nwfs kernel: SCI Adapter 0 : Driver attaching Jan 24 22:37:52 nwfs kernel: osif_big_alloc 8192 align 0 Jan 24 22:37:52 nwfs kernel: osif_big_alloc 65792 align 0 SW packet buffers Jan 24 22:37:52 nwfs kernel: SCI Adapter 0 : NodeId is 4 ( 0x4 ) Serial no : 100963 (0x18a63) Jan 24 22:37:52 nwfs kernel: osif_big_alloc 8192 align 2 ma_allocBuffer Jan 24 22:37:52 nwfs kernel: osif_big_alloc 520700 align 0 MbxMsgQueueDescArray Jan 24 22:37:52 nwfs kernel: osif_big_alloc 8192 align 2 ma_allocBuffer Jan 24 22:37:52 nwfs kernel: SCI driver : successfully registerd. Major number = 254 Removing and Querying RPM packages ---------------------------------- To remove the PCI-SCI drivers from your system, enter the following command with the proper adapter type installed in your system: rpm -e pci-sci-PSB64 Messages similiar to the following should be displayed on the system console. # # # rpm -e pci-sci-PSB64 pci-sci reports this system has 1 processor(s) (LINUX) Command:rem Adapter:PSB64 SMP: NOSMP Removing the IRM and SISCI drivers from the system Removing SCI device nodes and unloading drivers Done. # # The /var/log/messages file should also contain entries similiar to the following if your SCI hardware shutdown properly: Jan 24 22:38:03 nwfs kernel: osif_big_free 8192 ma_allocBuffer Jan 24 22:38:03 nwfs kernel: osif_big_free 520700 MbxMsgQueueDescArray Jan 24 22:38:03 nwfs kernel: osif_big_free 8192 ma_allocBuffer Jan 24 22:38:04 nwfs kernel: osif_big_free 65792 SW packet buffers Jan 24 22:38:04 nwfs kernel: osif_big_free 8192 Jan 24 22:38:04 nwfs kernel: SCI Adapter 0 : Adapter terminated Jan 24 22:38:04 nwfs kernel: SCI Driver : version Dolphin IRM 1.10.2 ( Beta 1 2000-12-18 ) terminating Jan 24 22:38:04 nwfs kernel: Trying to free free IRQ9 Querying RPM information ------------------------ If you need to query whether the RPM packages have been installed or not in your system, type the following command: rpm -q pci-sci-PSB64 This should produce output similiar to the following: # # # rpm -q pci-sci-PSB64 pci-sci-PSB64-1.0-1 # # Additional useful information concerning the options and versions of the RPM tools can be found by visiting the RPM website at www.rpm.org or by typing 'info rpm' or 'man rpm' from your system console. The man and info listing on RPM contains detailed information about using the RPM tools. rpm --help | more will also provide additional information about querying RPM options that are available. Rebuilding the RPM from the pci-sci-%{version}.spec file ------------------------------------- If you want to rebuild your .src.rpm and binary rpm packages from the RPM build tree, then you can change directory (cd) into the /usr/src/$(distribution)/SPECS directory. This directory will contain the rpm .spec files for any installed .src.rpm packages either installed via rpm -i .src.rpm command or the rpm --rebuild .src.rpm command. An RPM spec file is a file containing install scripts and build instructions for an RPM package or set of packages, along with versioning and dependecy information. To rebuild the PCI-SCI drivers from the SPECS directory, type the following command: rpm -ba pci-sci.spec This command will trigger complete rebuild of the .src.rpm and binary rpms for the PCI-SCI package. Increasing the Number of SCI Nodes Supported -------------------------------------------- This version of the PCI-SCI adapters will support up to 256 clustered SCI nodes. To increase the number of nodes supported, you will need to change the following line in the /src/IRM/drv/src/id.h file, line 36 contained in the pci-sci-1.1.tar.gz file contained in the source RPM. This file will normally be located in the /usr/src/$(distribution)/SOURCES directory. #define MAX_NODE_IDS 256 This value can be increased up to 1024 nodes. Increasing this value will also increase the amount of memory needed to setup the SCI mbx structures from 130K to 520K.