ComOS 4.0 Release Note for PortMaster 41998/11/11IntroductionThe new Lucent InterNetworking Systems (formerly Livingston Enterprises) ComOS(R) 4.0 software release is now available for the PortMaster(R) 4 Integrated Access Concentrator. This release note applies only to the PortMaster 4. This release is provided at no charge to all Lucent customers. This release note documents commands and features added after the "PortMaster 4 Installation Guide" was printed. ComOS 4.0 is available for the PortMaster 4 only at this time and is not yet available for the other PortMaster products. You must use PMconsole(TM) 3.5.3 or PMVision(TM) 1.3b5 or later or pmupgrade from PMTools 4.0 or later when upgrading to ComOS 4.0. If you are running Microsoft Windows 95 or Windows NT 4.0, you must use PMVision 1.3b5 or later. You can also use the "tftp get comos" command and TFTP to upgrade. Read "Upgrade Instructions" thoroughly before upgrading. Use PMVision 1.3b5 or later when configuring ComOS 4.0.
Contents
New FeaturesThe following commands and features have been added in ComOS 4.0:
Command> ping 192.168.1.1 192.168.1.1 is alive - round trip=3 ms The PortMaster 4 can be booted from the network the same way as any PortMaster product, using the GENERIC.PM4 netboot image.
[Back to Top] PortMaster 4 ManagementMost commands are the same as for the PortMaster 3, with the following
new commands. See also "Changes to Other ComOS Commands."
To view and configure specific board information within the PortMaster 4, you set your view to the board and then use the standard PortMaster set, show, and debug commands. The default view is of the system manager, board 4. If your view is set to anything other than the default view, your current view is displayed in the command line prompt. If you set the view to a board that is not present, the command line interface reports that no board is present.
Setting a view on the PortMaster 4 allows you to set and show configurations for a given board. The command takes a slot number that corresponds to the number of the slot where the board is installed in the PortMaster 4 chassis. Setting the console after setting the view displays any console messages about that board to the administrative session.
If the view is set to slot 4, where the manager board is installed, all the boards are shown. A "set console" here displays all console messages from all the boards. Likewise, the show commands show information for all boards. When a view is set, the view number is displayed in the prompt -- except for the manager. When the view is set to the manager no view number is shown. The "save all" command saves all configuration settings for the entire chassis, regardless of what view is set.
The "set slot" command turns the power on or off for the board in the specified slot. Your view must be set to slot4 (the manager board) in order to use the "set slot" command.
In addition to turning the board on or off this command sets the autostart configuration. If a slot is set to off, the PortMaster 4 will not turn that board on. If the slot is set to on, the PortMaster 4 turns the board on if enough power is available. The "save all" command saves the autostart configuration. NOTE: Wait 3 seconds before turning on a board after turning it off. In the following example, a Quad T1 board is installed in slot 3. You can turn off the board with the "set slot3 off" command. Note that no space appears between "slot" and "3". If you enter "save all" with the slot configured to off, the slot 3 board does not turn on when the PortMaster 4 is booted.
This command restarts the board in the specified slot.
Slot_number Value from 0 to 16 representing a slot in the PortMaster 4. NOTE: Do not insert a space between the keyword "slot" and Slot_number. Resetting a board is the equivalent of soft-booting the board. No output is generated from this command.
The "show boards" command shows information about boards installed in the PortMaster 4. Think of the PortMaster 4 architecture as multiple distributed processors sharing resources across a 5 gigabit ATM cell backplane. Each board loads the portion of the ComOS operating system required to perform its specific function. All configuration information is stored in the flash file system on the system manager module. When a board is inserted into a slot, it loads the ComOS components it requires and any configuration data needed for its specific interfaces from the manager. If any board (except the manager board) in any slot is replaced with a new board of the same type, the new board uses the existing configuration for that slot from the manager. The "show boards" command shows the following information:
The board ID number. It corresponds to the slot number where the board is physically located.
The type of board. * "Quad T1" board contains four T1 line ports and 98 modems. * "Triple E1" board contains three E1 line ports and 98 modems. * "Manager" board contains a 10Mbps Ethernet connection and two asynchronous console ports. * "Ethernet" board contains a 10/100Mbps Ethernet connection.
The number of seconds since the last hello packet was received from the board. Hello packets are sent every 30 seconds, so any number greater than 30 indicates a problem.
* "Active" means the board is present and running normally. * "Board Present" means a board is detected but is turned off or not activated.
The version of ComOS running on the board. Each board runs its own copy of ComOS. The ComOS for every board is stored in the nonvolatile file system on the manager board and can be seen with the "show files" command.
The "show slots" command provides an overall view of the PortMaster 4 power sources, power budget, and fans. It also displays information about each slot. As each board turns on, it reports information to the manager board. This information includes board type, serial number, power requirements, and the hardware revision of the board. The PortMaster 4 detects its power source as AC or DC. For AC power it determines if a power supply in installed and if it is generating power. For each power supply that is active, 400 watts of power are added to the power budget. Similarly, if a power supply is removed, then 400 watts are removed from the power budget. If a power supply fails or is unplugged an SNMP alarm is generated. Before a board is turned on the PortMaster 4 determines how much power the board requires. If enough power is available in the budget the board is turned on. If not enough power is available the board is left turned off and an SNMP alarm is generated. If in the course of operation the PortMaster 4 has a drop in its power budget and cannot run all the boards it begins turning off boards until the power budget is balanced. Boards are turned off first by type, and then by slot number. Line boards (Quad T1 or Tri E1) are turned off first. The manager board and Ethernet board are never turned off due to power. High slot numbers are turned off before low slot numbers. The PortMaster 4 also monitors the status of its four fans. If a fan fails an SNMP alarm is generated. Fan loss does not directly cause a board to be turned off. The "show slots" command displays the following information:
For each slot, "show slots" displays:
Command> show slots AC Power: Top: Working Middle: Working Bottom: Working Max Power: 1200W, Allocated: 160W, Left: 1040W
The number, 0 through 9, of the physical slot where the board is installed. For daughterboards such as the Ethernet board (attached to the manager board), slot numbers are assigned starting at 10.
* ACTIVE means the board is present and running normally. * CONFIG means the board is not active. * PRESENT means a board has been detected. It has not been identified and no code has been loaded. * EMPTY means the slot contains no board. While the board is loading its ComOS image, "show slots" shows the board as active, but "show boards" does not display the board.
* "Quad T1" board contains four T1 line ports and 98 modems. * "Triple E1" board contains three E1 line ports and 98 modems. * "Manager" board contains a 10Mbps Ethernet connection and two asynchronous console ports. * "Ethernet" board contains a 10/100Mbps Ethernet connection.
The serial number of the board present in the slot. The manager cannot read its own serial number, so the word "Manager" is displayed instead. The serial EPROM (SEP) is found on each board and contains the type of board, the serial number of the board, the amount of power to be budgeted for the board, and the temperature for the board. If the SEP driver is unable to interpret the programmed information, it shows the board type as "UNKNOWN." The temperature works independently of the programmed portion of the EPROM and works whether the EPROM has been programmed or not.
The number of watts budgeted for the board. When the board is originally detected, the manager reads this information from the board itself. If for any reason this information is unavailable, the manager budgets 80 watts for the board.
The manager board turns off boards that are too warm due to lack of air flow or too warm an operating environment. If a board exceeds 45C, a warning message is generated in the form of an SNMP alarm. If heat exceeds 50C an SNMP alarm is generated and the board is turned off. The board then has to be turned on with the "set Slot0 on" command. Temperature is sampled from the boards every 10 seconds. The manager board never shuts down due to excessive heat. See the "show alarms" command in "SNMP Traps and Alarm Management" in the "ComOS 3.8 Release Note" for more information on alarms.
The board revision level.
The "show files" command displays the name and size in bytes of each
file stored in nonvolatile memory on the manager board:
The "show files verbose" command performs a consistency check on the ComOS nonvolatile file system and lists the results as seen in the following example. The check is also done when the PortMaster 4 boots.
The "show all" command on the PortMaster 4 no longer displays the
following information. Use the "show global" command for this
information:
The "show all" command now includes console port C1 information as well as information for C0 and all slots. The "show Ether0" and "show Ether1" commands now display local IP address, netmask, broadcast filter, and routing information.
The following commands are no longer global, but are configured on each
Quad T1 or Tri E1 board. To use the following commands you must first
set your view to the slot you want to configure.
To display these settings, use the "show global" command.
The "set S0 dlci" command has been removed for the PortMaster 4.
To configure Frame Relay DLCIs use the "add dlci" command instead,
as shown in the following example:
[Back to Top] L2TP LAC SupportThe Layer 2 Tunneling Protocol (L2TP) allows PPP frames to be tunneled across an IP network from one PortMaster that answers the call -- the L2TP access concentrator (LAC) -- to another PortMaster that processes the PPP frames -- the L2TP network server (LNS): end user--->incoming call--->LAC--->LNS--->network access A PortMaster running ComOS 4.0 can be a LAC. ComOS 4.1 will support both LAC and LNS on the PortMaster 4, and ComOS 3.9 will support LAC and LNS on the PortMaster 3. The following sequence of events takes place when you establish a typical L2TP session:
set l2tp-lac disable | enable
NOTE: You must issue the "save all" and "reboot" commands after issuing the "set l2tp-lac enable" command, before any L2TP sessions can be established.
Both LAC and LNS can use the same RADIUS server, or they can use separate servers. The LAC authenticates using call-check and responds with L2TP tunnel information. The LNS does RADIUS authentication using PAP or CHAP. To configure RADIUS for L2TP LAC support:
The first line contains the check items. This is a typical use of the call-check feature.
A user profile can be configured to contain redundant tunnel server endpoints. The LAC uses the first endpoint specified if the endpoint is running L2TP. Otherwise, the LAC tries the second endpoint, and then the third. Up to three redundant tunnel server endpoints can be specified. Any more than three are ignored by the LAC. The LAC's acceptance of a tunnel server endpoint is determined by whether the endpoint is running L2TP. An endpoint running L2TP but configured as a LAC will make the session fail because the L2TP tunnel cannot be terminated. The following example shows a RADIUS user profile using multiple redundant tunnel server endpoints. Each tunnel server endpoint is preceded by the tunnel medium type for that tunnel.
[Back to Top] Hardware DiagnosticsAn SNMP alarm is generated for the following conditions. The alarms can be viewed with the "show alarms" command. * When a board generates a warning due to excessive heat (45C). A warning is generated only when the temperature crosses the threshold. If the temperature continues to be greater than the threshold, additional alarms are not sent. If the temperature falls below the threshold and then exceeds it again, another alarm is generated. The temperature is sampled very 10 seconds. The manager board never shuts down due to heat. * When a board shuts down due to excessive heat (50C). * When any fan stops. Fans stopping do not trigger boards to be shut down. Only excessive heat or lack of power causes boards to be shut down. * When a power supply is unplugged. The PortMaster 4 can distinguish whether a power supply is unplugged or if it is pulled out. A power supply being pulled out is considered intentional and does not generate an alarm. * When a power supply fuse is blown. * When a power supply fails. * When a board is shut down due to lack of power. Each power supply generates 400 watts. If insufficient power is available, boards are turned off first by type, then by slot number. High slot numbers are turned off before low slot numbers. The manager board is never turned off due to lack of power. (But note that if there is no power, the manager board stops running, of course.)
The trap OID is iso.org.dod.internet.private.enterprises.307.2.1.1
The following traps are used (but are subject to change)
n, x, and y represent numbers.
Tips on Ether0 and Ether1The PortMaster 4 comes with two Ethernet ports: Ether0 and Ether1. Lucent recommends that Ether0 and Ether1 be connected to separate Ethernet segments. * Both Ether0 and Ether1 are fully routable ports.
* Ether0 and Ether1 have their own MAC (machine) addresses.
* During PPP/IPCP negotiation the PortMaster identifies itself using an IP address chosen according to the following priority:
For the time being: * At this time Lucent recommends using Ether1 if you use only one Ethernet port. * RADIUS packets leaving the PortMaster have a source IP address of Ether1, even if the packet exits through Ether0. [Back to Top] Frequently Asked QuestionsHere are some answers to frequently asked questions concerning the PortMaster 4. manager board refers to the System Management Module (manager board).
[Back to Top] Limitations* No support is provided for IPX. * No support is provided for Multichassis PPP (MCPPP). * No support for a redundant system manager board. Do not insert a second manager board into a PortMaster 4 running ComOS 4.0. * The "erase configuration", "erase comos", and "erase partition" commands must not be used. The configuration is now stored in files in subdirectories of the nonvolatile file system, not in partitions. * Dial-in and dial-out OSPF are not supported. * The "set M0 on|off" command is not supported. * The "reset D0" command is not supported. * The "show isdn" command is not supported. * When using a line board (Quad T1 or Tri E1) you must plug in any lines from the telephone company that use telephone company clocking into the lower line ports starting with line0. Lines that do not have telephone company clocking must be plugged into the higher line ports starting with line3 and counting down. The line board uses the clock signal of the first line port that comes up, starting with line0, for its transmit clock signal which is shared among all the line ports. If the frequency of the clock signal is shifted, as it is in the case of clock generated by non-telephone company sources, then analog modems encounter problems and might not answer calls. ISDN and hardwired connections are mostly immune to shifts in clock frequency. * Ethernet subinterfaces cannot be configured on Ether1. * To reset the Ether1 port you must use the "reset slot10" command, which reboots the Ethernet board connected to the manager board in slot4. You must use this command to activate any change in Ether1 configuration. * The RADIUS client on the PortMaster 4 always uses the Ether1 IP address as the source IP address in the IP header sent to the RADIUS server, even if the packet exits through Ether0. * RADIUS, traceroute, syslog, DNS, and other management packets leaving Ether0 have a source IP address of Ether1 if both Ether0 and Ether1 are configured. * The PortMaster 4 manager board reboots if an snmpwalk is done at the same time that BGP is loaded. * A ptrace dump works only on outbound traffic. * OSPF neighbor information is propagated as all zeroes when Ether0 has no IP address configured. To avoid this behavior, use the command "set ospf router-id >IP address of Ether1>". * If you change the assigned pool size on a line board (Quad T1 or Tri E1) the manager board must be rebooted to flush out the routing table. Dynamic pool routing information is put into the routing table maintained on the manager, that is then sent to each board (including the manager) in the form of forwarding tables. Resetting the line board is not sufficient because routes to the old dynamic pool still exist in the routing table. * The "show session" command sometimes displays an idle timer of 99 days from the manager board view. This problem usually clears after you issue the command a few times. * In some cases when the client terminal adapter (TA) is configured to dial an 11-digit telephone number, ISDN data-over-voice calls might fail to connect. To fix the problem, configure the client TA to dial a 7-digit telephone number when possible. Call Lucent InterNetworking Systems Technical Support if this does not resolve the issue. [Back to Top] Upgrade InstructionsWARNING! YOU MUST USE PMINSTALL VERSION 3.5.3 OR LATER TO PERFORM THIS UPGRADE! You can also perform this upgrade using PMVision 1.3b5 or later, or the pmupgrade from PMTools 4.0. You can also use the "tftp get comos" command and TFTP to upgrade.
Never interrupt the upgrade process, or loss of configuration information can result.
The installation software can be retrieved by FTP from
ftp://ftp.livingston.com/pub/le/software/System/Tarfile.tar.Z. Replace
System and Tarfile.tar.Z with the names of the files. You can retrieve
the upgrade image at the same time. The following example shows an
administrator retrieving pmupgrade and the PortMaster 4 upgrade image:
Follow the instructions in pmtools40.txt to install and run pmupgrade. PMconsole for the following operating systems can be found under ftp://ftp.livingston.com/pub/le/software/:
See ftp://ftp.livingston.com/pub/le/software/java/pmvision13b5.txt for installation instructions for PMVision 1.3b5. The following upgrade image is available at ftp://ftp.livingston.com/pub/le/upgrades/: [Back To Top]
Copyright and TrademarksCopyright 1998 Lucent Technologies. All rights reserved. Copyright 1998 Lucent Technologies. 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 Lucent InterNetworking Systems 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/. Specify that you are running ComOS 4.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.html. 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).
|