File: UW57367.README

==============================================================================
IBM StorWatch Reporter Agent

Version 1 Release 1 Level 2 Final Edition		PTF UW57367
Licensed Materials - Property of IBM
 (C) Copyright IBM Corporation 1998, 1999. All rights reserved.
==============================================================================
Welcome to the StorWatch Reporter Agent for OS/390!

This PTF is a full product replacement for StorWatch Reporter Agent 1.1.1.  
YOU CAN INSTALL THIS PTF ON TOP OF YOUR EXISTING STORWATCH REPORTER AGENT, OR YOU CAN UNINSTALL
YOUR PREVIOUS AGENT AND INSTALL THIS AGENT PTF.

Following are instructions for StorWatch Reporter Agent for 0S/390. This information can be found also in 
the README.390 file under the directory where you install the application.
For more details, please refer to the StorWatch Reporter Installation Guide book.  

===========================================================================


Table of Contents:
-----------------
1.Software pre-requisite

2.Install StorWatch Reporter Agent   

3.Starting the StorWatch Reporter Agent

4.Stoping the StorWatch Reporter Agent

5.Uninstall StorWatch Reporter Agent

6.StorWatch Reporter Agent option file

7.Troubleshooting and Known Problems

8. Late-Breaking News
     - Known problem/restriction topics
     - Documentation updates
     - Message additions/changes

9. Getting Help
     - Online Help
     - Client Documentation
     - Technical Support


10. APARS fixed by previous PTF's

11. APARS fixed by this PTF

___________________________________________________________________________________________


1.Software pre-requisite
------------------------

Before you can install the StorWatch Reporter Agent, you must have specific applications
running. The specific applications are:

      * TCP/IP must be running.

      * The OS/390 UNIX System Services must be running on all agent machines.

      * The Java Virtual Machine (JVM) must be installed on the machines.
        JVM is part of the Java Developers ToolKit (JDK) or Java Runtime Environment (JRE).
        For more details, please refer to the StorWatch Reporter Installation Guide.
        All examples in this readme file assume that you have the JDK install. 
   

      * The Device Manager must be running.

      * The correct level of operating system: 

            OS/390 Version 2 Release 4, or
            OS/390 Version 2 Release 5, or
            OS/390 Version 2 Release 6

     * About 10MB total of disk space to place the install file,
       to allow the agent expands its file during the installation,
       and to provide space for the application data file.
       After the installation is sucessful, you can remove the install file
       to save some space.  You can always download the latest agent
       install file from the StorWatch Reporter Manager.


2.Install StorWatch Reporter Agent
----------------------------------
All of the following operations must be done in the UNIX System Services (Open Edition).
Before installing the StorWatch Reporter Agent, make sure you meet the above
software pre-requisite. You should create a subdirectory for the StorWatch Reporter
installation code. Then get the StorWatch Reporter installation (tar) file from CD-ROM,
or download from the StorWatch Reporter Manager, or from the MVS data set (or member)
which is created when you SMP/E install the StorWatch Agent component.

The name of agent install file in CD-ROM or in the Manager is I390VaRbMc.tar
    where:   
           a is the version level.
           b is the release level.
           c is the modification level. 

Assuming you install the agent using SMP/E install and obtain the data set name
X.Y.Z(GSWAGENT).  To transfer the data set to the Unix System Services,
use the TSO "oput" command.  For example:

     oput X.Y.Z(GSWAGENT) '/usr/lpp/StorWatch/Agent/GSWAGENT.tar' binary

