SYMBIOS UnixWare DMI 2.0 SDMS Component Instrumentation Release 2.06.00 ************************************Introduction******************************** The Symbios UnixWare DMI 2.0 SDMS Component Instrumentation(CI) is based on DMI (Desktop Management Interface) 2.0 standard defined by the Desktop Management Task Force (DMTF). It runs as a UnixWare background process and reports asset and configuration information for the adapters and storage devices controlled by the Symbios UnixWare driver. The Management Information File (MIF) defines the information for the component which the CI is to report. The component information is divided into groups and each group is further divided into attributes. Any application can use the Application Interface of the DMI Service Layer to access this information. This file contains the following information: o Features o Hardware requirements o Software requirements o Release restrictions o Installation instructions ***********************************Features************************************* * Initial Release for UnixWare 7 * Symbios2.MIF based on the DMTF: Mass Storage Standard Group Definitions and DMTF Master MIF. This Management Information File (MIF) contains the following groups from the MASTER MIF: ComponentID SubComponent Software Worldwide ID FRU Storage Device Storage Device Events Storage Controller Storage Controller Events Bus Port Fibre Channel Bus Port Extensions Mass Storage Association Mass Storage Association Events Bus Port Association Operational State Network Adapter Hardware Event Generation for Power Supply Symbios Vendor Unique Groups Symbios Event Polling Symbios SMART Device SAF-TE Processor SAF-TE Controlled Fan SAF-TE Controlled Power Supply SAF-TE Controlled Slot SAF-TE Controlled Temperature Sensor Network Adapter 802 Port Network Adapter Hardware Event Generation for Temperature Probe Event Generation for Fans * Rescan mechanism that can generate the following events: EventGeneration Storage Devices => Storage Device Error EventGeneration Storage Controller => Storage Controller Error EventGeneration Mass Storage Association => New Object Detected EventGeneration Mass Storage Association => Existing Object Replaced ***************************** Hardware Requirements *************************** o Intel Pentium based system or faster o The component instrumentation works with all Symbios PCI-SCSI I/O Processors that are supported by the SDMS BIOS and drivers. o SCSI Storage Devices. These devices must be at least SCSI-2 compliant. *****************************Software Requirements****************************** o UnixWare Operating System 7.0.1 or later o Symbios PCI SCSI HBA Driver Package(c8xx) version 4.07.00 or later o Intel DMI Service Layer (version 2.54.593 recommended) o Network Adapter Drivers (nics) o Network File System Utilities (nfs) o Remote Procedure Calls Utilities (rpc) o DMI application compatible with Intel DMI Service Layer NOTE: To view the software packages installed on your UnixWare system use the pkginfo command. For example to see all packages and their versions type: pkginfo -x | pg To view an individual package, use the same command but specify its package name. For example to view the Symbios PCI SCSI HBA driver type: pkginfo -x c8xx *****************************Release Restrictions ****************************** o At time of this release, the UnixWare Operating System did not support AMS events. o The Component Instrumentation routines do not have support enabled for SAF-TE, Network Adapters, or Fibre Channel groups. ********************Installation Instructions for UnixWare ******************** Installation instructions depend on the format of the package that you receive. If you receive the package on a floppy diskette, then skip to the section titled "Installing from Installation Floppy." If the package is received in the format of a file named "sdmsci.pkg", then follow the instructions in the section titled "Installing from File." * * * * * * * * * * Installing from File * * * * * * * * * * Before the package can be installed, an installation floppy diskette must be created from this file. First, you must copy the sdmsci.pkg file onto a UnixWare 7 system. Then, create the installation diskette by following these steps: 1. Press to go to login prompt. 2. Login as root user. 3. Obtain a writable floppy diskette and label it "SYMBIOS UnixWare DMI 2.0 Component Instrumentation Version xx.xx.xx Installation Diskette." Replace xx.xx.xx with the version number written at the top of this document and add the creation date onto the label. 4. Insert the diskette into the floppy drive. 5. Change to the directory on the UnixWare system that contains the sdmsci.pkg file. 6. To create the package onto the diskette, type the line: pkgtrans - diskette1 < sdmsci.pkg Note: Use diskette1 if your system has an alias of diskette1. Otherwise, if the floppy drive has another alias name, use that name instead in place of diskette1. 7. The screen displays text and queries the user to select the package to process. To select all packages, press the Enter or Return key. 8. Next, insert the diskette into the floppy drive, if not already done. The screen displays options to select. One of the options is to format the diskette and place a filesystem on diskette. To select this option, type the letter: f Then, press the Enter or Return key. 9. The diskette is formatted. The screen prompts the user for which filesystem type to be created on the diskette. To select the default filesystem ufs, press the Enter or Return key. 10. The filesystem is then created. Then, the screen prompts for the text to be entered for fsname label and volume label. The values you enter for these two fields do not matter for this package. Type in whatever values you desire. 11. The formatting and filesystem creation phase has now been completed. The screen displays options to be selected. The option that copies the sdmsci package to the diskette is the go option. To select the go option, press the Enter or Return key. 12. After the system prompt returns, the package should exist on the floppy diskette. To install this package to the system, follow the steps in the section titled "Installing from Installation Floppy". * * * * * * * * * Installing from Installation Floppy * * * * * * * 1. Press to go to login prompt. 2. Login as root user. 3. Insert the SYMBIOS UnixWare DMI 2.0 SDMS Component Instrumentation Release 2.06.00 installation diskette into the floppy drive. 4. To install the CI as a UnixWare service, type: pkgadd -d diskette1 sdmsci Note: For further instructions dealing specifically with the Intel DMI Service Layer, see the section below on the Intel DMI Service Layer. Autostart/Autostopping the CI ----------------------------- This mechanism is dependent on the the DMI Service Layer providing autostart files which start prior to invocation of the CI autostart files. If these conditions are met then the CI will start itself automatically during system startup. It will also shut down the CI when the system is shutdown. Starting the CI Manually ------------------------ The DMI Service Layer has to be started prior to starting the CI. After the service layer is up and running do the following steps: 1. While logged in as root user, set up the DMIPATH variable to base DMI directory. If using CI default, set the variable to: /etc/dmi 2. To change the directory, type: cd $DMIPATH/ci 3. To start the CI, type: cistartstop start Stopping the CI Manually ------------------------ 1. While Logged in as root user, set up the DMIPATH variable to base DMI directory. If using CI default, set variable to: /etc/dmi 2. To change the directory, type: cd $DMIPATH/ci 3. To stop the CI, type: cistartstop stop Logging ------- The cistartstop executable redirects the output of the CI to a file called sdmsci.log. cistartstop puts this file into the ci directory. This directory is a subdirectory of the directory pointed to by the environment variable DMIPATH. Each time cistartstop starts up the CI, the previous log is copied to a backup file located in the same directory and named sdmsci.log.bak. When cistartstop is executed the date and time are recorded and whether the CI was started or stopped. Any errors the CI reports will also be placed into this log. INTEL DMI SERVICE LAYER SUPPORT ONLY: ------------------------------------- The sdmsci package installs using a base directory of /etc/dmi. This directory path is assigned to an environment variable called DMIPATH. In order for the sdmsci package and the DMI Service Layer to work together, they must both use the same base directory and DMIPATH set to this common base directory path. IMPORTANT NOTE: Either the DMI Service layer needs to use the default DMIPATH of /etc/dmi or all the CI directories/files under /etc/dmi need to be moved directly under the DMIPATH directory used by the Service Layer. If CI files are copied to another location, maintain their original owner, group, and permission settings. If DMIPATH is not /etc/dmi, then the following CI start/stop files need to be modified to reflect the new DMIPATH: /etc/dmi/ci/cistartstop /etc/rc0.d/K30Sdmsci /etc/rc1.d/S89sdmsci /etc/rc2.d/S89sdmsci If the Intel Service Layer has its own autostart files that will start the CI, then the K30sdmsci and S89sdmsci files above should be removed. Please refer to the documentation provided with the Intel DMI Service Layer for instructions on its installation and startup. If problems occur, the following solutions may help. 1. The root user sets the variables and starts the DMI Service Layer. 2. Set up three environment variables: DMIPATH, DMITEMP, and LD_LIBRARY_PATH prior to starting the DMI service layer or DMI CI. When defining the DMIPATH below, replace with either the CI default /etc/dmi or the directory which the Intel Service Layer is using (See Note Above): Execute these commands by typing: DMIPATH= DMITEMP=$DMIPATH/temp LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$DMIPATH/lib export DMIPATH DMITEMP LD_LIBRARY_PATH 3. In order for the DMI service layer to create files and directories with the proper permissions, set the umask. To set this up, execute the command below before starting the DMI Service Layer: umask 022 4. Also, copying the DMI libraries to the /usr/lib directory may help. To copy these libraries, execute these commands below: DMIPATH= cd $DMIPATH/lib cp *.so /usr/lib NOTE: The CI was tested with Intel DMI Service Layer version 2.54.593. To see what version is installed on your system, use a DMI 2.0 management browser application that works with the DMI Service Layer. By using the browser, you can look into the "UnixWare DMI Service Layer" Component. The version is one of the attributes within the "ComponentID" group. * * * * * * * * Removing the UnixWare CI Service * * * * * * * * * * * To remove the service: 1. Login as root user, and type: pkgrm sdmsci 2. Remove the "Symbios DMI 2.0 MIF Definition" Component from the DMI Service layer database via the DMI application (that is, a browser) of your choice.