Trace Route
Trace Route
1 (92)
The information in this document is subject to change without notice and describes only the product defined in the introduction of this documentation. This documentation is intended for the use of Nokia Siemens Networks customers only for the purposes of the agreement under which the document is submitted, and no part of it may be used, reproduced, modified or transmitted in any form or means without the prior written permission of Nokia Siemens Networks. The documentation has been prepared to be used by professional and properly trained personnel, and the customer assumes full responsibility when using it. Nokia Siemens Networks welcomes customer comments as part of the process of continuous development and improvement of the documentation. The information or statements given in this documentation concerning the suitability, capacity, or performance of the mentioned hardware or software products are given as is and all liability arising in connection with such hardware or software products shall be defined conclusively and finally in a separate agreement between Nokia Siemens Networks and the customer. However, Nokia Siemens Networks has made all reasonable efforts to ensure that the instructions contained in the document are adequate and free of material errors and omissions. Nokia Siemens Networks will, if deemed necessary by Nokia Siemens Networks, explain issues which may not be covered by the document. Nokia Siemens Networks will correct errors in this documentation as soon as possible. IN NO EVENT WILL NOKIA SIEMENS NETWORKS BE LIABLE FOR ERRORS IN THIS DOCUMENTATION OR FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT LIMITED TO LOSS OF PROFIT, REVENUE, BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY OR DATA, THAT MAY ARISE FROM THE USE OF THIS DOCUMENT OR THE INFORMATION IN IT. This documentation and the product it describes are considered protected by copyrights and other intellectual property rights according to the applicable laws. The wave logo is a trademark of Nokia Siemens Networks Oy. Nokia is a registered trademark of Nokia Corporation. Siemens is a registered trademark of Siemens AG. Other product names mentioned in this document may be trademarks of their respective owners, and they are mentioned for identification purposes only. Copyright Nokia Siemens Networks 2008. All rights reserved.
2 (92)
Contents
Contents
Contents 3 List of tables 4 List of figures 5 Summary of changes 7 QR - TCP/IP STACK DATA HANDLING 9 QRN CONFIGURE NETWORK INTERFACE 11 QRG REMOVE NETWORK INTERFACE 21 QRW FORCE INTERFACE SWITCHOVER 25 QRI INTERROGATE NETWORK INTERFACE 29 QRT CONFIGURE TCP/IP PARAMETERS 35 QRH INTERROGATE TCP/IP PARAMETERS 39 QRK CONFIGURE DNS PARAMETERS 41 QRJ INTERROGATE DNS PARAMETERS 47 QRO INTERROGATE LOCAL DOMAIN NAMES 49 QRQ CONFIGURE LOCAL DOMAIN NAME 53 QRU DELETE LOCAL DOMAIN NAME 57 QRA CREATE VLAN INTERFACES 61
QRB INTERROGATE VLAN INTERFACES 65 QRR DELETE VLAN INTERFACES 69 QRF DISTRIBUTE CONFIGURATION FILE 73 QRX TEST HOST REACHABILITY (PING / TRACEROUTE) 75 QRS INTERROGATE NETWORK STATUS QRP PRIORITISE INTERFACE 91 81
3 (92)
List of tables
4 (92)
List of figures
List of figures
5 (92)
6 (92)
Summary of changes
Summary of changes
Changes between document issues are cumulative. Therefore, the latest document issue contains all changes made to previous issues.
Changes in command QRT The possibility to configure plugin units has been added. Changes in command QRK The new parameter lookup order has been added. Changes in command QRJ The new printout parameter lookup order has been added in the execution printout. Changes in command QRP The name of the command has been changed from PRIORITISE ETHERNET INTERFACE to PRIORITISE INTERFACE.
7 (92)
8 (92)
configure and interrogate network interfaces and TCP/IP parameters create, delete, and interrogate static routes maintain DNS parameters configure, interrogate, and delete VLAN interfaces . reset the network communications environment and distribute a configuration file within a network element . test host reachability (Ping) and interrogate network status
After you have configured a network interface, the programs in the computer unit containing the interface can exchange IP data units with programs in other computer units that belong to the same IP network. The creation of static routes is optional. Static routes provide the necessary routing information when dynamic routing protocols are not used. At least the default route is created this way. After establishing the parameters of the DNS resolver, you can use the Domain Name Service (DNS). A computer can be identified by its DNS name instead of its numerical IP address. If required, some TCP/IP parameters may be changed to support different network configurations. Usually the default values are adequate.
9 (92)
The commands in this command group are: QRN QRG QRW QRI QRT QRH QRK QRJ QRO QRQ QRU QRA QRB QRR QRF QRX QRS QRP CONFIGURE NETWORK INTERFACE REMOVE NETWORK INTERFACE FORCE INTERFACE SWITCHOVER INTERROGATE NETWORK INTERFACE CONFIGURE TCP/IP PARAMETERS INTERROGATE TCP/IP PARAMETERS CONFIGURE DNS PARAMETERS INTERROGATE DNS PARAMETERS INTERROGATE LOCAL DOMAIN NAMES CONFIGURE LOCAL DOMAIN NAME DELETE LOCAL DOMAIN NAME CREATE VLAN INTERFACES INTERROGATE VLAN INTERFACES DELETE VLAN INTERFACES DISTRIBUTE CONFIGURATION FILE TEST HOST REACHABILITY (PING/ TRACEROUTE) INTERROGATE NETWORK STATUS PRIORITISE INTERFACE
10 (92)
Parameter explanations
unit type
The type of the computer unit in which you want to configure a network interface. The program provides a list of computer units for you to choose from. This parameter is obligatory.
unit group
The unit group number of the computer unit in which you want to configure a network interface. The maximum value of the parameter is determined by the number of computer unit groups or stages. This parameter is asked only when it is needed, but in that case it is obligatory.
unit index
11 (92)
The index of the computer unit in which you want to configure a network interface. Not given if a logical IP address is configured to a 2N unit. The maximum value of this parameter is determined by the number of units.
interface name
The name of the network interface that you want to configure. The name is one of the interfaces listed in the interface guide. This parameter is obligatory.
interface type
The type of the network interface that was configured. The value is given to point-to-point interfaces only. U Unnumbered Interface This type of point-to-point interface must borrow it's local IP address from another broadcast type interface within the unit.. Numbered Interface This is the default value for point-to-point interfaces. The local IP address is a unique address within the system.
IP address
12 (92)
The IP address of the network interface. The address is specified in conventional dot notation (#.#.#.#). The parameter value ranges for each part of the address from 0 to 255, except for the first and the last part where the range is 1 to 255. Only one IP address can be given at a time.
IP address type
The logical or physical IP address for the network interface. L Logical IP address This address belongs to the specified interface of the specified functional unit. The logical IP address follows the active unit. The logical IP address can be given to 2N and N+1 units.. Physical IP address This address is assigned to the specified computer unit permanently.
netmask length
This parameter gives the length of the numerical part of the IP address in bits. The values range from 4 to 32. The parameter can be given only if an IP address is given. The default length of the netmask is determined by the IP address: for a class A address it is 8, for a class B address it is 16, and for a class C address it is 24. For point-to-point links it is always 32 and the maximum for ethernet type interfaces is 30. Examples of the corresponding netmasks: 255.0.0.0, 255.255.0.0, and 255.255.255.0.
destination IP address
This parameter can only be configured to a point-to-point interface. It is the remote address of the link.
13 (92)
state
This parameter indicates the initial administrative state of the interface immediately after configuration. If the interface is configured for the first time, the default value is UP. If state is omitted and the network interface has been configured before, its state does not change. The possible values of the parameter are the following: UP DOWN Examples 1. The interface is in use The interface is blocked
2.
Assign a physical IP address to the network interface el0 of BCSU0's PCUS-1. QRN:BCSU,0:PCUS,1:EL0:131.230.42.22,P;
14 (92)
3.
Assign a physical IP address to the network interface el0 of OMU-0 with a netmask of 20. QRN:OMU,0::EL0:131.228.45.178,P:20;
4.
Assign a logical IP address to the network interface el0 of OMU units. QRN:OMU::EL0:131.228.45.179,L;
5.
6.
Assign a logical IP address to the network interface el0 of PAPU-2 unit. QRN:PAPU,2::EL0:131.228.45.180,L;
7.
Assign a logical IP address to the network interface aa0 of IOCPE plugin-units. QRN:PAPU,0:IOCPE,1:AA0:131.228.45.181, L::140.0.0.1;
8.
Assign a physical unnumbered IP address to the network interface aa1 of a IOCPE plugin-unit. QRN:PAPU,0:IOCPE,1:AA1,U:131.228.45.182, P::140.0.0.2;
9.
Assign a physical IP address to the network interface el0 of computer unit with MTU 1300. QRN:OMU,0::EL0:66.6.6.6,P:::1300;
Additional information
To check the interfaces that have already been configured, use the QRI command. A computer unit can contain one loopback network interface at the most. The IP address of a loopback interface is always 127.0.0.1 (the parameter's default value) and its netmask length is always 8. The program prevents you from entering any other value. For other interface types, IP addresses between 127.0.0.0 and 127.0.0.255 are not allowed. You cannot give a network interface an IP address belonging to the 0.0.0.0/8 network. In addition, the subnetwork's broadcast addresses (those in which all bits after the netmask are either one or zero) are forbidden. For example, if the interface is in network 134.56.64.0/18, the addresses 134.56.64.0 and 134.56.127.255 are forbidden. The program prevents you from entering a forbidden address.
15 (92)
Execution printouts
UNIT IF NAME ADM STATE MTU PRIORITY IF TYPE ADDR TYPE IP ADDRESS
Computer unit and plug-in unit whose network interface is configured Network interface name Administrative state of the network interface Maximum Transmission Unit of the network interface Priorization of the network interface Interface type of a point-to-point interface Address type of the IP address IP address and netmask length. If in parenthesis the IP address is not active.
COMMAND EXECUTED
16 (92)
CONFIGURED NETWORK INTERFACE IF NAME -------EL0 EL0 ADM STATE ----UP UP PRIO RITY ---NO NO IF TYPE ---ADDR TYPE ---L L
COMMAND EXECUTED
17 (92)
You have given a computer unit which does not have TCP/IP services available. Change the computer unit to one which has TCP/IP services.
/*** INVALID INTERFACE NAME ***/
You have given an incorrect network interface name. Re-enter the command so that the network interface is one of the ones shown in the interface guide.
/*** IP ADDRESS IS ILLEGAL ***/
You have given the IP address in the wrong format, or the address is forbidden. Check whether the IP address has four parts separated by dots (#.#.#.#) and whether none of the parts in the address exceed the upper limit of 255. For more information, see Additional Information and re-enter the command so that the given conditions are met. The system may also output a general MML semantic error message. Execution error messages
/*** IP ADDRESS ALREADY IN USE ***/
You have tried to configure an IP address which has already been configured.
/*** MAXIMUM NUMBER OF IP ADDRESSES EXCEEDED ***/
18 (92)
You have given a network interface the eleventh logical or physical IP address. The maximum number of IP addresses is 10 physical and 10 logical IP addresses. If a configured interface exists, check its information using the QRI command.
/*** NETWORK INTERFACE DOES NOT EXIST ***/
You have given an incorrect network interface name. Give the command again so that the network interface is one of the ones shown in the interface guide. The system may also output a general MML execution error message.
19 (92)
20 (92)
Parameter explanations
unit type
The type of the computer unit whose network interface you want to remove. The program provides a list of computer units for you to choose from. This parameter is obligatory.
unit group
The unit group number of the computer unit whose network interface you want to remove. The maximum value of the parameter is determined by the number of computer unit groups or stages. This parameter is needed only for units having groups or stages, in which case it is obligatory.
unit index
The index of the computer unit whose network interface you want to remove.
21 (92)
The maximum value of this parameter is determined by the number of units. This parameter is asked only if needed, in which case it is obligatory.
interface name
The name of the network interface that you want to remove. The name is from 3 to 8 characters long. All available interface in the given unit are listed. This parameter is obligatory.
IP address
The IP address that you want to remove. The IP address must be valid address configured to the given network interface and unit. This parameter is optional. Examples 1. Remove the configuration of the network interface el0 of OMU-0. QRG:OMU,0::EL0; 2. Remove the configuration of the network interface mb0 of PCU-2 of BCSU-0. QRG:BCSU,0:PCU,2:MB0; 3. Remove IP address 10.0.0.1 from network interface el0 of OMU-0. QRG:OMU,0::EL0:10.0.0.1;
22 (92)
Use the QRI command to check existing configured network interfaces and their IP addresses. The following abbreviations are used in the execution printouts:
UNIT IF NAME ADM STATE MTU PRIORITY IF TYPE ADDR TYPE IP ADDRESS
Computer unit and plug-in unit whose network interface or IP address is removed. Network interface name Initial administrative state of the network interface Maximum Transfer Unit of the network interface Priorisation of the network interface Interface type of a point-to-point interface. Address type of the IP address IP Address and network mask lenght. If address is in parenthesis, it is not active.
NOTICE! EXISTING LOCAL IP ADDRESS BASED DEFAULT GATEWAYS RELATED TO THIS IP ADDRESS HAVE TO BE DELETED WITH ZQKP BEFORE IP ADDRESS CAN BE DELETED SAFELY.
NOTICE! EXISTING LOCAL IP ADDRESS BASED DEFAULT GATEWAYS RELATED TO THIS IP ADDRESS HAVE TO BE DELETED WITH ZQKP BEFORE IP ADDRESS CAN BE
23 (92)
DELETED SAFELY.
NOTICE! EXISTING LOCAL IP ADDRESS BASED DEFAULT GATEWAYS RELATED TO THIS IP ADDRESS HAVE TO BE DELETED WITH ZQKP BEFORE IP ADDRESS CAN BE DELETED SAFELY.
You have given a computer unit which does not have any TCP/IP service available. Change the computer unit to one which has TCP/IP services.
/*** INVALID INTERFACE NAME ***/
You have given an incorrect network interface name. Give the command again so that it matches one of the interfaces given in the interface guide. The system may also output a general MML semantic error message. Execution error messages
/*** NETWORK INTERFACE DOES NOT EXIST ***/
You have given a network interface which has not been configured. Check the unit and the interface name. Check the configured interfaces with the QRI command. The system may also output a general MML execution error message.
24 (92)
Parameter explanations
unit type
The type of the computer unit in which you want to force the interface switchover. The program provides a list of computer units for you to choose from. This parameter is obligatory.
unit group
The unit group number of the computer unit in which you want to force the interface switchover. The maximum value of the parameter is determined by the number of computer unit groups or stages. This parameter is asked only if needed, but in that case it is obligatory.
unit index
The index of the computer unit in which you want to force the interface switchover. The maximum value of this parameter is determined by the number of units.
25 (92)
interface name
The name of the network interface which you want to force to switchover. The name is between two and six characters long and must begin with 'CO' (COCEN interface), 'EL' (Ethernet interface), IFETH' Ethernet interface in Chorus), 'LO' (Loopback interface), or 'MB' (Message bus interface). This parameter is obligatory. IP addresses which are assigned in a given network interface are moved in the interface switchover. The system attaches IP interfaces to computer units automatically. Only the attached IP interface names can be given as a value of this parameter. You can check the attached IP interface names with the following command: QRI:<unit type>,<unit index>:::YES; Examples 1. Force switchover of interface el0. QRW:OMU:EL0; Additional information Execution printouts To check the interfaces that have already been configured, use the QRI command. The execution printout of command example 1 is the following:
You have given a computer unit which does not have any TCP/IP service available. Change the computer unit to one which has TCP/IP services.
/*** INVALID INTERFACE NAME ***/
You have given an incorrect network interface name. Re-enter the command so that it begins with the letters 'CO', 'EL', 'IFETH', 'LO', or 'MB' and has no more than six characters.
26 (92)
The system may also output a general MML semantic error message. Execution error messages
/*** NETWORK INTERFACE DOES NOT EXIST ***/
You have given a network interface which has not been configured. Check the unit and the interface name. Use the QRI command to check the configured interfaces. The system may also output a general MML execution error message.
27 (92)
28 (92)
Use this command to interrogate a computer unit's attached and configured network interfaces. unit identification: plug-in unit identification: interface name: display unit's attached network interfaces;
Parameter explanations
unit type
The type of the computer unit from which you want to interrogate a network interface. The program provides a list of computer units for you to choose from. The default value is all units.
unit group
The unit group number of the computer unit from which you want to interrogate the network interface. The maximum value of the parameter is determined by the number of computer unit groups or stages. The default value is all groups.
unit index
The index of the computer unit from which you want to interrogate the network interface.
29 (92)
The maximum value of this parameter is determined by the number of units. The default value is all indices of the given unit.
interface name
The name of network interface which you want to interrogate. The name is from 2 to 6 characters long and has to begin with 'CO' (Cocen interface), 'EL' (Ethernet interface), 'IFETH' (Ethernet interface in Chorus), 'LO' (Loopback interface) or 'MB' (Message Bus interface). The default value is all network interfaces. The system attaches IP interfaces to computer units automatically. Only attached IP interface names can be given as a value of this parameter. You can check attached IP interface nameswith the following command: QRI:<unit type>,<unit index>::YES;
30 (92)
2.
3.
4.
Interrogate all configured and attached network interfaces of BCSU1 PCUS-4 plug-in unit. QRI:BCSU,1:PCUS,4::YES;
5.
6.
7.
Interrogate all configured network interfaces of BCSU-2's PCUS-4 plug-in unit. QRI:BCSU,2:PCUS,4;
When listing attached interfaces, the unit type and the unit index must be defined in the command. The following abbreviations are used in the execution printouts:
UNIT
NAME IP ADDRESS ADDR TYPE NML ASSIGNED YES NO ADM STATE MTU P
Computer unit and plug-in unit whose network interface is configured. The asterisk (*) after computer unit in execution printouts tells that the unit is an active unit and uses the logical IP address configured to that unit pair. Network interface name IP address for network interface IP address type Netmask length Assigning status of IP address IP address is assigned IP address is pending Initial administrative state Maximum Transmission Unit Physical IP address
31 (92)
L I
UP DOWN
Logical IP address IP address is an internal LAN address and cannot be removed or modified with the commands of the TCP/ IP Stack Data Handling, QR command group. Internal LAN addresses can be added using the commands of the Internal LAN Management, WY command group. The interface is in use The interface is blocked
NO NO NO
1500 1500
NO NO
32 (92)
8 YES UP 1500 NO
UNIT NAME IP ADDRESS ------------------ ------ --------------BCSU-1 -PCUS- 4 IFETH0 14.4.4.44 20.1.1.11 17.7.7.77 -PCUS- 4 IFETH1
1500
NO
COMPUTER UNIT'S ALL ATTACHED NETWORK INTERFACES: ETHERNET: IFETH0 IFETH1 LOOPBACK: LO0 COMMAND EXECUTED
UNIT
NAME
IP ADDRESS
33 (92)
------------------ ------ --------------- ---- --- -------- ----- ----- ----BCSU-2 -PCUS- 4 IFETH0 66.6.6.6 P 8 YES UP 1300 NO COMMAND EXECUTED
You have given a computer unit which does not have a TCP/IP service available. Change the computer unit to one which has TCP/IP services.
/*** INVALID INTERFACE NAME ***/
You have given an incorrect network interface name. Re-enter the command so that it begins with letters 'CO', 'EL', 'IFETH', LO', or 'MB' and has 6 characters at maximum. The system may also output a general MML semantic error message. Execution error messages
/*** ATTACHED INTERFACES INTERROGATION FAILED ***/
The interrogation of the attached interfaces in the given computer unit has failed. Give the command again after a while. The system may also output a general MML execution error message.
34 (92)
Use this command to configure TCP/IP protocol stack specific parameters. unit identification: piu identification; host name, IP forwarding, IP TTL, subnets are local;
Parameter explanations
unit type
The type of the computer unit in which you want to configure TCP/IP stack parameters. The program provides a list of computer units for you to choose from. This parameter is obligatory.
unit group
The unit group number of the computer unit in which you want to configure the TCP/IP stack parameters. The maximum value of the parameter is determined by the number of computer unit groups or stages. This parameter is asked only if needed, but in that case it is obligatory.
unit index
The index of the computer unit in which you want to configure the TCP/IP stack parameters.
35 (92)
host name
The name of the host computer for which you want to create either a fully qualified domain name (FQDN) or a name without the domain part. The name can contain characters A-Z, 0-9, and a hyphen (-). The maximum length of the name is 100 characters. The name is given in quotation marks. If you enter a full stop/period (".") as the value, no domain name is used.
IP forwarding
The IP forwarding flag defines whether the TCP/IP stack forwards unicast IP packets not belonging to it. If the parameters are configured for the first time, the default value is NO, otherwise the current value remains. YES NO Forward Do not forward This is the default value if configured for the first time.
IP TTL
The maximum time-to-live (hop count) value for an IP packet sourced by the system.
36 (92)
Values range form zero to 255. The default value is 64 if configured for the first time, otherwise the current value remains.
Execution printouts
Computer unit whose TCP/IP stack parameters are configured IP forwarding flag IP time-to-live value Subnets are local flag The name of the host computer
37 (92)
CONFIGURED TCP/IP PARAMETER DATA UNIT IP FORW TTL SNL HOST NAME ------------------ ------- --- --- ---------------------------------------OMU-0 NO 64 YES MYHOST COMMAND EXECUTED
You have given a computer unit which does not have a TCP/IP service available. Change the computer unit to one which has TCP/IP services.
/*** INVALID DOMAIN NAME ***/
You have given an incorrect host name. Give a correct host name that consists of characters A-Z, 0-9, and a hyphen (-) and has four parts at the most. The maximum length is 100 characters. The system may also output a general MML semantic error message. Execution error messages If an error occurs, the system outputs a general MML execution error message.
38 (92)
Use this command to interrogate TCP/IP protocol stack specific parameters. unit identification;
Parameter explanations
unit type
The type of the computer unit from which you want to interrogate TCP/IP stack parameters. The program provides a list of computer units for you to choose from.
unit group
The unit group number of the computer unit from which you want to interrogate TCP/IP stack parameters. The maximum value of the parameter is determined by the number of computer unit groups or stages). This parameter is asked only if needed.
unit index
The index of the computer unit from which you want to interrogate the TCP/IP stack parameters. The maximum value of this parameter is determined by the number of units. Examples 1. Interrogate TCP/IP parameter information of all computer units. QRH;
39 (92)
2.
3.
Execution printouts
Computer unit and index whose TCP/IP stack parameters are interrogated IP forwarding flag IP time-to-live value Subnets are local flag Name of the host computer
You have given a computer unit which does not have any TCP/IP service available. Change the computer unit to one which has TCP/IP services. The system may also output a general MML semantic error message. Execution error messages If an error occurs, the system outputs a general MML execution error message.
40 (92)
Parameters
Syntax
Parameter explanations
41 (92)
If you give 0.0.0.0 as the value, there is no secondary DNS server. The default value is the current value.
network sortlist
The IP address of the network sortlist. The address is specified in the conventional dot notation (#.#.#.#). If you give 0.0.0.0 as the value, there is no network sortlist. The default value is the current value.
netmask sortlist
The netmask length of the network sortlist. The parameter value ranges from 1 to 32. The parameter can be given only if the IP address of the network sortlist is given. The default value is the natural netmask of the net.
resolver cache
The resolver cache parameter shows whether the cache is in use. If the cache is given for the first time, the default value is YES, otherwise the default value is the current value. The possible values of the parameter are the following:
42 (92)
YES NO
round robin
The round robin parameter shows whether the round robin is in use. If the round robin is given for the first time, the default value is YES, otherwise the default value is the current value. The possible values of the parameter are the following: YES NO The round robin is in use The round robin is not in use
lookup order
The lookup order parameter shows the lookup order of the DNS resolver. If the lookup order is given for the first time, the default value is YES, otherwise the default value is the current value. The possible values of the parameter are the following: YES NO Examples 1. Cache, network and hosts Cache, hosts and network Activate the DNS and use the IP address 131.228.118.232 as the primary server, the IP address 177.77.77.7 as the secondary server, and 188.88.88.88 as the tertiary server. The domain name is NOKIA. COM. The network sortlist is 122.2.70.4 and the netmask is 8. Resolver cache and round robin are in use. The lookup order is cache, network and hosts. QRK:131.228.118.232,177.77.77.7,188.88.88.88,"NOKIA.COM",122.2.70.4,8:YES,YES,YES; 2. Deactivate the DNS and at the same time change the domain name to STARDUST.COM and leave the network sortlist unchanged. QRK:0.0.0.0,,,"STARDUST.COM"; 3. Deactivate the DNS and at the same time change the domain name to STARDUST.COM and leave the network sortlist unchanged. Resolver cache and round robin are not in use. The lookup order is cache, hosts and network. QRK:0.0.0.0,,,"STARDUST.COM",,NO,NO,NO;
43 (92)
4.
Set 177.77.77.100 as the secondary DNS server. Remove the domain name and leave the primary and tertiary servers unchanged. QRK:,177.77.77.100,,".";
5.
Set 177.77.77.111 as the secondary DNS server and 122.2.2.2 as the tertiary DNS server. QRK:,177.77.77.111,122.2.2.2;
Additional information
If the primary server has been defined but is not functioning, that is, it does not respond to DNS requests, the system uses the secondary or the tertiary DNS server. Before using DNS servers, check whether they are accessible, that is, all units have a route established to them.
Execution printouts
If the primary, secondary, or tertiary DNS server has not been defined, its IP address is displayed as blank characters in printouts. The domain name is also displayed as blank characters when not defined. The following abbreviations are used in the execution printouts: PRIMARY DNS SERVER Primary domain name system server SECONDARY DNS SERVER Secondary domain name system server THIRD DNS SERVER Tertiary domain name system server DOMAIN NAME The local domain name SORT LIST Network sortlist and netmask sortlist RESOLVER CACHE Resolver cache is in use or not ROUND ROBIN Round robin is in use or not LOOKUP ORDER Lookup order is cache, network and hosts or cache, hosts and network The execution printout of command example 1 is the following:
CONFIGURED DNS PARAMETERS PRIMARY DNS SERVER..: 131.228.118.232 SECONDARY DNS SERVER: 177.77.77.7 THIRD DNS SERVER....: 188.88.8.8 DOMAIN NAME: NOKIA.COM SORT LIST: 122.2.70.4/8
44 (92)
RESOLVER CACHE IS IN USE ROUND ROBIN IS IN USE LOOKUP ORDER CACHE, NETWORK AND HOSTS COMMAND EXECUTED
45 (92)
RESOLVER CACHE IS NOT IN USE ROUND ROBIN IS NOT IN USE LOOKUP ORDER CACHE, HOSTS AND NETWORK COMMAND EXECUTED
You have given the IP address in a wrong format. Check that the IP address has four parts separated by dots (#.#.#.#) and that none of the parts in the address exceeds the upper limit of 255.
/*** INVALID DOMAIN NAME ***/
You have given an incorrect domain name. Give a correct domain name that consists of the characters AZ, 09, and hyphen (-) and has no more than four parts. The maximum length of the name is 110 characters. The system may also output a general MML semantic error message. Execution error messages
/*** MAXIMUM NUMBER OF IP ADDRESSES EXEEDED ***/
You have given an eleventh IP address of the network sortlist. The maximum number of IP addresses is 10. The system may also output a general MML execution error message.
46 (92)
Additional information
If a primary server has been defined, but is not functioning, that is, it does not respond to DNS requests, the system uses the secondary or the tertiary DNS server. Before using DNS servers, check wether they are accessible, that is, all units have a route established to them.
Execution printouts
If the primary, secondary, or tertiary DNS server has not been defined, its IP address is displayed as blank characters in printouts. The domain name is also displayed as blank characters when not defined. The following abbreviations are used in the execution printout: PRIMARY DNS SERVER Primary domain name system server SECONDARY DNS SERVER Secondary domain name system server THIRD DNS SERVER Tertiary domain name system server
47 (92)
DOMAIN NAME The common domain name SORT LIST Network sortlist and netmask RESOLVER CACHE Resolver cache ROUND ROBIN Round robin LOOKUP ORDER Lookup order is cache, network and hosts The execution printout of command example 1 is the following:
INTERROGATED DNS PARAMETERS PRIMARY DNS SERVER..: 131.228.118.232 SECONDARY DNS SERVER: 188.88.8.8 DOMAIN NAME: NOKIA.COM SORT LIST: 122.2.70.4/8 RESOLVER CACHE IS IN USE ROUND ROBIN IS IN USE LOOKUP ORDER CACHE, NETWORK AND HOSTS COMMAND EXECUTED
If an error occurs, the system outputs a general MML semantic error message. If an error occurs, the system outputs a general MML execution error message.
48 (92)
domain name
A name that identifies one or more IP addresses. Give a domain name that you want to interrogate. The name can contain characters A-Z, 0-9, and a hyphen (-). The maximum length of the name is 100 characters. The name is given in quotation marks.
IP addr family
The family of IP address. The provided families are IPv4 and IPv6. Examples 1. Interrogate all domain names with IPv4 type addresses. QRO; 2. Interrogate all domain names with IPv6 type addresses. QRO::IPV6; 3. Interrogate the domain name WWW.NOKIA.COM with IPv4 address family IP addresses. QRO:"WWW.NOKIA.COM";
49 (92)
Execution printouts
DOMAIN NAME AND ADDRESS FAMILY Domain name and address family CANONICAL NAMES Canonical names list IP ADDRESSES IP addresses list The execution printout of command example 1 is the following:
QRO; INTERROGATED DOMAIN NAME PARAMETERS DOMAIN NAME AND ADDRESS FAMILY: localhost IP IP ADDRESSES: 127.0.0.1 DOMAIN NAME AND ADDRESS FAMILY: WWW.NOKIA.COM IP IP ADDRESSES: 123.123.123.123 COMMAND EXECUTED
50 (92)
DOMAIN NAME AND ADDRESS FAMILY: WWW.NOKIA.COM IP IP ADDRESSES: 123.123.123.123 COMMAND EXECUTED
If an error occurs, the system outputs a general MML semantic error message.
/*** INVALID INFORMATION UNIT ***/
The quotation marks is missing from the domain name. The system may also output a general MML semantic error message. Execution error messages If an error occurs, the system outputs a general MML execution error message.
51 (92)
52 (92)
Use this command to configure local domain name parameters to the etc/ hosts file. domain name, IP addr family: domain canonical name/domain IP address;
Parameter explanations
domain name
A name that identifies one or more IP addresses. Give a domain name that you want to configure. The name can contain characters A-Z, 0-9, and a hyphen (-). The maximum length of the name is 100 characters. The name is given in quotation marks.
IP addr family
The family of IP address. The provided families are IPv4 and IPv6. The default value is IPv4.
53 (92)
domain IP address
The IP address of domain name. The IP address can be IPv4 or IPv6 type. The address is given in quotation marks. Examples 1. Configure the domain name WWW.NOKIA.COM with IPv4 type address. QRQ:"WWW.NOKIA.COM,IPV4:IP=123.123.123.123 2. Configure the canonical name WWW.NOKIA.FI to the domain name WWW.NOKIA.COM. QRQ:2WWW.NOKIA.COM,IPV4:NAME="WWW.NOKIA.FI"; Additional information You can interrogate the current domain name parameters with the QRO command. When configuring domain name parameters, you must configure one IP address to the domain name and then you can configure canonical names. The following abbreviations are used in the execution printouts:
Execution printouts
DOMAIN NAME AND ADDRESS FAMILY Domain name whose parameters are configured and the family CANONICAL NAME Domain name's configured canonical name IP ADDRESS Domain's configured IP address The execution printout of command example 1 is the following:
CONFIGURED DOMAIN NAME PARAMETERS DOMAIN NAME AND ADDRESS FAMILY: WWW.NOKIA.COM IP IP ADDRESSES: 123.123.123.123
COMMAND EXECUTED
54 (92)
CONFIGURED DOMAIN NAME PARAMETERS DOMAIN NAME AND ADDRESS FAMILY: WWW.NOKIA.COM IP CANONICAL NAMES: WWW.NOKIA.FI
COMMAND EXECUTED
You have given a domain name, canonical name, or IP address without quotation marks.
/*** INVALID DOMAIN NAME ***/
You have given an incorrect domain name or canonical name. Give a correct name that consists of characters A-Z, 0-9, and a hyphen (-) . The maximum length is 100 characters. The system may also output a general MML semantic error message. Execution error messages If an error occurs, the system outputs a general MML execution error message.
55 (92)
56 (92)
Use this command to delete existing domain name parameters. domain name, ip addr family: domain canonical name/domain IP address;
Parameter explanations
domain name
A name that identifies one or more IP addresses. Give a domain name that you want to delete. The name can contain characters A-Z, 0-9, and a hyphen (-). The maximum length of the name is 100 characters. The name is given in quotation marks.
IP addr family
The family of IP address. The provided families are IPv4 and IPv6. The default value is IPv4.
domain IP address
The deleted IP address of domain name.
57 (92)
The IP address can be IPv4 or IPv6 type. The address is given in quotation marks. Examples 1. Delete all domain names and parameters. QRU; 2. Delete WWW.NOKIA.COM domain name with IPv6 type IP address. QRU:"WWW.NOKIA:COM":IPv6; Execution printouts The following abbreviations are used in the execution printouts:
DOMAIN NAME AND ADDRESS FAMILY Domain name whose parameters are deleted and the family CANONICAL NAME The Domain name's deleted canonical name IP ADDRESS The Domain name's deleted IP address The execution printout of command example 1 is the following:
QRU; WARNING! THIS COMMAND DELETES ENTIRE CONFIGURATION OF LOCAL DOMAIN NAMES.
COMMAND EXECUTED
DELETED DOMAIN NAME PARAMETERS DOMAIN NAME AND ADDRESS FAMILY: WWW.NOKIA.COM IPV6
58 (92)
COMMAND EXECUTED
The quotation marks is missing from the domain name, canonical name, or IP address. The system may also output a general MML semantic error message. Execution error messages If an error occurs, the system outputs a general MML execution error message.
59 (92)
60 (92)
Parameter explanations
unit type
The type of the computer unit for which you want to create a VLAN interface. The program provides a list of computer units for you to choose from. This parameter is obligatory.
61 (92)
The identification you want to use for the created VLAN inteface.
vid
VLAN identifier The value of this parameter can range between 1 and 4094.
priority
Priority, a numerical value which can be between 0 and 7, with the default being 0.
cfi
Canonical format indicator, a numerical value which is either 0 or 1, with the default being 0. Examples 1. Create a VLAN interface for all BCSU's and all EL0 interfaces. QRA:BCSU::VLAN50:50:EL0:2:; 2. Create a VLAN interface for OMU el0 with a VID of 3000 and a priority of 4 with a CFI value of 1. QRA:OMU::VLAN3000:3000:EL0:4:1:; Additional information Execution printouts To interrogate existing VLAN interfaces, use the QRB command. The following abbreviations are used in the execution printouts:
UNIT
Computer unit and plug-in unit whose VLAN interface is configured. The asterisk (*) after the computer unit in execution printouts tells that the unit is an active unit and uses the logical IP address configured to that unit pair. VLAN interface name Network interface name VLAN identifier
62 (92)
PRI CFI
CONFIGURED VLAN INTERFACE VLAN UNIT NAME ------------------ -------BCSU VLAN50 COMMAND EXECUTED IF NAME VID PRI CFI -------- ---- --- --EL0 50 2 0
CONFIGURED VLAN INTERFACE VLAN UNIT NAME ------------------ -------OMU VLAN3000 COMMAND EXECUTED IF NAME VID PRI CFI -------- ---- --- --EL0 3000 4 1
You have given a VID, CFI, or priority value which is too high. Please reinput with a smaller value for the parameter in question.
/*** INVALID INTERFACE NAME ***/
You have given an invalid interface name. Give another interface. The system may also output a general MML semantic error message. Execution error messages If an error occurs, the system outputs a general MML execution error message.
63 (92)
64 (92)
Parameter explanations
unit type
The type of the computer unit in which you want to interrogate the VLAN interfaces. The program provides a list of computer units for you to choose from.
65 (92)
Examples
1.
2.
3.
Execution printouts
UNIT
Computer unit and plug-in unit whose network interface is configured. The asterisk (*) after computer unit in execution printouts tells that the unit is an active unit and uses the logical IP address configured to that unit pair. VLAN interface name Network interface name VLAN identifier Priority Canonical Format Indicator
PRI --3 4
CFI --1 0
UNIT
VID
PRI CFI
66 (92)
------------------ -------- -------- ---- --- --OMU VLAN300 EL0 300 4 0 COMMAND EXECUTED
INTERROGATING VLAN INTERFACES VLAN UNIT NAME ------------------ -------BCSU VLAN20 COMMAND EXECUTED IF NAME VID PRI CFI -------- ---- --- --EL0 20 3 1
If an error occurs, the system outputs a general MML semantic error message.
/*** INVALID INTERFACE NAME ***/
You have given an invalid interface name. Give another interface. The system may also output a general MML semantic error message. Execution error messages If an error occurs, the system outputs a general MML execution error message.
67 (92)
68 (92)
Parameter explanations
unit type
The type of the computer unit from which you delete the VLAN interfaces. The program provides a list of computer units for you to choose from.
69 (92)
Examples
1.
2.
Execution printouts
UNIT
Computer unit and plug-in unit whose network interface is configured. The asterisk (*) after computer unit in execution printouts tells that the unit is an active unit and uses the logical IP address configured to that unit pair. VLAN interface name Network interface name VLAN identifier Priority Canonical Format Indicator
REMOVE VLAN INTERFACE VLAN UNIT NAME ------------------ -------OMU VLAN3000 IF NAME VID PRI CFI -------- ---- --- --EL0 3000 4 1
REMOVE VLAN INTERFACE VLAN UNIT NAME ------------------ -------BCSU VLAN200 IF NAME VID PRI CFI -------- ---- --- --EL0 200 1 0
70 (92)
If an error occurs, the system outputs a general MML semantic error message.
/*** INVALID INTERFACE NAME ***/
You have given an invalid interface name. Give another interface. The system may also output a general MML semantic error message. Execution error messages If an error occurs, the system outputs a general MML execution error message.
71 (92)
72 (92)
file name;
QRF: <file name>;
file name
The name of the configuration file which has been changed by an external or internal editor, and which will be propagated within the network element. This parameter is obligatory.
Examples
1.
Execution printouts
If an error occurs, the system outputs a general MML semantic error message. If an error occurs, the system outputs a general MML execution error message.
73 (92)
74 (92)
Syntax
QRX: [ <unit type>, [ <unit index> | [ <unit group>, <unit index> ] ] | <active OMU> def ]: [<plug-in unit type>, <plug-in unit index>]: ( HOST = <host> | IP = <IP address> ); [ <PING> def | <TRACE> ]: ( [ M = <max number of hops> ], [ W = <wait time for each hop> ], [ N = <YES print hop address numerically> def | <NO print hop address symbolically> ] );
Parameter explanations
unit type
The type of the computer unit that sends the request. The program provides a list of computer units for you to choose from. The default value is OMU.
unit group
75 (92)
The unit group number of the computer unit that sends the request. The maximum value of the parameter is determined by the number of computer unit groups or stages. This parameter is asked only if needed.
unit index
The index of the computer unit that sends the request. The maximum value of this parameter is determined by the number of units. The default value is the active index of the OMU.
host
HOST The host name to be tested. Give either a host name or an IP address.
IP address
IP The IP address of the host to be tested. The address is specified in the conventional dot notation (#.#.#.#). The parameter value ranges for each part of the address from 0 to 255. You must give either a host name or an IP address.
command
The command, which is used to test host reachability. The default command is PING.
76 (92)
PING TRACE
Ping a host specified either by a host name or by an IP address. Trace the route to a host specified either by a host name or by an IP address.
This parameter can be given only if the command parameter has the value TRACE. Examples 1. Ping host 131.228.45.33 from OMU-0 (active unit). QRX:::IP=131.228.45.33; 2. Ping host 131.228.45.33 from OMU-0 (active unit). QRX:OMU::IP=131.228.45.33; 3. Ping host MAGIA-PRT.NTC.NOKIA.COM from OMU-0. QRX:OMU,0::HOST="MAGIA-PRT.NTC.NOKIA.COM";
77 (92)
4.
5.
Execution printouts
PING, SENDING UNIT: OMU-0 PING magia-prt.ntc.nokia.com (131.228.45.33): 56 data bytes 64 bytes from 131.228.45.33: icmp_seq=0 ttl=255 time=4.939 ms 1 packets transmitted, 1 packets received, 0% packet loss COMMAND EXECUTED
You have given a computer unit which does not have any TCP/IP service available. Change the computer unit to one which has TCP/IP services.
/*** INVALID DOMAIN NAME ***/
You have given an incorrect host name. Give a correct host name that consists of the characters AZ, 09, and hyphen (-) and has no more than four parts. The maximum length is 100 characters.
/*** IP ADDRESS IS ILLEGAL ***/
78 (92)
You have given the IP address in a wrong format. Check that the IP address has four parts separated by dots (#.#.#.#) and that none of the parts in the address exceeds the upper limit of 255. The system may also output a general MML semantic error message. Execution error messages If an error occurs, the system outputs a general MML execution error message.
79 (92)
80 (92)
Parameter explanations
unit type
The type of the target computer unit. The program provides a list of computer units for you to choose from. This parameter is obligatory.
unit group
The unit group number of the target computer unit. The maximum value of the parameter is determined by the number of computer unit groups or stages. This parameter is asked only if needed, but in that case it is obligatory.
unit index
The index of the target computer unit.
81 (92)
mode
The information listed varies depending on the mode of the command. The possible values of the parameter are the following: ALL INA INS Show active Internet connections Show the state of the interfaces Show information about a specific interface In this mode you must give the interface to the next parameter interface. Show routing tables Show per-protocol statistics
ROU PRO
interface name
The name of the network interface that you want to be shown. The name is between two and six characters long and must begin with 'CO' (COCEN interface), 'EL' (Ethernet interface), 'IFETH' (Ethernet interface in Chorus), 'LO' (Loopback interface), or 'MB' (Message bus interface). This parameter is obligatory and can be given only when the mode is INS. The system attaches IP interfaces to computer units automatically. Only attached IP interface names can be given as a value of this parameter. You can check the attached IP interface names with the following command:
82 (92)
addresses as symbols
SYM The way in which the addresses are shown
The possible values of the parameter are the following: YES NO Examples 1. Show network addresses as symbols Show network addresses as numbers (default value) Display the active Internet connections of OMU-0. QRS:OMU,0; 2. Display the active Internet connections of PCUS-1 of BCSU-0. QRS:BCSU,0:PCUS,1; 3. Display the active Internet connections of OMU-0, showing the network addresses as symbols. QRS:OMU,0::SYM=YES; 4. Display the active Internet connections of OMU-0 and the sockets used by server processes. QRS:OMU,0:ALL:SYM=YES; 5. Display the information of all interfaces which have been attached. QRS:OMU,0:INA:SYM=YES; 6. Display the information of the el0 network interface of OMU-1. QRS:OMU,1:INS,EL0:SYM=YES; 7. Display the routing tables of OMU-1. QRS:OMU,1:ROU:SYM=YES; 8. Display the per-protocol statistics of OMU-1. QRS:OMU,1:PRO:SYM=YES; 9. Display the active Internet connections of PCUS-1 of BCSU-0. QRS:BCSU,0:PCUS,1; Execution printouts The following abbreviations are used in the execution printouts of examples 1 to 4:
83 (92)
Proto Protocol Recv-Q Receive queue Send-Q Send queue Local Address IP address and port number Foreign Address Destination IP address and port number (state) Connection state The possible values are the following: LISTEN Passive open ESTABLISHED Data transfer state TIME_WAIT Closing The execution printout of command example 1 is the following:
UNIT: OMU-0 Active Internet connections Proto Recv-Q Send-Q Local Address tcp 0 0 131.228.45.176.23 tcp 0 0 131.228.45.176.23 tcp 0 269 131.228.45.176.23 COMMAND EXECUTED
84 (92)
UNIT: OMU-0 Active Internet connections Proto Recv-Q Send-Q Local Address tcp 0 0 ws20027.1114 tcp 0 0 ws20027.telnet tcp 0 0 ws20027.telnet tcp 0 347 ws20027.telnet COMMAND EXECUTED
(state) ESTABLISHED ESTABLISHED ESTABLISHED LISTEN LISTEN LISTEN LISTEN LISTEN LISTEN LISTEN LISTEN LISTEN LISTEN LISTEN LISTEN
The following abbreviations are used in the execution printouts of examples 5 and 6: Name Mtu Network Address Network interface name Maximum transmission unit Attached network Interface address
85 (92)
Coll 25 25 0 0
COMMAND EXECUTED
The following abbreviations are used in the execution printouts of examples 7 and 8: Destination Destination host or network Gateway Next-hop intermediary via which packets are routed Flags Route status. The possible values are the following: U G H Route is up Indirect route, that is, through a gateway Route is to a host
86 (92)
Flags UGS UH U UH UH
87 (92)
20345 messages received 0 messages received with too few bytes 0 messages received with bad checksum 20345 membership queries received 0 membership queries received with invalid field (s) 0 membership reports received 0 membership reports received with invalid field (s) 0 membership reports received for groups to which we belong 0 membership reports sent tcp: 15837 packets sent 8678 data packets (1322113 bytes) 0 data packets (0 bytes) retransmitted 6920 ack-only packets (2 delayed) 0 URG only packets 3 window probe packets 0 window update packets 236 control packets 13226 packets received 8499 acks (for 1322085 bytes) 332 duplicate acks 0 acks for unsent data 7467 packets (147668 bytes) received in-sequence 128 completely duplicate packets (128 bytes) 0 old duplicate packets 0 packets with some dup. data (0 bytes duped) 121 out-of-order packets (0 bytes) 0 packets (0 bytes) of data after window 0 window probes 7 window update packets 2 packets received after close 0 discarded for bad checksums 0 discarded for bad header offset fields 0 discarded because packet too short 112 connection requests 25 connection accepts 137 connections established (including accepts) ....
You have given a computer unit which does not have any TCP/IP service available. Change the computer unit to one which has TCP/IP services.
/*** INVALID INTERFACE NAME ***/
You have given an incorrect network interface name. Re-enter the command so that it begins with the letters 'CO', 'EL', 'LO', or 'MB' and has no more than six characters. The system may also output a general MML semantic error message.
88 (92)
If an error occurs, the system outputs a general MML execution error message.
89 (92)
90 (92)
Use this command to add or delete the prioritisation data of a computer unit. unit identification: interface name;
Parameter explanations
unit type
The type of the computer unit that sends the ICMP ECHO_REQUEST. The program provides a list of computer units for you to choose from. The default value is OMU.
unit index
The index of the computer unit that sends the ICMP ECHO_REQUEST. The maximum value of this parameter is determined by the number of units. The default value is the index of the active OMU.
unit group
The unit group number of the computer unit that sends the ICMP ECHO_REQUEST. The maximum value of the parameter is determined by the number of computer unit groups (or stages).
interface name
The name of the interface as a character string of maximum six characters.
91 (92)
You can check a unit's attached network interface names with the QRI: <unit>::YES; command. If you identify the computer unit and interface name, the information on that network interface is listed. Examples 1. Define the prioritised interface EL0 of OMU-0. QRP:OMU,0:EL0:; 2. Remove the prioritised interface EL0 of OMU-0. QRP:OMU,0:EL0:DEL; Execution printouts The execution printout of command example 1 is the following:
DX 200
DX200-LAB
1999-05-25
13:08:14
If an error occurs, the system outputs a general MML execution error message.
92 (92)