The StorWatch Reporter Agent uses the Install Shield Java Edition to install 
the code. To install the StorWatch Reporter Agent:

  a.Issue the following command from the Unix System Services to extract the compressed file:

       tar -xvf GSWAGENT.tar 

    This will create the following files in your directory:
     i  . I390VaRbMc.class
          where:
              a is the version level.
              b is the release level.
              c is the modification level.
     ii . This README.390 file
     iii. swAinstall - the install script file

  b.Issue the following command to install the agent component:  

     swAinstall target_directory
          where target_directory is the destination location where the agent component resides.

     If you get an error message saying that the java cannot be found,
     then make sure you have the Java Virtual Machine (JDK or JRE)
     installed and/or the environment PATH points the the Java binary
     (bin) directory.

     If you get an error message saying the I390VaRbMc file cannot be found,
     issue the following command to set the CLASSPATH environment:
            export CLASSPATH=.:$CLASSPATH

     If you get any error and the script is terminated,
     you should fix the problem and manualy issue the remaining
     commands from the swAinstall script that have not been run.
     You can always re-run the entire script to reinstall.

  c.The Install Shield will install the code and prompt you for information.
    If you are not sure about a certain parameter, use the default by pressing Enter.


3.Starting the StorWatch Reporter Agent
---------------------------------------

After the installation is completed, you can start the agent from
the UNIX System Services by issuing the command:

    swAgent

from the directory where you install the agent.

The StorWatch Reporter Agent master and slave console messages are displayed in the same window.
You can create a startup task which invokes the swAgent command from
the Unix Services so that when the system is IPLed, the StorWatch Agent
application can start automatically.


4.Stopping the StorWatch Reporter Agent
---------------------------------------

From the UNIX System Services, you can close the agent application by:

    * First display the agent application processes using command:

         ps -ef | grep java

    Look for two agent process ids associate with
         java COM.ibm.storage.storwatch.agent.KonaAgentServer

    * To stop the agent application, issue:

         kill process_id1 process_id2
      or kill -9 process_id1 precess_id2


5.Uninstall StorWatch Reporter Agent
------------------------------------

To uninstall the StorWatch Reporter Agent, make sure it is not running. 
Use the procedure mentioned above to terminate the agent application.

To uninstall the StorWatch Reporter Agent,
go to the directory where the agent files are installed
and issue any of the following command from the UNIX System Services:

       java uninstall -console
    or java uninstall -idb install.idb -console


6.StorWatch Reporter Agent option file
--------------------------------------

When you are installing the Agent, you can set or customized the application options.
If you are not sure about an option, use the default one.

After you install the application, you can also modify these options.
Many of them take effect immediately. To do so, edit the "KonaAge.opt"
file from the directory where you installed the agent, and change the options.

You can find more information about these options in the Installation Guide.


7.Troubleshooting and Known Problems
------------------------------------

    * java

       If you have problems relate to java such as java or class or jar
       files not found:

       - Make sure you have installed the appropriate version of JVM in your system
         JVM is part of the Java Developers ToolKit (JDK) or Java Runtime Environment (JRE).
         For supported version, please refer to the StorWatch Reporter Installation Guide.
      
       - Make sure the CLASSPATH is set properly. 

       If you have installed multiple JVM versions in your system,
       make sure the PATH and CLASSPATH are correct.

    * Uninstall

       When uninstalling, some of the files may not be removed. 
       The following files will not be removed:

          - log trace files
          - log console files
      
       All other files and directories should be removed. 
       If they are not removed, you have probably
       installed the current version over the previously installed
       StorWatch Reporter Agent version and selected not to remove the existing files.

       WARNING:
           The uninstall process will delete all files under 
               xx/COM/ibm/storage/storwatch/agent
           and xx/LockFiles directory,
           where xx is the directory you install the StorWatch Agent.

           You should not place any of you files under the above StorWatch
           install directories.

        If you get this message during installation: 
              I/O error while extracting archive: ...
        It means  you are installing over an existing StorWatch Reporter Agent
        which is currently running active). You have to stop the Agent application
        before you install over a previously installed StorWatch Agent.


    * Action Holds during installation

	   During the installation of the StorWatch Reporter Agent PTF, two action holds will come up requiring
	   action by the customer:

	   When SMP\E installs the PTF, MVS datasets are created.  These datasets must be moved from MVS 
         to UNIX Services.  Therefore, the first action hold requires the customer to read the contents 
         of the part named "GSWR11A".  This part contains instructions on how to move datasets from 
         MVS to UNIX Services.  GSWR11A also contains other important information about the PTF.

	   The StorWatch Agent PTF code is larger than the original StorWatch Agent which was shipped during
         General Availability.  Therefore a second action hold gives instructions on how much space to allocate
         for the dataset which will hold the PTF.
         
	
