CiscoWorks Blue SNA View 1.0 Release Note

Summary of Required System Software Changes

This is a summary of required changes to the mainframe system software.

• Updating SYS1.PARMLIB Members (may require an IPL)
  

  • Authorize SNA View load libraries
    

  • Set performance group
    

  • Add entry to Program Properties Table
    

• Updating VTAM (requires stopping and restarting VTAM)
  

  • Update MODETAB entry
    

  • Change ATCSTRxx member
    

  • Add Application Major Node
    

  • Add member to ATCCONxx
    

  • Add or update VTAM exit ISTEXCCS (may require customization)
    

  • Update VTAM procedure to include VSAM data set
    

• Updating NetView (requires stopping and restarting NetView)
  

  • Add commands to the DSICMD file in the DSIPARM dataset
    

  • Add CLISTs to the DSICLD dataset
    

  • Add operators to the DSIOPF dataset
    

  • Add NetView exits
    

  • Add task statements to the DSIDMN file in the DSIPARM dataset
    

  • Update the DSICRTTD file in the DSIPARM dataset
    

  • Add profile to the DSIPRF dataset
    

  • Update the Initial CLIST (The default initial CLIST is CNME1034)
    

• Updating Netmaster (does not require restart of Netmaster)
  

  • Update CNMPROC
    

  • Update PPOPROC
    

  • Change PPI
    

  • Add Netmaster NCL procedures
    

Workstation Information

The information in this section applies to SNA View on AIX, HP-UX, and SunOS workstations.

Workstation Online Help and Documentation Caveats

The following errata have been discovered in the CiscoWorks Blue SNA View Workstation Installation Guide :

• All parameters is Table 2-2 on page 2-15 and 2-16 should have an EV prefix, not SV. During configuration, you see the correct EVxxx parameters in the Domain Configuration window.
  

• The default value of the EVOCMD_OPERATOR parameter (shown in Table 2-2 on page 2-16) is NSPAUTO1.
  

Workstation Installation, Configuration, and Deinstallation on AIX

See the CiscoWorks Blue SNA View Workstation Installation Guide.

Workstation Installation, Configuration, and Deinstallation on HP-UX and SunOS

Follow these steps to install and configure SNA View on SunOS and HP-UX. The installation and configuration processes take at least 30 minutes.

Step 1 If you are installing from a remote CD-ROM drive, insert the CD-ROM into the drive on a remote system and export the CD-ROM file system (make it available to an outside system). See "Exporting a CD-ROM File System from a SunOS or HP-UX System" and "Mounting a Remotely Exported CD-ROM File System on a Local System."

If you are installing from a local CD-ROM drive, insert the CD-ROM into the drive on the local system, then mount the CD-ROM file system on the local system. See "Mounting a Local CD-ROM on SunOS or HP-UX."

Step 2 Perform installation. See "Installing on SunOS and HP-UX."

Step 3 Perform configuration. See "Configuring SNA View on SunOS or HP-UX."

Step 4 After successful configuration, remove log files. See "Removing Log Files on SunOS or HP-UX."

Caution The instructions for mounting a remotely exported CD-ROM drive on a local system are for like systems. For example, the instructions are for exporting a CD-ROM file system from an HP-UX system and mounting it on another HP-UX system for installation, and for exporting from a SunOS system and mounting on SunOS, but not for cross-platform operation. If necessary, your system administrator can help you with cross-platform exporting and mounting.

If it is necessary to reinstall a CiscoWorks Blue product, deinstall the existing software using procedures in "Deinstalling on SunOS or HP-UX," then reinstall as if it were a new installation.

To stop the SunOS or HP-UX installation or configuration process at any time, press Break or Ctrl-C.

Exporting a CD-ROM File System from a SunOS or HP-UX System

The root .rhosts file on the remote system must contain the host name of your local system and an entry for the user root. Otherwise, you cannot access the remote system to download software from its CD-ROM drive. For more information, refer to the rhosts manual page.

To export a CD-ROM file system from a SunOS, Solaris, or HP-UX system, perform the following steps on the remote system:

Step 1 Place the CD-ROM in its caddy and insert it into the CD-ROM drive.

Step 2 Log in as the root user.

Step 3 Create a /cdrom directory, if one does not exist, by entering the following command:

# mkdir /cdrom


If the /cdrom directory already exists, proceed to the next step.

Step 4 Create an /etc/exports file using a text editor, if the file does not exist.

Step 5 Edit the /etc/exports file to include the following line:

/cdrom -ro


Step 6 If you just created /etc/exports (in Step 4), you must enable your workstation as an NFS server. Start the nfsd server option by entering the following at the UNIX command line:

# /etc/nfsd 8 &
# /usr/etc/rpc.mountd -n

Step 7 Mount the CD-ROM by entering the following command:

On SunOS:

