NetView^(R) Web Application

This readme file contains information about the NetView Web application component of Tivoli^(R) NetView for z/OS^(R) version 5 release 4.

This file is divided into the following categories:

• Installation Planning for NetView Web Application
• Prerequisites
• Selecting the Correct Files
• Installing/Uninstalling the NetView Web Application
• Post-Installation Customizations
• Security Enhancements
• Starting/Stopping the NetView Web Application
• Special Considerations for DBCS Japanese environment
• Late-Breaking News
• Getting Help
• Trademarks and Copyrights

Installation Planning for NetView Web Application

The NetView Web application is available on the following platforms:

• Windows^(R)
• AIX^(R)
• Linux^(R) on zSeries^(R)
• Linux on x86/x86_64

The NetView Web application consists of the following features:

• WebSphere^(R) Enterprise Archive (EAR) file
• Web XML Editor Utility
• Embedded version of the IBM^(R) WebSphere Application Server v7.0

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 v7.0 or the IBM WebSphere Application Server as your web server. The Embedded version of the IBM WebSphere Application Server v7.0 image is installed as a 32-bit configuration. The machine where the Embedded version of the IBM WebSphere Application Server v7.0 or IBM WebSphere Application Server is installed is referred to as the Web Application Server.

The specific level of the Embedded version of the IBM WebSphere Application Server v7.0 feature which is shipped as part of the install image is v7.0. Detailed version information is as follows:

Name:               IBM Embeddable WebSphere Application Server
Version:           7.0.0.37
ID:                    embeddedEXPRESS

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, v7.0 is required. The specific tested and supported level of WebSphere is v7.0.

