2000/3/7

		PMVision 1.10 Release Note

PMVision(TM) is a configuration and monitoring application for Lucent
PortMaster(R) products and the MERLIN MAGIX(TM) Integrated Network
Access (INA) module. PMVision is based on the Sun Microsystems Java
Virtual Machine version 1.1.6. Version 1.10 of PMVision is available to
any Lucent customer at no charge.

PMVision works best with the following ComOS(R) versions and provides
equivalent functions:

* ComOS 4.2 (in beta)
* ComOS 4.1
* ComOS 4.0
* ComOS 3.9 (in beta)
* ComOS 3.8.2
* ComOS 3.8
* ComOS 3.7.2c3

If you are running an older version of ComOS, not all PMVision
functions are available.

_______________ Contents

About PMVision
New Features -- None
Bug Fixed
Main Functions
Limitations
Ether0 Requirements for a Redundant PortMaster 4 System
Upgrading a PortMaster 4 to ComOS 4.2
System Requirements
Installation
Deinstallation
Running PMVision
Login Options
Debug Log
Technical Support

______________ About PMVision

PMVision was designed to do the following:

* Be portable across operating systems.

* Manage multiple devices simultaneously.

* Extend to allow Wizards and Smart Agents to manage devices.

* Manage other platforms using ComOS.

PMVision provides a single document interface (SDI) panel.  A control
tree appears on the left, a list of currently open products --
including selection information -- appears at the top center, and the
main function window is in the center.

PMVision includes online help.

_______ Device Access

To access a device, you select the Connect option from the Device
pull-down menu, or select either PortMaster or INA in the control
tree.  PMVision allows you to connect to a device using the default
!root login, or to use RADIUS authenticated administrative logins if
the device is appropriately configured. If RADIUS authenticated
administrative logins are used, the password for these logins is
currently sent over the connection in clear text.

_______ RADIUS User Permissions

A RADIUS NAS-Prompt-User has limited command rights. A RADIUS
Administrative-User is equivalent to the !root administrative login.
PMVision treats the RADIUS NAS-Prompt-User administrative user the same
as the RADIUS Administrative-User until ComOS denies access to a
function. For example, a user at the NAS-Prompt-User level can use
PMVision to create a user or location record, but creation of that
record is denied when the command is sent to the PortMaster.

_______________ New Features -- None

This release is a bug fix release only and does not add any new
features.

_______________ Bug Fixed

PMVision 1.10 fixes a bug in PMVision 1.9 that prevented the
application from restoring a backup file to a PortMaster 4 with only
one system manager module. Backup files are now restored properly.

______________ Main Functions

You access PMVision functions by clicking them in the control tree.
PMVision provides the following main functions:

* Monitoring (requires ComOS 3.8 or later)
* Graphing (requires ComOS 3.9 or later, and is not available for INA)
* Diagnosis -- Debug (not available for INA)
* Maintenance -- Upgrade, Back Up, and Restore
* Command -- Using the ComOS command line interface
* Configuration

_______ Monitor

PMVision provides extensive real-time monitoring capabilities,
including the ability to monitor diagnostic commands.

The Monitor tree item allows you to monitor operations on the devices
as follows:

* Chassis shows power use, fan status, and temperature for each board
  on a PortMaster 4. This feature works only with ComOS 4.0 or later.

* Users shows the list of connected users.

* Modem Summary shows the number of modems in each state on a
  PortMaster 3 running ComOS 3.9 or later or on a PortMaster 4.

* Modem Details shows the state of modems either for an entire
  PortMaster 3 chassis or for a single PortMaster 4 Quad T1 or Tri E1
  board.

* Session Summary shows the number of connections for various
  connection speeds on a PortMaster 3 running ComOS 3.9 or later or on
  a PortMaster 4.

* Session Details shows active sessions either for an entire
  PortMaster 3 chassis or for a single PortMaster 4 Quad T1 or Tri E1
  board.

* Lines shows the state of lines for an entire chassis.