# /etc/mount -r -t hsfs /dev/device_filename /cdrom


On HP-UX:

# /etc/mount -o ro -t cdfs /dev/device_filename /cdrom


In the SunOS command, the -r option mounts the CD-ROM in read-only mode.

In the HP-UX command, the -o ro option mounts the CD-ROM in read-only mode.

In each command, -t indicates the type of file system: hsfs for the ISO 9660 standard and cdfs for the High Sierra standard with Rock Ridge extensions.

In the SunOS command, replace the device_filename variable with /dev/sr0.

In the HP-UX command, replace the device_filename variable with /dev/dsk/c201d2s0 or a different device number reported by the /etc/ioscan program for the CD-ROM device.

Step 8 If the /etc/exports file existed previously (before Step 4), enter the following command to run exportfs:

# exportfs -va


Step 9 If /etc/exports did not exist previously, reboot your system.

# reboot


Step 10 Go to "Mounting a Remotely Exported CD-ROM File System on a Local System."

Mounting a Remotely Exported CD-ROM File System on a Local System

To mount a file system that is exported from a remote system, perform the following steps on the local SunOS or HP-UX system:

Step 1 Log in as the root user.

Step 2 Create a /cdrom directory, if one does not already exist, by entering the following command:

# mkdir /cdrom


Step 3 To mount a file system that is exported from a remote system, enter the following at the command prompt:

hostname# mount remote_hostname:remote_filesystem local_mount_point

For example, to mount the /cdrom file system from a remote host called faraway on a local directory named /cdrom, enter the following command at the prompt:

hostname# mount faraway:/cdrom /cdrom

The remote CD-ROM is ready for installation of software on the local system.

Step 4 Go to "Installing on SunOS and HP-UX."

Mounting a Local CD-ROM on SunOS or HP-UX

To prepare the system for installation of software from a local CD-ROM drive, complete the following steps:

Step 1 Place the CD-ROM in its caddy and insert it into the CD-ROM drive.

Step 2 Log in as the root user.

Step 3 Create a /cdrom directory, if one does not exist, by entering the following command:

# mkdir /cdrom


If the /cdrom directory already exists, proceed to the next step.

Step 4 Mount the CD-ROM by entering the following command:

On SunOS:

# mount -r -t hsfs /dev/device_filename /cdrom

On HP-UX:

# /etc/mount -o ro -t cdfs /dev/device_filename /cdrom

In the SunOS command, the -r option mounts the CD-ROM in read-only mode.

In the HP-UX command, the -o ro option mounts the CD-ROM in read-only mode.

In each command, -t indicates the type of file system: hsfs for the ISO 9660 standard and cdfs for the High Sierra standard with Rock Ridge extensions.

In the SunOS command, replace the device_filename variable with /dev/sr0.

In the HP-UX command, replace the device_filename variable with /dev/dsk/c201d2s0 or a different device number reported by the /etc/ioscan program for the CD-ROM device.

Step 5 Go to "Installing on SunOS and HP-UX."

Installing on SunOS and HP-UX

After the CD-ROM is mounted, use this procedure to move the software to the host system.

The default for each prompt is the value in brackets. To accept any default value, press Enter. Note that you can press Break or Ctrl-C to stop the installation script at any time.

Step 1 Start the interactive installation and configuration script by entering the following commands:

# cd /cdrom

# cwbinstall

Step 2 In response the the following prompt, enter the source of the software to be installed.

On SunOS, press Enter to accept the default directory.

Source Directory :[/cdrom]

On HP-UX, enter the image file in which the software is stored.

Source File:[/cdrom/cwbsnaview.tar]

Step 3 In response the the following prompt, press Enter. Do not override the default.

Where do you want to install the product :[/usr/cw-blue]

Step 4 In response to the following prompt, press Enter.

What filesets do you want to install : [CWBLUE-SNAVIEW]

Step 5 The installation program reviews your responses to the previous questions and asks:

Do you wish to continue? (y/n)[y]:

Press Enter to continue, or type n and press Enter to terminate installation.

Step 6 The program installs the software from CD-ROM and reports on its progress.

Step 7 Examine /tmp/update.log for error messages by typing the following command:

On SunOS, press Enter to accept the default directory.

# more /usr/cw-blue/log/cwb_install.log

On HP-UX, type:

# more /tmp/update.log

Press Enter to advance the display one screenful at a time.

Step 8 Installation is complete. Go to "Configuring SNA View on SunOS or HP-UX."

If it is necessary to deinstall any or all CiscoWorks Blue Maps applications, see "Deinstalling on SunOS or HP-UX."

Deinstalling on SunOS or HP-UX

If it is necessary to deinstall CiscoWorks Blue Maps, such as after a failed installation, follow this procedure. Note that you can press Break or Ctrl-C to stop the deinstallation script at any time.

Step 1 Shut down the SNA View application.