8. Late-Breaking News

	- Enhancements made to the On-Line Help and Installation Guide.
     
     

9. Getting Help
     - N/A
     

10.  APARS fixed by previous PTF's

APAR #OW36289:

PROBLEM DESCRIPTION: NECESSARY MAINTENANCE AFTER CODE CUTOFF 

ERROR DESCRIPTION:                                                              
	
1.  The OS/390 StorWatch Manager would hang with multiple                      
connections on the DB2 database.                                               
2.  The OS/390 StorWatch Manager was unable to download                        
StorWatch agents properly.                                                     
3.  The Node Discovery Task on the OS/390 platform would                       
inconsistently discover StorWatch agents.                                      
4.  The "Next" hypertext link on the Storage Capacity Detail                   
Report would always result in the next page for the first                      
Node Group being displayed.                                                    
5.  Various inconsistencies between the StorWatch Reporter                     
Installation Guide and the OS/390 Installation Program                        
have been resolved.                                                           
6.  The "Growth by Interval" charts for OS/390 volumes were                    
not displaying correctly.                                                      
7.  The Windows NT agent was not installing correctly when the                 
JRE 1.1.6 was installed.                                                        
8.  Various inconsistencies between the StorWatch Reporter                      
Program Directory and Installation Guide have been resolved.                    
9.  The "silent mode" install for the OS/390 StorWatch Manager                  
had incorrect prompts, which have been corrected.                               
10.  The "Support" Web site for StorWatch Reporter is now                       
accessible through the StorWatch Reporter user interface.                       
11.  The on-line guide now documents the fact that,                             
if an expiration date is not entered for a StorWatch user                       
password, the password never expires.                                           
12.  The characters "<&&lit>" sometimes mistakenly appear                      
in the task summary reports.                                                   
13.  Unauthorized users were able to edit and/or delete report                 
filters belonging to other users.                                              
14.  The OS/390 StorWatch Manager was unable to discover                       
Web servers running in SSL mode.                                               
15.  Extra commas in the HTML statements in the Node                           
Discovery Task summary report were causing extraneous                         
columns to appear.                                                             
16.  The Report Generation Task would occassionally get                        
a missing resource exception.                                                  
17.  The Report Generation Task would abend when a report                      
filter included a node name with a single part.                                
18.  The user interface would display the wrong error message                  
for an invalid password expiration date.                                       
19.  The StorWatch Agent for the H-P platform was                              
returning a value of 0 for system memory.                                      
20.  The message number GSW1000S was not documented                            
in the on-line help.                                                           
21.  The explanation for message GSW7999E in the                               
on-line help was incomplete.                                                   
22.  An out of memory condition was created when generating                    
reports with large amounts of data on the OS/390 platform.                     
23.  The automatic restart of the StorWatch Agent was failing                  
on Windows NT systems under certain conditions.                            

 
11.  APARS fixed by this PTF
    --------------------------

APAR #OW37769:

PROBLEM DESCRIPTION: MADE MINOR ENHANCEMENTS TO THE PRODUCT.

ERROR DESCRIPTION:                                                              

1.  Update Install Guide with numerous changes.                                 
2.  Change minimum purge criteria from 2 yrs to 6 mos.                           
3.  Fixed various problems with display of elapsed time.                        
4.  Old password is displayed in swConfig on OS/390 only.                       
5.  Prompt for default URL on OS/390                                             
6.  Fragmentation Index is not explained in on-line guide                        
7.  Node Discovery does not use number of threads efficiently                    
8.  Enhance view report to allow each user to specify the number                 
of rows displayed for the detailed reports.                                     
9.  Add note to readme files about not uninstalling existing                     
product.                                                                     
10. User password never expires is not documented.                              
11. Senseless chart displayed when Stacked+Area are selected. 


Last Update  03/23/1999