If you decided to use the Embedded version of the IBM WebSphere Application Server v7.0 (which is an installable feature 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 Linux on zSeries.

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

• Windows:
  Hardware:
  • Intel^(R) Pentium^(R) processor; Intel EM64T or AMD Opteron
  Operating System:
  • Microsoft Windows Server 2003 with SP2
  • Microsoft Windows Server 2003 R2
  • Microsoft Windows Server 2003 x64 with SP2
  • Microsoft Windows Server 2003 x64 R2
  • Microsoft Windows Server 2008 (Datacenter, Enterprise, Standard) with SP1
  • Microsoft Windows Server 2008 (Datacenter, Enterprise, Standard) x64 with SP1
  • For the NetView Web application Japanese version, the locale supported is Shift-JIS (codepage 932).

• AIX:
  Hardware:
  • IBM POWER family of processors 32-bit and 64-bit
  Operating System:
  • AIX 5L 5.3 with Service Pack 5300-07-01 (32 and 64-bit kernel support)
  • AIX 6.1 with Recommended Maintenance package 6100-00-04
  • For the NetView Web application Japanese version, the locale supported is ja_JP (EUC).

• Linux on System z9 and zSeries:
  Hardware:
  • System z processors
  Operating System:
  • SUSE Linux Enterprise Server 9 for zSeries with SP4 (64 bit kernel only)
  • SUSE Linux Enterprise Server 10 for zSeries with Update 1 (64 bit kernel only)
  • Red Hat Enterprise Linux AS 4.0 for zSeries with Update 6 (64 bit kernel only)
  • Red Hat Enterprise Linux 5.0 for zSeries with Update 1 (64 bit kernel only)
  • For the NetView Web application Japanese version, the locale supported is ja_JP.eucjp.

    For z/OS x390 64-bit platforms, this architecture requires the installation of compatibility libs for 32-bit apps to run in "compatibility mode" or "tolerance mode".

    NetView Web application runs on the 64-bit Linux on zSeries distributions in compatibility mode does not contain any native 64-bit compiled code.

• Linux on x86/x86_64:
  Hardware:
  • Intel Pentium processor; Intel EM64T or AMD Opteron
  Operating System:
  • SuSE Linux Enterprise Server 9 with SP4
  • SuSE Linux Enterprise Server 10 with SP1
  • Red Hat Enterprise Linux AS or ES 4 with Update 6
  • Red Hat Enterprise Linux 5 with Update 1
  • For the NetView Web application Japanese version, the locale supported is ja_JP.eucjp.

Supported web browsers

• Windows:
  • Internet Explorer 6.0 SP2 or later with Java Plug-in v5.0 or v6.0

• SuSE Linux:
  • Mozilla 1.7 or later with Java Plug-in v5.0 or v6.0

• Red Hat Linux:
  • Mozilla 1.7 or later with Java Plug-in v5.0 or v6.0

• Hewlett-Packard HP-UX:
  • Mozilla 1.7 or later with Java Plug-in v5.0 or v6.0

• Sun^(TM) Solaris^(TM):
  • Mozilla 1.7 or later with Java Plug-in v5.0 or v6.0

Hardware Requirements

For additional hardware requirements for IBM Websphere Application Server v7.0, 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 CD distribution media under the directory "webapp".

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

Installing/Uninstalling the NetView Web Application

General information concerning Installing and Uninstalling the NetView Web Application

• The wizard for the uninstall process will guide you through the uninstall by prompting you to provide information in each wizard panel.
• Before attempting the uninstall, make sure you save any customized files that you may want to keep (e.g., the web.xml and nvim.xml files that you modified for your environment).
• Also, during the uninstall process, if you selected the Embedded version of the IBM WebSphere Application Server v7.0 feature for uninstall, you must end web app server (Embedded version of the IBM WebSphere Application Server v7.0) if active before continuing with the uninstall.

• For instructions to run the NetView Web application web server as a Windows service, see section below under "Hints and Tips" called Setting up Web Application webserver to run as a Windows service.
• For silent installation of NetView Web application features, see InstallShield template file in the "doc" subdirectory under your installation location. The file is called "znetview_installation.template" and contains all the necessary instructions and information about running a silent install on any supported platform. This file is also available on the CD-ROM volume 1 media under "webapp" subdirectory.
• The installation wizard will guide you through the install process by prompting you to provide information in each wizard panel.

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 with the Embedded version of the IBM WebSphere Application Server v7.0.

• If SECURE CONNECTION is configured, then the HTTPS Transport Port value (specified in the previous panel: default is 9943) is the port number for the URL to run the Web application. See the section below entitled "Starting your Internet Browser" for details. Selecting SECURE CONNECTION will only allow HTTPS access since HTTP transport will be disabled.

  Sample URL   (notice the "s" with this protocol https !):
  https://hostname:9943/netview/NetView4zosDomain/      (secure connection)

• If NON-SECURE CONNECTION is configured, then both HTTP and HTTPS transports are enabled. This means that you can run the Web application using either HTTPS Transport Port value (default is 9943) or HTTP Transport Port value (default is 9980).

  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 the IBM WebSphere Application Server v7.0 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 v7.0 for details.

• As a general rule for each of the installation sections below, uninstall the product before attempting any new installation.
• When using the "-console" option during the installation processing in a Japanese environment, the "PRODUCT_NAME" string does not resolve properly. The string "$L(com.tivoli.nvweb.install.nls.WEB_Strings,PRODUCT_NAME)" will be displayed instead of the correct substitution "NetView Web Application". This incorrect output will not affect the installation process or cause any subsequent failure.

Installing the NetView Web Application on Windows

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

Installation Tips:

• How can I tell if the NetView Web application is already installed on my PC?
  Display the "Add/Remove Program" dialog available on Windows and look for the entry "NetView Web Application".

• How much extra disk space will I need to complete my installation of all features?
  When you see the first InstallShield panel displaying the title "IBM NetView Web Application", at least 350 MB of temporary disk space will be required on the C: drive. When you complete the installation, the temporary space will be released. As for your target directory or folder, you will need at least 750 MB of space to install all features.

• If a feature that you selected for installation is already installed, first uninstall that feature before proceeding.

To install the NetView Web application from CD:

• Insert the Tivoli NetView for z/OS CD distribution media into the CD drive of your workstation.

• Find the drive and directory where the NetView Web application for Windows resides. The directory is "webapp" and the file name is znetview_webapp_win.exe.

               ---- or ----

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

• Point your web browser to the following URL: http://www.ibm.com
• Under "Get support", select the item "Downloads and drivers".
• In the section entitled "Products of IBM", select "Category" of "Tivoli" with "Sub-category" of "IBM Tivoli NetView for z/OS"
• Enter "NetView Web Application" in text field labeled "Search within results" and then select "Search"
• You will now be on the support and downloads page for NetView Web Application.
• Select the download package for Windows Version 5.4 and download it into a temporary directory as znetview_webapp_win.exe.

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\v5r4". 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

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

• To Uninstall the NetView Web application, use the "Add/Remove Program" available on Windows. If you select "NetView Web Application" in the list and start the uninstall process, InstallShield will run an uninstall program which will present you with panel information that will let you select the feature(s) that you want uninstalled.

• InstallShield will not remove files that have been created dynamically.

  Note:
  DO NOT remove any installed files or folders (subdirectories) without first completing the "Add/Remove Program" process (for all Features) described above in the first bullet.

  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.

Installing the NetView Web Application on AIX

To install the NetView Web application on AIX, follow these steps:

Installation Tips:

• Options to consider when launching the znetview_webapp_aix.bin installation wizard:

  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.

• How can I tell if the NetView Web application is already installed on my AIX system ?

  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.

• How much extra disk space will I need to complete my installation?

  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 350 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 750 MB for a Full Installation.

• If a feature that you selected for installation is already installed, first uninstall that feature before proceeding.

To install the NetView Web application from CD:

• Insert the Tivoli NetView for z/OS CD distribution media into the CD drive of your workstation.

• Find the drive and directory where the NetView Web application for AIX resides. The directory is "webapp" and the file name is znetview_webapp_aix.bin.

               ---- or ----

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

• Point your web browser to the following URL: http://www.ibm.com
• Under "Get support", select the item "Downloads and drivers".
• In the section entitled "Products of IBM", select "Category" of "Tivoli" with "Sub-category" of "IBM Tivoli NetView for z/OS"
• Enter "NetView Web Application" in text field labeled "Search within results" and then select "Search"
• You will now be on the support and downloads page for NetView Web Application.
• Select the download package for AIX Version 5.4 and download it into a temporary directory as znetview_webapp_aix.bin.

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/v5r4".

Uninstalling the NetView Web Application from AIX

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

• To uninstall the NetView Web application, you can run znetview_webapp_aix_uninstall.bin file that resides in the _uninst subdirectory located in the path selected during the installation.

  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.

• InstallShield will not remove files that have been created dynamically.

  Note:
  DO NOT remove any installed files or subdirectories without first running the InstallShield's uninstaller file znetview_webapp_aix_uninstall.bin as described above in the first bullet 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.

Installing the NetView Web Application on Linux on zSeries

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

Installation Tips:

• Options to consider when launching the znetview_webapp_zlinux.bin installation wizard:

  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.

• How can I tell if the NetView Web application is already installed on my Linux on zSeries system ?

  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.

• How much extra disk space will I need to complete my installation?

  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 350 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 750 MB for a Full Installation.

• If a feature that you selected for installation is already installed, first uninstall that feature before proceeding.

To install the NetView Web application from CD:

• Insert the Tivoli NetView for z/OS CD distribution media into the CD drive of your workstation.

• Find the drive and directory where the NetView Web application for Linux on zSeries resides. The directory is "webapp" and the file name is znetview_webapp_zlinux.bin.

               ---- or ----

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

• Point your web browser to the following URL: http://www.ibm.com
• Under "Get support", select the item "Downloads and drivers".
• In the section entitled "Products of IBM", select "Category" of "Tivoli" with "Sub-category" of "IBM Tivoli NetView for z/OS"
• Enter "NetView Web Application" in text field labeled "Search within results" and then select "Search"
• You will now be on the support and downloads page for NetView Web Application.
• Select the download package for Linux on zSeries Version 5.4 and download it into a temporary directory as znetview_webapp_zlinux.bin.

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/v5r4".

Uninstalling the NetView Web Application from Linux on zSeries

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

• To uninstall the NetView Web application, you can run znetview_webapp_zlinux_uninstall.bin file that resides in the _uninst subdirectory located in the path selected during the installation.

  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.

• InstallShield will not remove files that have been created dynamically.

  Note:
  DO NOT remove any installed files or subdirectories without first running the InstallShield's uninstaller file znetview_webapp_zlinux_uninstall.bin as described above in the first bullet 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.

Installing the NetView Web Application on Linux on x86/x86_64

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

Installation Tips:

• Options to consider when launching the znetview_webapp_ia32linux.bin installation wizard:

  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.

• How can I tell if the NetView Web application is already installed on Linux ?

  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.

• How much extra disk space will I need to complete my installation?

  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 350 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 750 MB for a Full Installation.

• If a feature that you selected for installation is already installed, first uninstall that feature before proceeding.

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

• Point your web browser to the following URL: http://www.ibm.com
• Under "Get support", select the item "Downloads and drivers".
• In the section entitled "Products of IBM", select "Category" of "Tivoli" with "Sub-category" of "IBM Tivoli NetView for z/OS"
• Enter "NetView Web Application" in text field labeled "Search within results" and then select "Search"
• You will now be on the support and downloads page for NetView Web Application.
• Select the download package for Distributed Linux Version 5.4 and download it into a temporary directory as znetview_webapp_ia32linux.bin.

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/v5r4".

Uninstalling the NetView Web Application from Linux

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

• To uninstall the NetView Web application, you can run znetview_webapp_ia32linux_uninstall.bin file that resides in the _uninst subdirectory located in the path selected during the installation.

  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.

• InstallShield will not remove files that have been created dynamically.

  Note:
  DO NOT remove any installed files or subdirectories without first running the InstallShield's uninstaller file znetview_webapp_ia32linux_uninstall.bin as described above in the first bullet 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 v7.0", then you should skip to the section below called "Post-Installation Customizations for the Embedded version of the IBM WebSphere Application Server v7.0" 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

Installing the Enterprise Application (zNetViewWebApp.ear file) with the WebSphere Enterprise Application Wizard

Note:   The following steps should be used as a guide only since the presentation of panel information is dependant upon your WebSphere configuration. For example, if Global Security is not enabled, you may not see any of the "Security" related panels display during the enumerated steps below. Also, if default binding are pre-configured, then binding information will be filled in automatically with defaults and the Bindings window panel may not be displayed.

To install the Enterprise Application zNetViewWebApp.ear file:

• Start the WebSphere Application Server, if it is not already started.
  
  Windows environment:
  Start -> Programs -> IBM WebSphere -> Application Server v70 -> Profiles -> profile -> First Steps
  Where: profile is the profile name associated with this instance of the WebSphere Application Server.
  
  Choose Start the Server
  
  UNIX environment:
  Issue the following command from the WebSphere Application Server's installation location "firststeps" directory in order to start First Steps:
  Note: WebSphere Application Server installation location's firststeps directory is "websphere_installation_path/profiles/profile/firststeps" where:
  websphere_installation_path is the install location of WebSphere Application Server
  profile is the profile name associated with this instance of the WebSphere Application Server.
  
  ./firststeps.sh &
  
  Choose Start the Server
  

• Start the WebSphere Administrator's Console
  
  Windows environment:
  Start -> Programs -> IBM WebSphere -> Application Server V70 -> Profiles -> profile -> First Steps
  Note: profile is the profile name associated with this instance of the WebSphere Application Server.
  
  Choose Administrative Console
  
  UNIX environment:
  Issue the following command from the WebSphere Application Server's installation location "firststeps" directory in order to start First Steps:
  Note: WebSphere Application Server installation location's firststeps directory is "websphere_installation_path/profiles/profile/firststeps" where:
  websphere_installation_path is the install location of WebSphere Application Server
  profile is the profile name associated with this instance of the WebSphere Application Server.
  
  ./firststeps.sh &
  
  Choose Administrative Console
  

• On the left side of the Administrative Console, expand Applications.
• Click on Install New Application.
• Provide the path or use the browse key to locate the zNetViewWebApp.ear file.
• By default, the zNetViewWebApp.ear file resides in usr\lpp\netview\v5r4\ears.
• Click Next
• Click Next on the Bindings window
• Click Continue on the Application Security Warnings panel.
• On Step 1: Select installation options to perform the installation, click Next. Note that the application name is already filled in.
• On Step 2:Map Modules to Servers, click Next.
• On Step 3: Map virtual hosts for web modules, select z/NetView Web Application and choose the virtual host
• Click Next
• On Step 4: Map Security Roles to Users/Groups, click Next.
• Click Finish on the Step 5: Summary window after verifying the information is correct
• After the NetView Web Application is installed successfully, click "Save directly to the master configuration"

To start the NetView Web Application

• Expand Applications on the left side of the Administrative Console
• Click Enterprise Applications and select the application name that you provided above for the NetView Web application (for example, "NetView Web Application")
• Click the Start button

Uninstalling the Enterprise Application (zNetViewWebApp.ear file) with the WebSphere Enterprise Application Wizard

To uninstall the NetView Web application from a supported 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.

• On the Administrator's Console, go to Applications -> Enterprise Applications.
• Select NetView Web Application and click Stop.
• Once the NetView Web Application has stopped, select it again, and click Uninstall.
• Save the changes.

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.

• It will be necessary to modify the web.xml file in the WEB-INF directory before starting the NetView Web application. For a deployment within an application server, the full path to this file will be as follows:
  websphere_installation_path/profiles/profile/config/cells/Node/applications/NetView Web Application.ear/deployments/NetView Web Application/zNetViewWebApp.war/WEB-INF
  where:
  websphere_installation_path is the install location of WebSphere Application Server.
  profile is the profile of the WebSphere application server running on Node.
  Node is the Node name where the WebSphere application server resides.

• It is recommended that you use the Web XML Editor Utility to modify your web.xml file. See "Starting the Web XML Editor Utility" under the section Starting/Stopping the NetView Web Application for information regarding this utility.

• You must create a uniquely named servlet definition and url-pattern for each NetView for z/OS domain that you want to communicate with. The default domain used in the web.xml file is cnm01. Using the servlet definition section named cnm01_ZnvAccessServlet as your template, create a uniquely named section for each of your NetView domains. Only create a single servlet definition for each NetView domain; however, you can define multiple url-patterns that point to each servlet. The domain portion of the url-pattern cannot be mixed case. Note: If you are not using the Web XML Editor Utility, the url-pattern is part of the servlet-mapping element. Be sure to provide equivalent url-pattern tags creating the URL with the domain in lowercase and another with the domain in uppercase. The Web XML Editor Utility will automatically do this for you.

• Modify the value of the HOST parameter to be the fully qualified hostname of your NetView for z/OS domain (for example, netviewhost.subnet.company.com). Change the value of the ZNV_DOMAIN parameter to be the NetView for z/OS domain name. Modify PORT, INKEY and OUTKEY as appropriate for your installation.

• You must also create a uniquely named url-pattern for each z/NetView. Change the value of the url-pattern for the ZnvAccessServlet to the same value you assigned to ZNV_DOMAIN parameter.

From the NetView Web application, you can open incident reports either in IBM Tivoli Information Management for z/OS or in the Peregrine Systems ServiceCenter. To enable the opening of incident reports, update the nvim.xml file using an available editor. The nvim.xml file is in the WEB-INF directory. For a deployment within an application server, the full path to this file will be as follows:
websphere_installation_path\profiles\profile\installedApps\Node\NetView Web Application.ear\zNetViewWebApp.war\WEB-INF
where:
websphere_installation_path is the install location of WebSphere Application Server.
profile is the profile of the WebSphere application server running on Node.
Node is the Node name where the WebSphere application server resides.

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:

rename "nvim.xml" to "nvim_en.xml"
rename "nvim_ja.xml" to "nvim.xml"


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.

Post-Installation Customizations for the Embedded version of the IBM WebSphere Application Server v7.0

• It will be necessary to modify the web.xml file in the WEB-INF directory before starting the Web Application Server. If you have chosen the default target directory during installation, the full path to this file will be as follows:
  \usr\lpp\netview\v5r4\ewas\profiles\profile1\installedApps\DefaultNode\zNetViewWebApp.ear\zNetViewWebApp.war\WEB-INF

• It is recommended that you use the Web XML Editor Utility to modify your web.xml file. See "Starting the Web XML Editor Utility" under the section Starting/Stopping the NetView Web Application for information regarding this utility.

• You must create a uniquely named servlet definition and url-pattern for each NetView for z/OS domain that you want to communicate with. The default domain used in the web.xml file is cnm01. Using the servlet definition section named cnm01_ZnvAccessServlet as your template, create a uniquely named section for each of your NetView domains. Only create a single servlet definition for each NetView domain; however, you can define multiple url-patterns that point to each servlet. Note: If you are not using the Web XML Editor Utility, the url-pattern is part of the servlet-mapping element.

• Modify the value of the HOST parameter to be the fully qualified hostname of your NetView for z/OS domain (for example, netviewhost.subnet.company.com). Change the value of the ZNV_DOMAIN parameter to be the NetView for z/OS domain name. Modify PORT, INKEY and OUTKEY as appropriate for your installation.

• You must also create a uniquely named url-pattern for each z/NetView. Change the value of the url-pattern for the ZnvAccessServlet to the same value you assigned to ZNV_DOMAIN parameter.

From the NetView Web application, you can open incident reports either in IBM Tivoli Information Management for z/OS or in the Peregrine Systems ServiceCenter. To enable the opening of incident reports, update the nvim.xml file using an available editor. The nvim.xml file is in the WEB-INF directory. If you have chosen the default target directory during installation, the full path to this file will be as follows:
\usr\lpp\netview\v5r4\ewas\profiles\profile1\installedApps\DefaultNode\zNetViewWebApp.ear\zNetViewWebApp.war\WEB-INF

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

The NetView Web application user logon security has been enhanced.

If a user cannot logon to the NetView host from the NetView Web application, it may be that their user ID has been locked out due to five consecutive unsuccessful logon attempts. This would be indicated by the user being redirected to the web site http://www.ibm.com upon attempting to logon to the NetView host. If a user gets locked out, the administrator can locate the following directory:

install_location/ewas/profiles/profile
and delete the file named userid_domain_settings.xml

Do not modify the userid_domain_settings.xml file manually as that can lead to unexpected results.

The browser instance, which was in use when the NetView user ID lock out occurred, must be closed and a new browser instance started.

Try the logon to the NetView host again with a new browser instance.

Starting/Stopping the NetView Web Application

The nvsrvc Command

nvsrvc start webserver OR, simply
nvsrvc start
This will start the Embedded version of the IBM WebSphere Application Server v7.0. The Web Application server is started when a message stating "Server open for e-business" is issued.
A log file will be created in \usr\lpp\netview\v5r4\ewas\logs when the z/NetView Web Application is accessed:

netviewservlets.log - This log contains information, warning and error messages generated during NetView Web application server initialization or processing.

The Embedded version of the IBM WebSphere Application Server v7.0 provides log files in the \usr\lpp\netview\v5r4\ewas\profiles\profile1\logs\server1 directory. The SystemOut.log file is the main log file for application server operations.

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

Configuring the Embedded version of the IBM WebSphere Application Server v7.0

• 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 v7.0 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.

• y  option enables only https access and disables http access for the NetView Web application.
• n  option enables both https and http accesses for the NetView Web application.

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:

"./secure.sh  n"

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.

• Session Timeout:
To set a new value for session timeout, edit the following file in installation_location\ewas\profiles\profile1\config\cells\DefaultNode\nodes\DefaultNode\servers\server1\server.xml
where installation_location is the install location previously specified (default is c:\usr\lpp\netview\v5r4 for windows and /usr/lpp/netview/v5r4 for unix)

In this server.xml file, look for string invalidationTimeout. Default value is 30. Change this value, save the file and then stop/start the web server to enable the change to take place.

(It is recommended that you make a backup of this file before saving any changes)

• Port Values:

Current values of ports values set during the installation can be queried by examining the portdef.props file in the installation_location\properties subdirectory.

Common port values to change are WC_defaulthost (default is 9980) and WC_defaulthost_secure (default is 9943).
You can modify these two values by editing the following three files, searching for their strings, saving your changes, and then stop/start the web server to enable the changes to take place.

The three files are:

installation_location\ewas\profiles\profile1\config\cells\DefaultNode\nodes\DefaultNode\serverindex.xml
installation_location\ewas\profiles\profile1\config\cells\DefaultNode\virtualhosts.xml
installation_location\ewas\profiles\profile1\config\templates\servertypes\APPLICATION_SERVER\serverindex.xml

(It is recommended that you make backups of all three files before saving any changes)

Starting the Embedded version of the IBM WebSphere Application Server v7.0

Windows Environment - execute the following:

cd D:\usr\lpp\netview\v5r4\bin
nvsrvc start webserver      (or just nvsrvc start)

UNIX Environment - execute the following:

cd /usr/lpp/netview/v5r4/bin
nvsrvc.sh start webserver      (or just nvsrvc.sh start)

Starting the Web XML Editor Utility

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

Windows Environment - execute the following:
cd D:\usr\lpp\netview\v5r4\wxe\bin
WxeEditor.bat

UNIX Environment - execute the following:

cd /usr/lpp/netview/v5r4/wxe/bin
./WxeEditor.sh

Important note: When running the Web XML Editor Utility (WxeEditor.sh) on UNIX systems, which may not have a common desktop environment (e.g. Linux on zSeries), it is important that the display be previously configured to handle X-Windows or X11 GUI applications. Any RPM package installations, tools, and configuration needed to export the display properly in this context is beyond the scope of IBM's responsibilities.

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 v7.0, point your web browser to:

https://hostname:9943/netview/NetView4zosDomain/    (where "NetView4zosDomain" is the servlet Mapping Name)

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.

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.

portnumber is the port number for the application server's internal HTTP or HTTPS transport connection.

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 v7.0) 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.

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:

