1999/2/18

			PMTools 4.1b1 Open Beta Release Note

The PMTools are a group of Java programs that supplement certain
PMVision(tm) functions.  You can incorporate these utilities into your
suite of scripts for PortMaster(R) management.  PMTools 4.1b1 is an
open beta release available to Lucent customers at no charge.



_______________ Contents

New Features
Limitations
Description of the PMTools
System Requirements
Installing the PMTools
Running the PMTools
Your Comments
Contacting Technical Support


_______________ New Features

The following is a list of new features in PMTools 4.1b1:

* pmbackup now allows the user to specify which areas of the
  PortMaster configuration to save.

* pmdial now returns a status of whether the dial was successful.  An
  exit of 0 means that the dial was successful, and an exit of -1 means
  that an error occurred.

* pmdial now accepts a configuration file of locations.  A location
  from this file must then be specified for dialing.

* pmdial now has a -x flag that displays all dial debug messages.
  This flag requires ComOS 3.8 or later.

* pmdumpfilter has been removed from the suite of PMTools.  This
  functionality can now be accessed with pmbackup.

* pmreset now has a -s flag that allows you to specify the slot
  number of a PortMaster 4.



_______________ Limitations

The following is a list of known limitations of PMTools 4.1b1:

* pmdial does not work with ComOS 4.0 or later because the idle timeout
  flag and some error messages are incompatible.

* pmbackup puts the "set isdn-msn off" command in the backup file.  
  The command produces an error on the PortMaster 3 and PortMaster 4
  that causes pmcommand to stop running.  Use the -nostop flag with
  pmcommand to prevent this problem.

* If you use pmbackup on a PortMaster running ComOS 3.7.2 or earlier,
  it incorrectly generates the following backup commands, which generate
  errors when the backup file is sent to a PortMaster.

  set call-check off
  set arp-proxy enable
  set reported-ip 0.0.0.0
  set C0 dtr_idle on

  The errors do not affect the rest of the commands or the PortMaster
  and can be ignored.

* If you are running pmcommand, you cannot use the version option when
  sending commands to a PortMaster.

* If you are running pmcommand on a Microsoft Windows system, you must
  enclose any multiword <Command> in double quotation marks -- for 
  example, "show table locations".

* If you are running pmupgrade on a Windows system, the -at flag must
  have the time enclosed in double quotation marks -- for example, 
  -at "4/30/98 10:00 AM".



_______________ Description of the PMTools

pmbackup	Backs up a PortMaster configuration to an ASCII file.
pmcommand	Sends commands to a PortMaster.
pmdial		Dials a location on a PortMaster.
pmreset		Resets a port on a PortMaster.
pmupgrade	Upgrades ComOS(R) on a PortMaster.

The following sections describe the options associated with each utility.
For backwards compatibility you can omit the "-h" and "-p" before
<Hostname> and <Password> if they are given as the first two arguments
and the <Username> is !root.


_______ pmbackup

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for the PortMaster.  The default is !root.
-version	Displays the version and date.
-help		Displays a list of options and a description of each.
-f <Filename>   Name of the file to store the backup.  If you do not
		specify a file, the backup information is displayed on
		standard output.
-bgp		Saves the BGP configuration.  Requires ComOS 3.9 or later.
-boards		Saves the board configurations on a PortMaster 4.
-choicenet	Saves the ChoiceNet(R) configuration.
-ethernets	Saves the Ethernet configuration.
-filters	Saves the filter table.
-global		Saves the global configuration.
-hosts		Saves the host table.
-lines		Saves the line configurations.
-locations	Saves the location table.
-maps		Saves the Network Address Translation (NAT) map table.
		Requires ComOS 3.9 or later.
-ospf		Saves the OSPF configuration.
-ports		Saves the port configurations.
-radius		Saves the RADIUS configuration.
-snmp		Saves the SNMP configuration.
-subinterfaces	Saves the subinterface table.
-users		Saves the user table.


_______ pmcommand

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for the PortMaster.  The default is !root.
-version	Displays the version and date.
-help		Displays a list of options and a description of each.
-f <Filename>   Name of a file with a list of commands to send to the
		PortMaster.
-v              When used with -f, displays verbose output to standard
		output, echoing each command.
-nostop         When used with -f, specifies that errors caused by a
		command do not stop the other commands from being
		carried out.
-noreboot       When used with -f, instructs pmcommand to ignore any
		reboot commands.  Setting this option might cause some
		commands to fail.
-prompt		When used with -f, instructs pmcommand to prompt you
		when it encounters a reboot command.
"<Command>"	A single command to be sent to the PortMaster.  If you
		are running pmcommand from Microsoft Windows, you must
		enclose the command in quotation marks.

If you do not specify a file or command, pmcommand enters interactive
mode, allowing you to type commands at a prompt.


_______ pmdial

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for the PortMaster. The default is !root.
-version	Displays the version and date.
-help		Displays a list of options and a description of each.
-t <Minutes>	Idle timeout for the current session.
-x		Displays the dial debug messages.
-f <Filename>   Specifies a file of locations.
<Location>	Name of the location to dial.


