SSA Remote Systems Management v1.53 Stand Alone Windows Service Last Updated : 2nd October 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 .10 - Before UNINSTALLING... 5.0 - SSA HOMEPAGE APPENDIX A - Setup Error Messages 1.0 PRE-REQUISITES ================== To run the IBM SSA RSM Stand Alone Windows Service * One 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 drivers. The latest levels can be checked via RSM, or see http://www.storage.ibm.com/hardsoft/products/ssa * Windows SSA Event Logger Version, at least 1.30 * NT Server 4.0 (Standard or Enterprise Edition SP3+) with TCP/IP Networking Installed. (Recommend SP5) NOTE: SP4+ is required when using Microsoft Cluster Service. *** OR *** Windows 2000 Server / Advanced Server with TCP/IP Networking Installed. (Recommend SP1) * 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 Administrators account. When installation is complete, confirm that RSM has installed correctly, by opening your browser at : http://your.machine.name:511/ssa OR select the "SSA Tools" icon setup created on your Start Menu which opens your default 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 NT 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. *** SECURITY WARNING *** 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. It is highly recommended you confirm that : ssacfg.sec ssacfg.bak ssacfg.old are hidden files once they have been copied to your install directory, and that you don't share this directory on your network. ************************ If you have already installed RSM, setup will ask if you wish to overwrite your existing security records. If you select YES, your security file (ssacfg.sec) is copied to ssacfg.old before it is overwritten by the default security file. If you select NO, your security file remains unchanged. 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 ================ If you have another service running, or using port 511, you can change the RSM port number to any valid number by running : c:\issa\servutil (With no parameters will show usage below) To re-install with a different port setting : c:\issa\servutil -i rsm c:\issa\web xxx (where xxx=new port number) This can also be used to change the install directory. Be sure to copy all the files in c:\issa\web including subdirectories before moving the service path. 4.8 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. 4.9 KNOWN PROBLEMS (P) / FIXES (F) ================================== See history.txt copied to install directory for latest release notes / known problems and fixes / enhancements. 4.10 BEFORE UNINSTALLING... =========================== If uninstalling this version of SSA RSM, you MUST first run the following command c:\issa\servutil -rm rsm This will remove the SSA RSM Service from the Registry. Then run Control Panel->Add Remove Software to remove the program files. NB: If you do not run servutil -rm ,selecting SSA RSM in Add Remove Software will fail as the RSM service will still be running. 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. 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 Version 5.2, Setup failed to find the Netfinity install location. Install the Stand Alone version. 11. "RSM no longer supports Netfinity SM Versions 5.0 and 5.1. You should upgrade Netfinity SM to Version 5.2 or install the RSM Stand Alone version" Setup has detected that you previously installed the Netfinity SM 5.0 / 5.1 version of RSM. This is not longer supported. You can continue to use the previous version, but you should install Netfinity SM 5.2 and re-run setup. 12. "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. 13. "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 ------------ 14. "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. 15. "An unknown error has occurred." Setup suffered an unrecoverable error. Please contact your service representative / supplier. 16. "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" 17. "The SSA Device Driver requires Windows Service Pack 3 or later. Please install Service Pack 3 or later and re-run setup." Setup detected an unsupported level of Windows NT. Install Service Pack 5 and re-run setup. 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 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 ===