AdventNet Web NMS 4.7.0 Service Pack README

- Introduction to Service Pack 3
  - What does it contain ?
  - Pre-requisites for installation
  - Latest updates with the Service Pack
- Installing and Uninstalling the Service Pack
- Important Notes
- Contact

Introduction to Service Pack 3

What does it Contain ?

AdventNet Web NMS 4.7.0 Service Pack 3 is an update on Web NMS 4.7.0. It is a cumulative pack which includes new features, enhancements, and bug fixes done over Web NMS 4.7.0. The complete details of Service Pack 3 is available in the Release Notes.

Pre-requisites for Installation

- If you have Web NMS 4.7.0 or Web NMS 4.7.0 SP1 or Web NMS 4.7.0 SP2 then apply Web NMS 4.7.0 SP3 directly.
- If you have Web NMS 4.5.0 and want to update to the latest,
  - first apply Web NMS 4.5.0 SP1
  - then, apply Web NMS 4.7.0 SP3

Latest updates with the Service Pack

- The primary focus of this release is to make Web NMS more developer-friendly. With this Service Pack, Web NMS is empowered with self monitoring and management capabilities by the usage of J2SE5.0 Management APIs. The following features can be enabled by running Web NMS with JRE 1.5 :
  - Memory and Thread Monitoring of the Web NMS Server and Application Clients - Existing Data Collection framework will be used to collect the Web NMS JVM resource statistics.
  - Memory Notification System - Automatic email notification will be sent to the administrator and information of the threads will be dumped when the server memory usage exceeds the configured threshold value.
- P6SPY, an open-source framework for applications that intercept database statements/operations, has been integrated in to the Web NMS platform. As a result, all the database queries between the Web NMS server and the database server can be logged to a flat file. Also, long-running database queries can be identified by enabling P6SPY logging. A new page has been provided in the Web Client to configure the P6SPY properties at runtime.
- Apart from the default Web NMS Logging Framework, Web NMS provides support for industry standard Apache's Log4J framework. The default implementation for Rolling File Appender and Mail Appender is made available in Web NMS. Custom logging Framework can also be plugged into Web NMS.
- Server Log and P6SPY Log Viewers - This release provides new web-based UIs for viewing Web NMS, P6SPY, Apache, and Tomcat logs.
- Support tab is added to the Web Client. This page enables users to create a bug report by means of a support information file which contains logs, and configuration files. The file can then be uploaded to AdventNet or can be mailed to nms-support@adventnet.com along with the support query. This tab also provides access to the Web NMS Online Public Forums, Technical Documentation and Knowledge Base.
- Support for RedHat Linux ES 4.0 and AS 4.0 has been included. Refer to the Installation Guide for more information.
- Support for MySQL 5.0.X has been included. Refer to the Installation Guide for the appropriate database driver versions.
- Transaction support is provided for Firebird database.
- New methods are added in NmsUtil, GenericFEAPI, and NmsClientUtil to expose information about Web NMS server and clients connected. The new list of methods include getClientDetailsOfType, getIpConfigInformation, getJVMSystemProperties, getLicenseInformation, getNmsVersion, getServerIPAndHostName, getServerStartTime, and getServerUpTime. Refer to the Javadocs section for the API documentation.
- Support for JFreeChart 1.0.0 has been provided. On upgrading to Service Pack 3, any user customization done to the performance graphs generated by Web NMS will need to be redone to be compatible with the JFreeChart version 1.0.0. Customizations done using JFreeChart 0.9.15 will not be compatible with JFreeChart 1.0.0. Please contact nms-support@adventnet.com for further information.

For a detailed list of bug fixes and enhancements, refer to the Release Notes.

Installing and Uninstalling the Service Pack

AdventNet releases its Service Packs in the form of PPM file. The Service Pack update process is done using a tool called "UpdateManager". You need to apply the PPM file over the existing Web NMS product. This tool has an easy-to-use GUI which will guide you through the Service Pack update process.

Refer to the Notes given below before proceeding with the installation.

Detailed documents are available on how to install the Service Pack and Uninstall it. Please refer to the following URLs

- Installing the Service Pack
- Uninstalling the Service Pack

Important Notes

1. A PPM has been made available for this Service Pack.
   - It can be used for all the three supported platform installations, i.e., Windows, Linux, and Solaris.
   - It can be used for all the three types of downloads, i.e., Combined (BE+FE+Client), FE, and Application Client.
   - It can also be installed over Japanese and Chinese versions of Web NMS.
2. The configuration file update (using ConfigurationUpdater.bat/sh) and the compilation of JSP files (using compileJSP.bat/sh) processes are invoked automatically by the Update Manager, making the update process much simpler.
3. Changes done by you in the Configuration files are retained during Service Packs. The Service Pack update process ensures that it maintains the customization that have been done in the Configuration files. In case of any modification in the Configuration file by AdventNet during a Service Pack, it is taken care that the changes are appended to your existing Configuration files and not overwritten.
4. Open code sources, such as JSPs, Servlets, Example (.java) files, and default implementations (.java files) are overwritten. In case you have modified any of those, then you need to merge the changes with the ones done for the Service Pack. If you want to know the exact changes done for the Service Pack, please contact us at nms-support@adventnet.com.
5. Before installing a Service Pack, ensure to uninstall the Studio NARs that you have already installed (if any).
6. If your application uses HTML UI, update the database with the latest entries of Tree.xml (located in the <Web NMS Home>/html/defaultsToNewUsers directory or <Web NMS Home>/users directory) using DBXmlTool.bat/sh present in <Web NMS Home>/bin directory. This is to ensure that the enhanced pages of web client are displayed in your browser.
7. You can download the latest README files of the <examples> and <default_impl> from the website.

Contact

Please contact nms-support@adventnet.com in case of any clarification.