• Editing nvim.xml and web.xml files on a Japanese windows operating system:

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.

• Appearance of some English text during the installation process:

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.

Late-Breaking News

New Enhancements

• None.

Hints and Tips

• When running MIB Browser or Real Time Poller functions and a secure connection is configured (https - this is the default installation option), you will see a message "Hostname Mismatch" - "The hostname in the server security certificate does not match the name of the server".

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 running MIB Browser or Real Time Poller functions if the applet has problems upgrading and downloading the current level of the Java plug-in, it may be the result of a known Java bug. This problem is evidenced by seeing repeated instances of a DownloadException in the Java console.

To solve this problem, open the Java Plug-In Control Panel. Select the Cache tab. Make sure the option to "Enable Caching" is unselected. Click "Apply".

More details about this problem can be viewed in the Sun^(TM) Java bug report for bug ID #4845728.

• Setting up Web Application webserver to run as a Windows service.

This section describes the information necessary for installing and starting NetView Web application webserver (WebSphere app server, server1) as a Windows service for the installed feature "Embedded version of the IBM WebSphere Application Server v7.0".

Initial assumptions for the NetViewWebApp Windows service:

This first step is important since you want to make sure that the webserver is functioning properly in normal usage (not as a Windows service):
• It is assumed at this point that "nvsrvc start webserver" successfully starts the WebSphere app server, server1.
• Also, it is assumed that another system can access the webserver remotely and signon to the Web application via its browser. This means that all the setup work for web.xml has been completed correctly.

