[Top] [Table Of Contents] [Prev] [Next] [Index]
5 out of 25 total pages
 

PortMaster 4 Management Commands   2

  This chapter describes the commands you use to manage the PortMaster 4, to access the boards installed in the slots of the PortMaster 4 for configuration, and to display general information about boards and slots. The PortMaster 4 runs on ComOS releases 4.0 and later.

  Note ¯ After making any configuration changes to a PortMaster 4 slot, you must use the reset slot Slotnumber  command for the changes to take effect.

  Table 2-1 lists commands for managing the PortMaster 4. Definitions of general administration commands and show  commands follow the table. For debug commands and other show  command definitions, see the pages indicated in the table.

  Table 2-1 PortMaster 4 Management Commands 

 
  Command Syntax     

  !!

 - see page 2-4

  copy Subdirectory/Filename(source) Subdirectory/Filename(destination)

 - see page 2-4
 dial Locname [-x]  - see page 2-6
 done, quit, exit  - see page 2-7
 erase all-flash  - see page 2-7
 erase file String  - see page 2-7
 help [CommandName]  - see page 2-8
 ifconfig [Interface] [address Ipaddress] [netmask Ipmask]
[destination Ipaddress(dest)] [ipxnet Ipxnetwork]
[ipxframe ethernet_802.2|ethernet_802.3|ethernet_802.2_ii|ethernet_ii]
[up] [down] [private] [-private] 		 - see page 2-9
 ping [Ipaddress]  - see page 2-10
 ptrace [Filtername|Filtername extended|dump Bytes]  - see page 2-11
 reboot  - see page 2-13
 reset all|C0|S0|W1|console|dialer|nic|nHandle|dNumber|
ospf|bgp|slotSlotnumber 		 - see page 2-13
 rlogin Ipaddress  - see page 2-15
 save all|global|console|filter|host|location|
netmask|ports|route|snmp|user|ospf|bgp 		 - see page 2-15
 set console C0  - see page 2-16
 set debug clock on|off  - see page 14-6
 set debug Hex|off  - see page 14-6

  set debug comport on|off S0

 - see page 14-4

  set debug flash on|off

 - see page 14-5
 set debug mdp-status|mdp-events|mdp-max on|off  - see page 14-9

  set slotSlotnumber on|off

 - see page 2-17
 set sysname [String]  - see page 2-18

  set view Slotnumber

 - see page 2-18
 show all [String]  - see page 2-19
 show arp Interface  - see page 2-21
 show bgp memory  - see page 9-31
 show bgp next-hop  - see page 9-32
 show bgp paths [Prefix/NM [verbose]]  - see page 9-33
 show bgp peers [verbose|packets]  - see page 9-36
 show bgp policy [Policyname]  - see page 9-40
 show bgp summarization [all]  - see page 9-41

  show boards

 - see page 2-22
 show bootlog  - see page 2-23
 show Ether0  - see page 4-12

  show files [verbose]

 - see page 2-25
 show filter Filtername  - see page 12-18
 show global  - see page 2-28
 show ipxroutes  - see page 7-23
 show isdn [dNumber|S0]  - see page 15-20
 show Line0  - see page 15-21
 show location Locname  - see page 11-21
 show M0  - see page 15-23
 show memory  - see page 2-32
 show modems [String]  - see page 15-24
 show modem ModemName(short)  - see page 5-39
 show modules  - see page 2-33
 show netconns  - see page 2-33
 show netstat  - see page 2-34
 show ospf areas  - see page 8-15
 show ospf links [router|network|summary|external|nssa]  - see page 8-18
 show ospf neighbor  - see page 8-20
 show propagation  - see page 7-24
 show routes [String|Prefix/NM]  - see page 7-24,
