IBM SSA Tools Help

IBM SSA RAID Adapters for PC Servers
SSA Remote Systems Management
Stand Alone NetWare Service - README.TXT
Version v1.53 - Last Updated 11th July 2000


 1.0  -  PRE-REQUISITES
 2.0  -  INSTALLATION

 3.0  -  SECURITY               <<< !IMPORTANT! >>>
 4.0  -  NOTES FOR USERS
  .1  -   Tutorial
  .2  -   Help
  .3  -   SRN List
  .4  -   Proxies
  .5  -   Netscape Configuration
  .6  -   Browser Time-outs
  .7  -   Service Port
  .8  -   General
  .9  -   Known Problems / Fix History
 5.0  -  SSA HOMEPAGE

APPENDIX A - Setup Error Messages


1.0 PRE-REQUISITES
==================

 To run the IBM SSA RSM Stand Alone NetWare Service

 * One of the following IBM SSA RAID Adapters :

   IBM SSA RAID Adapter,
   IBM Advanced SerialRAID/X Adapter.

   You should ensure you are running the latest
   adapter, disk and enclosure microcode and are
   running the latest NetWare drivers. The
   latest levels can be checked via RSM, or see

    http://www.storage.ibm.com/hardsoft/products/ssa

 * NetWare SSA Event Logger Version, at least 1.30
    installed and running.

 * NetWare SSA Injector installed and running.

 * NetWare 4.2, 5.0 installed on the Server.

 * NetWare TCP/IP protocol installed and configured.

 * Netscape 4.5x+, recommend 4.7x
   or
   Internet Explorer 4.72 SP2, recommend 4.72 SP2
   Internet Explorer 5.0x,     recommend 5.00.23x+

   NOTE: RSM is not supported with any releases of 
         Internet Explorer 3, or Netscape 3 or below.


2.0 INSTALLATION
================


 Extract this zip files contents onto the server.

 We recommend you create a new directory, RSM,
 and extract all files in this zip - maintaining
 the sub-directory structure.

 SYS:SYSTEM\RSM

 When installation is complete, run :

 load SYS:SYSTEM\RSM\ISSARSM.NLM

 Confirm that RSM has installed correctly, by opening
 your client browser at :

  http://your.machine.name:511/ssaindex.htm

 The SSA Tools Menu contains links to RSM itself, the
 RSM Tutorial, HTML versions of all SSA readme files,
 and other reference material.

 When you enter RSM, you are prompted for a uid and pwd,
 enter "SSA" for both, NB Security is case sensitive,
 must enter SSA in capitals for both uid and pwd.
 (See 3.0 NOW for important security information)
          ^^^
 You should then see the SSA Adapter List Page. The
 context sensitive help icon on each page should
 answer any further questions/problems you may
 experience.


3.0 SECURITY
============

 This version (Stand Alone NetWare Service) includes
 full access security. At install, only one user exists
 and has administrator access. This user can add/delete
 and modify user access privileges and has full
 SSA configuration permission.

 At least two users should be created, one to
 administer the SSA devices and one to simply view
 the current configuration. It is recommended that
 the default user is removed as soon as you have
 created a new administrator user to stop unauthorised
 access via the default user and password.

 The default user is : SSA
       with password : SSA

 (NB Usernames and passwords are case-sensitive and
     can only be from 1 to 10 characters - blank
     passwords cannot be used.)

 The encrypted access security resides in the hidden
 file ssacfg.sec in your install directory. There is a
 backup copy of the default file (ssacfg.bak) Should
 the original ssacfg.sec file become corrupt/unusable
 copy ssacfg.bak to ssacfg.sec and you can login
 again as user SSA and password SSA.

 You should ensure that access is restricted
 to  your install directory otherwise an unauthorised
 user could replace the security file with the default
 and hence gain unauthorised SSA configuration access.