Installing the NetViewWebApp Windows service:

(Default installation location is used throught for the example. Run all commands from a command prompt windows)
• cd c:\usr\lpp\netview\v5r4\bin
• WASService_wrapper.bat

After running the batch file, you should see a final displayed message:
"IBM WebSphere Application Server v7.0 - NetViewWebApp service successfully added."

Our webserver is now a windows service called "NetViewWebApp". The name to look for in the windows "Services" panel is the full title:
"IBM WebSphere Application Server v7.0 - NetViewWebApp".

Starting the NetViewWebApp Windows service:

• cd c:\usr\lpp\netview\v5r4\ewas\bin
• WASService -start NetViewWebApp

Now you can start/stop/disable this "NetViewWebApp" service from the Services panel or change directory into C:\usr\lpp\netview\v5r4\ewas\bin and run "WASService.exe" and it'll display other options that can be run from the command prompt (like those in the Service panel).

Using the NetViewWebApp Windows service:

• Reboot, but do not logon to your system:
After reboot, let the system quiesce a bit at Windows logon prompt, but do not logon. Wait for disk activity to level off since the webserver is starting under the Windows service.
• Try accessing the Web App via browser from other system:

Problem Determination for the NetViewWebApp Windows service:

If the Web App fails to display the NetView signon panel in the browser, then
• Possibly give more time for the Windows service to complete the initialization of the webserver.
• Log onto the PC running the NetViewWebApp Windows service and examine the nvsrvc.log file in C:\usr\lpp\netview\v5r4\bin. Nvsrvc.log should show status: Server server1 open for e-business
• See points listed above under subtopic "Initial assumptions for the NetViewWebApp Windows service".

