1998/09/25 PMVision (Java Based PMconsole) Version 1.2 Release Notes INTRODUCTION PMVision(TM) (referred to as Amber in previous release notes) is a new generation of PMconsole(TM) based on Sun's Java Virtual Machine version 1.1.4. Version 1.2 of PMVision is available to any Lucent customer at no charge. In order to use the full capabilities of this product product, you must have ComOS(R) 3.8 or later. ComOS 3.8 is currently only available for PortMaster(R) 3. Older releases of ComOS are supported by PMVision to the same extent that the old PMconsole supported them, except that the SNMP table, hosts table, and routing table cannot be configured with PMVision on releases of ComOS older than 3.8. PMVision was designed with the three following goals: - To enhance the portability of the product. This goal has been met with the use of the Java environment. - To allow management of multiple PortMaster units simultaneously. - To build a platform that is extensible to allow Wizards and Smart Agents to aid the management of PortMaster products. PMVision presents the user with a single document interface (SDI) style window, with a control tree on the left, a list of currently open PortMaster units, including selection information, on the top center, and the main function window in the center. To access a PortMaster, you select the Connect option from the PortMaster pulldown menu, or select PortMaster in the control tree. PMVision allows you to connect to a PortMaster using the default !root login, or to use RADIUS authenticated administrative logins if the PortMaster is appropriately configured. If RADIUS authenticated administrative logins are used, the password for these logins is currently sent over the connection in cleartext. PMVision does not treat the RADIUS NAS-Prompt-User administrative user, which has limited command rights, any differently from the RADIUS Administrative-User, which is equivalent to the !root account, until the ComOS denies access to a function. For example, a NAS-Prompt-User level administrative user 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. Existing PMconsole products provide four main functions: - Configuration - Viewing (Monitoring) - Install/Upgrade - Backup/Restore PMVision provides all configuration options available through PMconsole, for a PortMaster running ComOS 3.8 or later. In addition, PMVision lets you copy configurations within a PortMaster or to other PortMaster products, and provide debug capabilities and a window for entering ComOS commands. When controlling a PortMaster running a ComOS release earlier than 3.8, PMVision does not provide configuration for SNMP, the Host Table, or Static Routes. PMVision provides much more extensive monitoring capabilities than those afforded by the old PMconsole, including the ability to monitor diagnostic commands. PMVision provides ComOS upgrade capabilities equivalent to PMconsole. PMVision provides the capability to backup and restore PortMaster configuration as ASCII text commands. PMVision does not backup or restore user passwords, the administrative password, the RADIUS secret, or the ChoiceNet secret. PMVision does not read or restore binary backup files created by PMconsole or pmreadconf. However, you can use Upgrade to send a pmreadconf'ed binary backup file back to a PortMaster. NOTE: The binary backup file format is heavily dependent on ComOS version, and restoring a file saved from one version onto another is potentially dangerous. PMVISION FUNCTIONS You access PMVision functions by clicking on them in the menu tree. MONITOR The Monitor tree item allows you to monitor Sessions, Modems, Lines, and Interfaces. Counters may be reset, affecting PMVision only, and the counters revert to actual values when changing to another screen. - Sessions shows active sessions. - Modems shows the state of the modems. - Lines shows the state of line0 and line1. - Interfaces shows active interfaces. DIAGNOSE Debug allows you to select a variety of debug information to be displayed. MAINTAIN Upgrade allows you to upgrade 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 doing a restore, 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. NOTE: If there are items not overwritten by restore they will be left unchanged. WARNING: Backing up the user table does not recover the individual user passwords. WARNING: Restoring a user table from an PMVision back up does not restore the user password. This can result in a null password on the user table entry. If a user entry has a null password a login attempt will not prompt for a password. This can result in the user being unable to login. It can also result in unauthorized use of the user account since no password is required. WARNING: The administrative (!root) password and RADIUS and ChoiceNet secrets are not saved by the backup operation. Unless the administrative password and RADIUS and ChoiceNet secrets are added to the backup file they are not restored and the previous password and secrets will remain in effect. COMMAND Command provides a command window for entering ComOS commands and viewing command output. CONFIGURE Configure allows you to view and change configuration information for the PortMaster. SYSTEM REQUIREMENTS PMVision is a Java based product, and can be executed on any system that has JDK or JRE (Java Runtime Environment) version 1.1.4 or later. Non-developers should use JRE rather than JDK. Currently, JDK 1.1 and/or JRE 1.1 is available for the following platforms. o Windows NT 4.0 http://www.javasoft.com/products/jdk/1.1/ o Windows 95 http://www.javasoft.com/products/jdk/1.1/ o Solaris 2.5.1 http://www.javasoft.com/products/jdk/1.1/ o Solaris x86 2.5.1 http://www.javasoft.com/products/jdk/1.1/ o Linux 2.x ftp://lagrange.la.asu.edu/pub/Linux_jdk/ o FreeBSD http://www.freebsd.org/java/ o SGI Irix 6.3 http://www.sgi.com/Products/DevMagic/products/java.html o HP/UX 10.02 http://www.hp.com/esy/go/java.html o DEC Alpha 4.0 http://www.digital.com/java/download/ o IBM AIX 4.1 http://www.ibm.com/java/tools/jdk.html o All other platforms http://java.sun.com/cgi-bin/java-ports.cgi INSTALLING PMVISION 1. Download the following files from ftp.livingston.com: ftp ftp.livingston.com binary cd pub/le/software/java (for Solaris) get pmvision12_solaris.tar (for other UNIX systems) get pmvision12_unix.tar.gz (for Windows) get pmvision12.zip 2. For the UNIX systems, in the .cshrc file, define the path for jre1.1.4/bin. For example: If you install jre1.1.4 in the /usr/local/lib directory, then the .cshrc file should have the following entry: set path=( /usr/local/lib/jre1.1.4/bin $path ) Installing the 1.1.5 JRE sets the correct values for PATH and CLASSPATH on both Windows NT and Windows 95. For JRE or JDK 1.1.4 on Windows 95, edit c:\autoexec.bat and add path=%PATH%;\bin where is the location where the Java runtime environment was installed. Note that if the JDK is installed instead of the JRE the scripts need to be edited. For Windows NT 4.0, define the path for jre1.1.4 in the System Environment as follows: a. Open the Control Panel b. Click on the System icon c. Click on the Environment On the display window, highlight and click on the line with the word Path, enter the installation path of the JDK or JRE on the Value window, and click on the Set button. Typically, the JDK or JRE is intalled on C:\jdk1.1.4 or C:\jre1.1.4. Therefore, the correct path for JDK and JRE in this case would be C:\jdk1.1.4\bin or C:\jre1.1.4\bin. 3. Running the installation. For Solaris users, on the command line, enter the following command: tar xvf pmvision12_solaris.tar ./pmvision_install.bin For other UNIX users, on the command line, enter the following command (gunzip is available from the Free Software Foundation at ftp.gnu.org): gunzip pmvision12_unix.tar.gz tar xvf pmvision12_unix.tar mkdir /Lucent mkdir /Lucent/PMVision cp pmvision.jar /Lucent/PMVision cp pmvision /Lucent/PMVision is the directory where you keep your applications. For Windows users, unzip the pmvision12.zip file and run the pmvision_install.exe program. Follow the instructions of the installation. RUNNING PMVISION For an NT system, you can select the PMVision icon from the Lucent folder in your Start, Programs menu. For UNIX systems, You can run PMVision by typing pmvision at your command tool window 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. When executing PMVision, you can use the following options: -h -u -p -g -l for Use local directory -h, -u, -p are used together to force PMVision to log into the specified PortMaster at startup. If only -h is specified, then the connect dialog box is popped up with the hostname filled in. For example: pmvision -h hostname -u \!root -p password -g specifies the debug level. Following are the valid value for this command: 0 - NONE - No debug output at all 10 - FATAL_ERRORS - Debug output for fatal errors only 20 - ALL_ERRORS - Debug output for all errors 30 - DEBUG - Useful debug information 40 - VERBOSE - More debug than you can possibly stand ALL_ERRORS is the default in this Beta release. If you want VERBOSE debugging please specify -g 40 on the command line. -l 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 this does the right thing. However the concept of a home directory is not so clear on PCs and seems to differ for each vendor's VM. Try looking for one of the following: c:\java\Lucent\PMVision c:\users\\Lucent\PMVision c:\windows\Lucent\PMVision If you still can not figure out where things are going try doing a Find, File for debuglog.txt. NEW FEATURES IN 1.2 Everything. LIMITATIONS Following is a list of the known limitations in PMVision Version 1.2: o The backup operation (Maintain, Back Up) does not save the administrative password, RADIUS secret, ChoiceNet secret, user passwords, OSPF interface configuration, and BGP configuration. o Do not connect to more than five PortMaster 3 units unless you have more than 32MB of RAM in the computer running PMVision. o PMVision can run out of memory and crash when using Configure, Routes to monitor more than 5 PortMasters with large routing tables. o Monitor, Modems shows different call and retrain counts than a "show modem" command done at the command line. o Modem Display information is not always in the correct order, this can be corrected by clicking on the Column Name to sort the column. o When a user enters invalid information, it is changed to a valid value. This problem occurs in some of the Configuration Panels. In a future release of PMVision, an invalid input will be tagged so that user can change it to a valid value. o When using the Diagnose --> Debug screen, the debugging options do not always get turned off correctly. Once a debug option is selected, deselecting it may result in continual display of the debug information. Turning off all debugging options stops the display of all debug information. o Since the ComOS only has one set of debug flags changing the debug settings on the command line will affect the debug messages displayed in PMVision's debug window. o Windows "Hourglass" cursor remains after the command is completed. The workaround for this is to move the mouse and cursor will change. o The Scroll Bar might not work correctly if you have JDK/JRE version 1.1.3 or earlier. Use 1.1.4 or later. o When PMVision is run under Motif or OpenWindows the following text may be displayed. This does not cause any runtime problems in PMVision. Warning: Name: scrollbar Class: XmScrollBar The scrollbar page increment is less than 1. o Occasionally, the initial overview screen might not be shown. Resizing the window will display the screen. o If an PortMaster running a a release older than ComOS 3.8 is sent unsupported commands, a "Command Error" dialog box is displayed. Click Done to dismiss the box, and return PMVision to a normal state. o An alternative UDP port for RADIUS cannot be entered. Use the command line for this. o On Windows systems, the links shown in the help pages do not work unless Java 1.1.6 or later is used. Please send your questions, comments, and suggestions regarding this beta software to support@livingston.com. Please mention that you are running PMVision 1.2, 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 will display the version of PMVision you are running including the build date, debug level and location of runtime debug files. Copyright and Trademarks Copyright 1998 Lucent Technologies, Inc. All rights reserved. PortMaster, ComOS, and ChoiceNet are registered trademarks of Lucent Technologies, Inc. RADIUS ABM, PMVision, PMconsole, and IRX are trademarks of Lucent Technologies, Inc. ProVision is a service mark of Lucent Technologies, Inc. All other marks are the property of their respective owners. Notices Lucent Technologies, Inc. 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., Inc. 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 Technical Support Lucent Technologies Remote Access Business Unit (previously Livingston Enterprises) provides technical support via voice, fax, electronic mail, or through the World Wide Web at http://www.livingston.com/. Please specify that you are running PMVision 1.2 when reporting problems with this release. Internet service providers (ISPs) and other end users in Europe, the Middle East, Africa, India, and Pakistan should contact their authorized Lucent Remote Access sales channel partner for technical support; see http://www.livingston.com/International/EMEA/distributors.html For North and South America 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 the Caribbean, or 1-925-737-2100 from elsewhere, for voice support. Otherwise, fax to 1-925-737-2110, or send email to support@livingston.com (asia-support@livingston.com for Asia Pacific customers).