NetView(R) Web Application

This readme file contains information about the NetView Web application component of Tivoli(R) NetView for z/OS(R) Version 6 Release 2 Modification 1.

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 4 components:

Before installing the NetView Web application, you must decide if you want to use the Embedded version of the IBM WebSphere Application Server v8 or the IBM WebSphere Application Server as your web server. The Embedded version of the IBM WebSphere Application Server v8 image is installed as a 32-bit configuration. This embedded version of the WebSphere is integrated within the installation/package self-extracting image of NetView Web Application. The machine where the Embedded version of the IBM WebSphere Application Server v8 or IBM WebSphere Application Server is installed is referred to as the Web Application Server.

During the installation process, the InstallShield InstallAnywhere wizard will guide you through a series of short steps to determine your setup preferences. If you select "Yes, install embedded version of WebSphere", then all components (4) of the NetView Web app will be installed and configured. If you select "No, I already have WebSphere installed", then only 3 components will be be installed (installation and configuration of the Embedded version of the IBM WebSphere Application Server will not take place).

The specific level of the Embedded version of the IBM WebSphere Application Server v8 component which is shipped as part of the install image is V8.0.0.11. Detailed version information is as follows:

Refer to the IBM Tivoli NetView for z/OS Installation: Configuring Additional Components manual for more information.


Prerequisites

Software Requirements

If you are using WebSphere as your web server, IBM WebSphere Application Server, v8 or higher level is required.
Also supported editions are WebSphere v8.5 and v8.5.5.

If you decided to use the Embedded version of the IBM WebSphere Application Server v8 (which is an installable component of NetView Web application) as your web server, then there is no need for another or separate WebSphere Application Server.

The NetView Web application Japanese version is only supported when connected to the NetView for z/OS Japanese version. The NetView Web application English version is only supported when connected to the NetView for z/OS English version.

The final install footprint is about 800 MB of fixed disk space for Windows and 950 MB for UNIX systems.
Important Note: During installation and deployment of the NetView Web application, system temp (%TEMP%) space on Windows and /tmp filesystem on UNIX will increase the total disk space requirements. Also, the target installation directory will require more disk space during the deployment phase than what is noted for the final install footprint. Based on this, it is recommended that your system have at least 1.5 GB for temp space and an additional 1.5 GB for the target installation directory.

It is recommended for your Windows or UNIX system to have at least 2 GB of memory. It is very important to have at least 2 GB of virtual memory available for the NetView Web application when installing on the platform Linux on System z.

The NetView Web application is supported on the following operating systems:

Supported web browsers

The supported web browser versions (English and Japanese languages) for the NetView Web application are:

Hardware Requirements

Any hardware that supports individual platforms (Windows, AIX, Linux on System z, Linux) as listed in the above "software requirements" section.

For additional hardware requirements for IBM Websphere Application Server v8, Advanced Edition, see the WebSphere documentation for the applicable platform.


Selecting the Correct files

The files to install are located in the Tivoli NetView for z/OS DVD distribution media under the directory "webapp".

The following files are distributed as part of the NetView Web application:

znetview_webapp_win.exe InstallAnywhere image for Windows.
znetview_webapp_aix.bin InstallAnywhere image for AIX.
znetview_webapp_zlinux.bin InstallAnywhere image for Linux on System z.
znetview_webapp_ia32linux.bin InstallAnywhere image for Linux on x86-32/x86-64.
znetview_webapp_readme_en.htm English version of this README file.
znetview_webapp_readme_ja.htm Japanese version of this README file.
znetview_webapp.gen Maintenance file.
znetview_webapp_silent_install.rsp Silent or "unattended" install option template file.


Installing/Uninstalling the NetView Web Application

General information concerning Installing and Uninstalling the NetView Web Application

Uninstall - Important Information: Install - Important Information:

Installing the NetView Web Application on Windows

Note: Before you begin, first read the section "Install - Important Information"

To install the NetView Web application on a supported Windows platform, follow these steps:

Installation Tips:

To install the NetView Web application from DVD:

               ---- or ----

To install the NetView Web application by HTTP download, follow these instructions:

Running the znetview_webapp_win.exe file will invoke the InstallShield InstallAnywhere setup wizard.

Note:
When you run znetview_webapp_win.exe for Windows, you get an initial InstallAnywhere panel that prepares a JVM (Java Virtual Machine) to be used for the installation.

Next you should see the display of a NetView for z/OS 6.2.1 "splash screen". The initial panel to start the InstallAnywhere Wizard should appear shortly thereafter.

It is recommended, but not necessary, to use the default directory name of the target folder. The default path is "c:\usr\lpp\netview\v6r2m1". It is important not to use special characters like &, *, or # as part of the target folder path name.

Uninstalling the NetView Web Application from Windows

Note: Before you begin, first read the section "Uninstall - Important Information"

To uninstall the NetView Web application on a supported Windows platform, follow these steps:

Installing the NetView Web Application on AIX

Note: Before you begin, first read the section "Install - Important Information"

To install the NetView Web application from DVD:

               ---- or ----

To install the NetView Web application by HTTP download, follow these instructions:

Running the znetview_webapp_aix.bin file will invoke the InstallShield InstallAnywhere setup wizard.

Note:
When you invoke znetview_webapp_aix.bin, AIX will display the following status messages:

         Initializing InstallAnywhere Wizard Installer...
         Preparing Java(tm) Virtual Machine...
         ...................................
         ...................................
         .........................

         Running InstallAnywhere Wizard Installer...


