*******************************************************************************
                                LSI DMI Browser
                                Version 2.02,00 
*******************************************************************************
Installation Guide for the LSI DMI Browser.

This file describes the features, description, and installation instructions
for this software. This file is divided into the following sections:
     
  Features
  Description
  Installation Requirements
     Software/Hardware Environment for Installation
  Installing the LSI DMI Browser
     Description of Variables
     Invocation Examples


*  *  *  *  *  *  *  *  *  *  *  * Features *  *  *  *  *  *  *  *  *  *  *  * 

o  Supports management of the DMTF Mass Storage MIF and the LSI vendor unique 
   extensions to this MIF.
o  Remote management supported on a TCP/IP based network such as the Internet.
o  Easy graphical representation of all LSI Storage elements.
o  Displays device and adapter hierarchy visually in a tree view.
o  Digitally signed by LSI Logic with a Class 3 Server Certificate.
o  Highly portable user interface implemented in the Java programming Language
o  May be launched either as a Java Applet in a Web Browser or as a stand-alone
   Java Application

*  *  *  *  *  *  *  *  *  *  *  * Description *  *  *  *  *  *  *  *  *  *  *

The LSI DMI Browser is a DMI (Desktop Management Interface) compliant Management
Application for LSI mass Storage elements. When using this tool, it is possible
to connect to remote computers on a TCP/IP based network, and manage the storage 
elements attached to them. The managed elements include SCSI host adapters, 
SCSI peripheral devices, and SCSI device drivers installed on the computer. In 
addition, the browser also supports LSI specific extensions to the Mass Storage
MIF such as SAF-TE, SMART, and LSI Event Polling.

The LSI DMI Browser, implemented in the Java Programming language, may be 
executed on any operating system environment that supports Java. It may be
launched as:

    o  an Applet running inside a Web Browser,

      -OR-
  
    o  a Java Application that is run using a Java VM (Virtual Machine)
       installed on the computer. 

DMI Service Providers are available on Windows NT, Novell NetWare, SCO
UnixWare, and Sun Solaris platforms. The LSI Browser supports management of
LSI storage on any of these platforms.

The LSI DMI Browser consists of two separate software components:

    o  LSI DMI Browser GUI

    o  LSI RPC Proxy Service 

The LSI RPC Proxy Service is required for the Management of Windows NT servers. 
All other servers are managed directly from the Java Browser graphical user
interface (GUI). The LSI RPC Proxy Service need not be installed if Windows NT
servers are not managed.  

    o The LSI DMI Browser GUI enumerates all elements instrumented by LSI
      Component Instrumentations of the DMTF Mass Storage MIF, along with 
      LSI Specific extensions. 

      The Browser requires additional permissions such as file reading, file 
      writing, and the ability to perform network socket connections. Hence,
      the GUI is digitally signed by LSI using Microsoft Authenticode and 
      Netscape Object Signing methods.  

      User preferences and other helpful informaion is saved on the client 
      side in a file named StorDMI.ini.

      A User Guide is available in the file help.html.

    o The LSI RPC Proxy Service mediates all communication between the LSI
      DMI Browser GUI and a Windows NT DMI Service Provider. It is implemented
      as a Windows NT Service.
      


*  *  *  *  *  *  *  *  *  * Installation Requirements *  *  *  *  *  *  *  *

The LSI DMI Browser GUI may be installed locally on the management console, or
on a web server. A Java enabled Browser or the Java Runtime environment is 
required to launch the product. In order to perform remote management, the 
computer must be configured for TCP/IP based networking.

Management of Windows NT servers is supported through the LSI RPC Proxy Service,
which needs to be installed on any one Windows NT computer on the network.

The managed systems need to be DMI-enabled, which means that they must have the 
DMI Service Provider, and the LSI Component Instrumentaion installed and active.

The software/hardware environment and tools that are required to perform this 
installation are discussed below. 


*   *   *   * Software/Hardware Environment for Installation *   *   *   *   *

For the LSI DMI Browser:

    Please verify the following software/hardware requirements are met before
    installing the LSI DMI Browser:

         o Any Operating System that supports Java
 
         o Java Virtual Machine (version 1.1.x) or any of the following 
           Java-enabled browsers installed:

           Microsoft Internet Explorer version 4.0, or higher
           Netscape navigator version 4.07, or higher
     
         o Web Server (Optional).

         o About 1 MB of Disk Space.
   

