cc/td/doc/product/rtrmgmt/snaview/snav10
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Installing and Configuring SNA View on AIX

Installing and Configuring SNA View on AIX

You use the System Management Interface Tool (SMIT), an IBM AIX system administration facility, to install and configure CiscoWorks Blue SNA View from a local or remote CD-ROM drive. The example installation and configuration process described in this chapter uses the graphical user interface (GUI) version of SMIT; you can use the ASCII version called SMITTY, if you prefer. Refer to your IBM documentation for more information about SMIT and SMITTY.

In the process of installing and configuring CiscoWorks Blue SNA View for NetView for AIX, you do the following:

This chapter also contains instructions for deinstalling CiscoWorks Blue SNA View software.

Note Refer to CiscoWorks Blue SNA View Release Note for cautionary statements about the installation and configuration process.

Becoming the Root User

The user named root can perform functions restricted from normal users. To install and configure CiscoWorks Blue SNA View, you must know the root user's password and log in to your system as the root user or become the root user by use of the su command.

Caution If you are a relatively inexperienced AIX user, limit your activities as the root user to the tasks described in this publication. As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands you use.

If you are not logged in, enter the following commands to log in as the root user:

login: root Password: rootpassword hostname#

If you are already logged in, but not as the root user, enter the following to change your login to root:

hostname% su Password: rootpassword hostname#

