This readme file contains information about the NetView Web application component of Tivoli(R) NetView for z/OS(R) v5r2.
This file is divided into the following categories:
Installation Planning for NetView Web Application
The NetView Web application is available on the following platforms:
The NetView Web application consists of the following features:
If you choose to do a full installation, all features will be installed. If you choose to do a custom installation, you can specify which features you want to install.
Before installing the NetView Web application, you must decide if you want to use the embedded version of the IBM WebSphere Application Server - Express or IBM WebSphere Application Server as your web server. The embedded version of the WebSphere Application Server - Express image is installed as a 32-bit configuration. The machine where the embedded version of the IBM WebSphere Application Server - Express or IBM WebSphere Application Server is installed is referred to as the Web Application Server.
Once you have determined which web server to use, you must decide if you want to install the SNMP Server on the Web Application Server or on a separate machine. Refer to the IBM Tivoli NetView for z/OS Installation: Configuring Additional Components manual for more information.
If you are using WebSphere as your web server, IBM WebSphere Application Server, V6.0.2 is required.
The NetView Web application is supported on the following operating systems:
For SLES 9 x390 64-bit platforms, this architecture requires the installation of compatibility libs for 32-bit apps to run in "compatibility mode" or "tolerance mode". The two RPM packaged libs that are required are:
You can query your SLES system for these compat libs by issuing the following command: "rpm -qa | grep compat"
NetView Web application runs on the 64-bit Linux on zSeries distributions in compatibility mode does not contain any native 64-bit compiled code.
The install footprint is 400 MB of fixed disk space for Windows and 650 MB for UNIX systems.
For additional hardware requirements for IBM Websphere Application Server V6.0.2, Advanced Edition, see the WebSphere documentation for the applicable platform.
The files to install are located in the Tivoli NetView for z/OS CD distribution media under the directory "webapp".
The following files are distributed as part of the NetView Web application:
| znetview_webapp_win.exe | InstallShield image for Windows. |
| znetview_webapp_aix.bin | InstallShield image for AIX. |
| znetview_webapp_zlinux.bin | InstallShield image for Linux on zSeries. |
| znetview_webapp_ia32linux.bin | InstallShield image for Distributive Linux. |
| znetview_webapp_readme_en.htm | English version of this README file. |
| znetview_webapp_readme_ja.htm | Japanese version of this README file. |
Installing/Uninstalling the NetView Web Application
Notes concerning SECURE and NON-SECURE selections for configuring your CONNECTION:
The default choice for the installation wizard is SECURE CONNECTION when running the NetView Web application in the embedded version of WebSphere Application Server - Express.
Sample URL (notice the "s" with this protocol https !):
https://hostname:9943/netview/NetView4zosDomain/ (secure connection)
Sample URL (either one will provide access):
http://hostname:9980/netview/NetView4zosDomain/ (non-secure connection)
https://hostname:9943/netview/NetView4zosDomain/ (secure connection)
Note: If after installation of the embedded version of WebSphere Application Server - Express feature, you then decide that you want to change your CONNECTION from SECURE to NON-SECURE or NON-SECURE to SECURE, then use the "secure script" to make this change. See the section below labeled "Using the secure script:" under Configuring the embedded version of the IBM WebSphere Application Server - Express for details.
However, if you are running NetView Web application on WebSphere Application Server using SSL transport, then additional customization will need to be done in order for the NetView Web application to run SNMP Server functions (other NetView Web application functions will not be affected). Follow these customization suggestions below:
Customization to enable NetView Web application communication to the SNMP Server with SSL transport enabled:
The current WebSphere Application Server's client and server certificates located in WebSphere's ../etc jks key files need to be added to WebSphere's ..\java\jre\lib\security\cacerts trust store file using the appropriate tool (e.g. ikeyman). If cacerts certificates do not match WebSphere's, then WebSphere will indicate SSL handshake errors (in WebSphere application server's trace log) and no communication to SNMP Server will be possible (NetView Web application will display message "CNM1268E: Unable to contact SNMP Server"). This only affects SNMP Server access and this customization is only necessary with WebSphere Application Server that is running with SSL transport.
To install the NetView Web application on a supported Windows platform, follow these steps:
Installation Tips:
To install the NetView Web application from CD:
---- or ----
To install the NetView Web application by HTTP download, follow these instructions:
Running the znetview_webapp_win.exe file will invoke the InstallShield MultiPlatform setup wizard.
Note:
When you run znetview_webapp_win.exe for Windows, you get an initial InstallShield panel
that prepares a JVM (Java Virtual Machine) to be used for the installation.
Depending upon your machine's speed and memory and other processes currently running
and competing for machine resources, this preparation could take 30 - 40 seconds or
longer. The "status" indicator may freeze for a moment, but
you should get to the next panel which starts the InstallShield Wizard initialization.
It is recommended, but not necessary, to use the default directory name of the target
folder. The default path is "c:\usr\lpp\netview\v5r2". It is important not to use
special characters like &, *, or # as part of the target folder path name.
To uninstall the NetView Web application on a supported Windows platform, follow these steps:
Note:
DO NOT remove any installed files or folders (subdirectories) without first completing
the "Add/Remove Program" process described in step #1 above for ALL Features.
Also, if you have made any important updates to the web.xml file or to the nvim.xml file, you might want to save this file before uninstalling the product.
To install the NetView Web application on AIX, follow these steps:
Installation Tips:
When exporting the DISPLAY to another machine, you can avoid problems with the X server by running the install in non-graphics (text only) mode from a terminal session as follows: "znetview_webapp_aix.bin -console"
Default temp space is /tmp for installation files. If there is not enough disk space available, you can specify a different temp area as follows: "znetview_webapp_aix.bin -is:tempdir new_temp" where new_temp is a valid fully qualified path.
From a terminal session, issue this command: "cat /tmp/nvweb_hist.log"
This history log will detail which features of NetView Web application have been installed or uninstalled, the date and time of the installation or uninstall, and the install location.
AIX uses the /tmp area for its temp JVM (Java Virtual Machine) area and NetView Web application files during installation so you should plan for at least an extra 250 MB of additional free space in the /tmp file system for a Full Installation. The /tmp space will be released after the installation completes successfully. As for your target directory, you'll need at least 650 MB for a Full Installation.
To install the NetView Web application from CD:
---- or ----
To install the NetView Web application by HTTP download, follow these instructions:
Running the znetview_webapp_aix.bin file will invoke the InstallShield MultiPlatform setup wizard.
Note:
When you invoke znetview_webapp_aix.bin, AIX will display the following status messages:
Initializing InstallShield Wizard Installer...
Preparing Java(tm) Virtual Machine...
...................................
...................................
.........................
Running InstallShield Wizard Installer...
The InstallShield panels that follow with the AIX installation are
similar to the other platform installation sequences.
It is recommended, but not required, to use the default directory name of the target folder. The default path is "/usr/lpp/netview/v5r2".
To uninstall the NetView Web application from AIX, follow these steps:
InstallShield will run the uninstall program which will present you with panel information that will let you select the feature(s) that you want uninstalled.
Note:
DO NOT remove any installed files or subdirectories without first running the
InstallShield's uninstaller file znetview_webapp_aix_uninstall.bin as described in step #1
above for ALL Features.
Do not attempt to uninstall the NetView Web application product via "installp -u" or through the SMIT/SMITTY interface.
Also, if you have made any important updates to the web.xml file or to the nvim.xml file, you might want to save this file before uninstalling the product.
To install the NetView Web application on your Linux system follow these steps:
Installation Tips:
When exporting the DISPLAY to another machine, you can avoid problems with the X server by running the install in non-graphics (text only) mode from a terminal session as follows: "znetview_webapp_zlinux.bin -console"
Default temp space is /tmp for installation files. If there is not enough disk space available, you can specify a different temp area as follows: "znetview_webapp_zlinux.bin -is:tempdir new_temp" where new_temp is a valid fully qualified path.
From a terminal session, issue this command: "cat /tmp/nvweb_hist.log"
This history log will detail which features of NetView Web application have been installed or uninstalled, the date and time of the installation or uninstall, and the install location.
Linux uses the /tmp area for its temp JVM (Java Virtual Machine) area and NetView Web application files during installation so you should plan for at least an extra 250 MB of additional free space in the /tmp file system for a Full Installation. The /tmp space will be released after the installation completes successfully. As for your target directory, you'll need at least 650 MB for a Full Installation.
To install the NetView Web application from CD:
---- or ----
To install the NetView Web application by HTTP download, follow these instructions:
Running the znetview_webapp_zlinux.bin file will invoke the InstallShield MultiPlatform setup wizard.
Note:
When you invoke znetview_webapp_zlinux.bin, your linux system will display the following status messages:
Initializing InstallShield Wizard Installer...
Preparing Java(tm) Virtual Machine...
...................................
...................................
.........................
Running InstallShield Wizard Installer...
The InstallShield panels that follow with the Linux on zSeries installation are
similar to the other platform installation sequences.
It is recommended, but not required, to use the default directory name of the target folder. The default path is "/usr/lpp/netview/v5r2".
To uninstall the NetView Web application from Linux on zSeries, follow these steps:
InstallShield will run the uninstall program which will present you with panel information that will let you select the feature(s) that you want uninstalled.
Note:
DO NOT remove any installed files or subdirectories without first running the
InstallShield's uninstaller file znetview_webapp_zlinux_uninstall.bin as described in step #1
above for ALL Features.
Do not attempt to uninstall the NetView Web application product via "rpm -e".
Also, if you have made any important updates to the web.xml file or to the nvim.xml file, you might want to save this file before uninstalling the product.
To install the NetView Web application on your Linux system follow these steps:
Installation Tips:
When exporting the DISPLAY to another machine, you can avoid problems with the X server by running the install in non-graphics (text only) mode from a terminal session as follows: "znetview_webapp_ia32linux.bin -console"
Default temp space is /tmp for installation files. If there is not enough disk space available, you can specify a different temp area as follows: "znetview_webapp_ia32linux.bin -is:tempdir new_temp" where new_temp is a valid fully qualified path.
From a terminal session, issue this command: "cat /tmp/nvweb_hist.log"
This history log will detail which features of NetView Web application have been installed or uninstalled, the date and time of the installation or uninstall, and the install location.
Linux uses the /tmp area for its temp JVM (Java Virtual Machine) area and NetView Web application files during installation so you should plan for at least an extra 250 MB of additional free space in the /tmp file system for a Full Installation. The /tmp space will be released after the installation completes successfully. As for your target directory, you'll need at least 650 MB for a Full Installation.
To install the NetView Web application by HTTP download, follow these instructions:
Running the znetview_webapp_ia32linux.bin file will invoke the InstallShield MultiPlatform setup wizard.
Note:
When you invoke znetview_webapp_ia32linux.bin, your linux system will display the following status messages:
Initializing InstallShield Wizard Installer...
Preparing Java(tm) Virtual Machine...
...................................
...................................
.........................
Running InstallShield Wizard Installer...
The InstallShield panels that follow with the Linux installation are
similar to the other platform installation sequences.
It is recommended, but not required, to use the default directory name of the target folder. The default path is "/usr/lpp/netview/v5r2".
To uninstall the NetView Web application from Linux, follow these steps:
InstallShield will run the uninstall program which will present you with panel information that will let you select the feature(s) that you want uninstalled.
Note:
DO NOT remove any installed files or subdirectories without first running the
InstallShield's uninstaller file znetview_webapp_linux_uninstall.bin as described in step #1
above for ALL Features.
Do not attempt to uninstall the NetView Web application product via "rpm -e".
Also, if you have made any important updates to the web.xml file or to the nvim.xml file, you might want to save this file before uninstalling the product.
Post-Installation Customizations
If you have installed the NetView Web application feature "embedded version of the IBM WebSphere Application Server - Express", then you should skip to the section below called "Post-Installation Customizations for the embedded version of the IBM WebSphere Application Server - Express" to complete necessary customization steps that still need to be taken.
If you have installed the zNetViewWebApp.ear file and only want to run the NetView Web application within the WebSphere Application Server, then you still need to complete the following section herein called "Post-Installation Customizations for WebSphere Application Server".
Installing the Enterprise Application (zNetViewWebApp.ear file) with the WebSphere Enterprise Application Wizard
To install the Enterprise Application zNetViewWebApp.ear file:
To uninstall the NetView Web application from a supported Windows platform, follow these steps:
Note: You might want to first save any customizations made to the web.xml and nvim.xml files before proceeding with the rest of these instructions.
Note: Uninstalling the zNetViewWebApp.ear file from WebSphere Application Server does not uninstall any of the NetView WebSphere application features previously installed. To uninstall the NetView WebSphere application feature(s), see the Installing/Uninstalling the NetView Web Application section for your platform.
Note1: Please note that the location that for the nvim.xml is different than the location specified above for the web.xml file.
Note2: For Japanese environment, you must edit the Japanese version of the nvim.xml file. Please follow these suggested procedures:
Now you can edit the nvim.xml file.
For more information, refer to the IBM Tivoli NetView for z/OS Installation: Configuring Additional Components manual.
For more information, refer to the IBM Tivoli NetView for z/OS Installation: Configuring Additional Components manual.
Starting/Stopping the NetView Web Application
Any information, warning or error messages related to SNMP Server initialization will
be written to the snmpserver.log file in \usr\lpp\netview\v5r2\jars\logs. You may notice
the following warning messages in the snmpserver.log file. These messages can be
ignored.
WARN com.tivoli.netview.util.InetService - Unable to load 'utiljni':java.lang.UnsatisfiedLinkError:
no utiljni (utiljni.dll) in java.library.path
This will start the embedded version of IBM WebSphere Application Server - Express and the SNMP Server.
To display help for this command, issue the nvsrvc command without any parameters.
The embedded version of the IBM WebSphere Application Server - Express has been configured with default values. These default values are the following:
Use the following command to configure the embedded version of the IBM WebSphere Application Server - Express
on your Web application Server.
Note: D: drive is used as an example drive in the command below.
Windows Environment - execute the following:
cd D:\usr\lpp\netview\v5r2\bin
nvsrvc config option
UNIX Environment - execute the following:
cd /usr/lpp/netview/v5r2/bin
nvsrvc.sh config option
options:
-help - show this list
-show - show current configuration of embedded version of the IBM WebSphere Application Server - Express
-httpport portnumber - port used to connect for HTTP transport
valid range 1-65535 : default = 9980
-httpsport portnumber - port used to connect for HTTPS transport
valid range 1-65535 : default = 9943
-rmi portnumber - port used to connect for Bootstrap/RMI
valid range 1-65535 : default = 10809
-soap portnumber - port used to connect for SOAP connector
valid range 1-65535 : default = 10880
-timeout minutes - session timeout value, in minutes
valid range 2 - 2147483647 : default = 30
-keyfile filename - Key File Name. NOTE: Enter file name only.
File must be placed in the \ewas\etc directory of your NetView Web Application
-keypw password - Key File Password.
WARNING: Password will be displayed on command line.
-trustfile filename - Trust File Name. NOTE: Enter file name only.
File must be placed in the \ewas\etc directory of your NetView Web Application
-trustpw password - Trust File Password.
WARNING: Password will be displayed on command line.
Using the secure script:
You can set the CONNECTION type to SECURE or NON-SECURE when running the NetView Web application within the embedded version of the IBM WebSphere Application Server - Express feature at any time by using a tool in the "bin" subdirectory of the NetView Web application installed location. For Windows, the script tool is called "secure.bat". For Unix it is "secure.sh".
Only options for the secure script are "y" or "n". Running the script without any parameters will display the available options with a brief description.
For example, if you wanted to set the CONNECTION for the NetView Web application to NON-SECURE on AIX, then you would issue the following command from the ../bin subdirectory:
Refer to "Notes concerning SECURE and NON-SECURE selections for configuring your CONNECTION" in the
section above under Install - Important Information concerning the details that will affect
your URL access (http vs. https) and port number.
Windows Environment - execute the following:
cd D:\usr\lpp\netview\v5r2\bin
nvsrvc start webserver
UNIX Environment - execute the following:
cd /usr/lpp/netview/v5r2/bin
nvsrvc.sh start webserver
UNIX Environment - execute the following:
cd /usr/lpp/netview/v5r2/bin
nvsrvc.sh start snmpserver
Use the following command to start the utility.
Note: D: drive is used as an example drive in the command below.
UNIX Environment - execute the following:
cd /usr/lpp/netview/v5r2/wxe/bin
WxeEditor.sh
To display the sign-on panel for the NetView Web application from your Internet Browser (Mozilla or Internet Explorer), task DSIWBTSK must be ACTIVE on the NetView for z/OS system.
If you are using the embedded version of the IBM WebSphere Application Server - Express, point your web browser to:
If you are using WebSphere, point your web browser to http://hostname/netview/NetView4zosDomain/
If you configure your HTTP web server and WebSphere Application Server to use a port other than the
default of 80, then you will need to specify that port in the URL after the hostname. Note that hostname and
port must be separated by a colon.
hostname is the hostname of the machine where your Web Application code is installed. If you are running everything locally, you can specify localhost as your hostname.
NetView4zosDomain is the name that you specified in the servlet-mapping definition in the web.xml file (if you are using the embedded version of the IBM WebSphere Application Server - Express) or the value that you supplied when performing the pre-installation steps for WebSphere. If you have followed the customization steps above, this will be the NetView for z/OS domain name.
Sign on to NetView using a valid user name (NetView operator ID) and password.
Modifying the Default MIB Definitions
The NetView Web application is shipped with a default set of MIB definitions which are included when you start the SNMP Server. MIB definitions are specified in a file named mibserver.def which resides in the usr\lpp\netview\v5r2\mibs directory. The mibserver.def file can be modified to include additional MIB definitions or exclude existing MIB definitions. Refer to the mibserver.def file for the complete list of MIBs shipped with the NetView Web Application.
Special Considerations for DBCS Japanese environment
The following items describe some situations that need to be considered when operating NetView Web application in a supported Japanese environment:
Do not use wordpad since some Japanese characters will be incorrectly converted from UTF-8 format when saving the file. It is recommended to use another editor that can handle UTF-8 locale.
During the installation process, some non-translated English strings may appear in the status field of the installation wizard panel (during deployment of the NetView Web application EAR file). This limitation will not affect the installation of Japanese support files and will not affect the application or any of its features during runtime in the Japanese supported environment.
The SSL certificate exchange causes a browser security alert ("Hostname Mismatch") because the server's dummy certificate name "jserver" (which is a default name) does not match your web site URL hostname.
You could stop this message alert by installing a certificate named for your site's hostname and signed by a trusted certification authority known to the browser. However, an easier solution is to simply select "Yes" for this message and proceed. You will get two or three similar messages. Answer "Yes" to each one and those messages should no longer appear for this specific instance of the NetView Web application.
When using the "Save as" feature with the utility, there are some problems related to the Java runtime. You can only "save as" to the current directory as shown in the open file window or to a file that already exists.
The resulting data is corrupt when using "Search" against a command in the field "Enter a command or message" in the secondary web browser panel. This panel displays when, from a Japanese web browser, the "NetView Help" option (under the "NetView Support" heading) is selected on the main Tivoli NetView Welcome panel.An alternative work-around is to issue this same command (as displayed from the "NetView Help" panel) from NCCF or NetView command line.
When using the Japanese web browser, and your credentials are removed (for example, you click on the Sign Off hot link) or expired, and you attempt to display another NetView web page, the error message "CNM1210E No credentials exists to access NetView for z/OS CNM01." will be displayed in English in the browser.
We are ready to help you with your NetView Web application questions. You can contact us through standard problem reporting procedures.
For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways:
Customers in the United States can also call 1-800-IBM-Serv, #2. International customers should consult the Customer Support Handbook, which is available on our Web site at http://techsupport.services.ibm.com/guides/handbook.html
When you contact Tivoli Customer Support, be prepared to provide identification information for your company so that support personnel can assist you more readily. Company identification information may also be needed to access various online services available on the Web site.
The Customer Support Web site offers extensive information, including a guide to support services (the Customer Support Handbook); frequently asked questions (FAQs); and documentation for all Tivoli products, including Release Notes, Redbooks, and Whitepapers. The documentation sets for some product releases are available in both PDF and HTML formats. Translated documents are also available for some product releases.
Additional support is also available on the NetView group on Yahoo!. These forums are monitored by NetView developers who answer questions and provide guidance. When it appears that a problem with the code is found, you will be asked to open a PMR to get resolution.
To find documentation online, point your web browser at the following site and select "Product Documenation and Manuals" in the Learn section.
We are very interested in hearing about your experience with Tivoli products and documentation. We also welcome your suggestions for improvements. If you have comments or suggestions about our documentation, please contact us in one of the following ways:
When reporting defects it will be necessary to provide Tivoli with your service level. You will receive instructions on how to do this when you contact Tivoli. You can edit or type the file named znetview_webapp.gen under the doc subdirectory of the installation location. This file lists the level of maintenance of the NetView Web application.
Also once you are signed onto the NetView Web application, the service level of your application will appear on the About view.
The following terms are trademarks of the respective companies in the United States or other countries or both:
The license agreement for this product refers you to this file, or to a file referenced by this file, for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided in the "LICENSE.TXT" file on the \readmes directory of the installation CD-ROM for this product. The "LICENSE.TXT" file is also installed into the doc product installation directory as part of the installation process. Please note that any non-English version of the information in this file is unofficial and is provided to you for your convenience only. The English version of the file is the official version.
US Government Users Restricted Rights - Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with IBM Corporation.