For the LSI RPC Proxy Service:

   Please verify the following software/hardware requirements are met before
   installing the LSI RPC Proxy Service on Windows NT:

    o Windows NT Workstation/Server versions 4.0/5.0
    
    o Windows NT TCP/IP protocol installed and enabled

    o Windows NT Remote Procedure Call (RPC) Service installed and enabled


*  *  *  *  *  *  *  *  Installing the LSI DMI Browser GUI  *  *  *  *  *  *  *  *  


To install the LSI DMI Browser GUI, follow these steps:   

 1. Create a directory on your hard disk, for example, C:\LSIDMI, and copy
    all the contents of the LSIDMI\BROWSER directory to it.

 2. To verify the installation for a Web Browser or Stand-alone Application, 
    follow these instructions:
    
    For a Web Browser: 

    1.  Open the lsidmi.html page using a web-browser. The "Launch LSI DMI
        Browser" button is displayed on the Web page if your browser is Java
        enabled. 

    2.  To launch the applet, click on the Launch LSI DMI Browser button.

    For a Stand-alone Application:

    1. At the command prompt, change to the directory where the the DMI browser
       is located. To launch the browser as an application, type:
    
        java -classpath <CLASSPATH>;LSIDMI.ZIP Launch LSIDMI

       where 

       <CLASSPATH> refers to the location of the java files on the
       installed machine. (The basic java classes are usually contained in 
       an environment variable named CLASSPATH.)

       LSIDMI.ZIP (Signed JAR) JAVA Archive refers to the file that is
       being appended to <CLASSPATH>.


To install the LSI RPC Proxy Service, follow these steps:   

 1. To install the service on a Windows NT computer, create a new directory
    where the new file will be copied. For example, at the command prompt
    type: 
    
    C:\LSIPROXY 

 2. Copy the executable LSIDMI\LSIPROXY\LSIRPC.EXE file to this directory.

 3. From the command prompt, change to the install directory and type:

        lsirpc.exe -install

 4. Open the Windows NT Control Panel. Select the Services icon and
    double-click to open it. Scroll down the list of services and highlight
    "LSI RPC Proxy Service".  

 5. Click on the "Start" button in the same Services dialog to start the
    LSI RPC Proxy service.

6. To verify the installation of the LSI RPC proxy Service, launch the LSI
   DMI Browser GUI. Refer to the section "Installing the LSI DMI Browser GUI"
   for step-by-step instructions. 

   After successfully launching the browser, the system will prompt with
   the Preferences Dialog Box.  

7. Type the Internet name/Address of the machine running the Proxy Service,
   and click on the OK button. Now attempt to connect to a Windows NT machine 
   using the LSI DMI Browser. If you are able to perform DMI management, the
   proxy server is working.


*   *    * Description of Variables *   *   * 

The LSI DMI browser may be launched from an HTML page or as a stand-alone 
Java application from the command line. Command line parameters are supported 
from either of these modes. When a sufficient number of parameters are passed, 
the user is not prompted with the connection dialog. Instead, the browser 
attempts to connect to the server machine with the information passed to it 
via these parameters. The parameters are all case sensitive. The parameters
that the LSI Browser GUI accepts are listed below:

MachineName        The Internet host name or IP Address of the computer to be 
                   managed.

RpcType            The RPC type supported by the DMI service provider installed 
                   on the machine. Supported values are "dce" or "onc". Usually, 
                   Windows NT servers use DCE while others use ONC RPC.

ProxyServer        The address of the Windows NT machine running the LSI RPC
                   proxy service. This parameter is only required if the RpcType
                   parameter is "dce".

ProxyPort          The TCP port of the proxy server. The default value is 6301.
(Optional)         This parameter is only required if the RpcType parameter is
                   "dce".

SocketTimeout      Number of seconds after which a network socket connection 
(Optional)         times out. The default value is 5 seconds.

DisableFileWrite   Supported values are "true" and "false". If "true", the local
(Optional)         file "stordmi.ini" is not updated. The default value is false. 


*   *    * Invocation Examples *   *   * 

o Command Line Parameters from an HTML Page 

     <P><applet code = StorDMI.class width = 200 height = 60 >
     <param name = cabbase value = LSIDMI.CAB>
     <param name="ProxyServer" value="proxy1.company.com"> 
     <param name="ProxyPort" value="6301">
     <param name="RpcType" value="dce">
     <param name="MachineName" value="server1.company.com">
     </applet>
     </P>

o Command Line Parameters while launched as an application. Use the format 
  [<ParameterName> <ParameterValue>]* while passing arguments on the command 
  line. 

    java -classpath lsidmi.zip Launch LSIDMI MachineName 
    server1.company.com RpcType onc

  