* Interfaces shows active interfaces either for an entire PortMaster 3
  chassis or for a single PortMaster 4 Quad T1 or Tri E1 board.

* Alarms shows the list of SNMP alarms for ComOS 3.9 or later.

* NAT Sessions shows the list of network address translator (NAT)
  sessions on a PortMaster running ComOS 3.9 or on an INA module
  running ComOS 4.1.5.

* NAT Statistics shows the list of NAT statistics on a PortMaster
  running ComOS 3.9 or on an INA module running ComOS 4.1.5.

* OSPF Neighbors shows the list of OSPF neighbors on a PortMaster
  running ComOS 3.9 or later.

* Network Connections shows the list of network connections on a
  PortMaster running ComOS 3.9 or later.

* Mux Channels shows the state of channels on a T3 Mux or STS-1 Mux
  board.

* Mux Stats shows the state of the multiplexor (mux) line on a T3 Mux
  or STS-1 Mux board.

* Ethernet shows the activity on all Ethernet interfaces.

* L2TP Tunnels shows the Layer 2 Tunneling Protocol (L2TP) tunnels 
  on your PortMaster.

* L2TP Sessions shows the L2TP sessions on your PortMaster.

_______ Graph

The Graph tree item allows you to view and log the history of modem
and session summaries. You can specify the log interval, log file,
and colors for each item in the display. The colors are saved to a
preferences file. This feature is currently available only on ComOS 3.9
or later, and is not available on the INA module.

* Modems shows the Modem Summary information over time.

* Sessions shows the Session Summary information over time.

_______ Diagnose

Debug allows you to display debug information. This feature is not
available on the INA module.

_______ Maintain

* Upgrade allows you to upgrade your PortMaster with a ComOS
  upgrade file.

* Back Up allows you to save certain parts of your configuration to a
  file. This configuration is saved in ASCII file format.

* Restore allows you to restore a previously saved configuration file.
  When restoring a configuration, PMVision is not just performing an
  erase-and-restore operation. Instead, the configuration file
  overwrites the specific configuration information that is being
  restored from the file.

Any items that are not overwritten by the restore operation are left
unchanged.

PMVision does not read or restore binary backup files. However, you can
use Upgrade to send binary backup files created by the pmreadconf
utility to a PortMaster.

CAUTION:  Because the binary backup file format is heavily dependent on
ComOS version, restoring a file saved from one version onto another is
not recommended.

WARNING - LOSS OF USER PASSWORDS. If you are running ComOS 3.8 or
earlier, backing up the user table fails to recover the individual user
passwords. For this reason, restoring a user table from a PMVision
backup produces null passwords in the user table. If a user entry has a
null password, the PortMaster does not prompt the user for a password
at login. As a result, the user might be unable to log in. In addition,
an unauthorized user might gain access to the user account because no
password is required. After a backup-and-restore operation, you must
add user passwords through either PMVision or the command line
interface.

As of PMVision 1.3 and ComOS 3.8.2 and later releases, user passwords
can be retrieved from the PortMaster. However, the passwords are passed
from the PortMaster to PMVision in clear text. They are then encrypted
when saved to the file.

WARNING - LOSS OF !ROOT PASSWORDS AND SECRETS. If you are running ComOS
3.8 or earlier, the administrative (!root) password and RADIUS and
ChoiceNet(R) secrets are not saved by the backup operation.  Unless you
add the administrative password and RADIUS and ChoiceNet secrets to the
backup file, they are not restored and the previous password and
secrets remain in effect.

As of PMVision 1.3 and ComOS 3.8.2 and later releases, RADIUS and
ChoiceNet secrets can be retrieved from the device. However, the
secrets are passed from the device to PMVision in clear text. They are
then encrypted when saved to the file.

_______ Command

Command provides a command window for entering ComOS commands 
and viewing command output.

The following ComOS commands are not allowed in Command:

* attach
* dial
* ping
* pmlogin
* ptrace
* rlogin
* set debug
* telnet
* tftp
* traceroute

