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 -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\\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.