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."

Note: For further instructions dealing specifically with the Intel DMI 
      Service Layer, see the section below on the Intel DMI Service Layer.
*  *  *  *  *  *  *  *  *  *  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 <CTRL><ALT><ESC> 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.

    
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 <CTRL><ALT><ESC> to go to login prompt.

2. Login as root user.

3. Insert the SYMBIOS UnixWare DMI 2.0 SDMS Component Instrumentation
   installation diskette into the floppy drive.  

4. To install the CI as a UnixWare service, type:

     pkgadd -d diskette1 sdmsci



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 <dmi directory> 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=<dmi directory>
       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=<dmi directory>
        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.