_______ Configure

Configure allows you to enter, view, and update configuration
information for the device.

PMVision 1.10 supports the following PortMaster 4 modules and boards:

* System manager module
* Redundant system manager modules
* Quad T1 board
* Tri E1 board
* Standalone single Ethernet board
* Standalone dual Ethernet board
* T3 Mux board
* Synchronous Transport Signal 1 (STS-1) Mux board
* L2TP network server (LNS) board

When controlling a PortMaster running a ComOS release earlier than
ComOS 3.8, PMVision does not provide configuration for the Simple
Network Management Protocol (SNMP) or the host table. PMVision does not
provide configuration for static routes.

_______________ Limitations

PMVision 1.10 has the following known limitations:

* ComOS 4.2 does not always send all the active SNMP alarms
  to PMVision. To display the alarms that are active on a PortMaster 4,
  enter "show alarms" in the Command  window.

* The Session Summary display does not work with an Office Router,
  PortMaster 2, or IRX(TM) Router running ComOS 3.9b27.

* You cannot use PMVision to configure or back up static routes.

* If you are running a release earlier than ComOS 3.8, you cannot
  use PMVision to configure SNMP or the host table.

* Saving port configuration settings while the PortMaster is in use
  might improperly rearrange ports out of their correct order. This
  behavior is caused by a ComOS bug that incorrectly reports the port
  type of established ports. To avoid reordering ports incorrectly, be
  sure to save port configuration settings when the PortMaster is not
  being used.

* Using the "show mux" command in the Command panel produces
  truncated output.

* The control tree is not updated when table entries are deleted or
  renamed.

* LEDs for the T3 Mux and STS-1 Mux boards on the PortMaster 4 are 
  not displayed in the main monitor panel.

* LEDs for the Ethernet ports are not displayed in the main monitor
  panel.

* The main monitor panel does not refresh the display of boards
  in the PortMaster 4 chassis.

* Using the "Log to File" option on the Maintain->Restore panel causes
  user passwords to be written to the log file in clear text.

* The Monitor->Interfaces display does not show the point-to-point
  interfaces on the PortMaster 4.

* The backup operation (Maintain->Back Up) does not save the
  administrative password.

* You cannot connect to more than five PortMaster products unless you
  have more than 32MB of RAM in the computer running PMVision.

* The Monitor->Modem Details display shows different call and retrain
  counts than does a "show modems" command entered at the command
  line.

* Modem information is not always displayed in the correct order.
  Click the column name to sort the column correctly.

* On the Diagnose->Debug panel, the debug options do not always
  turn off correctly after you deselect them, and might continue to
  display debug information. To stop the display of all debug
  information, turn off all debug options by clicking Clear All and
  then Apply in the Debug Options dialog box.

* Because ComOS has only one set of debug flags, changing the debug
  settings on the command line affects the debug messages displayed in
  the PMVision debug panel.

* In Microsoft Windows, the "hourglass" cursor remains visible after
  PMVision completes an operation. Move the mouse to correct the
  cursor.

* When PMVision is run under Motif or OpenWindows, the following text
  might appear but does not indicate any runtime problems in PMVision:

  Warning:
      Name: scrollbar
      Class: XmScrollBar
      The scrollbar page increment is less than 1.

* If a PortMaster is sent unsupported commands, a Command Error dialog
  box is displayed. Click Done to dismiss the box and return PMVision
  to a normal state.

_______________  Ether0 Requirements for a Redundant PortMaster 4 System

For the redundant system manager module feature to work correctly, the
Ether0 interface must be configured and active on each manager module.

If you use the Open Shortest Path First (OSPF) routing protocol, you
must now set the OSPF router ID on the Ether0 interface for each
manager module.

_______________  Upgrading a PortMaster 4 to ComOS 4.2