page 8-22,
page 9-42
 show route to-dest Ipaddress  - see page 7-26
 show S0  - see page 2-36
 show sap  - see page 2-38
 show sessions  - see page 2-39

  show slots

 - see page 2-40
 show syslog  - see page 2-43
 show table filter|host|location|modem|netmask|snmp|user  - see page 2-43
 show user Username  - see page 10-19
 show W1  - see page 6-17
 telnet Ipaddress [Tport]  - see page 2-44
 tftp get [comos|config|nostop] Ipaddress String  - see page 2-45
 traceroute [Ipaddress]  - see page 2-46
 version  - see page 2-46
 

       PortMaster 4 Management Commands

  ComOS releases 4.0 and later support the following management commands for the PortMaster 4.
 

       !!

  This command repeats the previous command.

  !!

  You can also enter !! and a keyword such as when using the help  command.  See the examples on page 2-8.
  help - page 2-8
 

       copy

  This command copies files from one directory to another in the nonvolatile file system.

  copy /Subdirectory/Filename(source) /Subdirectory/Filename(destination)

 
 Subdirectory  Path to the file.
 Filename(source)  Name of the file to be copied. Filenames and directories cannot exceed 16 characters.
 Filename(destination)  Name to give the copied file. Filenames and directories cannot exceed 16 characters.

  The manager board's nonvolatile RAM file system has a shared directory and directories for each board in the PortMaster 4.
  Use the copy command to copy files between the subdirectories in the PortMaster 4 or to copy files in the same directory. To verify that you have successfully copied files, use the show files command before and after using the copy  command.

  Note ¯ Entire subdirectories cannot be copied.

  This example copies the SNMP file from the directory of the manager board to the shared directory. The copied file is highlighted in this example.
 
 Command> show files
 File Name  Length
 ----------------------------
 ComOS-pm4  525602
 /manager  
 confdata  2812
 snmp  65
 /shared  
 global  324
 lan  293908
 m2c_1.2a  73214
 m2d_1.2a  131072
 quadt1  327452
 /slot10  
 confdata  124
   -------------
 Total  1373437
 
 Command> copy /manager/snmp /shared/snmp2
 Command> show files
 File Name  Length
 ----------------------------
 ComOS-pm4  525602
 /manager  
 confdata  2812
 snmp  65
 /shared  
 global  324
 lan  293908
 m2c_1.2a  73214
 m2d_1.2a  131072
 quadt1  327452
 snmp2  65
 /slot10  
 confdata  124
   -------------
 Total  1373437
  show files - page 2-25
 

       dial

  This command initiates dialing to a network location.

  dial Locname [-x]

 
 Locname  Name of location to dial.
 -x  Displays send and expect strings during dialing. Also resets some debugging values previously set with set debug .

  This command is useful when you are testing a location configuration. Set the location to manual , set the console, and initiate a connection to a remote location using the dial  command. You can watch the connection process to ensure that location-specific parameters are configured correctly.
  Command> dial loc1 -x
 Starting dial to location loc1 using S1
send them (atdt5551212\r)
expect (CONNECT)
atdt5551212\r\r\nCONNECTgot it
send them (\r)
expect (Login:)
38400\r\n\r\n\r\nserver login:got it
send them (john\r)
expect (ssword:)
john\r\nPassword:got it
send them (jogrtheyz\r)
expect (PPP)
\r\nPPPgot it
Chat Succeeded - Starting PPP
LCP IPCP Open
Connection Succeeded
 

       done, quit, or exit

  These commands exit the command line interface.

  done
quit
exit

  When you use these commands, the connection from your PC or terminal to the PortMaster is terminated. Depending on the PC or terminal software, a message usually appears to let you know that the connection to the PortMaster is lost.
  Command> quit
Goodbye...
 

       erase

  This command erases all or part of the nonvolatile RAM in the PortMaster 4.

  erase all-flash|file String

 
 all-flash  Erases all the nonvolatile RAM in the PortMaster 4, including ComOS.
 file  Erases a specified file from nonvolatile RAM.
 String  The name of the file to be erased; see show files  on page 2-25 for filenames.

  The erasure can take up to a minute to finish; wait until the erasure is complete before issuing any other commands.
 

       help

  These commands provide online help for the PortMaster 4 commands.

  help [CommandName]

 
 CommandName  One of the general commands listed in Table 2-1 on page 2-1.

  If you type the help  command without a command name, the online help shows a list of valid keywords, with descriptions. If you include a command name, a description or secondary keyword with description is shown.
  ComOS releases 3.8 and later support context-sensitive help. Entering a question mark (?) at any point in the command line and pressing Return generates a list of keywords or values that can be entered at that point.
  Examples 

 

 
 Command> help      
 add  - Add entry to table  ptrace  - Trace packet traffic
 attach  - Connect direct to port  quit|exit  - Quit Console
 delete  - Remove entry from table  reboot  - Restart the system
 dial  - dial to a location  reset  - Reset session/port
 erase  - Erase element of FLASH  rlogin  - Establish rlogin session
 help  - list available commands  save  - Save current config
 ifconfig  - View/configure interface  set  - Set configuration
 ip|ipx  - Sets the environment  show  - Show configuration
 max pmconsole  - Pmconsole session limit#  telnet  - Establish Telnet session
 tftp  - Transfer file from host  ping  - Send ICMP packet to Dest
 traceroute  - Use ICMP to detect route  pmlogin  - Establish PMD session
 version  - Display ComOS version  !!  - Repeat last command

  Command> help add
 Valid add commands are:
filter - Add a new packet or access filter
host - Add a host to the local hosts table
ipxroute - Add an IPX route to the static routing table
route - Add a route to the static routing table
location - Add a new Dialnet dial-out location
snmphost - Add a host to the SNMP access list
netuser - Add a SLIP or PPP user to the password table
user - Add a login user to the password table

 

 

  Command> set snmp? 

  ON OFf Readcommunity Writecommunity

 

  Command>!! readcommunity? 

  set snmp readcommunity?

  string256 NONE <CR>

 

  Command>!! public 

  set snmp readcommunity public

  SNMP read community changed to: public

 

       ifconfig

  This command displays configuration values for all interfaces.

  Note ¯ Enter this command on one line, without any breaks. The line breaks shown here are due to the limited space available.

  ifconfig [Interface] [address Ipaddress] [netmask Ipmask]
[destination Ipaddress(dest)] [ipxnet Ipxnetwork]
[ipxframe ethernet_802.2|ethernet_802.3|ethernet_802.2_ii|ethernet_ii]
[up] [down] [private [-private]

 
 
 Interface  Interface specification--for example, ether0 , frm1 , frmw1 .
 Ipaddress  IP address of the interface.
 Ipmask  Netmask for the interface IP address.
 Ipaddress(dest)  IP address of the destination of a point-to-point connection.
 Ipxnetwork  IPX network number of the interface.
 ipxframe  Frame type used for sending IPX packets out of the Ethernet interface. Options include the four protocols that follow.
 ethernet_802.2  Uses the Ethernet 802.2 protocol. This is the default encapsulation used by Novell NetWare Version 4.0.
 ethernet_802.3  Uses the Ethernet 802.3 protocol. This is the default encapsulation used by Novell NetWare Version 3.11.
 ethernet_802.2_ii  Uses the Ethernet 802.2_ii protocol. This encapsulation is not commonly used.
 ethernet_ii  Uses the Ethernet II protocol. This is sometimes used for networks that handle both TCP/IP and IPX traffic.
 up  Brings up the interface.
 down  Shuts down the interface.
 private  Prevents routing information from being transmitted on this interface.
 -private  Enables routing information to be broadcast on this interface by the Routing Information Protocol (RIP).
  The ifconfig command allows you to view the active configuration of all network interfaces. You cannot use ifconfig  to make configuration changes on ComOS 4.0 and ComOS 4.1.
 

  Note ¯ The PortMaster 4 supports IPX protocols on ComOS releases 4.1 and later.

 
 

       ping

  This command sends Internet Control Message Protocol (ICMP) echo request packets to the target, and listens for an ICMP echo reply.

  ping [Ipaddress]

 
 Ipaddress  IP address or hostname of host to ping.

  Ping is the basic connectivity test for network debugging. Because it uses the source IP address of the interface the packet leaves (except when a ping packet leaves a port or an interface that is not IP numbered), ping  also displays the IP address of a host name. On a PortMaster 4, the output also displays the elapsed time for the ICMP reply.
  To stop the process, type the ping  command with no argument.
 

       ptrace

  This command is used for debugging purposes and allows you to see packet information as it passes through the PortMaster. Filters are used to define which packets you want to display.

  ptrace [Filtername|Filtername  extended|dump Bytes 

 
 Filtername  Name of the filter defining which packets to display.
 extended  Displays the name of the interface through which the packets are passing, in addition to the packets defined by the filter.
 dump  Provides a raw hexadecimal dump of the contents of an Ethernet frame for any packet specified.
 Bytes   Number of bytes in the hex dump--between 0 and 1514.
]

  For more information about filters, see "Filter Commands" on page 12-3.
  Packets permitted by the filter are displayed. The ptrace  command does not display ICMP or UDP packets originating on the PortMaster itself.
  To stop the ptrace  process, issue the command without any arguments.

  Caution ¯ When debugging from a Telnet session, be very careful not to use ptrace  on  Telnet packets going between the PortMaster and the host from which you are using Telnet. Doing so can create an endless loop of messages.

  show table filter - page 12-18
 

       reboot

  This command restarts the software using the currently saved configuration.

  reboot

  You must reboot the system manager card for a changed IP address, IPX address, or ISDN switch type to take effect, or for an upgrade loaded earlier into nonvolatile RAM to be used.

  Note ¯ Rebooting performs a software restart that takes approximately 30 seconds. This process resets all active ports to their saved configurations, disconnecting all active sessions. Any changes made since a save  command was last issued are lost when you reboot, unless you first save them.

 

       reset

  This command shuts down and immediately restarts a physical or virtual port or all ports on the PortMaster 4.

  Note ¯ After making any changes to port configuration, you must reset PortMaster ports to make the changes take effect.

  reset all|C0|S0|W1|console|dialer|nic|nHandle|dNumber|propagation
|ospf|bgp|slotSlotnumber

 
 all  Resets all ports.
 C0  Any asynchronous port. Resetting an asynchronous port causes the Data Terminal Ready (DTR) signal to be held low for 500ms, then keeps DTR down for 10 seconds or until the Data Carrier Detect (DCD) signal drops, whichever occurs first.
 S0  Any ISDN primary rate interface.
 W1  Any synchronous WAN port.
 console  Removes the current console setting, if any.
 dialer  Checks all active interfaces against the location table and creates, destroys, or times out interfaces as needed. This command manually initiates a reset that is normally a background process.
 nic  Resets the network interface card (NIC) controller.
 nHandle  Network identifier. Enter this value as n  immediately followed (no space) by a number from the first column of the show netconns  output. See page 2-33 for an example display.
 dNumber  ISDN channel.
 ospf  See page 8-5.
 bgp  See page 9-8.
 slot Slotnumber   Resets a board in a specified slot--physical or virtual. Table 2-2 lists the slots in the PortMaster 4. No output is generated from this command.  Slotnumber  is an integer between 0 and 16.
 propagation  See page 7-5.

  Ports are reset automatically when a connection drops. You can reset specific asynchronous or synchronous ports, or all ports, by selecting the appropriate keyword.
 

       rlogin

  This command is used for debugging purposes to establish a remote login from the PortMaster to a host.

  rlogin Ipaddress

 
 Ipaddress  IP address or hostname.

  Rlogin is a method for logging in to a remote machine from a workstation. Once the login and password procedures are complete, a session is started on the host.
  telnet - page 2-44
 

       save

  This command saves configuration information to the nonvolatile memory of the PortMaster 4, regardless of what view is set.

  Note ¯ You must use the command save ports  to save changes made to any port.

 

  save all|global|console|filter|host|location|netmask|
ports|route|snmp|user|ospf|bgp

 
 all  All configuration changes.  
 global  Global configuration changes.  See Chapter 3.
 console  Console port setting.  See page 2-16.
 filter  Filter configuration changes.  See Chapter 12.
 host  Host table settings.  See Chapter 13.
 location  Location table settings.  See Chapter 11.
 netmask  Netmask table settings.  See Chapter 7.
 ports  All ports.  
 route  Static route table settings.  See Chapter 7.
 snmp  SNMP table settings.  See Chapter 3.
 user  User table settings.  See Chapter 10.
 ospf  OSPF configuration.  See Chapter 8.
 bgp  BGP configuration.  See Chapter 9.

  After making changes to configuration parameters or tables, you can save the changes individually using the save  command with a specific keyword, or you can use the save all  command to save all changes. Some configuration changes require that you reboot before the changes become effective, as noted in individual chapters and command descriptions. To save changes made to any port, use the save ports  command.
 

       set console

  This command sets the port as the PortMaster system console so that system messages sent to this port can be displayed on an attached device such as a terminal.

  set console C0

 
 C0  Console port.

  If no port is specified, the current connection becomes the console. The command reset console  removes the console, and save console  saves the console setting to nonvolatile RAM.
 

       set slot

  This command turns the power on or off for a specific slot.

  set slotSlotnumber on|off

 
 Slotnumber  Integer between 0 and 9 that identifies a physical slot in the PortMaster 4 chassis. Leave no space between the keyword slot  and the slot number. See Table 2-2 on page 2-14 for slot number values.
 on  Turns on the board or module in the specified slot.
 off  Turns off the board or module in the specified slot, except slot number 4, the manager module.

  Use the set slot  Slotnumber  off  command before removing or inserting a board or module into a slot of the PortMaster 4. Entering save all  after setting a slot on or off sets the autostart configuration for that slot.

  Note ¯ Before turning off a board or module, you must first save all.  After turning a board or module off, wait 3 seconds before turning it back on.

 
 

       set sysname

  This command sets the name used for the SNMP system name, IPX Service Advertising Protocol (SAP), Challenge Handshake Authentication Protocol (CHAP), and the command prompt.

  set sysname [String

 
 String  Name of up to 16 characters. No default.
]

  The command prompt displays the system name instead of Command  on a PortMaster that has the system name set. To remove a system name, enter the command without any arguments.
 

       set view

  This command provides configuration access to the specified slot and displays its status.

  set view Slotnumber

 
 Slotnumber  Integer between 0 and 16 that identifies a physical or virtual slot in the PortMaster 4. See Table 2-2 on page 2-14 for slot number values.

  Setting the view to a slot allows you to configure or display the status of a board or module in the slot. Entering set console  after setting this view displays console messages for this board only. The view number appears in the command prompt.
  Setting the view to slot 4, the slot containing the manager module, allows you to configure and display the status individual boards installed in the PortMaster 4. Similarly, entering set console  from the manager view displays console messages for all boards. No view number appears in the prompt for the manager view, which is the default view.
  Setting the view to a virtual slot lets you configure the board assigned to that slot--the Ethernet board in the manager module is assigned to slot 10, for example. However, you can also configure the Ethernet boards from any view.

  Note ¯ The save all command saves the configuration for the entire chassis regardless of what view is set.

  Command 2> set view 5

  View changed from 2 to 5

  Command 5>

 

 

       show all

  This command shows a summary status of all ports on the PortMaster 4, or of all ports on a particular board or module if the view is set to its slot.

  show all [String]

 
 all  Shows the summary of the ports of the board or module occupying the specified slot.  If the view is set to the manager module, shows a summary of all the ports.
  String  Displays information matching the specified string when the view is set to the manager module.

  The following example is from the manager module of a PortMaster 4. In this example, only two slots are active, slot 0 and slot 1.
  If your view is set to a board or module other than the manager module, the output displays port information only for the selected line board.
 
 Command> show all
 C0  9600  off    Login  COMMAND  356  29969  0
 C1  115200  off    Login  USERNAME  0  1321  0
 *************Slot 0*****************
 Port  Speed  Mdm  Host  Type  Status  Input  Output  Pend
 ----  -----  ----  --------  --------  -----------  -------  --------  ----
 S0  28800  M2  server  Login/  COMMAND  1126499  4734323  0
 S1  28800  M1  -  Device  ESTABLISHED  912355  3707007  0
 S2  64000  on  ptp49  Netwrk  ESTABLISHED  783691  874518  0
 S3  64000  on  server  Netwrk  CONNECTING  63057187  64106116  0
 S4  64000  on  server  Login/  IDLE  99463  789349  0
 .                
 .                
 .                
 S96  9600  OFF    Login/  NO-SERVICE  0  0  0
 *************Slot 1*****************
 Port  Speed  Mdm  Host  Type  Status  Input  Output  Pend
 ----  -----  ----  --------  --------  -----------  -------  --------  ----
 S0  9600  OFF    Login/  NO-SERVICE  0  0  0
 S1  9600  OFF    Login/  NO-SERVICE  0  0  0
 S2  9600  OFF    Login/  NO-SERVICE  0  0  0
 S3  9600  OFF    Login/  NO-SERVICE  0  0  0
 S4  9600  OFF    Login/  NO-SERVICE  0  0  0
 .                
 .                
 .                
 S96  9600  OFF    Login/  NO-SERVICE  0  0  0
 

       show arp

  This command shows ARP tables for the specified Ethernet or Frame Relay interface.

  show arp Interface

 
 Interface  The interface specification--for example, ether0 , frm1 , or frmw1 . Use the command ifconfig to obtain a list of available interfaces.

  For Ethernet interfaces, the output shows the mapping from IP address to media access control (MAC) address in the ARP cache.
  For Frame Relay, the output shows the mapping from IP address to data link connection identifier (DLCI), and includes the Q.922 value for the DLCI.
 

       show boards

  This command displays general information about the boards installed in the PortMaster 4.

  show boards

  Use the show boards command to display the status of all boards in the PortMaster 4. The PortMaster 4 stores configuration files for a board in a subdirectory named after the slot number the board occupies. If you move a board from one slot to another, and turn on the board, the board uses the configuration stored for the new slot, allowing you to replace a failed board without re-entering configuration information.
  The output of this command is the same from any view.
 

       show bootlog

  This command saves reboot information and stack traces of the boards and modules to a boot log file.

  show bootlog

  The PortMaster 4 supports this command on ComOS 4.1 and later releases.
  Use this command to capture reboot information without using a console. The PortMaster 4 reserves a portion of its memory to store stack traces and the last process ID. The boot log is stored in the nonvolatile RAM file system in a file named bootlog , a circular buffer up to 64KB in length.
  When a board in the PortMaster 4 reboots, it checks for information in the reserved area and sends it to the boot log and the console, if configured. This portion of memory is not overwritten at boot time so this information can be preserved. To erase boot log information, use the erase file bootlog command.
  To translate the last process and stack trace data, send the information to Lucent InterNetworking Systems technical support.
  The information that is stored in the boot log consists of the following:
 
 Time Stamp  Time elapsed since the board was last rebooted.
 Slot  Slot where the reboot occurred.
 Description  Indicates if the unit was powered on, soft booted, or crashed.  If a crash occured, the stack trace is displayed.  If a softboot and crash occurred, the last process is displayed.
 
  Command> show bootlog
[000:00:00:00:25] Slot4 - Power On
[000:00:00:42:65] Slot3 - Power On
[000:00:00:00:25] Slot4 - Soft Boot - Last Process 0x138b30
[000:00:00:42:65] Slot3 - Power On
[000:04:26:49:10] Slot3 - Crash Boot - Last Proc 0x158264 - Trace:
1bb727 (8 202 32a6ac 22c068)
1414aa (1 0 626 0)
134787 (32c5a4 32a6ac 22c068 1fb830)
118371 (32c5a4 2052e822 0 0)
117e12 (32c5a4 1db070 330fa4 2052e822)
14f5b4 (330fa4 1db070 228 800)
14d2c2 (1db070 228 1063 2c00)
158351 (2422f0 40 ffff000 1)
1bdb51 (1f4 10cdb7 0 0)
10cded (0 0 0 0)
[000:05:36:35:25] Slot3 - Crash Boot - Last Proc 0x158264 - Trace:
1bb727 (8 202 327a8c 22adb8)
1414b0 (0 0 626 0)
134787 (33041c 327a8c 22adb8 1fb830)
118371 (33041c 2053c822 0 0)
117e12 (33041c 1db070 3310a0 2053c822)
14f5b4 (3310a0 1db070 228 800)
14d2c2 (1db070 228 1063 2c00)
158351 (2422f0 40 ffff000 0)
1bdb51 (1f4 10cdb7 0 0)
10cded (0 0 0 0)
 

       show files

  This command shows the files in the nonvolatile directories of the manager board and optionally performs a check on them.

  show files [verbose]

 

  files

 Shows the files in the nonvolatile directories of the manager board and the length of each file in bytes.
 verbose  Performs a file system check on the nonvolatile directories of the manager board to ensure that they are not corrupt and that if problems are detected, they are automatically fixed.

  The PortMaster 4 stores configuration files for a board in a subdirectory named after the slot number the board occupies. If you move a board from one slot to another, and turn on the board, the board uses the configuration stored for the new slot, allowing you to replace a failed board without re-entering configuration information.
  The PortMaster 4 performs a check on the nonvolatile directories of the system manager whenever the show files verbose command is used or when the PortMaster 4 is started. The output of this command is displayed to the command line interface. The results of the check at startup is sent to the console.
  Filenames and directories cannot exceed 16 characters. The number of files and subdirectories in directories is limited by the size of nonvolatile RAM.
 

       show global

  This command shows system-wide configuration values.

  show global

 

       show memory

  This command shows system memory use.

  show memory

 
 

       show modules

  The PortMaster ComOS is divided into functional modules. This command shows the names and sizes of the modules that are loaded into the currently running ComOS. Optional functions that are not loaded, such as the SNMP table, are not displayed.

  show modules

 

       show netconns

  This command shows the TCP and UDP network sockets open on the PortMaster.

  show netconns

  reset rHandle - page 2-13
 

       show netstat

  This command shows network interface statistics.

  show netstat

 

       show C0|S0

  This command shows the current status and configuration of asynchronous console ports and synchronous ISDN Primary Rate Interface (PRI) ports on the PortMaster.

  show C0|S0

 
 C0  C0 or C1--asynchronous console port.
 S0  Synchronous ISDN PRI.

  show W1 - page 6-17
 

       show sap

  Shows the active Service Advertising Protocol (SAP) table.

  show sap

  Note ¯ The PortMaster 4 supports IPX protocols on ComOS 4.1 and later releases.

 

       show sessions

  This command shows current use of ports on a selected board.

  show sessions [String

 
  String  Displays session information matching the specified string when the view is set to the manager module.
 ]

  ComOS 4.1 and later releases supports an enhanced display on a specified string.
  The following example shows output from the default (manager) view of a PortMaster 4 with two active slots:
 
 
 
 
 
       
 Command> show sessions        
 Port  User  Host/Inet/Dest  Type  Dir  Status  Start  Idle
 ----  ----  --------------  --------  ---  -------------  ---  --
 C0  test1    Login  In  COMMAND  0  
 C1      Login  In  USERNAME  0  
 *****************Slot0**************
 S0      Login  In  USERNAME  0  0
 S1      Device  Out  ESTABLISHED  1:23  1:23
 S2      Device  Out  ESTABLISHED  3  3
 S3      Log/Net  In  USERNAME  0  0
 S4      Login  In  USERNAME  0  0
 S9      Login  In  USERNAME  0  0
 S10      Log/Net  In  NO-SERVICE  0  0
 .              
 .              
 .              
 S95      Log/Net  In  NO-SERVICE  0  0
 *****************Slot1**************
 S0      Log/Net  In  NO-SERVICE  0  0
 S1      Log/Net  In  NO-SERVICE  0  0
 S2      Log/Net  In  NO-SERVICE  0  0
 S3      Log/Net  In  NO-SERVICE  0  0
 S4      Log/Net  In  NO-SERVICE  0  0
 S9      Log/Net  In  NO-SERVICE  0  0
 S10      Log/Net  In  NO-SERVICE  0  0
 .              
 .              
 .              
 S95      Log/Net  In  NO-SERVICE  0  0
 

       show slots

  This command displays general information about the physical slots in the PortMaster 4 and information about the PortMaster 4 chassis.

  show slots

  The output of this command is the same from any view. The following example is from a PortMaster 4 running ComOS 4.1:
 

  Command> show slots

 

  AC Power:

  Top: Working

  Middle: Working Bottom: Removed

 

  Max Power: 800W,

  Allocated: 520 W, Left: 280W

 

 

 

  DC Power:

  Primary DC: Off

  Secondary DC: Off

 

  Fan Status:

  1: On 2: On 3: On 4: On

 

  -----------------------------------------------------------------------------

 

 

  Chassis slot entries

 

 

 

  -----------------------------------------------------------------------------

  Slot

  State

 Board

  Config

  Serial Number

  Power

  Temp

  Rev

  00

  Empty

 

  On

 

  0W

  n/a

 

  01

  ACTIVE

  Quad T1

  On

  slot1

  200W

  34C/86F

 

  02

  ACTIVE

  Quad T1

  On

  3C00006

  80W

  34C/86F

  B

  03

  ACTIVE

 

  On

 

  0W

  n/a

 

  04

  ACTIVE

  Manager

  On

  Manager

  80W

  n/a

 

  05

  EMPTY

 

  On

 

  0W

  n/a

 

  06

  EMPTY

  Ethernet

  On

  slot6

  80W

  37C/95F

 

  07

  EMPTY

  Triple E1

  On

  3D00405

  80W

  33C/86F

  B

  08

  EMPTY

 

  On

 

  0W

  n/a

 

  09

  EMPTY

 

  On

 

  0W

  n/a

 

  show boards - page 2-22
show alarms - page 3-37
 

       show syslog

  This command shows the current syslog  settings.

  show syslog

  This example displays the default settings. These default settings can be changed with the set syslog  command (see page 3-23).
 

       show table

  This command displays the contents of tables stored in the memory of the PortMaster. Each command is covered in more detail in the chapter for that table.

  show table filter|host|location|modem|netmask|snmp|user

 
 filter  See the following example and page 12-18.
 host  See page 13-3.
 location  See page 11-22.
 modem  See page 5-40.
 netmask  See page 7-27.
 snmp  See page 3-38.
 user  See page 10-18.

  To see a list of filters in the filter table:
 
         
 Command> show table filter    
 next.in  sapo.out  ether.in  inter.in  general.in
 general.out  hosts.in      
  To see the contents of a specific filter:
 
   
 Command> show filter inter.in
 1  deny 192.168.200.0/24 0.0.0.0/0 ip
 2  permit 0.0.0.0/0 0.0.0.0/0 tcp estab
 3  permit 0.0.0.0/0 0.0.0.0/0 udp dst eq 53
 4  permit 0.0.0.0/0 0.0.0.0/0 tcp dst eq 53
 5  permit 0.0.0.0/0 0.0.0.0/0 tcp dst eq 25
 
 

       telnet

  This command is used for debugging purposes to establish a login from the PortMaster to a host using the Telnet protocol.

  telnet Ipaddress

 
 Ipaddress  IP address or hostname.
 Tport  Number of the designated TCP port--a 16-bit decimal number from 1 to 65535. Default is 23.  See Table B-1 on page B-1 for a list of the port numbers 20 through 1701 commonly assigned to TCP and UDP services.
[Tport]

  Telnet is an Internet standard protocol used for remote terminal service.

  Note ¯ The parser for this command does not allow the use of 0 as value for Tport .

 
  rlogin - page 2-15

  set telnet - page 3-25

 

       tftp get

  This command retrieves a file of configuration commands or a ComOS image from a TFTP server using the Trivial File Transfer Protocol (TFTP) and moves it to the nonvolatile RAM of the PortMaster.

  tftp get [comos|config|nostop] Ipaddress String

 
 comos  Downloads a ComOS image that has been translated via uuencode  to ASCII for the transmission over the Internet. This is the default. If no keyword is specified, the PortMaster tries to download this ComOS image.
 config  Downloads a text file containing command line interface commands. If any one of the commands produces an error, the TFTP transmission is terminated.
 nostop  Downloads a text file containing command line interface commands. If any one of the commands produces an error, the TFTP transmission is terminated the TFTP transmitting will continue.
 Ipaddress  IP address or hostname--up to 39 characters--of the TFTP server.
 String  Name of the file to be retrieved from the TFTP server.

  See your system administration manual for instructions on how to set up a TFTP server on your host.
  You can use either pminstall  or tftp get comos  to upgrade from ComOS release 3.1.2 and later to ComOS release 3.7 and later. However, you cannot use the tftp get comos  command to upgrade from ComOS release 3.1.1 or earlier, or to upgrade to ComOS release 3.5 or earlier. For these upgrades you must use the pminstall  utility instead.
 

       traceroute

  This command traces a network route by sending UDP packets with a decrementing Time-to-Live timer set to between 1 and 30 hops and printing the addresses that send back ICMP Time Expired packets.

  traceroute [Ipaddress]

 
 Ipaddress  IP address of destination to which route is to be traced.

  The traceroute  command takes its source address from the interface through which it exits.
  To stop the traceroute process, issue the command with no argument.
  Command> traceroute 172.16.1.2
traceroute to (172.16.1.2), 30 hops max
1 192.168.96.2
2 192.168.1.3
3 172.16.1.2
 

       version

  This command displays the ComOS software version number, PortMaster hardware platform, and the uptime since the last boot.

  version

  Always include the version number when reporting problems to Lucent InterNetworking Systems Technical Support.
[Top] [Table Of Contents] [Prev] [Next] [Index]
5 out of 25 total pages
spider@livingston.com
Copyright © 1999, Lucent Technologies. All rights reserved.