4.0 NOTES FOR USERS
===================

 4.1 RSM TUTORIAL
 ================
 This version of RSM is supplied with an HTML based
 tutorial, which can be accessed via :

  http://your.machine.name:511/tutorial.htm

 OR from the SSA Tools Menu.

 4.2 HELP WINDOW
 ===============
 The help within SSA RSM is context sensitive.
 Clicking on the help icon opens another browser
 window containing the relevant help section.
 Every subsequent click on the help icon will
 update the same window.

 Please be aware that depending upon Windows setup
 and the browser used, the help window may not
 auto-raise when the icon is re-selected.

 4.3 SRN LIST
 ============
 Upon "analysing" the SSA Event Logger within RSM, if
 any problems exist, an SRN (Service Request Number)
 will be shown. Click on the link to open the SRN
 window, where instructions will be given to help you
 correct the problem.

 Some browsers will not refresh the window when
 subsequent SRN links are selected. Either use the
 'Find' function, or close the window and re-click
 on the link.


 4.4 PROXY CONFIGURATIONS
 ========================
 Some problems may be experienced when accessing
 SSA RSM via a proxy server. It is recommended that
 you use an automatic proxy configuration script
 (if available) otherwise

 - if you are accessing SSA RSM from behind a
   firewall, and SSA RSM itself is behind the
   firewall, ensure you are using the "no proxy
   for" to stop proxy usage for internal access

 Some problems have also been found using Netscape
 when an array contains a failed resource and no hot
 spare is available. At this point, the failed
 resource is replaced by a virtual disk, a "blank
 reserved". When using a proxy server, some versions
 of Netscape fail to process the "blank reserved"
 resource. Please contact a service representative.

 With the enhanced IP Address based security, if you
 access RSM through a proxy, you will not be granted
 access unless you add the IP address of the proxy
 server to RSM. This will nullify the IP security,
 as it will allow all users entering through the
 proxy server to access RSM.

 For local (behind a firewall) access you should 
 ensure you are using an automatic proxy configuration
 script.

 4.5 NETSCAPE CONFIGURATION
 ==========================

 It has been found that in some cases, using Netscape
 and clicking on a link before the Explorer frame
 has finished loading will crash the RSM service.

 If you experience this, simply stop and start the
 RSM service from the Control Panel services window.

 To stop this happening, wait until all images have
 loaded before clicking on a link.

 It is recommended that you enable your browser to
 reload documents every time, otherwise cached pages
 may cause confusion when configuring systems.

 Edit, Preferences, Advanced, Cache

 NETSCAPE 3 USER'S PLEASE NOTE : These versions of the
 browser are not supported, this is due to the lack of
 support for some JavaScript functions used in RSM
 versions 1.42+. This will only occur when you create
 RAID10 arrays with multiple domains. When you select
 the Primary and Secondary resources, your browser will
 not be able to validate the selections as they are made,
 you will still be presented with the confirmation screen.

 4.6 BROWSER TIME-OUTS
 =====================
 If your browser connection is slow (i.e. when remotely
 accessing RSM), the reply may time-out. Note that
 the action you performed will have been executed if
 it got to the server and will continue to completed,
 since the adapter execute all requests it receives.
 You should refresh the view before repeating the
 action, to ensure you don't perform the action twice.

 4.7 SERVICE PORT
 ================

 The NetWare RSM service will default to port 511.

 This can be changed, by modifing the autoexec.ncr
 file. Change the line containing :

 load SYS:SYSTEM\issarsm.nlm

 to :

 load SYS:SYSTEM\issarsm.nlm (port number)

 where (port number) is any valid TCP/IP port
 number.

 4.8 ACCESS
 ==========

 The stand-alone service is single-threaded. If two
 users attempt to use a single service at the same
 time, one user may be returned a time-out. Simply
 click reload on your browser to retry.

 4.9 KNOWN PROBLEMS (P) / FIXES (F)
 ==================================
 See history.txt copied to install directory for latest
 release notes / known problems and fixes / enhancements.


5.0 SSA HOMEPAGE
================

 For all the latest code releases, device drivers etc,


  http://www.storage.ibm.com/hardsoft/products/ssa


 For updates to RSM,


  http://www.storage.ibm.com/hardsoft/products/ssa/rsm/


 For product news,

  http://www.storage.ibm.com/

 We always welcome comments, or suggestions for
 improvement via our Active Feedback forms,
 please submit via the forms on the Website.


Trademarks and Notices
======================

The following terms are trademarks of the IBM Corporation
in the United States or other countries or both:

IBM, OS/2

Microsoft and Windows are trademarks or registered
trademarks of Microsoft Corporation.

Adobe, Acrobat and the Acrobat Logo are trademarks of Adobe
Systems Incorporated.

Novell NetWare, and NetWare are trademarks or registered
trademarks of Novell Inc.

Other company, product, and service names may be trademarks
or service marks of others.

THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR
IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES
OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH
RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING
THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR
COPYRIGHTS.

Note to U.S. Government Users -- Documentation related to
restricted rights -- Use, duplication or disclosure is
subject to restrictions set forth in GSA ADP Schedule
Contract with IBM Corp.

===
END
===