This special upgrade process applies only to PortMaster 4 systems
running a ComOS version earlier than ComOS 4.2. Once the PortMaster 4
is running ComOS 4.2, PMVision will correctly handle configuration,
backup, restore, and upgrade operations on a system operating with
redundant system manager modules.

Because PMVision 1.10 needs ComOS 4.2 to correctly identify a redundant
PortMaster 4 system, you must use the following special process to
upgrade a PortMaster 4 to ComOS 4.2.

To upgrade to ComOS 4.2 from any earlier ComOS release, follow 
these steps EXACTLY:

1. Obtain ComOS 4.2.

2. Use PMVision to connect to the Ether0 interface of each installed
   manager module.

3. Select both addresses in the device list.

4. Select the Maintain->Upgrade option.

   DO NOT select the "Reboot After Upgrade''option.

5. Select the new ComOS file and click Upgrade to upgrade both 
   manager modules.

6. Exit PMVision.

7. From the command line interface, reboot the PortMaster 4.

_______________ System Requirements

PMVision is a Java-based product that runs on any system with Java
Development Kit (JDK) or Java Runtime Environment (JRE) version 1.1.6
or later installed. Nondevelopers can use the JRE rather than the JDK.
Currently, JDK 1.1 and JRE 1.1 are available for the following and
other platforms at http://www.javasoft.com/products/jdk/1.1/:

*  Windows NT 4.0
*  Windows 95
*  Solaris 2.5.1
*  Solaris x86 2.5.1
*  Linux 2.x
*  FreeBSD
*  SGI IRIX 6.3
*  HP-UX 10.02
*  Alpha Digital UNIX 4.0
*  IBM AIX 4.1
*  Macintosh

_______________ Installation

To install PMVision, follow these steps:

1. Download files from ftp.livingston.com as follows:

   ftp ftp.livingston.com
   (Enter "anonymous".)
   (Enter your email address; it will not echo.)
   binary
   cd pub/le/software/java

   - For Solaris, enter
   get pmvision110_solaris.tar

   - For other UNIX systems, enter
   get pmvision110_unix.tar

   - For Windows, enter
   get pmvision110.zip

   - For Macintosh, enter
   get pmvision110.sit

   quit

2. For UNIX systems only, define the path for jre/bin in your .cshrc
   file. For example, if you install the JRE in the /usr/local/lib
   directory, your .cshrc file must have the following entry:

   set path=( /usr/local/lib/jre/bin $path )

   If the JDK has been installed, then change the pmvision script
   to use the java command instead of jre.

3. Run the installation.

   - For Solaris, enter the following commands on the command line:

   tar xvf pmvision110_solaris.tar
   ./pmvision_install.bin

   - For other UNIX systems, enter the following commands on the
     command line, replacing /usr/local/lucent with whatever path
     you prefer:

   mkdir /usr/local/lucent
   mkdir /usr/local/lucent/pmvision
   cp pmvision110_unix.tar /usr/local/lucent/pmvision
   cd /usr/local/lucent/pmvision
   tar xvf pmvision110_unix.tar
   rm pmvision110_unix.tar

   - For Windows, unzip the pmvision110.zip file, run the
     pmvision_install.exe program, and follow its instructions.

   - For Macintosh, unstuff the pmvision110.sit file using Stuffit
     Expander 5.0 or later, run the pmvision_install program, and
     follow its instructions.

4. If you are using a ChoiceNet server, increase to at least 2 and
   preferably 10 the maximum number of pmconsole connections allowed
   into the device. PMVision and ChoiceNet both use TCP port 1643
   for communication. If only one port is available, ChoiceNet cannot
   send filters to the device while PMVision is connected.

   To increase the number of connections allowed through this port,
   log in to your device through the console or a Telnet session
   and type the following commands:

   set maximum pmconsole 10
   save all

_______________ Deinstallation

* On a Solaris, Windows, or Macintosh system, an application called
  Uninstall_PMVision is placed in the Lucent/PMVision directory. Run
  this application to remove PMVision from your system.

  On Solaris, if the local jre directory still exists after you run
  Uninstall_PMVision, remove the directory with the command
  "rm -rf jre".