The InstallAnywhere 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/v6r2m1".

Uninstalling the NetView Web Application from AIX

Note: Before you begin, first read the section "Uninstall - Important Information"

To uninstall the NetView Web application from AIX, follow these steps:

Installing the NetView Web Application on Linux on System z

Note: Before you begin, first read the section "Install - Important Information"

To install the NetView Web application on your Linux system follow these steps:

To install the NetView Web application from DVD:

               ---- or ----

To install the NetView Web application by HTTP download, follow these instructions:

Running the znetview_webapp_zlinux.bin file will invoke the InstallShield InstallAnywhere setup wizard.

Note:
When you invoke znetview_webapp_zlinux.bin, your Linux system will display the following status messages:

         Initializing InstallAnywhere Wizard Installer...
         Preparing Java(tm) Virtual Machine...
         ...................................
         ...................................
         .........................

         Running InstallAnywhere Wizard Installer...


The InstallAnywhere panels that follow with the Linux on System z 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/v6r2m1".

Uninstalling the NetView Web Application from Linux on System z

Note: Before you begin, first read the section "Uninstall - Important Information"

To uninstall the NetView Web application from Linux on System z, follow these steps:

Installing the NetView Web Application on Linux on x86-32/x86-64

Note: Before you begin, first read the section "Install - Important Information"

To install the NetView Web application on your Linux system follow these steps:

To install the NetView Web application by HTTP download, follow these instructions:

Running the znetview_webapp_ia32linux.bin file will invoke the InstallShield InstallAnywhere setup wizard.

Note:
When you invoke znetview_webapp_ia32linux.bin, your Linux system will display the following status messages:

         Initializing InstallAnywhere Wizard Installer...
         Preparing Java(tm) Virtual Machine...
         ...................................
         ...................................
         .........................

         Running InstallAnywhere Wizard Installer...


The InstallAnywhere 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/v6r2m1".

Uninstalling the NetView Web Application from Linux

Note: Before you begin, first read the section "Uninstall - Important Information"

To uninstall the NetView Web application from Linux, follow these steps:


Post-Installation Customizations

If you have installed the NetView Web application component "Embedded version of the IBM WebSphere Application Server v8", then you should skip to the section below called "Post-Installation Customizations for the Embedded version of the IBM WebSphere Application Server v8" 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".

Post-Installation Customizations for WebSphere Application Server

Note:   This is not the embedded WebSphere that is delivered as a component of NetView Web application.
This section refers to the base WebSphere Application Server offering.
Modify the web.xml File:

For more information, refer to the IBM Tivoli NetView for z/OS Installation: Configuring Additional Components manual.


Post-Installation Customizations for the Embedded version of the IBM WebSphere Application Server v8

Modify the web.xml File:

For more information, refer to the IBM Tivoli NetView for z/OS Installation: Configuring Additional Components manual.


Security Enhancements

Securing logon to the NetView for z/OS host

Securing connection between NetView host and Web application server

Certificate and Key Management for NetView host and Web application server


Starting/Stopping the NetView Web Application

The nvsrvc Command

The nvsrvc command is used to start the web app server (Embedded version of the IBM WebSphere Application Server v8). In the AIX, Linux on System z, and Red Hat environments, you must include the .sh extension when issuing the nvsrvc command (nvsrvc.sh). The nvsrvc command can be found in the "bin" subdirectory of the product installation path.

Use the 'nvsrvc.sh end' or 'nvsrvc end webserver' command to stop the Embedded version of the IBM WebSphere Application Server v8 in the UNIX environment. In the Windows environment, use the 'nvsrvc end' or 'nvsrvc end webserver' command to stop the Embedded version of the IBM WebSphere Application Server v8.

To display help for this command, issue the nvsrvc command without any parameters.

Configuring the Embedded version of the IBM WebSphere Application Server v8

Starting the Embedded version of the IBM WebSphere Application Server v8

Use the following command to start the Embedded version of the IBM WebSphere Application Server v8 on your Web application Server.
   Note: D: drive is used as an example drive in the command below.

Starting the Web XML Editor Utility

This utility enables you to edit the web.xml file that is used by the WebSphere and Embedded version of the IBM WebSphere Application Server v8. Consult the online help available with this component for detailed information.

Use the following command to start the utility.
   Note: D: drive is used as an example drive in the command below.

Starting your Internet Browser

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 v8, point your web browser to:

Note that port 9943 is the default port configured for the Embedded version of the IBM WebSphere Application Server v8. If you have modified the configuration to use a different port, you must specify that port in the URL. See the nvsrvc command information for details on modifying the default port values.

If you are using WebSphere, point your web browser to http://hostname:portnumber/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.

Sign on to NetView using a valid user name (NetView operator ID) and password.


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:


Late-Breaking News

New Enhancements

Hints and Tips

Known Defects

Service History

Documentation Changes


Getting Help

For Technical Information

We are ready to help you with your NetView Web application questions. You can contact us through standard problem reporting procedures.

Defect Reporting

For support for this or any Tivoli product, you can contact Tivoli Customer Support in the following way:

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:

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. For information about registration and access to the NetView group on Yahoo!, look on Web page:

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:

Determining Your Service Level

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 view 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.


Trademarks and Copyrights

The following terms are trademarks of the respective companies in the United States or other countries or both:

Top

Last Updated: