SSA Remote Systems Management v1.53 Netfinity Manager Web Extension for v5.2 Last Updated : 11th July 2000 1.0 - PRE-REQUISITES 2.0 - INSTALLATION 3.0 - NOTES FOR USERS .1 - Tutorial .2 - Help .3 - SRN List .4 - Proxy Configurations .5 - Netscape Configuration .6 - Browser Time-outs .7 - General .8 - Known Problems / Fixes .9 - Netfinity Alert Manager 4.0 - SSA HOMEPAGE APPENDIX A - Setup Error Messages 1.0 PRE-REQUISITES ================== To run the Netfinity SSA Web Extension : * Any of the following IBM SSA RAID Adapters : IBM SSA RAID Adapter, IBM SSA RAID Cluster Adapter, IBM SerialRAID Adapter, IBM Advanced SerialRAID/X Adapter. You should ensure you are running the latest adapter, disk and enclosure microcode and are running the latest Windows NT drivers. The latest levels can be checked via RSM, or see http://www.storage.ibm.com/hardsoft/products/ssa/ * Netfinity Manager Versions 5.2 with Web Manager Services installed and enabled. * Windows NT SSA Event Logger (at least Version 1.30) * NT Server 4.0 (Standard or Enterprise Edition SP3+) with Networking Installed. (Recommend SP5) NOTE: SP4+ is required when using Microsoft Cluster Service. * 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 ================ Run setup.exe from the Administrator account. When installation is complete, setup will restart the Netfinity Service. To confirm that SSA RSM has installed correctly open a browser at : http://your.machine.name:411/ssa OR select the "SSA Tools" icon setup creates on your Start Menu which opens your default browser at : http://your.machine.name:411/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. (NB This assumes you just installed on the server. If you have installed on a client, you may have to use Netfinity's "Remote System Manager" to access the client service via the server, see Netfinity documentation/help for more details) This is the Netfinity Web Manager index page. You should now see an extra icon "SSA" on this page. Click on this icon and you will see the SSA Host Page. The context sensitive help icon on each page should answer any further questions/problems you may experience. If you failed to get to the SSA Host Page, please confirm the following: a) You installed the Netfinity Web Manager when you installed Netfinity. If you did not, reinstall Netfinity, checking the box next to "Install Web Service Manager" b) You have enabled the Web Manager from the WWW icon on the Netfinity Service Manager NT Window. Also confirm that the port number is 411. If it is not, replace :411 in the URL above with the port number your machine is set to. c) If a) and b) are correctly setup, but you don't see an "SSA" icon on the Netfinity Web Manager Main page, confirm that the following files exist in your Netfinity directory. (Usually c:\wnetfin ) ssabase.exe ssa.web ssa.ini ssa.dll ssalink.txt If they do, setup has copied the files correctly, but has failed to correctly install the new service. You can manually install as follows: Open a DOS window and cd into your Netfinity directory, and execute the three following commands. (Wait until the hour-glass next to the mouse pointer finishes before running each command) 1) netfbase shutdown 2) bdsvcini merge ssa.ini 3) netfbase start You should now check the above URL again and the "SSA" icon should be visible. 3.0 NOTES FOR USERS =================== 3.1 RSM TUTORIAL ================ This version of RSM is supplied with an HTML based tutorial, which can be accessed via : http://your.machine.name:411/tutorial.htm OR from the "SSA Tools" index on your Start Menu. 3.2 HELP WINDOW =============== The help within 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. 3.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. 3.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. 3.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. For Netscape4, 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. 3.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. 3.7 GENERAL =========== The stand-alone service defaults to port 511 to prevent conflicts with Netfinity Manager which, by default, binds to port 411. Both versions of RSM can be run on the same server without any apparent problems. It should be noted however that there is nothing to be achieved from this configuration, except the noticeable time delays when more than one user tries to access the stand- alone service. The Netfinity Service is multi-threaded by nature, i.e. the Netfinity server schedules the tasks should two users request information from the same adapter. 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. 3.8 KNOWN PROBLEMS (P) / FIXES (F) ================================== See history.txt copied to your install directory for release notes / known problems and fixes / enhancements. 3.9 NETFINITY ALERT MANAGER =========================== Note that all SSA events forwarded to the Netfinity SM Alert Manager are raised with a Severity of 0 - this is the highest priorty. Events are either of type :Failure or :Warning. See the Netfinity SM Documentation for further information. 4.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. APPENDIX A - Setup Error Messages ================================= A1 - Device Driver ------------------ 0. "Setup did not find the IBM SSA Adapter device driver. This device driver must be installed and running before setup can continue..." Follow the instructions displayed when you click OK and re-run setup when you have installed the appropriate device driver. A2 - Windows NT Registry ------------------------ 1. "Couldn't set registry root to HKEY_LOCAL_MACHINE" Setup failed to contact your System Registry. 2. "Could not create registry Key : xxx" Setup failed to create the registry key xxx, try creating the specified key with regedt32.exe and re-run setup. 3. "Could not create registry value : xxx" Setup failed to create the registry value xxx, try creating the specified value with regedt32.exe and re-run setup. 4. "Could not retrieve registry value : xxx" A value (xxx) required by setup could not be found. If setup aborted, you may not have one of the pre-requisite software components or services. 5. "Could not delete registry old Registry key... xxx" Setup removes old registry software keys after upgrading and recreates the keys with the new settings. Delete the key specified and re-run setup. A3 - Application Launch ----------------------- 6. "Failed to launch application cmdxxx paramsyyy" Setup failed to run the specified application. This generally relates to the RSM or Event Logger Service utility - servutil.exe. Try running the command before setup to stop services if setup fails to copy files, or run the command after setup if setup fails to restart / start a service. For usage see : servutil -h For all commands add -d for debug output. Note : If setup fails to launch notepad, simply view the readme file later. A4 - Event Logger ----------------- 7. Not currently used. A5 - RSM -------- 8. "Setup detected an old version of RSM which is not in the default location. This old version has been stopped, uninstalled and replaced by ..." You should delete the files in the old location as specified by the error message. These files have been replaced by those in the default c:\issa\web directory. 9. "Setup could not find the Microsoft TCP/IP Network Service on this machine..." The Stand Alone NT Service version of RSM requires TCP/IP Networking to function. Install the TCP/IP Network protocol and re-run setup. 10. "Setup could not find a version of Netfinity compatible with RSM. You must install the Stand Alone NT Service." RSM is compatible with Netfinity Manager Versions 5.0, 5.1 and 5.2 Setup failed to find one of these. Install the Stand Alone version. 11. "The version of Netfinity you have installed is not compatible with the version of RSM you selected..." Re-select the appropriate version of RSM, or select the Stand Alone version. 12. "Could not find a default browser in your registry..." Setup couldn't find one of the supported browsers, see pre-reqs. Setup will not have created a link to the SSA Tools Menu, but RSM may still function with your browser, try running it manually. A6 - General ------------ 13. "This Software is for Windows NT Server 4.0 Only." Setup detected an operating system other than Windows NT. SSA Adapters are only supported on Intel Windows NT servers. 14. "An unknown error has occurred." Setup suffered an unrecoverable error. Please contact your service representative / supplier. 15. "An error occurred during the move data process: -nnn" If you have a previous version of the either RSM or the SSA Event Logger services running. You must ensure these are stopped before re-installing, setup tries to stop the service but may have failed. Use servutil.exe to stop both services manually, or use the Control Panel, services window to stop both "PC's SSA Event Logger" and "SSA Remote Systems Management" Trademarks and Notices ====================== The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM, OS/2, Netfinity, Netfinity Manager 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 is a trademark or registered trademark 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 ===