1998/06/23

			PMTools 4.0b2 Open Beta Release Note

	Introduction

The PMTools are a group of programs which supplement specific
functionality of PMVision.  These utilities are intended to be
incorporated into a user's suite of scripts for PortMaster management.



	Contents

Introduction
Description of PMTools
System Requirements
Installing the PMTools on UNIX Systems
Installing the PMTools on Win32 Systems
Limitations of the PMTools



	Description of PMTools

pmbackup	Backup a PortMaster configuration
pmcommand	Send commands to PortMaster
pmdial		Dial a location on a PortMaster
pmdumpfilter	Dump the filters from a PortMaster
pmreset		Reset a port on a PortMaster
pmupgrade	Upgrade the ComOs on a PortMaster

The following describes the flags associated with each utility.
The "-h" and "-p" portions of the <Hostname> and <Password> arguments may
be omitted for backwards compatability if the <Username> is !root and if
specified as the first two arguments.


	pmbackup

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for PortMaster, default is !root.
-version	Displays the build version and date.
-help		Displays a listing of flags and description of each.
-f <Filename>	Name of file to store backup.  If a file is not
		specified, then the backup information is printed on
		stdout.


	pmcommand

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for PortMaster, default is !root.
-version	Displays the build version and date.
-help		Displays a listing of flags and description of each.
-f <Filename>	Name of file with listing of commands to send to the PortMaster.
-v		Specifies verbose output, each command is echoed to stdout.
		Can only be used in combination with the -f flag.
-nostop         Specifies that errors caused by the commmands does not
		stop execution of the rest of the commands.  Can only be
		used in combination with the -f flag.
-noreboot       Specifies that reboot commands are ignored.  Setting
		this flag may cause commands to fail. Can only be used
		in combination with the -f flag.
-prompt		Specifies that reboots are prompted.  If a reboot command
		is encountered in the file, then pmcmmand will ask
		the user if he wants to reboot the PortMaster.  Can
		only be used in combination with the -f flag.
"command"	A command to be sent to the PortMaster.  If running from
		Windows, the command must be enclosed with quotes.

If neither a file or command is specified, pmcommand goes into
interactive mode where the user can type commands at a prompt.


	pmdial

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for PortMaster, default is !root.
-version	Displays the build version and date.
-help		Displays a listing of flags and description of each.
-t <Minutes>	Specifies an idle timeout for the current session.
-v		Specifies verbose output.
<Location>	Name of the location to dial


	pmdumpfilter

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for PortMaster, default is !root.
-version	Displays the build version and date.
-help		Displays a listing of flags and description of each.
-toc		Displays a listing of the filter names.
-filter "<Filterlist>"	A comma separated list of filters to be dumped.
		(for example "filter1,filter2").  If this flag is not
		specified, all the filters are dumped.


	pmreset

-h <Hostname>	PortMaster address.
-p <Password>	Password for the PortMaster.
-u <Username>	Username for PortMaster, default is !root.
-version	Displays the build version and date.
-help		Displays a listing of flags and description of each.
"<Ports>"	Specifies 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 PortMaster, default is !root.
-version	Displays the build version and date.
-help		Displays a listing of flags and description of each.
-r		Specifies that the PortMaster be rebooted after a
		successful upgrade.
-f <Filename>	Specifies the ComOS image file.
-at "mon/day/year hour:min AM/PM" : Specifies the time at which the
		PortMaster will be upgraded.  If this argument is 
		present it must come after any other arguments.


		System Requirements

The PMTools are written in Java and run on any platform that supports
Java Development Kit (JDK) or Java Runtime Environment (JRE) 1.1.4 or
higher.  JDK 1.1.4 or JRE 1.1.4 or a higher release is available for
the following platforms and  operating systems:

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/Products/DevMagic/products/java.html
HP/UX 10.02		http://www.hp.com/esy/go/java.html
DEC Alpha 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
   binary
   cd pub/le/software/java
   get pmtools40b2_solaris.tar	(for Solaris)
   get pmtools40b2_unix.tar	(for other UNIX systems)
   get pmtools40b2.zip		(for Windows)
   quit

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 JRE 1.1.5 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%;<JAVADIR>\bin

where <JAVADIR> 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 pmtools40b2_solaris.tar
  ./pmtools_install.bin

For other UNIX users, on the command line, enter the following command:

  tar xvf pmtools40b2_unix.tar
  jre -cp pmvision_install.zip install

For Windows users, unzip the pmtools40b2.zip file and run the
pmtools_install.exe program.

Follow the instructions of the installation.

4.  Running the tools.

For Solaris and other UNIX users, the installation creates a set
of shell scripts to run the PMTools.  Make sure that the executable
bit is set for each of these scripts; for example "chmod +x pmcommand".

For Windows users, the installation creates a set of batch files to
run the PMTools.  If you are referencing these batch files in any
other scripts, make sure that you use the CALL command.  For example:

The file version.bat:

CALL pmcommand -h xxxxx -p xxxxxx "version"



               Limitations in PMTools 4.0b2

	pmbackup

On a PortMaster with a ComOS release earlier than 3.8, the following
backup commands are incorrectly generated:

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


	pmcommand

On a PortMaster with ComOS release earlier than 3.8, the following
commands from a backup file get sent to the PortMaster and generate errors.

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.

On Windows systems, if the <Command> is more than one word, it needs
to be enclosed in double quotes.  For example, "show table locations".


	pmupgrade

On Windows systems, the -at flag needs to have the time enclosed in
double quotes, for example: -at "4/30/98 10:00 AM".


________________________________________________________________________

	Copyright and Trademarks

Copyright 1998 Lucent Technologies. 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 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 6 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).