Removing the NetViewWebApp Windows service:

To uninstall this Windows service previously installed, issue the following command from the c:\usr\lpp\netview\v5r4\ewas\bin directory:
WASService -remove NetViewWebApp

Known Defects

• Problems with "Save as" in Web XML Editor Utility

  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.

• Hot links not working for Japanese help panel in Japanese web browser

  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.

• Error message displayed in English language in Japanese web browser

  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.

Service History

• Further information regarding the NetView Web Application build level is contained in the file znetview_webapp.gen under the doc subdirectory of the installation location.

• 5.4.0.1:   OA31870

  IMPORTANT:   APAR OA31870 changes both Tivoli NetView for z/OS host code and NetView Web Application Server code. The fix for APAR OA31870 for the Tivoli NetView for z/OS host must be applied before the new NetView Web Application Server is installed.

• 5.4.0.2:   OA33865    OA34096
• 5.4.0.3:   OA35932
• 5.4.0.4:   OA37234
• 5.4.0.5:   OA39765
• 5.4.0.6:   OA45266
• 5.4.0.7:   OA45922
• 5.4.0.8:   OA46618
• 5.4.0.9:   OA47545
• 5.4.0.10:   OA48111

Documentation Changes

• NONE: GA Version

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 one of the following ways:

• Submit a problem management record (PMR) electronically from IBMSERV/IBMLINK
• Submit a problem management record (PMR) electronically from our Web site at
  http://www-3.ibm.com/software/sysmgmt/products/support/IBMTivoliNetViewforzOS.html

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.