_______ pmreset

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for the PortMaster. The default is !root.
-version	Displays the version and date.
-help		Displays a list of options and a description of each.
-slot <0-9>	Specifies a slot number in a PortMaster 4.
"<Ports>"	Ports to reset.  A single port can be specified
		("s1"), a comma-separated list can be specified ("s1,s2"),
		a range can be specified ("s1-s4"), or any combination
		("s1,s4,s8-s12").


_______ pmupgrade

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for the PortMaster.  The default is !root.
-version	Displays the version and date.
-help		Displays a list of options and a description of each.
-r		Reboots the PortMaster after a successful upgrade.
-f <Filename>	ComOS image file to be used for the upgrade.
-at "Mon/Day/Year Hour:Min AM|PM"	Date and time at which you
		want the PortMaster to be upgraded.  Enclose the entire
		date and time in quotation marks.  Enter this option
		last if you include it.


_______________ System Requirements

PMTools are Java-based products that can run on any system with Java
Development Kit (JDK) or Java Runtime Environment (JRE) 1.1.4 or later
installed.  Nondevelopers can use the JRE rather than the JDK.
Currently, JDK 1.1 and JRE 1.1 are available on the following
platforms:

Windows NT 4.0		http://www.javasoft.com/products/jdk/1.1/
Windows 95		http://www.javasoft.com/products/jdk/1.1/
Solaris 2.5.1		http://www.javasoft.com/products/jdk/1.1/
Solaris x86 2.5.1	http://www.javasoft.com/products/jdk/1.1/
Linux 2.x		ftp://lagrange.la.asu.edu/pub/Linux_jdk/
FreeBSD			http://www.freebsd.org/java/
SGI IRIX 6.3		http://www.sgi.com/developers/devtools/
HP-UX 10.02		http://www.hp.com/esy/go/java.html
Digital Alpha UNIX 4.0	http://www.digital.com/java/download/
IBM AIX 4.1		http://www.ibm.com/java/tools/jdk.html
Other Platforms		http://java.sun.com/cgi-bin/java-ports.cgi



_______________ Installing the PMTools

1. Download the following file from the Lucent Remote Access FTP site as
   follows:

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

   - For Solaris (other than x86), enter
   get pmtools41b1_solaris.tar

   - For other UNIX systems, enter
   get pmtools41b1_unix.tar

   - For Windows, enter
   get pmtools41b1.zip

   quit

   PMTools are not available for the Macintosh because it has no
   command line interface to run them from.

2. For non-Solaris UNIX systems, define the path for jre/bin in the
   .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 is installed, change the PMTools scripts to use the java
   command instead of jre.

3.  Run the installation.

 * For Windows, unzip the pmtools41b1.zip file, run the
   pmtools_install.exe program, and follow the instructions.

 * For Solaris, enter the following command:

   tar xvf pmtools41b1_solaris.tar
   ./pmtools_install.bin

 * For other UNIX systems, enter the following commands.  You can
   replace /usr/local/lucent with any directory, which you should then
   add to your path.

  mkdir /usr/local/lucent
  mkdir /usr/local/lucent/pmtools
  mv pmtools41b1_unix.tar /usr/local/lucent/pmtools
  cd /usr/local/lucent/pmtools
  tar xvf pmtools41b1_unix.tar
  rm pmtools41b1_unix.tar
  ./setbits  # This will set the executable bits on the shell scripts.


_______________ Deinstallation

* On a Solaris or Windows system, an application called Uninstall_PMTools
  is placed in the lucent/pmtools directory.  Run this application to
  remove PMTools from your system.

* On other UNIX systems, remove the shell scripts and jar files to remove
  PMTools from your system.


_______________ Running the PMTools

For all platforms, to refer to the tools from outside their
installation directory, edit the scripts and insert the full path to
the jar file.  For example:

jre -cp /usr/local/lucent/pmtools/pmtools.jar PMCommand $*

* For UNIX systems (including Solaris), the installation creates a set
  of shell script files to run the PMTools.  Use these shell scripts to
  run the different applications of PMTools.

* For Windows users, the installation creates a set of batch files to
  run the PMTools.  If you reference these batch files in any other
  scripts, make sure that you use the CALL command.  For example,
  the following command calls the file version.bat:

  CALL pmcommand -h xxxxx -p xxxxxx "version"

NOTE:  If you are using a ChoiceNet server, make sure to increase the
maximum number of pmconsole ports to at least 2 and preferably 10 with
the "set maximum pmconsole" command.  PMVision uses this port for
communication, and if only one port is available then ChoiceNet cannot
send filters to the PortMaster.  To increase the number of pmconsole
ports, log in to your PortMaster through the console or a Telnet session
and type the following command:

 set maximum pmconsole 10



_______________ Your Comments

Send your questions, comments, and suggestions regarding this beta
software to pmc-feedback@livingston.com.  Mention that you are running
PMTools 4.1b1, 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.

________________________________________________________________________

	Copyright and Trademarks

Copyright 1999 Lucent Technologies. All rights reserved.

PortMaster, ComOS, and ChoiceNet are registered trademarks of Lucent
Technologies, Inc. RADIUS ABM, PMVision, IRX, and PortAuthority are
trademarks 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 Lucent Remote Access 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/.
 
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).

