IBM Tivoli Netcool/Webtop 2.2.0.83 FP1 README There are updates to the following TIP components: Common Reporting 1.2.0.2 TIPCore 1.1.1.3 TIPTSS 1.1.1.1 ESSServer 1.1.1.1 CGIServer 1.1.1.3 TIP 1.1.1.1 eWAS 6.1.0.2101 ISC 7.5.1.3 Deployment Engine 1.3.1.17 IBM Tivoli Netcool/Webtop 2.2.0.83 FP1 Installation Instructions ================================================================ This document shows how to install the Fix Pack 1 for IBM Tivoli Netcool/Webtop 2.2.0.83. The installation has the following stages: 1. Stop TIP and its associted services. 2. Extract the installation files from the archive. 3. Install the WebSphere Update Installer (WUI). 4. Install the fix pack. 5. Restart the TIP server. 6. Install SDK interim fix for IBM WebSphere Application Server Version 6.1 Terminology: These instructions use the following terms to refer to directories used during installation: TIP_HOME is the home directory for IBM Tivoli Netcool/Webtop. The location of the directory is given by the environment variable $TIP_HOME (on Unix-based systems) or %TIP_HOME% on Microsoft Windows systems. FP_dir is the temporary directory where you extract the contents of the fix pack's archive. WUI_dir is the temporary directory where you extract the contents of the WUI archive. 1. Stop TIP and its associated services ======================================= Follow the instructions for your operating system: Unix-based systems ------------------ 1. Log in as an adminstrator and stop TIP by entering: $TIP_HOME/bin/stopServer.sh server1 2. Wait for 30 seconds for the TIP and its subprocesses to stop. 3. Stop the IBM ADE Service by entering: /usr/ibm/acsi/bin/acsisrv.sh -stop 4. Wait 30 seconds for the service and all it subprocesses to stop. Windows systems --------------- 1. Log in as a user with administrative privileges. 2. Open the Services control panel by clicking Start-->Control Panel--> Adminstrative Tools-->Services. 3. Stop the service named Tivoli Integrated Portal - TIPProfile_Port_16310. 4. Wait 30 seconds for TIP and its subprocesses to stop. 5. Stop the service named IBM ADE Service. 6. Wait 30 seconds for the service and its subprocesses to stop. 7. Close the Services control panel. 2. Extract the installation files ================================= Extract the installation files from their archives, ready to install on your system. 1. Extract all the files from the Webtop-2.2.0.83-FP1- archive into a temporary directory (the FP_dir directory). The extension for the fix pack's archive is .tar or .zip, depending on the platform. is a code for the system platform you are installing the fix pack on to. 2. Navigate to FP_dir. 3. Extract all the files from the 7.0.0.1-WS-UPDI- archive into a temporary directory or use the default of 7.0.0.7-WS-UPDI- in FP-dir. The directory you choose is the WUI_dir directory. The extension for the WUI archive is .tar or .zip, depnding on the platform. is a code for the system platform you are installing the fix pack on to. 3. Install WebSphere Update Installer ===================================== The following instructions are a summary of how to install the WebSphere Update Installer. For full details, refer to the document at: http://www-01.ibm.com/support/docview.wss?rs=180&uid=swg24020446 To install the WUI: 1. Navigate to TIP_HOME and create a subdirectory named UpdateInstaller. 2. Navigate to the UpdateInstaller directory in the WUI_dir. 3. Run the installer for WUI. Use the appropriate command for your operating system: Unix-based: ./install -is:javaconsole Windows: install.exe The installation procedure then begins. When asked for the installation directory, specify the TIP_HOME/UpdateInstaller directory that you created in step 1. The following is an example of installing the WUI using the installation wizard on a Windows system: 1. Click Next on the Welcome screen. 2. Accept the license agreement. 3. In the Installation Directory screen, specify the TIP_HOME/UpdateInstaller directory that you created. 4. Set or clear the checkbox to Create a start menu icon, depending on your preference, and click Next. 5. Click Next to start the installation. 6. When the installation results appear, click Next to complete the installation. 4. Install the fix pack ======================= 1. Navigate to the FP_dir directory. 2. Run the installater for the fix pack. use the appropriate command for your operating system: Unix-based: ./install.sh -i console Windows: install.bat 5. Restart the TIP server ========================= When the installation is complete restart the TIP server. 6. Install SDK interim fix for IBM WebSphere Application Server Version 6.1 =============================================================================== There is an interim fix to the SDK that addresses a parseDouble vulnerability security issue. NOTE: The user must: * Have Administrative rights in Windows, or be the Actual Root User in a UNIX environments. * Logged in with the same authority level when unpacking a fix, fix pack or refresh pack. The SDK interim fix for Versions 6.1 through 6.1.0.33 is available from: http://www.ibm.com/support/docview.wss?uid=swg24029112 1. Copy the .pak file directly to the TIP_HOME/UpdateInstaller/maintenance directory. (eg: TIP_HOME/UpdateInstaller/maintenance). 2. Stop the Tivoli Integrated Portal. 3. Start the Update Installer by running the folowing script: Windows: update.bat Unix/Linux: update.sh 4. Enter the installation location of the the Tivoli Integrated Portal product you want to update. (i.e: TIP_HOME). 5. Select the "Install maintenance package" operation. 6. Select location of the maintenance package to install (.pak file which was copied in the maintenance directory). 7. Choose the maintenance package to install (.pak file which was copied in the maintenance directory). 8. Install the maintenance package. 9. Restart the Tivoli Integrated Portal server. Workaround for installing Webtop 2.2 FP1 on top of TBSM 4.2 on AIX ================================================================== Before installing Webtop 2.2 FP1 on top of TBSM 4.2 on AIX, shut down the TBSM applications. This shuts down the ObjectServer, the Postgres Database and the two TIP Profiles (TIPProfile and TBSMProfile). To shut down the TBSM applications: 1. Enter the following command: $TBSM_HOME/bin/tbsm_suite.sh stop 2. Search for PID of TBSM TIP component to ensure that it is shutdown properly: ps -ef|grep java|grep TBSMProfile 3. If the component has not shut down properly, kill the process manually. After the installing the fixpack restart the TBSM applications can be restarted by entering the following command: $TBSM_HOME/bin/tbsm_suite.sh start ------------------------------------------- Bugs/Enhancements addressed in 2.2.0.83 FP1 ------------------------------------------- ALM00112661 / IZ52553 ===================== Short Description: Behavior of the AEL Portlet in the views is variable Summary: There is an issue in that loading an AEL portlet for the first time using a transient entity. The username cannot be found from the session, and so the transient entity can not be stored there. The issue is resolved by using the session that is available from container, and creating the Webtop user storage so that the transient entity can be stored. ALM00108999 / IZ49654 ===================== Short Description: Unable to open event information by double clicking an event in an AEL that was opened from a map Summary: No event information is available when double clicking on an AEL launched from Map. This issue is resolved by adding "eventlistdoubleclickaction" as one of the standard parameters to, and is default for, "showinfo". ALM00109957 / IZ50721 ===================== Short Description: user.modifyUser causes errors Summary: A method for implementing the "modify user" functionality was missing, which caused runwapi to fail when using "user.modifyUser". This is resolved by implementing the method. ALM00107185 / IZ46722 ===================== Short Description: Unable to edit or change the name of an iframe Summary: On the IFramePortlet edit preferences page there is an option to change the iFrame name for the portlet. When the name is changed and the preferences are saved, the name reverts to the original value, and is not saved nor used. This issue is fixed by changing the portlet so that custom iframe name setting are saved and used as specified on the edit preferences page. ALM00111976 / IZ52075 ===================== Short Description: File manager broken Summary: An outdated and hard-coded relative path was being used. This was replaced by the class variable rootdir, which contains a full path to the web root directory. Also, an unused class variable with the same outdated path was removed. A related security flaw regarding WAAPI file calls was fixed. WAAPI can no longer (by default) work on files and directories outside the Web root directory. ALM00114199 / IZ53937 ===================== Short Description: The Event detail list scroll bar is broken when an event field is long Summary: Opening event information windows from LEL is not able to display properly if any of the fields contain a long string. This is fixed by making adjustments in the width of the outer div. ALM00114202 / IZ53832 ===================== Short Description: Webtop - SP3 Installation Problems-ESR: Monitor boxes do not appear in browser. Summary: The background color of a map is being saved in the browser locale into the map file. If the browser locale setting is not English, the backgound colour appears as black when the map is loaded using a browser with a different locale setting. As Webtop will not know in which language the color was previously saved, it cannot translate the background color correctly when loading the map. The problem is fixed by saving the map backgound color in a default language, for example English. When the map is viewed or edited, the background color is then translated to the browser locale. ALM00115417 / IZ55268 ===================== Short Description: CGI scripts are executed twice Summary: CGI scripts are executing twice when run from a Webtop/TBSM installation on Linux or AIX. The problem is fixed with a single execution on CGI Script in method runCgi and holding the result in the input stream before passing it to the output stream. ALM00115904 / IZ55402 ===================== Short Description: Webtop last/first occurrence issue Summary: A Table View that contains date fields such as firstOccurrence and LastOccurrence causes a NullPointerException if the user preference "ael_user_properties_timeformat" is not set for user in profiles\TIPProfile\etc\webtop\configstore\ncwUserPreferences\{username}.nova. An icon indicating Object Server not available is shown. The problem is fixed by retrieving the default value from the userdefault.properties if any property does not exist in the user's preference nova file. alm00117187 / IZ56567 ===================== Short Description: Control key operation is inconsistent in 2.2.0.0 GA release and IF4. Summary: When a user tries to log in immediately after loging off, they do not get logged on but either of the following occurs: o A browser session opens containing some strange text o Windows starts a different application that tries to act on the text such as Notepad or a zip utility. This becomes a particular problemwhen the user re-uses the same browser session to log in again. The problem occurs on IE6 with JRE 1.5.0_17, and is fixed by modifying the iFrameView.jsp file, so that the jsp properly handles the TIP closePage event. In addition, Webtop needs to register to receive those closePage events. This is done using the ibm-portal-event.xml file. alm00118912 / IZ59314 ===================== Short Description: Webtop fix for --"strange pop-up when logging in real fast after logout". Summary: This involves the Webtop IFrame portlets. Whenever an IFrame portlet is used, which calls on a Java applet, the applet does terminate properly when the page is closed or the user logs off. This is now fixed. alm00120674 / IZ60571 ===================== Short Description: Regular users not able to modify initial entity Summary: The solution is to move and rename tooleditor\scripts\toolEditorControllers.js to scripts\editModeControllers.js. A user with ncw_ael_editor role but without ncw_admin role can now use edit mode of AEL portlet. alm00123505 / IZ63863 ===================== Short Description: Ability to remove padding style on IFrame Summary: Implemented javascript code to remove portlet padding. There are now no empty space between the edge of iFrame and the page inside the iFrame. ------------------------------------------- Bugs/Enhancements addressed in 2.2.0.82 IF4 ------------------------------------------- ALM00105474/APAR IZ39904 ======================== Issue Description: AEL shows events after restart of TIP The AEL brings returns events and displays them after a server restart. This is fixed by ensuring the AEL implements the required behavior such that a disconnect icon gets displayed after restart. ALM00103998/APAR IZ42233 ======================== Issue Description: MAP PORLET DOES NOT SHOW SPECIFIED WEBTOP MAP A user creates a page using a Map Portlet and it is set as a page to be loaded at startup. When the user logs in the first time Webtop correctly displays the map. However, when the user logs out and logs in again, the map does not appear and a stack trace is printed in the java console. The problem was caused by a NullPointerException occuring in ResourceBundleSource due to the locale being null. This happened because subsequent requests sent to the server did not contain the 'Accept-Language' header in the request due to the locale not being set. This problem has now been fixed. ------------------------------------------- Bugs/Enhancements addressed in 2.2.0.82 IF2 ------------------------------------------- NBS054468 / APARIZ08045 ===================== Issue Description: Map browser list does not automatically refresh after a map is created. The issue is fixed and new maps are added to the list automatically. NBS061262 / APAR IZ37221 ======================== Webtop 2.2 - Filter Builder unable to handle large number of LDAP users The issue has been fixed by using the AdminCommand API, instead of the slower InstanceAuth API in dci_security.jar, and by retrieving only users with Webtop roles assigned, instead of a list of all users. NBS 55391 / APAR IZ14796 ======================== Issue Description: Entity status requests sent through the status servlet are only ever returned from default data source. This caused issues with multidomain Network Manager configuration where there is no central ObjectServer but each domain has separate ObjectServer and Tivoli Netcool/Webtop connects to each of them. Status in Topoviz maps was displayed from the default data source regardless of domain selected. The issue is fixed by enhancing the entity registration handling process triggered by Topoviz. NBS55102 / APAR IZ12265 ======================= Issue Description: Changes to text font and text size of inactive buttons in Map Editor have no effect. The issue is fixed and changes to text font and size take effect. NBS55392 / APAR IZ14830 ======================= Issue Description: Smart Matching is not working as described in IBM Tivoli Netcool/Webtop Administration Guide. The issue is fixed and key strokes work as described in IBM Tivoli Netcool/Webtop Administration Guide. NBS56083 / APAR IZ18472 ======================= Issue Description: The width of the 'Current Items' and 'Add Items' columns in the Menus Editor do not adjust according to the tool's name. The issue is fixed by adding horizontal and vertical scroll bars to the 'Current Items' and 'Add Items' columns. NBS 57102 / APAR IZ22105 ======================== Issue Description: Selecting or clearing the Show Highest Color/Show Lowest Color check boxes and clicking Apply->Save in the AEL Preference panel causes a NullPointerException on the Java console. In addition, the changes are not applied to the Monitor boxes. This problem is fixed and the Monitor Boxes correctly follow the preferences set up in the AEL Preferences panel. NBS 57101 / APAR IZ22106 ======================== Issue Description: Show Lowest Severity Color check box is grayed but selected when 'Show lowest severity' parameter is disabled. The check box should be grayed and unchecked. The Show Lowest Color check box has been amended and is cleared when the user clears the Show Lowest Severity check box. NBS56639 / APARIZ20492 ====================== Issue Description: Multiple monitor boxes added to a web page using the insert:AEL smartpage command do not load. The issue is fixed and monitor boxes can now be loaded. NBS055264 / APARIZ13962 ======================= Issue Description: Changes to the font and font size via AEL Edit Preferences are lost after browsing to different page. The issue is fixed and the font and font size are changed. NBS 57483 / APAR IZ23055 ======================== Issue description: Running the WAAPI method cgi.registercgi against previously registered CGI causes java.lang.NullPointerException to occur. This issue was caused by an object of the Tivoli Netcool/Webtop CGI manager component that did not start properly when registering CGI tools. The is fixed and the CGI subsystem now starts properly. NBS61339 / APAR IZ37439 ======================= Issue description: Chinese code not interpreted correctly in entity and entity views. When column titles in entity views are set using multibyte characters (eg. chinese), they do not display correctly after the Tivoli Integrated Portal server restarts either in entity views or in the AEL. The issue was caused by the data being written to the file without using UTF-8 encoding. The issue is fixed by using correct encoding when writing the data to the file system. NBS56838 / APAR IZ20932 ======================= Issue Description: Netcool/Webtop tools no longer work after one tool opens new window with new AEL and closes it. The issue is fixed by using the correct mechanism to access the tool manager component code. NBS 54469 / APAR IZ07975 ======================== Issue Description: A view jumps to first in AEL view list combo box when tool opens multiple new windows. If a tool executed over multiple events that were opening new AELs in new windows, the view in the original AEL was reset to first available view. Thisissue was caused by inappropriate synchronization of view definitions between the old AEL, the new AELs and the Tivoli Netcool/Webtop server. The issue was fixed by improving the code for synchronizing of views with Tivoli Netcool/Webtop server. investigation into this issue showed that filters had a similar probelm, and that is fixed also. NBS057074 / APAR IZ22028 ======================== Issue Description: Class list boxes in the tool editor do not display more than 28 characters. The issue is fixed by adding horizontal and vertical scroll bars to the Available Class list box and the Selected Class list box. Due to HTML limitations, even if items in the list are shorter than the list itself, the horizontal scrollbar always appears. NBS056752 / APAR IZ20892 ======================== Issue Description: The Available entity list box in the Entity editor does not resize for long names. The issue is fixed by adding horizontal and vertical scroll bars to the Available Entity list box and the Current Dependencies list box. Due to HTML limitations, even if items in the list are shorter than the list itself, the horizontal scrollbar always appears. NBS 57893 / APAR IZ24023 ======================== Issue description: The background color os a map does not change after Java 1.6 was installed in a browser This issue occurred because the system did not check for the condition when the user creates a map with a background color but no background image. This is now fixed and a map created in HTML editor shows the background color correctly when opened with JDK 1.6. NBS 57000 / APAR IZ21888 ======================== Issue Description: User permissions are cached after user logs out The issue is fixed by getting user's permission from session and setting it correctly. NBS55652 / APAR IZ16348 ======================= Issue Description: Switching between Webtop filters in AEL takes long time when a filter has many events. The issue is fixed by changing the way Tivoli Netcool/Webtop reads and writes data. NBS55473 / APARIZ14892 ===================== Issue Description: Events selected by one user in an AEL change after refresh if another user deletes one or more events above the event selected by the first user. The issue is fixed and selected events stay the same after refresh. NBS55838 / APARIZ16971 ===================== Issue Description: The browser is locked-up if an AEL or Map is displayed for an indeterminate time. The issue is fixed.