The AIX prompt changes to a pound sign (#)when you are logged in as the root user.

Mounting from a Local or Remote CD-ROM Drive

You can install CiscoWorks Blue SNA View from a CD-ROM drive attached to your system or from a drive connected to a remote system. You must first use SMIT to mount the local or remote device on the local AIX system.

Caution Avoid exposing the CiscoWorks Blue SNA View CD-ROM to direct sunlight because it could harm the contents.

Mounting from a Local CD-ROM Drive

To mount the CD-ROM on the file system from a local CD-ROM drive, use SMIT to perform the following steps:

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

Step 2 Log in as the root user. For details, see "Becoming the Root User."

Step 3 Start SMIT by entering the following at the command prompt:

The main SMIT menu appears, as shown in Figure 2-1.



Figure 2-1: Main SMIT Menu

Step 4 From the System Management menu, click Physical & Logical Storage.

Step 5 Click File Systems.

Step 6 Click Add / Change / Show / Delete File Systems.

Step 7 Click CDROM File Systems.

Step 8 Click Add a CDROM File System.

Step 9 Click the "DEVICE name" List button and select the device name (such as /dev/cd0) from the list that appears.

Step 10 Enter the name of a mount point directory (such as /cdrom) in the "Mount point" field.

Step 11 Click Do and read the output.

Note If you have already performed this procedure, or if another device is already mounted on the mount point, the process will fail.

Step 12 Click Done.

Step 13 Terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.

Step 14 Enter the following at the command prompt:

Step 15 Click the "FILE SYSTEM name" List button and select a device name (such as /dev/cd0) from the list that appears.

Step 16 In the "DIRECTORY over which to mount" field, enter the name of a mount point directory (such as /cdrom).

Step 17 Click the "TYPE of file system" List button and select cdrfs as the file system type.

Step 18 Set the "Mount as Read-Only System" field to yes.

Step 19 Click Do and read the output, and then click Done.

Step 20 Terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.

Mounting from a Remote CD-ROM Drive

To install software from a device on a remote system, you must have remote access rights to that system. Specifically, the .rhosts file (in the root directory) on the remote system must contain the local host name and your username to access the remote system. For more information, refer to the manual (man) page for .rhosts

Installation of CiscoWorks Blue SNA View does not require any disk space on the remote system. The software is copied across the network to the local workstation.

On the Remote System

To mount the CD-ROM on the local file system from a remote CD-ROM drive, perform the following steps on the remote system:

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

Step 2 Log in as the root user. For details, see "Becoming the Root User."

Step 3 Start SMIT by entering the following at the command prompt:

The main SMIT menu appears, as shown in Figure 2-1.


Step 4 From the System Management list, click Physical & Logical Storage.

Step 5 Click File Systems.

Step 6 Click Add/Change/Show Delete File Systems.

Step 7 Click CDROM File Systems.

Step 8 Click Add a CDROM File System.

Step 9 Click the "DEVICE name" List button and select the device name (such as /dev/cd0) from the list that appears.

Step 10 Enter the name of a mount point directory (such as/cdrom) in the "Mount point" field.

Step 11 Click Do and read the output.

If you have already performed this procedure, or if another device is already mounted on the mount point, the process will fail.


Step 12 Click Done.

Step 13 Terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.

Step 14 Enter the following at the command prompt:

Step 15 Click the "FILE SYSTEM name" List button and select a device name (such as /dev/cd0) from the list that appears.

Step 16 In the "DIRECTORY over which to mount" field, enter the name of a mount point directory (such as /cdrom).

Step 17 Click the "TYPE of file system" List button and select cdrfs as the file system type.

Step 18 Set the Mount as Read-Only System field to yes.

Step 19 Click Do and read the output, and then click Done.

Step 20 Terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.

Step 21 Enter the following at the command prompt

Step 22 Enter the "PATHNAME of directory to export" (such as /cdrom).

Step 23 Use the arrow keys to change the "Mode to Export Directory" field to read-only.

Step 24 Enter the appropriate information, if necessary, into any of the other fields.

Step 25 Click Do, read the output, then click Done.

Step 26 Terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.

On the Local System

Perform the following steps on the local system:

Step 1 Log in as the root user. For details, see "Becoming the Root User."

Step 2 Enter the following at the command prompt:

hostname# mount remote_hostname:remote_exported_filesystem_name local_mount_point

For example, to mount a remote file system named zen, enter the following at the prompt:


The CD-ROM is ready for installation of software.


Installing CiscoWorks Blue SNA View

Installation is the transfer of software from the distribution medium to the AIX system.

Note Before performing these procedures, you must have mounted a local or remote CD-ROM as described earlier.
Caution CiscoWorks Blue SNA View can be installed only in the /usr/cw-blue directory. If you create a file system, its mount point must be /usr/cw-blue.

To install CiscoWorks Blue SNA View from a mounted CD-ROM drive, perform the following steps:

Step 1 Place the CD-ROM into its caddy and insert it into the local or remote CD-ROM drive.

Step 2 Log in as the root user. For details, see "Becoming the Root User."

Step 3 Set the CWBROOT environment variable to /usr/cw-blue, the NMSROOT environment variable to /usr/nms, and the SVHOME variable to $CWBROOT/snaview

If you are using the K shell, type the following on the command line:


If you are using the C shell, type the following on the command line:


Step 4 Start SMIT by entering the following at the command prompt:

Step 5 On the System Management menu, click Software Installation & Maintenance.

Step 6 On the next menu, click Install / Update Software.

Step 7 On the next menu, click Install / Update Selectable Software (Custom Install).

Step 8 On the next menu, click Install Software Products at Latest Available Level.

Step 9 In the Install Software Products at Latest Available Level dialog box, click the List button, then click the name of the CD-ROM device on which you loaded the CD-ROM in Step 1.

Step 10 Click Do.

The Install Software Products at Latest Available Level dialog box displays additional fields as shown in Figure 2-2.



Figure 2-2: Install Software Products at Latest Available Level Dialog Box

Step 11 Click the List button next to the "SOFTWARE to install" field. After a brief delay, the Multi-Select List dialog box appears, as shown in Figure 2-3.


Figure 2-3: Multi-Select List Dialog Box

Step 12 Click the CWBSNAView.base.obj module.

Step 13 Click OK and then click Do.

Step 14 In response to the "ARE YOU SURE?" prompt, click OK when you are sure you want to install the modules you just highlighted. An animated man is displayed on the screen.

While the animated man is running, SMIT installs the selected modules in the /usr/cw-blue directory, and CiscoWorks Blue SNA View modifies SMIT to allow subsequent configuration and deinstallation of CiscoWorks Blue SNA View.


If the man raises his hands and SMIT displays OK, the process has succeeded.


If the man falls, installation has failed. If the reason is not apparent, read the installation log file $HOME/smit.log or /usr/cw-blue/install/cwb_install.log and supply it to a Cisco Technical Assistance Center (TAC) representative.


Step 15 Click Done.

Step 16 If Step 14 indicated success, click the Return to System Management button and go to the following section, "Configuring CiscoWorks Blue SNA View."

In the event of failure, terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.


Configuring CiscoWorks Blue SNA View

Configuring CiscoWorks Blue SNA View on AIX consists of specifying the mainframe domains with which SNA View is to operate, plus a set of parameters for each domain.

Note Before performing these procedures, you must have completed the installation process.

To configure the CiscoWorks Blue SNA View product, perform the following steps:

Step 1 Start SMIT if you have not already done so:

Step 2 On the initial SMIT menu, click Communications Applications and Services.

Step 3 On the next menu, click Cisco Network Management Applications for AIX.

Step 4 On the next menu, click CiscoWorksBlue SNA View.

Step 5 On the CiscoWorks Blue SNA View 3.0 menu, click Configure.

Step 6 On the Configure menu, click SNA View.

The SNA View dialog appears, as shown in Figure 2-4.



Figure 2-4: SNA View Dialog Box

Step 7 Type one or more new domain names into the SNA Domain(s) field, separated by spaces.

Note If you are reconfiguring an existing domain, leave the SNA Domain(s) field blank.

Step 8 Click Do. SMIT presents a window with the name of each domain you specified, plus the name of each pre-existing domain. (When the Domain Selection menu is active, the SMIT man continues to run.)

Step 9 In the Domain Selection menu, click once on a domain name, then click the Select button at the bottom of the window.

SMIT presents a parameter configuration screen for the selected domain.


Step 10 See "Configuring Domain-Specific Parameters" 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 scroll the form up and down.

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

Step 12 Repeat Step 9 through Step 11 for each SNA domain.

Step 13 When you have configured each domain, click Close on the Domain Selection menu. The SMIT man should raise his hands to indicate success.

Step 14 Click Done, and then Cancel.

Step 15 Terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.

Configuring Domain-Specific Parameters

For each SNA Domain listed on the Domain Selection menu, you must set a group of operational parameters.

Note The parameters for a particular domain are stored in a file named /etc/sv_config_domainname, such as /etc/sv_config_texas. You can edit this file directly, if necessary.

Table 2-1 lists the parameters that you must set, and Table 2-2 lists additional parameters that you may choose to customize. Detailed descriptions of each parameter follow the tables.


Table  2-1: Required CiscoWorks Blue SNA View Configuration Parameters
Parameter Default Value Valid Values
SVPATH none SNA View home directory
SVMF_CONNECT TCP LU62 or TCP
SVVTAM_AGENT_ADDR machine.name.com Machine name running the VTAM Server
SVMVS_AGENT_ADDR machine.name.com Machine name running the MVS Server
SVALERT_AGENT_ADDR machine.name.com Machine name running the Alert Server
SVCMDS_AGENT_ADDR machine.name.com Machine name running the Command Server
SVHCI_AGENT_ADDR machine.name.com Machine name running the Host Connection Interface
SVMF_AGENT_ADDR machine.name.com Machine name of the mainframe where the mainframe component is installed
SVSTATUS_SOURCE VTAM VTAM
SVHOST_NAME NET1 An alphanumeric string consisting of up to 6 characters
SVSOCKET_MODE TCP TCP
SVBUILD_MAP_TYPE ACTIVE ACTIVE or PASSIVE

Table  2-2: Optional CiscoWorks Blue SNA View Configuration Parameters
Parameter Default Value Valid Values
UPDATE_DB_W_ NEWNODES yes yes or no
MONITOR_SWITCHED_PUS no yes or no
REFRESH_TYPE PASSIVE ACTIVE or PASSIVE
INCLUDE_LUS no yes or no
KEEP_DISCOVER_INPUT_FILES yes yes or no
KEEP_DISCOVER_STDOUT_FILES yes yes or no
SVVTAM_AGENT_PORT 6100 Any unused PORT value
SVALERT_AGENT_PORT 6101 Any unused PORT value
SVCMDS_AGENT_PORT 6102 Any unused PORT value
SVHCI_VTAM_PORT 6103 Any unused PORT value
SVHCI_ALERT_PORT 6104 Any unused PORT value
SVHCI_STATUS_PORT 6105 Any unused PORT value
SVMF_HCI_AGENT_PORT 6106 Any unused PORT value
SVMF_CMDS_AGENT_PORT 6107 Any unused PORT value
SVMVS_AGENT_PORT 6108 Any unused PORT value
SVHCI_MVS_PORT 6109 Any unused PORT value
SVCMD_TIMEOUT 30 Any number of seconds
SVCMD_OPERATOR SVAUTO1 Valid NetView for MVS operator task
SVCMD_DEFDIS yes yes or no
SVWORK_AREA /tmp Any valid directory

Configuration Parameter Descriptions

The following information describes each parameter in detail.

Required Parameters

You must set the following parameters for each domain:

Note In most cases, the first five agent address parameters (but not SVMF_AGENT_ADDR) will be identical to the same-named parameter in the configuration of each domain.

Optional Parameters

You may choose to override the default values of the following parameters:

When you are managing more than one domain with SNA View, the SNA View install program will automatically increment the port values for each specified domain by 10. For example, if a port number in Domain A is 6100, CiscoWorks Blue SNA View will automatically make the value for the same configuration parameter in Domain B 6110. If the port numbers are already in use, please modify them to fit your site's requirements.
d net,id=pu_none
or to issue the display command in the form:
d net,id=pu_name, max=*
See your system administrator for more information about the appropriate form of the command for your environment.

Cleaning Up after Using SMIT

Perform these tasks after installation and configuration of CiscoWorks Blue SNA View 3.0.

Note You should now be able to access CiscoWorks Blue SNA View applications through the CiscoWorks Blue Maps menus.

Unmounting the CD-ROM

Unmount the CD by logging in as the root user and entering the following at the local or remote workstation where it is mounted:

hostname# cd / hostname# umount /cdrom

AIX unmounts the CD-ROM device from the /cdrom directory. Remove the CD-ROM caddy from the drive.

Removing Log Files

During installation and configuration, log files are created to track the installation process and provide diagnostic information if a problem arises. When you are satisfied that CiscoWorks Blue SNA View is properly installed and operating, you can remove these files. To remove these files from your system, log in as the root user and enter the following command:

hostname# rm /tmp/cwb_install.log cwb_config.log $CWBROOT/INSTALL

Unless an error message appears, the log files are removed.

After installing and configuring CiscoWorks Blue SNA View, proceed to the chapter "CiscoWorks Blue SNA View Features."

Customizing Window Preferences

Application default files for each of the SNA View Motif windows are copied from $SVHOME/app-defaults to /usr/lib/X11/app_defaults by the installation program. The defaults consist of:

These defaults may be modified to suit each individual user's preferences.

Deinstalling CiscoWorks Blue SNA View

If you must deinstall all files related to CiscoWorks Blue SNA View, perform these steps:

Step 1 Log in as the root user. For details, see "Becoming the Root User."

Step 2 Start SMIT by entering the following at the command prompt:

Step 3 On the System Management menu, click Communications Applications and Services.

Step 4 On the next menu, click Cisco Network-Management Applications for AIX.

Step 5 On the next menu, click CiscoWorks Blue SNA View.

Step 6 On the next menu, click Maintain.

Step 7 On the next menu, click De-Install CiscoWorks Blue SNA View.

Step 8 In the Deinstall dialog box, click the "De-install" List button.

Step 9 In the Multi-select List dialog box, select all object names so that all are highlighted simultaneously, then click OK.

Step 10 In response to the "ARE YOU SURE?" prompt, click OK. An animated man appears on the screen.

While the animated man is running, SMIT deinstalls all files related to CiscoWorks Blue SNA View.


If the man raises his hands and SMIT displays OK, the deinstallation process has succeeded.


If the man falls, deinstallation has failed. Contact a TAC representative.


Step 11 Terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.