2000/1/13

               ConsoleWizard 1.0p1 Release Note

ConsoleWizard is a configuration wizard for Lucent PortMaster(R) 2
products based on the Sun Microsystems Java Virtual Machine 1.1.6.
ConsoleWizard 1.0p1 is an unsupported pilot release available to any
Lucent customer at no charge. This version of ConsoleWizard works best
with the following ComOS(R) versions:

* ComOS 3.9 (in beta)
* ComOS 3.7.2

ConsoleWizard was designed to do the following:

* Provide a step-by-step process to configure a PortMaster 2
  as a reverse terminal
* Set the unit's IP address through an integrated BOOTP server
* Save the unit's configuration
* Be portable across operating systems

_______________ Contents

Disclaimer
Main Functions
System Requirements
Installation
Deinstallation
Running ConsoleWizard
Debug Log

______________ Disclaimer

Lucent Technologies is releasing ConsoleWizard on an unsupported basis
only and does not intend to fix bugs or make enhancements to the
ConsoleWizard application.

______________ Main Functions

ConsoleWizard allows you to configure a PortMaster 2 as a reverse
terminal server. This capability allows you to connect with the console
port of any PortMaster from a remote location to more easily administer
multiple PortMaster products at once.

Follow the screens and enter the information as appropriate. The online
help system will help you complete the fields required.

_______________ System Requirements

ConsoleWizard is a Java-based product that runs on any system with Java
Development Kit (JDK) or Java Runtime Environment (JRE) version 1.1.6
or later installed. Nondevelopers can use the JRE rather than the JDK.
Currently, JDK 1.1 and JRE 1.1 are available for the following and
other platforms at http://www.javasoft.com/products/jdk/1.1/:

*  Windows NT 4.0 
*  Windows 95 
*  Solaris 2.5.1  
*  Solaris x86 2.5.1 
*  Linux 2.x  
*  FreeBSD 
*  SGI IRIX 6.3
*  HP-UX 10.02
*  Alpha Digital UNIX 4.0
*  IBM AIX 4.1
*  Macintosh

_______________ Installation

To install the ConsoleWizard, follow these steps:

1. Download files from ftp.livingston.com 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 consolewizard10p1_solaris.tar

- For other UNIX systems, enter
get consolewizard10p1_unix.tar

- For Windows, enter
get consolewizard10p1.zip

- For Macintosh, enter
get consolewizard10p1.sit

quit

2. For UNIX systems only, define the path for jre/bin in your .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 has been installed, then change the consolewizard script to
use the java command instead of jre.

3. Run the installation.

- For Solaris, enter the following commands on the command line:

tar xvf consolewizard10p1_solaris.tar
./consolewizard_solaris_install

- For other UNIX systems, enter the following commands on the command
line, replacing /usr/local with your desired path:

mkdir /usr/local/lucent
mkdir /usr/local/lucent/consolewizard
cp consolewizard10p1_unix.tar /usr/local/lucent/consolewizard
cd /usr/local/lucent/consolewizard
tar xvf consolewizard10p1_unix.tar
rm consolewizard10p1_unix.tar

- For Windows, unzip the consolewizard10p1.zip file, run the
consolewizard_install.exe program, and follow its instructions.

- For Macintosh, unstuff the consolewizard10p1.sit file, run the
consolewizard_install program, and follow its instructions.

4. If you are using a ChoiceNet(R) server, increase to at least 2 and
preferably 10 the maximum number of connections allowed into the
PortMaster through TCP port 1643.

ConsoleWizard uses this port for communication. If only one port is
available, ChoiceNet cannot send filters to the PortMaster.

To increase the number of connections allowed through this port, log in
to your PortMaster through the console or a telnet session and type the
following commands:

set maximum pmconsole 10
save all

_______________ Deinstallation

* On a Solaris, Windows, or Macintosh system, an application called
  uninstall_consolewizard is placed in the Lucent/ConsoleWizard
  directory.  Run this application to remove ConsoleWizard from your
  system.

  On Solaris, if the local jre directory still exists after you run
  uninstall_ConsoleWizard, remove the directory with the command
  "rm -rf jre".

* On a UNIX system, remove the shell script and jar files to remove
  ConsoleWizard from your system.

_______________ Running ConsoleWizard 

* On a Windows NT system,  select the ConsoleWizard icon from the
  Lucent folder in your Start --> Programs menu.

* On UNIX systems (including Solaris), run ConsoleWizard by typing
  "consolewizard" when you are in the consolewizard installation
  directory.  If you have added the consolewizard installation
  directory to your PATH, you can run it from anywhere.

* On Macintosh systems, select the ConsoleWizard icon from the Apple
  menu.

_______________ Debug Log

When running ConsoleWizard, you can use the following debug options on
the command line:

-g <Debug level>
-l (specifies the local directory)

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 output than you can possibly stand

The -l option sends all debug output to the directory ConsoleWizard is
installed in.

By default, all debug output is sent to the Lucent/ConsoleWizard
directory created in your home directory. On UNIX machines, the default
works properly. However the concept of a home directory is not so clear
on PCs and seems to differ for each vendor's Virtual Machine. Try
looking for one of the following:

c:\java\Lucent\ConsoleWizard 
c:\users\<username>\Lucent\ConsoleWizard 
c:\windows\Lucent\ConsoleWizard 

If you still cannot find the directory that contains debug output,
select Find --> File and search for debuglog.txt.

________________________________________________________________________

Copyright and Trademarks

Copyright 2000 Lucent Technologies. All rights reserved.

PortMaster, ComOS, ChoiceNet, and NetCare are registered 
trademarks of Lucent Technologies. PMVision, IRX, and 
PortAuthority are trademarks of Lucent Technologies. All 
other marks are the property of their respective owners.

Notices

Lucent Technologies 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
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

Because ConsoleWizard is being released on an unsupported basis, do not
contact Lucent NetCare(R) Professional Services about technical support
for this product.