Step 2 Log in as the root user and set the CWBROOT and NMSROOT environment variables.

If you are using the K shell, type commands like the following:

# export CWBROOT=/usr/cw-blue

# export CWBROOT=/usr/nms

If you are using the C shell or the TC shell, type commands like the following:

# setenv CWBROOT /usr/cw-blue

# setenv CWBROOT /usr/nms

Step 3 To start the interactive deinstallation script, type the following commands:

Step 4 Log in as the root user and type the following commands:

# cd /usr/cw-blue/install/bin

# cwbdeinstall

The deinstallation script lists the Maps and SNA View filesets that are installed.

Step 5 To deinstall the SNA View application only, type the following and press Enter:

CWBLUE-SNAVIEW

Step 6 In response to the following prompt, press Enter to begin the deinstallation, or type n and press Enter to terminate deinstallation.

Do you wish to de-install? (y/n)[y]:

Step 7 When the system prompt returns, examine the deinstallation log file. Unless you see an error message in that file, deinstallation is complete.

On HP-UX, type:

# more /tmp/cwb_deinstall.log

On SunOS, there is no deinstallation log file.

Step 8 Remove the deinstallation log file. On HP-UX, type:

# rm /tmp/cwb_deinstall.log

You can now reinstall the software.

Configuring SNA View on SunOS or HP-UX

Perform these steps on a SunOS or HP-UX system when installation of the software in complete.

The default for each prompt is the value in brackets. To accept any default value, press Enter. Note that you can press Break or Ctrl-C to stop the configuration script at any time.

Step 1 To run the interactive configuration script, type the following:

# cd /usr/cw-blue/install/bin

# cwbconfigure

Step 2 In response to the following prompt, type snaview to specify that you want to configure the SNA View product.

Which product do you want to configure?: [maps or snaview]

Step 3 The following prompt appears only if the CWBROOT variable is not already set. Press Enter to accept the default (the same directory in which you placed the software during installation), or type an alternate directory name.

CiscoWorks Blue root directory: [/usr/cwblue]

Step 4 In response to the following prompt, type the name(s) of the SNA domains from which SNA View will collect information. Separate multiple names with a space.

SNA Domain name(s):

If you are reconfiguring an existing domain, press Enter without typing a name.

Step 5 The configuration program reviews your responses to the previous questions and asks:

Do you wish to continue? (y/n)[y]:

Press Enter to continue, or type n and press Enter to terminate configuration.

Step 6 An SNA View domain selection window pops up. The window lists the name of each domain you specified, plus the name of each pre-existing domain. In the Domain Selection Menu, click once on a domain name, then click the Select button at the bottom of the window.

The window also lists domains configured for the E/View/Open product from NetTech, Inc. Do not select a domain originally configured for EView/Open.

Step 7 See "Configuring Domain-Specific Parameters" in the "Installing and Configuring SNA View on AIX" chapter of the CiscoWorks Blue SNA View Workstation Installation Guide, and configure the selected domain. To put the cursor in a field where you want to make a change, point and click with the mouse. Press the TAB key to move down the list, or press Shift-TAB to move the cursor up the list. Click the scroll bar to move the form up and down.

Note that the CiscoWorks Blue SNA View Workstation Installation Guide incorrectly names the parameters with an SV prefix. The EV prefix that appears in the window is correct.

If you want to configure LU6.2 connectivity with the mainframe rather than the default TCP connectivity, see "Configuring LU6.2 Connectivity" under "Workstation Installation and Configuration Caveats" in this release note.

Step 8 When you are finished with the parameters of a given domain, click Save, then click Quit.

Step 9 Repeat Step 6 through Step 8 for each SNA domain.

Step 10 When you have configured each domain, click Close on the Domain Selection Menu.

Step 11 Click Done, then click Cancel.

Control returns to the window in which you previously executed the configuration script.

Step 12 Unmount the CD-ROM by entering the following commands:

# cd /
# umount /cdrom


Step 13 Eject the CD-ROM.

Step 14 Configuration is complete. Go to "Removing Log Files on SunOS or HP-UX."

Removing Log Files on SunOS or HP-UX

During installation and configuration, messages are recorded in a log file to provide diagnostic information in case a problem arises. Perform these commands on a SunOS or HP-UX system when you are satisfied that configuration of the software is complete.

On SunOS:

# rm /usr/cw-blue/log/cwb_install.log        

On HP-UX:

# rm /tmp/update.log        

TCP 6116 6117        

TCP 6126 6127        

EVOMF_HCI_AGENT_PORT 6116        
EVOMF_CMDS_AGENT_PORT 6117

EVOMF_HCI_AGENT_PORT 6126        
EVOMF_CMDS_AGENT_PORT 6127

        F NSPOPEN,SHOW FLOW

        P NSPOPEN
S NSPOPEN