• For information about IBMLINK registration and access, look on the IBM Web page:
  http://www.ibmlink.ibm.com
• For information about registration and access to the NetView group on Yahoo!, look on Web page:
  http://groups.yahoo.com/group/NetView

To find documentation online, point your web browser at the following site and select "Product Documenation and Manuals" in the Learn section.

http://publib.boulder.ibm.com/tividd/td/NetViewforzOS5.4.html

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:

• Send e-mail to johnlew@us.ibm.com
• Or visit web site: http://www-306.ibm.com/software/tivoli/contact.html

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

Trademarks and Copyrights

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

• IBM, the IBM logo, Tivoli, the Tivoli logo, WebSphere, AIX, APPN, BookManager, DB2, MVS/ESA, NetView, OS/390, TME, VisualAge, VTAM and z/OS are trademarks or registered trademarks of International Business Machines Corporation or Tivoli Systems Inc. in the United States, other countries, or both.

• Sun, SPARC, SunOS, and Solaris, java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

• HP-UX and Hewlett-Packard are trademarks of Hewlett-Packard Company.

• Microsoft, Windows, Windows 2003, Windows 2008, and the Windows logo are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

• UNIX is a registered trademark in the United States and other countries licensed exclusively through The Open Group.

• Linux is a registered trademark of Linus Torvalds.

• SuSE is a trademark of SuSE Inc.

• Red Hat, RPM, and all Red Hat based trademarks and logos are trademarks
  or registered trademarks of Red Hat, Inc. in the United States and other countries.

• AMD, the AMD Arrow logo and combinations thereof are trademarks of Advanced Micro Devices, Inc.

• Intel is a registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.

• Yahoo!, the Yahoo! logo, and product and service names are trademarks of Yahoo! Inc.

• Other company, product, and service names may be trademarks or service marks of others.

• Third party license terms and conditions, notices and information

  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.

Licensed Materials - Property of IBM
Product Number 5697-ENV
(C) Copyright IBM Corp. 2002, 2009. All rights reserved.


US Government Users Restricted Rights - Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with IBM Corporation.