* On a UNIX system, remove the shell script and jar files to remove
  PMVision from your system.

_______________ Running PMVision

* On a Windows NT system, select the PMVision icon from the Lucent
  folder in your Start->Programs menu.

* On UNIX systems (including Solaris), run PMVision by typing
  "pmvision" when you are in the pmvision installation directory.
  If you have added the pmvision installation directory to your PATH,
  you can run it from anywhere.

* On Macintosh systems, select the PMVision icon from the Apple 
   menu.

_______________ Login Options

When running PMVision, you can use the following options:

-h <Hostname>
-u <Username>
-p <Password>

Use the -h, -u, and -p options together to force PMVision to log in to
the specified device at startup. For example:

pmvision -h Hostname -u "\!root" -p Password

If only -h is specified, the Connect dialog box is displayed with the
hostname filled in.

_______________ Debug Log

To specify the debug level for PMVision, select Help->About PMVision
and choose from the drop-down list. Alternatively, you can select a
debug level at the command line with the following debug options:

-g <Debug Level>
-l <specifies the local directory>

Valid debug levels are the following:

 0 - NONE - No debug output
10 - FATAL_ERRORS - Debug output for fatal errors only
20 - ALL_ERRORS - Debug output for all errors (the default)
30 - DEBUG - Useful debug information
40 - VERBOSE - More debug output than you can possibly stand

The -l option sends all debug output to the directory PMVision is
installed in.

By default, all debug output is sent to the Lucent/PMVision directory
created in your home directory. On UNIX machines, the default works
properly. However the concept of a home directory is not so clear on
PCs and seems to differ for each vendor's Virtual Machine. Look for 
one of the following:

c:\java\Lucent\PMVision
c:\users\<username>\Lucent\PMVision
c:\windows\Lucent\PMVision

If you still cannot find the directory that contains debug output,
select Find->File and search for debuglog.txt.

____________________________________________________________

	Copyright and Trademarks

Copyright 2000 Lucent Technologies. All rights reserved.

PortMaster, ComOS, ChoiceNet, MERLIN, and NetCare are registered
trademarks of Lucent Technologies. PMVision, IRX, PortAuthority, and
MERLIN MAGIX are trademarks of Lucent Technologies. PolicyFlow is a
service mark of Lucent Technologies.  All other marks are the property
of their respective owners.

	Notices

Lucent Technologies makes no representations or warranties with 
respect to the contents or use of this publication, and specifically 
disclaims any express or implied warranties of merchantability or 
fitness for any particular purpose. Further, Lucent Technologies 
reserves the right to revise this publication and to make changes 
to its content, any time, without obligation to notify any person or 
entity of such revisions or changes.

	Contacting Lucent NetCare Technical Support

Lucent NetCare(R) Professional Services provides technical support 
via voice and electronic mail, or through the World Wide Web at
http://www.livingston.com/. Mention that you are running 
PMVision 1.10, and include the version of JDK or JRE that you are 
running, the operating system version ("uname -a" output), and 
the version of ComOS on the PortMaster.

The "About PMVision..." menu item in the Help menu displays the 
version of PMVision you are running, including the build date, 
debug level, and location of runtime debug files.

Internet service providers (ISPs) and other end users in Europe, the
Middle East, Africa, India, and Pakistan must contact their authorized
Lucent sales channel partner for technical support; see
http://www.livingston.com/International/EMEA/distributors.html.

For North America, the Caribbean and Latin America (CALA), and Asia
Pacific customers, technical support is available Monday through Friday
from 7 a.m. to 5 p.m. U.S. Pacific Time (GMT -8).  Dial 1-800-458-9966
within the United States (including Alaska and Hawaii), Canada, and
CALA, or 1-925-737-2100 from elsewhere, for voice support. Otherwise,
send email to support@livingston.com (asia-support@livingston.com for
Asia Pacific customers).
