FilterEditor 1.0 Release Note 1998/11/11 Introduction FilterEditor is a filter configuration application for PortMaster(R) products based on Sun's Java Virtual Machine 1.1.4. Version 1.0 of FilterEditor is available to any Lucent customer at no charge. FilterEditor was designed to do the following: - Be portable across operating systems - Read filters from and save filters to PortMaster products, configuration files, and ChoiceNet(R) filter files - Let you view and configure the list of rules in a filter - Let you edit a filter rule The FilterEditor provides a single document interface (SDI) panel with a list of the current filter rules at the top and a rule editor at the bottom. Contents FilterEditor Functions System Requirements Installing FilterEditor Running FilterEditor Limitations Technical Support FilterEditor Functions FilterEditor provides the following main functions: - Adding, deleting, and renaming filters - Adding, deleting, and reordering filter rules - Editing 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 Reading Filters The File menu lists the options for reading filters. - Open File opens the specified configuration file and reads all 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. Configuring Filters The Filters menu lists the options for configuring 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 displays a panel where you can specify the filter source, the filters to copy, and the destination sources. Configuring Filter Rules If a single filter rule is selected in the rule list, the rule's configuration appears 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 restores 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 rule number. - Move Down moves a contiguous selection of rules down by one rule number. 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 saves the filters of the currently selected source. - Save All saves the filters of all the open sources. - Export Filters to File saves the selected filters from the current source to a specified file. - Export Filter to ChoiceNet File saves the IP rules of the current filter to a ChoiceNet file. Back To TOP System Requirements FilterEditor is a Java-based product that can run on any system with JDK or JRE (Java Runtime Environment) 1.1.4 or later installed. Nondevelopers can use JRE rather than JDK. Currently, JDK 1.1 and JRE 1.1 are available for 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/Products/DevMagic/products/java.html - HP-UX 10.02 http://www.hp.com/esy/go/java.htmt - Alpha Digital Unix 4.0 http://www.digital.com/java/download - IBM AIX 4.1 http://www.ibm.com/java/tools/jdk.html - All other platforms http://java.sun.com/cgi-bin/java-ports.cgi Back To TOP Installing FilterEditor 1. Download files from the Lucent InterNetworking Systems 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, enter get filtereditor10_solaris.tar - For other UNIX systems, enter get filtereditor10_unix.tar - For Windows, enter get filtereditor10.zip quit 2. Make sure the path values are set properly: - For UNIX systems, define the path for jre1.1.4/bin in the .cshrc file. For example, if you install jre1.1.4 in the /usr/local/lib directory, the .cshrc file must have the following entry: set path=( /usr/local/lib/jre1.1.4/bin $path ) - For JRE or JDK 1.1.5 on Windows systems, installing JRE or JDK 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 Replace <JAVADIR> with the location where the JRE or JDK was installed. NOTE: If the JDK is installed instead of the JRE, the scripts must be edited. - For JRE or JDK 1.1.4 on Windows NT 4.0, define the path for jre1.1.4 or jdk1.1.4 in the System Environment as follows: Open the Control Panel. Click the System icon. Click the Environment. On the display window, highlight and click the line with the word Path. Enter the installation path of the JDK or JRE in the Value window, and click the Set button. Typically, the JDK or JRE is installed on C:\jdk1.1.4 or C:\jre1.1.4. In this case, the correct path for JDK and JRE is C:\jdk1.1.4\bin or C:\jre1.1.4\bin. 3. Run the installation: - For Solaris users, enter the following command on the command line: tar xvf filtereditor10_solaris.tar ./filtereditor_install.bin - For other UNIX users, enter the following commands on the command line: mkdir <bin>/Lucent mkdir <bin>/Lucent/FilterEditor cp filtereditor10_unix.tar <bin>/Lucent/FilterEditor cd <bin>/Lucent/FilterEditor tar xvf filtereditor10_unix.tar - For Windows users, unzip the filtereditor10.zip file, and run the filtereditor_install.exe program. Follow the instructions in the installation. Back To TOP Running FilterEditor On Windows NT or Windows 95 systems, select the FilterEditor icon from the Lucent folder in your Start, Programs menu. On UNIX systems, type "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 running FilterEditor, you can use the following options: -h <Hostname> -u <Username> -p <Password> -g <Debug level> -l (specifies the local directory) Use -h, -u, and -p together to force FilterEditor to log in to the specified PortMaster at startup. For example: filtereditor -h xxxxxx -u \!root -p xxxxx The -g <Debug level> option specifies the debug level. Valid debug level values 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 than you can possibly stand The -l option 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 default works properly. However, the concept of a home directory is not so clear on PCs and seems to differ for each vendor's Java Virtual Machine. Try looking for one of the following: c:\java\Lucent\FilterEditor c:\users\<username>\Lucent\FilterEditor c:\windows\Lucent\FilterEditor If you still cannot find the directory that contains the debug output, do a Find, File for debuglog.txt. Back To TOP Limitations in FilterEditor 1.0 - The scroll bar might not work correctly if you have JDK or JRE 1.1.3 or earlier. Use JDK or JRE 1.1.4 or later. - When FilterEditor is run under Motif or OpenWindows the following text might appear but does not indicate any runtime problems in FilterEditor. Warning: Name: scrollbar Class: XmScrollBar The scrollbar page increment is less than 1. Send your questions, comments, and suggestions regarding this software to support@livingston.com. Mention that you are running FilterEditor 1.0 and include the version of JDK or JRE that you are running, the operating system version ("uname -a" output), and the version of ComOS(R) on the PortMaster. The "About FilterEditor..." menu item in the Help menu displays the version of FilterEditor you are running, including the build date, debug level, and location of runtime debug files. Back To TOP Technical Support Copyrights and Trademarks Copyright 1998 Lucent Technologies, Inc. All rights reserved. PortMaster, ComOS, and ChoiceNet are registered trademarks of Lucent Technologies, Inc. RADIUS ABM, PMVision, and IRX 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 Technical Support Lucent Technologies InterNetworking Systems (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.0 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 InterNetworking Systems sales channel partner for technical support; see http://www.livingston.com/International/EMEA/distributors.htmt 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).