1998/08/26

				FilterEditor 
		  Version 1.0b1 Beta Release Notes


		INTRODUCTION

FilterEditor is a filter configuration application for PortMaster
products based on Sun's Java Virtual Machine version 1.1.4.
Version 1.0b1 of the FilterEditor is available for open beta to any 
Lucent customer at no charge.

FilterEditor was designed with the following goals:

-  To enhance the portability of the product.  This goal has been met 
   with the use of the Java environment. 

-  To provide the ability to read filters from and save filters to
   various formats.  These formats are PortMaster products, configuration
   files and ChoiceNet filter files.  

-  To provide a mechanism for viewing and configuring the list of rules
   in a filter.

-  To provide a mechanism for editing a filter rule.

The FilterEditor presents the user with a single document interface (SDI)
style window, with a list of the current filter rules at the top and
a rule editor on the bottom.  

FilterEditor provides the following main functions:

-  Adding/Deleting/Renaming filters
-  Adding/Deleting/Reording filter rules.
-  Editing of a single filter rule.
-  Copying filters from one source to many sources.
-  Copying filter rules from one filter to many filters.
-  Reading filters from and saving filters to various formats.


		FILTEREDITOR FUNCTIONS

	READING OF FILTERS

The File menu lists the options for reading of filters.

-  Open File opens the specified configuration file and reads all of
   the filters.
-  Connect opens a connection window to connect to a PortMaster product.
-  Import ChoiceNet Filter opens the specified ChoiceNet file and adds
   the filter to the current source.


	CONFIGURATION OF FILTERS

The Filters menu lists the options for the configuration of filters.

-  New Filter creates a new filter with a specified name.
-  Rename Filter renames the current filter with the specified name.
-  Clone Filter creates an exact copy of the current filter with a new
   specified name.
-  Delete Filter deletes the current filter.
-  Copy Filters brings up a window where you can specify the filter
   source, which filters to copy and the destination sources.


	CONFIGURATION OF FILTER RULES

If a single filter rule is selected in the rule list, the rule's 
configuration will show up in the rule editor.  You can edit the
rule and select the "Apply Changes" button for the changes to be
reflected in the rule list.  The "Cancel Changes" button will restore
the rule to its configuration as represented in the rule list.

The row of buttons directly beneath the filter rule list provides most
of the rule configuration options.

-  Add Rule appends a new rule to the end of the rule list.
-  Delete Rule deletes the selected rules in the list.
-  Move Up moves a contiguous selection of rules up by one rulenumber.
-  Move Down moves a contiguous selection of rules down by one rulenumber.

Additionally, the Edit menu provides the ability to Cut, Copy and Paste
filter rules from one filter to another.


	SAVING FILTERS

The File menu provides the list of options for saving filters.
NOTE: Unlike PMVision, changes are not immediately applied to the source.

-  Save will save the filters of the currently selected source.
-  Save All will save the filters of all the open sources.
-  Export Filters to File will save the selected filters from the current
   source to a specified file.
-  Export Filter to ChoiceNet File will save the IP Rules of the current
   filter to a ChoiceNet file.


	SYSTEM REQUIREMENTS

FilterEditor 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 FILTEREDITOR

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

  ftp ftp.livingston.com
  binary
  cd pub/beta
  (for previous FilterEditor users)
  get filtereditor.jar.gz
  (for Solaris)
  get filtereditor10b1_solaris.tar
  (for other UNIX systems)
  get filtereditor10b1_unix.tar
  (for Windows)
  get filtereditor10b1.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%;<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 previous FilterEditor users, on the command line, enter the following
command:

  gunzip filtereditor.jar.gz

Then replace the old filtereditor.jar file in your installation directory
with the newer unzipped jar file.

For Solaris users, on the command line, enter the following command:

  tar xvf filtereditor10b1_solaris.tar
  ./filtereditor_install.bin

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

  mkdir <bin>/Lucent
  mkdir <bin>/Lucent/FilterEditor
  cp filtereditor10b1_unix.tar <bin>/Lucent/FilterEditor
  cd <bin>/Lucent/FilterEditor
  tar xvf filtereditor10b1_unix.tar

For Windows users, unzip the filtereditor10b1.zip file and run the
filtereditor_install.exe program.



	RUNNING FILTEREDITOR

For an NT system, you can select the FilterEditor icon from the Lucent folder 
in your Start, Programs menu.

For UNIX systems, You can run FilterEditor by typing filtereditor at your 
command tool window from the FilterEditor installation directory.  If you
add the FilterEditor installation directory to your PATH you can run
FilterEditor from anywhere.

When executing FilterEditor, you can use the following options:

-h <Hostname>
-u <Username>
-p <Password>
-g <Debug level>
-l for Use local directory

-h, -u, -p are used together to force FilterEditor to log into the specified
PortMaster at startup. 

For example:  filtereditor -h xxxxxx -u \!root -p xxxxx

-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 FilterEditor is installed in.  
By default all debug output is sent to the Lucent\FilterEditor 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\FilterEditor
c:\users\<username>\Lucent\FilterEditor
c:\windows\Lucent\FilterEditor

If you still can not figure out where things are going try doing a Find,
File for debuglog.txt.


	NEW FEATURES IN 1.0b1

This is the first public release.

	LIMITATIONS

Following is a list of the known limitations in FilterEditor Version 1.0b1:


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 FilterEditor is run under Motif or OpenWindows the following text may
be displayed. This does not cause any runtime problems in FilterEditor.  

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


Please send your questions, comments, and suggestions regarding
this beta software to pmc-feedback@livingston.com. Please mention that you
are running FilterEditor 1.0b1, 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 FilterEditor..." menu item in the Help menu will display the
version of FilterEditor 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 FilterEditor 1.0b1 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 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).

