Vous êtes sur la page 1sur 92

BSC3153 Nokia GSM/EDGE BSS, Rel. BSS13, BSC and TCSM, Rel. S13, Product Documentation, v.

QR - TCP/IP Stack Data Handling

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

1 (92)

QR - TCP/IP Stack Data Handling

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

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

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

3 (92)

QR - TCP/IP Stack Data Handling

List of tables

4 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

List of figures

List of figures

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

5 (92)

QR - TCP/IP Stack Data Handling

6 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

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 made between issues 141 and 140


The following commands have been added: QRO QRQ QRU QRA QRB QRR INTERROGATE LOCAL DOMAIN NAMES CONFIGURE LOCAL DOMAIN NAME DELETE LOCAL DOMAIN NAME CREATE VLAN INTERFACES INTERROGATE VLAN INTERFACES DELETE VLAN INTERFACES

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

7 (92)

QR - TCP/IP Stack Data Handling

Changes made between issues 140 and 131


Changes in command QRN Information on MTU functionality has been added. Changes in command QRI Information on MTU texts has been added. Changes in commands QRC, QRD and QRL Commands QRC, QRD, and QRL have been removed, functionality has been transferred to command group QK as QKC, QKA and QKB.

Changes made between issues 131 and 130


Changes in command QRX Information on traceroute functionality has been added.

8 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QR - TCP/IP STACK DATA HANDLING

QR - TCP/IP STACK DATA HANDLING


Use the commands in this command group to maintain the data on TCP/IP stacks. The commands cover a wide range of manoeuvres related to TCP/IP stacks. Use the commands in this command group for the following tasks:
.

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

9 (92)

QR - TCP/IP Stack Data Handling

Menu of the command group:


TCP/IP STACK DATA HANDLING COMMANDS ? ..... DISPLAY MENU N: ..... CONFIGURE NETWORK INTERFACE G: ..... REMOVE NETWORK INTERFACE W: ..... FORCE INTERFACE SWITCHOVER I: ..... INTERROGATE NETWORK INTERFACE T: ..... CONFIGURE TCP/IP PARAMETERS H: ..... INTERROGATE TCP/IP PARAMETERS K: ..... CONFIGURE DNS PARAMETERS J: ..... INTERROGATE DNS PARAMETERS O: ..... INTERROGATE LOCAL DOMAIN NAMES Q: ..... CONFIGURE LOCAL DOMAIN NAME U: ..... DELETE LOCAL DOMAIN NAME A: ..... CREATE VLAN INTERFACES B: ..... INTERROGATE VLAN INTERFACES R: ..... DELETE VLAN INTERFACES F: ..... DISTRIBUTE CONFIGURATION FILE X: ..... TEST HOST REACHABILITY (PING/TRACEROUTE) S: ..... INTERROGATE NETWORK STATUS P: ..... PRIORITISE INTERFACE Z; ..... RETURN TO MAIN LEVEL

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRN CONFIGURE NETWORK INTERFACE

QRN CONFIGURE NETWORK INTERFACE


Function Parameters Syntax Use this command to configure a new network interface, modify an existing one and configure an IP address to a network interface. unit identification: plug-in unit identification: interface name: IP address: netmask length: destination IP address: maximum transmission unit: state;
QRN: <unit type>, [<unit index> | <unit group> , <unit index>]: [<plug-in unit type>, <plug-in unit index>]: <interface name>, [<U>|<N> | <N> def ]: [ <IP address> ], [ <L>|<P> | <L> def ]: [ <netmask length> | 8/16/24 def ]: [ <destination IP address> ]: [ <maximum transmission unit> | <interface default> def ]: [ <state> | <current> def ];

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

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

11 (92)

QR - TCP/IP Stack Data Handling

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.

plug-in unit type


The type of the plug-in unit in which you want to configure a network interface. The program provides a list of plug-in units for you to choose from.

plug-in unit index


The index of the plug-in unit in which you want to configure a network interface. The program provides a list of indices for you to choose from.

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRN CONFIGURE NETWORK INTERFACE

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

13 (92)

QR - TCP/IP Stack Data Handling

maximum transmission unit


This parameter gives the maximum transmission unit to be used with the network interface. The default maximum transmission unit for the IP address depends on the type of the interface which has been chosen. The limits are: (in bytes) Ethernet (ELxx): minimum 64, maximum 1500 and the default is 1500 Loopback: 33204 permanent value ATM (AAxx): minimum 64, maximum 9180, default 9180 MB: 992

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

Assign a physical IP address to the network interface el0 of OMU-0. QRN:OMU,0::EL0:131.228.45.176,P;

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRN CONFIGURE NETWORK INTERFACE

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.

Change the administrative state of network interface el0 to DOWN. QRN:OMU,0::EL0::::DOWN;

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

15 (92)

QR - TCP/IP Stack Data Handling

Execution printouts

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

The execution printout of command example 1 is the following:


CONFIGURED NETWORK INTERFACE IF UNIT NAME ------------------ -------OMU-0 EL0 COMMAND EXECUTED ADM STATE MTU ----- ----UP 1500 PRIO RITY ---NO IF TYPE ---ADDR TYPE IP ADDRESS ---- ----------------------P 131.128.45.176/16

The execution printout of command example 2 is the following:


CONFIGURED NETWORK INTERFACE IF UNIT NAME ------------------ -------BCSU-0 -PCUS-1 EL0 COMMAND EXECUTED ADM STATE MTU ----- ----UP 1500 PRIO RITY ---NO IF TYPE ---ADDR TYPE IP ADDRESS ---- ----------------------P 131.230.42.22/16

The execution printout of command example 3 is the following:


CONFIGURED NETWORK INTERFACE IF UNIT NAME ------------------ -------OMU-0 EL0 ADM STATE MTU ----- ----UP 1500 PRIO RITY ---NO IF TYPE ---ADDR TYPE ---P P

IP ADDRESS ----------------------131.128.45.176/16 131.128.45.178/20

COMMAND EXECUTED

The execution printout of command example 4 is the following:

16 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRN CONFIGURE NETWORK INTERFACE

CONFIGURED NETWORK INTERFACE IF NAME -------EL0 EL0 ADM STATE ----UP UP PRIO RITY ---NO NO IF TYPE ---ADDR TYPE ---L L

UNIT -----------------OMU-0 OMU-1 COMMAND EXECUTED

MTU ----1500 1500

IP ADDRESS ----------------------131.128.45.179/16 (131.128.45.179/16)

The execution printout of command example 5 is the following:


CONFIGURED NETWORK INTERFACE IF UNIT NAME ------------------ -------OMU-0 EL0 COMMAND EXECUTED ADM STATE MTU ----- ----DOWN 1500 PRIO RITY ---NO IF TYPE ---ADDR TYPE IP ADDRESS ---- ----------------------L 131.128.45.179/16

The execution printout of command example 6 is the following:


CONFIGURED NETWORK INTERFACE IF UNIT NAME ------------------ -------PAPU-2 EL0 COMMAND EXECUTED ADM STATE MTU ----- ----UP 1500 PRIO RITY ---NO IF TYPE ---ADDR TYPE IP ADDRESS ---- ----------------------L 131.128.45.180/16

The execution printout of command example 7 is the following:


CONFIGURED NETWORK INTERFACE IF UNIT NAME ------------------ -------PAPU-0 -IOCPE-1 AA0 ADM STATE MTU ----- ----UP 9180 PRIO RITY ---NO IF TYPE ---ADDR TYPE IP ADDRESS ---- ----------------------L 131.228.45.181/32 ->140.0.0.1

COMMAND EXECUTED

The execution printout of command example 8 is the following:


CONFIGURED NETWORK INTERFACE IF UNIT NAME ------------------ -------PAPU-0 -IOCPE-1 AA1 ADM STATE MTU ----- ----UP 9180 PRIO RITY ---NO IF TYPE ---U ADDR TYPE IP ADDRESS ---- ----------------------L 131.228.45.182/32

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

17 (92)

QR - TCP/IP Stack Data Handling

->140.0.0.2 COMMAND EXECUTED

The execution printout of command example 9 is the following:


CONFIGURED NETWORK INTERFACE IF UNIT NAME ------------------ -------OMU-0 EL0 COMMAND EXECUTED ADM STATE MTU ----- ----UP 1300 PRIO RITY ---NO IF TYPE ---ADDR TYPE IP ADDRESS ---- ----------------------P 66.6.6.6/8

Semantic error messages

/*** COMPUTER UNIT DOES NOT HAVE TCP/IP SERVICE ***/

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRN CONFIGURE NETWORK INTERFACE

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

19 (92)

QR - TCP/IP Stack Data Handling

20 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRG REMOVE NETWORK INTERFACE

QRG REMOVE NETWORK INTERFACE


Function Parameters Syntax Use this command to remove an existing network interface configuration. unit identification: plug-in unit identification: interface name;
QRG: <unit type>, [ <unit index> | [ <unit group>, <unit index> ] ]: [<plug-in unit type>, <plug-in unit index>]: <interface name>: [<IP address>];

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

21 (92)

QR - TCP/IP Stack Data Handling

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.

plug-in unit type


The type of the plug-in unit whose network interface you want to remove. The program provides a list of plug-in units for you to choose from.

plug-in unit index


The index of the plug-in unit whose network interface you want to remove. The program provides a list of indices for you to choose from.

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRG REMOVE NETWORK INTERFACE

Additional information Execution printouts

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.

The execution printout of command example 1 is the following:


REMOVED NETWORK INTERFACE IF UNIT NAME ------------------ -------OMU-0 EL0 ADM STATE MTU ----- ----UP 1500 PRIO RITY ---NO IF TYPE ---ADDR TYPE IP ADDRESS ---- ----------------------L 131.128.45.176/16

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.

CONFIRM COMMAND EXECUTION: Y/N ?

The execution printout of command example 2 is the following:


REMOVED NETWORK INTERFACE IF UNIT NAME ------------------ -------BCSU-0-PCU-1 EL0 ADM STATE MTU ----- ----UP 1500 PRIO RITY ---NO IF TYPE ---ADDR TYPE ---P P L

IP ADDRESS ----------------------131.128.45.181/16 131.128.45.182/16 (131.128.45.180/16)

NOTICE! EXISTING LOCAL IP ADDRESS BASED DEFAULT GATEWAYS RELATED TO THIS IP ADDRESS HAVE TO BE DELETED WITH ZQKP BEFORE IP ADDRESS CAN BE

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

23 (92)

QR - TCP/IP Stack Data Handling

DELETED SAFELY.

CONFIRM COMMAND EXECUTION: Y/N ?

The execution printout of command example 3 is the following:


REMOVED NETWORK INTERFACE IF UNIT NAME ------------------ -------OMU-0 EL0 ADM STATE MTU ----- ----UP 1500 PRIO RITY ---NO IF TYPE ---ADDR TYPE IP ADDRESS ---- ----------------------P 10.0.0.1/8

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.

CONFIRM COMMAND EXECUTION: Y/N ?

Semantic error messages

/*** COMPUTER UNIT DOES NOT HAVE TCP/IP SERVICE ***/

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRW FORCE INTERFACE SWITCHOVER

QRW FORCE INTERFACE SWITCHOVER


Function Parameters Syntax Use this command to force interface switchover. unit identification: interface name;
QRW: <unit type>, [ <unit index> | [ <unit group> , <unit index> ] ]: <interface name>;

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

25 (92)

QR - TCP/IP Stack Data Handling

This parameter is asked only if needed, but in that case it is obligatory.

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:

INTERFACE SWITCHOVER FROM OMU:EL0 COMMAND EXECUTED

Semantic error messages

/*** COMPUTER UNIT DOES NOT HAVE TCP/IP SERVICE ***/

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRW FORCE INTERFACE SWITCHOVER

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

27 (92)

QR - TCP/IP Stack Data Handling

28 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRI INTERROGATE NETWORK INTERFACE

QRI INTERROGATE NETWORK INTERFACE


Function Parameters Syntax
QRI: [ <unit type>, [ <unit index> | [ <unit group> , <unit index> ] | <all> def ]: [<plug-in unit type>, <plug-in unit index>]: [ <interface name> | <all> def ]: [ <display unit's attached network interfaces> | NO def ] ] | <interrogate all interfaces of all units> def;

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

29 (92)

QR - TCP/IP Stack Data Handling

The maximum value of this parameter is determined by the number of units. The default value is all indices of the given unit.

plug-in unit type


The type of the plug-in unit from which you want to interrogate a network interface. The program provides a list of plug-in units for you to choose from.

plug-in unit index


The index of the plug-in unit from which you want to interrogate the network interface. The program provides a list of indices for you to choose from.

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;

display unit's attached network interfaces


Use this parameter to choose whether you want to list attached network interfaces. NO YES Examples 1. The attached interfaces are not listed. This is the default value. The attached interfaces are listed. Interrogate all configured network interfaces of all computer units. QRI;

30 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRI INTERROGATE NETWORK INTERFACE

2.

Interrogate all configured network interfaces of BCSU computer units. QRI:BCSU;

3.

Interrogate all configured network interfaces of BCSU-1 computer unit. QRI:BCSU,1;

4.

Interrogate all configured and attached network interfaces of BCSU1 PCUS-4 plug-in unit. QRI:BCSU,1:PCUS,4::YES;

5.

Interrogate el0 network interface of OMU computer unit. QRI:OMU::EL0;

6.

Interrogate el0 network interface of all computer units. QRI:::EL0;

7.

Interrogate all configured network interfaces of BCSU-2's PCUS-4 plug-in unit. QRI:BCSU,2:PCUS,4;

Additional information Execution printouts

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

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

31 (92)

QR - TCP/IP Stack Data Handling

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

The execution printout of command example 1 is the following:


INTERROGATING NETWORK INTERFACE DATA ADDR ADM TYPE NML ASSIGNED STATE ---- --- -------- ----P 8 YES UP P 8 YES UP P 8 YES P 8 YES UP P 8 YES UP L 24 YES UP PRIORISED ----- ----1500 NO 1500 NO MTU

UNIT -----------------BCSU-1 -PCUS- 4

NAME -----EL0 IFETH0

IP ADDRESS --------------1.2.3.4 14.4.4.44 20.1.1.11 17.7.7.77

-PCUS- 4 BCSU-2 OMU COMMAND EXECUTED

IFETH1 EL0 1.2.3.5 EL0 172.21.227.13

1500 1500 1500

NO NO NO

The execution printout of command example 2 is the following:


INTERROGATING NETWORK INTERFACE DATA ADDR ADM TYPE NML ASSIGNED STATE ---- --- -------- ----P 8 YES UP P 8 YES UP P 8 YES P 8 YES UP P 8 YES UP PRIORISED ----- ----1500 NO 1500 NO MTU

UNIT -----------------BCSU-1 -PCUS- 4

NAME -----EL0 IFETH0

IP ADDRESS --------------1.2.3.4 14.4.4.44 20.1.1.11 17.7.7.77

-PCUS- 4 BCSU-2 COMMAND EXECUTED

IFETH1 EL0 1.2.3.5

1500 1500

NO NO

The execution printout of command example 3 is the following:


INTERROGATING NETWORK INTERFACE DATA ADDR ADM TYPE NML ASSIGNED STATE ---- --- -------- ----P 8 YES UP P 8 YES UP P 8 YES PRIORISED ----- ----1500 NO 1500 NO MTU

UNIT -----------------BCSU-1 -PCUS- 4

NAME -----EL0 IFETH0

IP ADDRESS --------------1.2.3.4 14.4.4.44 20.1.1.11

32 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRI INTERROGATE NETWORK INTERFACE

17.7.7.77 -PCUS- 4 COMMAND EXECUTED IFETH1

8 YES UP 1500 NO

The execution printout of command example 4 is the following:


INTERROGATING NETWORK INTERFACE DATA ADDR ADM TYPE NML ASSIGNED STATE ---- --- -------- ----P 8 YES UP P 8 YES P 8 YES UP PRIORISED ----- ----1500 NO MTU

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

The execution printout of command example 5 is the following:


INTERROGATING NETWORK INTERFACE DATA ADDR UNIT NAME IP ADDRESS TYPE NML ASSIGNED ------------------ ------ --------------- ---- --- -------OMU EL0 172.21.227.13 L 24 YES COMMAND EXECUTED ADM MTU STATE ----- ----UP 1500 PRIORISED ----NO

The execution printout of command example 6 is the following:


INTERROGATING NETWORK INTERFACE DATA ADDR ADM TYPE NML ASSIGNED STATE ---- --- -------- ----P 8 YES UP P 8 YES UP L 24 YES UP PRIORISED ----- ----1500 NO 1500 NO 1500 NO MTU

UNIT -----------------BCSU-1 BCSU-2 OMU COMMAND EXECUTED

NAME -----EL0 EL0 EL0

IP ADDRESS --------------1.2.3.4 1.2.3.5 172.21.227.13

The execution printout of command example 7 is the following:


INTERROGATING NETWORK INTERFACE DATA ADDR ADM MTU TYPE NML ASSIGNED STATE PRIORISED

UNIT

NAME

IP ADDRESS

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

33 (92)

QR - TCP/IP Stack Data Handling

------------------ ------ --------------- ---- --- -------- ----- ----- ----BCSU-2 -PCUS- 4 IFETH0 66.6.6.6 P 8 YES UP 1300 NO COMMAND EXECUTED

Semantic error messages

/*** COMPUTER UNIT DOES NOT HAVE TCP/IP SERVICE ***/

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRT CONFIGURE TCP/IP PARAMETERS

QRT CONFIGURE TCP/IP PARAMETERS


Function Parameters Syntax
QRT: <unit type>, [ <unit index> | [ <unit group> , <unit index> ] ]: [<plug-in unit type>, <plug-in unit index>]: ( [ HOST = <host name> | . | <current> def ], [ IPF = <IP forwarding> | NO def if configured first time ], [ TTL = <IP TTL> | 64 def if configured first time ], [ SNL = <subnets are local> | YES def if configured first time ] );

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

35 (92)

QR - TCP/IP Stack Data Handling

The maximum value of this parameter is determined by the number of units.

plug-in unit type


The type of the plug-in unit from which you want to configure the TCP/IP stack parameters. The program provides a list of plug-in units for you to choose from.

plug-in unit index


The index of the plug-in unit in which you want to configure the TCP/IP stack parameters. The maximum value of this parameter is determined by the number of plug-in units. The program provides a list of indices for you to choose from.

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRT CONFIGURE TCP/IP PARAMETERS

Values range form zero to 255. The default value is 64 if configured for the first time, otherwise the current value remains.

Subnets are local


This parameter defines whether subnets are considered to be local addresses. If not, only destination IP addresses on an attached subnetwork are considered local. The default value is YES if parameters are configured for the first time, otherwise the current value remains. YES NO Examples 1. Subnets are local addresses This is the default value if configured for the first time. Subnets are not local addresses Give the host name MYHOST to the OMU-0 computer unit (all other parameters get the default values). QRT:OMU,0::HOST=MYHOST; 2. Give the host name YOURHOST.NTC.NOKIA.COM to the OMU-1 computer unit, allow IP forwarding, set time-to-live to 70 and do not allow subnets to be local addresses. QRT:OMU,1::HOST="YOURHOST.NTC.NOKIA.COM",IPF=YES, TTL=70,SNL=NO; Additional information You can interrogate the current TCP/IP parameters using the QRH command. When configuring TCP/IP parameters, you must define at least one of the parameters in the second parameter block, that is, either host name, IP forwarding, IP TTL, or subnets are local. The following abbreviations are used in the execution printouts:

Execution printouts

UNIT IP FORW TTL SNL HOST NAME

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

The execution printout of command example 1 is the following:

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

37 (92)

QR - TCP/IP Stack Data Handling

CONFIGURED TCP/IP PARAMETER DATA UNIT IP FORW TTL SNL HOST NAME ------------------ ------- --- --- ---------------------------------------OMU-0 NO 64 YES MYHOST COMMAND EXECUTED

The execution printout of command example 2 is the following:


CONFIGURED TCP/IP PARAMETER DATA UNIT IP FORW TTL SNL HOST NAME ------------------ ------- --- --- ---------------------------------------OMU-1 YES 70 NO YOURHOST.NTC.NOKIA.COM COMMAND EXECUTED

Semantic error messages

/*** COMPUTER UNIT DOES NOT HAVE TCP/IP SERVICE ***/

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRH INTERROGATE TCP/IP PARAMETERS

QRH INTERROGATE TCP/IP PARAMETERS


Function Parameters Syntax
QRH: [ <unit type>, [ <unit index> | <unit group> , <unit index> ]] | specific parameters of all units> def;

Use this command to interrogate TCP/IP protocol stack specific parameters. unit identification;

<interrogate all TCP/IP Stack

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;

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

39 (92)

QR - TCP/IP Stack Data Handling

2.

Interrogate TCP/IP parameter information of all OMU units. QRH:OMU;

3.

Interrogate TCP/IP parameter information of OMU-0. QRH:OMU,0;

Execution printouts

The following abbreviations are used in the execution printouts:

UNIT IP FORW TTL SNL HOST NAME

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

The execution printout of command examples 1 and 2 is the following:


INTERROGATED TCP/IP PARAMETER DATA UNIT IP FORW TTL SNL HOST NAME ------------------ ------- --- ---------------------------------------------------OMU-0 NO 64 YES MYHOST OMU-1 YES 80 NO YOURHOST.NET.NOKIA.COM COMMAND EXECUTED

Semantic error messages

/*** COMPUTER UNIT DOES NOT HAVE TCP/IP SERVICE ***/

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRK CONFIGURE DNS PARAMETERS

QRK CONFIGURE DNS PARAMETERS


Function Use this command to define whether the DNS service is used in the TCP/ IP data transfer service. If it is used, a common domain name of the local environment and the DNS server addresses are given. All computer units in the network element that have TCP/IP services belong to the same domain. primary DNS server, secondary DNS server, third DNS server, local domain name, network sortlist, netmask sortlist, resolver cache, round robin, lookup order;
QRK: [ [ [ [ [ [ [ [ [ <primary DNS server> | 0.0.0.0 | current def ] , <secondary DNS server> | 0.0.0.0 | current def ] , <third DNS server> | 0.0.0.0 | current def ] , <local domain name> | . | current def ] <network sortlist> | 0.0.0.0 | <current> def ] , <netmask sortlist> | 8/16/24 def ] : <resolver cache> | <YES> def | <current> def] , <round robin> | <YES> def | <current> def] , <lookup order> | <YES> def | <current> def] ;

Parameters

Syntax

Parameter explanations

primary DNS server


The IP address of the primary DNS server. The address is specified in the conventional dot notation (#.#.#.#). If you give 0.0.0.0 as the value, there is no primary DNS server and the DNS is not used. The default value is the current value.

secondary DNS server


The IP address of the secondary DNS server. The address is specified in the conventional dot notation (#.#.#.#).

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

41 (92)

QR - TCP/IP Stack Data Handling

If you give 0.0.0.0 as the value, there is no secondary DNS server. The default value is the current value.

third DNS server


The IP address of the third DNS server. The address is specified in the conventional dot notation (#.#.#.#). If you give 0.0.0.0 as the value, there is no third DNS server. The default value is the current value.

local domain name


The local domain name as a character string. The maximum length of the name is 100 characters. If you enter a full stop/ period (.) as the value, no domain name is used. 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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRK CONFIGURE DNS PARAMETERS

YES NO

The resolver cache is in use The resolver cache is not in use

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;

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

43 (92)

QR - TCP/IP Stack Data Handling

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRK CONFIGURE DNS PARAMETERS

RESOLVER CACHE IS IN USE ROUND ROBIN IS IN USE LOOKUP ORDER CACHE, NETWORK AND HOSTS COMMAND EXECUTED

The execution printout of command example 2 is the following:


CONFIGURED DNS PARAMETERS DOMAIN NAME: STARDUST.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

The execution printout of command example 3 is the following:


CONFIGURED DNS PARAMETERS PRIMARY DNS SERVER..: 177.77.77.99 SECONDARY DNS SERVER: 133.3.33.3 DOMAIN NAME: STARDUST.COM RESOLVER CACHE IS NOT IN USE ROUND ROBIN IS NOT IN USE LOOKUP ORDER CACHE, HOSTS AND NETWORK COMMAND EXECUTED

The execution printout of command example 4 is the following:


CONFIGURED DNS PARAMETERS PRIMARY DNS SERVER..: 177.77.77.99 SECONDARY DNS SERVER: 177.77.77.100 RESOLVER CACHE IS NOT IN USE ROUND ROBIN IS NOT IN USE LOOKUP ORDER CACHE, HOSTS AND NETWORK COMMAND EXECUTED

The execution printout of command example 5 is the following:


CONFIGURED DNS PARAMETERS PRIMARY DNS SERVER..: 177.77.77.99 SECONDARY DNS SERVER: 177.77.77.111 THIRD DNS SERVER....: 122.2.2.2

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

45 (92)

QR - TCP/IP Stack Data Handling

RESOLVER CACHE IS NOT IN USE ROUND ROBIN IS NOT IN USE LOOKUP ORDER CACHE, HOSTS AND NETWORK COMMAND EXECUTED

Semantic error messages

/*** IP ADDRESS IS ILLEGAL ***/

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRJ INTERROGATE DNS PARAMETERS

QRJ INTERROGATE DNS PARAMETERS


Function Use this command to interrogate the current DNS parameters. If the DNS service is used in TCP/IP data transfer, a common domain name of the local environment and the DNS server addresses are displayed. All computer units in the network element that have TCP/IP services belong to the same domain. Parameters Syntax Examples 1. The command has no parameters.
QRJ;

Interrogate the current DNS parameters. QRJ;

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

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

47 (92)

QR - TCP/IP Stack Data Handling

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

Semantic error messages Execution error messages

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRO INTERROGATE LOCAL DOMAIN NAMES

QRO INTERROGATE LOCAL DOMAIN NAMES


Function Parameters Syntax Parameter explanations Use this command to list the domain name data. domain name: ip addr family;
QRO: [ <domain name> ]: [<ip addr family>];

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";

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

49 (92)

QR - TCP/IP Stack Data Handling

Execution printouts

The following abbreviations are used in the 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

The execution printout of command example 2 is the following:


QRB::IPV6; INTERROGATED DOMAIN NAME PARAMETERS DOMAIN NAME AND ADDRESS FAMILY: WWW.NOKIA.COM IPV6 IP ADDRESSES: 3FFE:0123:0123:0123:0000:0000:0000:0123 COMMAND EXECUTED

The execution printout of command example 3 is the following:


QRO:"WWW.NOKIA.COM"; INTERROGATED DOMAIN NAME PARAMETERS

50 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRO INTERROGATE LOCAL DOMAIN NAMES

DOMAIN NAME AND ADDRESS FAMILY: WWW.NOKIA.COM IP IP ADDRESSES: 123.123.123.123 COMMAND EXECUTED

Semantic error messages

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

51 (92)

QR - TCP/IP Stack Data Handling

52 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRQ CONFIGURE LOCAL DOMAIN NAME

QRQ CONFIGURE LOCAL DOMAIN NAME


Function Parameters Syntax
QRQ: <domain name>, [ <IP addr family> ]: [ NAME = <domain canonical name> | IP = <domain IP address> ];

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.

domain canonical name


The canonical name of the domain name. 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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

53 (92)

QR - TCP/IP Stack Data Handling

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

The execution printout of command example 2 is the following:

54 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRQ CONFIGURE LOCAL DOMAIN NAME

CONFIGURED DOMAIN NAME PARAMETERS DOMAIN NAME AND ADDRESS FAMILY: WWW.NOKIA.COM IP CANONICAL NAMES: WWW.NOKIA.FI

COMMAND EXECUTED

Semantic error messages

/*** INVALID INFORMATION UNIT ***/

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

55 (92)

QR - TCP/IP Stack Data Handling

56 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRU DELETE LOCAL DOMAIN NAME

QRU DELETE LOCAL DOMAIN NAME


Function Parameters Syntax
QRU: [ <domain name> ], [<IP addr family>]: [ NAME = <domain canonical name> | IP = <domain IP address> ];

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 canonical name


The deleted canonical name of the domain name. 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.

domain IP address
The deleted IP address of domain name.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

57 (92)

QR - TCP/IP Stack Data Handling

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.

CONFIRM COMMAND EXECUTION: Y/N ? Y MSCi DX220-LAB 2006-04-28 14:20:27

DELETED DOMAIN NAME PARAMETERS IP

COMMAND EXECUTED

The execution printout of command example 2 is the following:


QRU:"WWW.NOKIA:COM",IPV6; MSCi DX220-LAB 2006-05-03 13:26:24

DELETED DOMAIN NAME PARAMETERS DOMAIN NAME AND ADDRESS FAMILY: WWW.NOKIA.COM IPV6

58 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRU DELETE LOCAL DOMAIN NAME

COMMAND EXECUTED

Semantic error messages

/*** INVALID DOMAIN NAME ***/

You have given an invalid interface name. Give another interface.


/*** INVALID INFORMATION UNIT ***/

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

59 (92)

QR - TCP/IP Stack Data Handling

60 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRA CREATE VLAN INTERFACES

QRA CREATE VLAN INTERFACES


Function Parameters Syntax Use this command to create VLAN interfaces. unit identification: PIU identification: VLAN interface: VLAN identifier: network interface identification: priority: canonical format indicator;
QRA: [ <unit type>,]: [<plug-in unit type>, <plug-in unit index>]: [ <VLAN interface identification> ]: [ <vid> ]: [ <network interface identification> ]: <priority> | 0 def >: <cfi>| 0 def;

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.

plug-in unit type


The type of the plug-in unit in which you want to create a VLAN interface. The program provides a list of plug-in units for you to choose from.

plug-in unit index


The index of the plug-in unit in which you want to create a VLAN interface. The program provides a list of indices for you to choose from.

VLAN interface identification

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

61 (92)

QR - TCP/IP Stack Data Handling

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.

network interface identification


The name of the network interface you want to bind the VLAN interface to.

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

VLAN NAME IF NAME VID

62 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRA CREATE VLAN INTERFACES

PRI CFI

Priority Canonical Format Indicator

The execution printout of command example 1 is the following:


QRA:BCSU::VLAN50:50:EL0:2:; BSC SP403 2006-02-06 16:21:51

CONFIGURED VLAN INTERFACE VLAN UNIT NAME ------------------ -------BCSU VLAN50 COMMAND EXECUTED IF NAME VID PRI CFI -------- ---- --- --EL0 50 2 0

The execution printout of command example 2 is the following:


QRA:OMU::VLAN3000:3000:EL0:4:1:; BSC SP403 2006-02-07 18:35:42

CONFIGURED VLAN INTERFACE VLAN UNIT NAME ------------------ -------OMU VLAN3000 COMMAND EXECUTED IF NAME VID PRI CFI -------- ---- --- --EL0 3000 4 1

Semantic error messages

/*** VALUE TOO HIGH ***/

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

63 (92)

QR - TCP/IP Stack Data Handling

64 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRB INTERROGATE VLAN INTERFACES

QRB INTERROGATE VLAN INTERFACES


Function Parameters Syntax Use this command to list the VLANs of a given unit. unit type: plug-in unit type, plug-in unit index: VLAN interface name;
QRB: [ <unit type>,]: [<plug-in unit type>, <plug-in unit index>]: [ <VLAN interface name> ];

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.

plug-in unit type


The type of the plug-in unit in which you interrogate the VLAN interfaces. The program provides a list of plug-in units for you to choose from.

plug-in unit index


The index of the plug-in unit in which you interrogate the VLAN interfaces. The program provides a list of indices for you to choose from.

VLAN interface name


The name of the VLAN interface which you want to interrogate. The name must begin with 'VLAN' and the letters that follow it must all be digits. The default value is all network interfaces.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

65 (92)

QR - TCP/IP Stack Data Handling

Examples

1.

Interrogate all VLAN interfaces. QRB;

2.

Interrogate the VLAN interfaces of OMU. QRB:OMU;

3.

Interrogate the VLAN interface VLAN20. QRB:::VLAN20;

Execution printouts

The following abbreviations are used in the execution printouts:

UNIT

VLAN NAME IF NAME VID PRI CFI

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

The execution printout of command example 1 is the following:


QRB; INTERROGATING VLAN INTERFACES VLAN NAME -------VLAN20 VLAN300 IF NAME -------EL0 EL0

UNIT -----------------BCSU OMU COMMAND EXECUTED

VID ---20 300

PRI --3 4

CFI --1 0

The execution printout of command example 2 is the following:


QRB:OMU; INTERROGATING VLAN INTERFACES VLAN NAME IF NAME

UNIT

VID

PRI CFI

66 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRB INTERROGATE VLAN INTERFACES

------------------ -------- -------- ---- --- --OMU VLAN300 EL0 300 4 0 COMMAND EXECUTED

The execution printout of command example 3 is the following:


QRB:::VLAN20; BSC SP403 2006-02-22 16:50:14

INTERROGATING VLAN INTERFACES VLAN UNIT NAME ------------------ -------BCSU VLAN20 COMMAND EXECUTED IF NAME VID PRI CFI -------- ---- --- --EL0 20 3 1

Semantic error messages

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

67 (92)

QR - TCP/IP Stack Data Handling

68 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRR DELETE VLAN INTERFACES

QRR DELETE VLAN INTERFACES


Function Parameters Syntax Use this command to delete the existing VLAN interfaces. unit type: plug-in unit type, plug-in unit index: VLAN interface name;
QRR: [ <unit type>,]: [<plug-in unit type>, <plug-in unit index>]: [ <VLAN interface name> ];

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.

plug-in unit type


The type of the plug-in unit from which you delete the VLAN interfaces The program provides a list of plug-in units for you to choose from.

plug-in unit index


The index of the plug-in unit from which you delete the VLAN interfaces The program provides a list of indexes for you to choose from.

VLAN interface name


The name of the VLAN interface which you delete. The name must begin with 'VLAN' and the following letters must all be digits. The default value is all network interfaces.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

69 (92)

QR - TCP/IP Stack Data Handling

Examples

1.

Delete all VLAN interfaces on OMU. QRR:OMU;

2.

Delete VLAN100 interface on OMU. QRR:OMU::VLAN100;

Execution printouts

The following abbreviations are used in the execution printouts:

UNIT

VLAN NAME IF NAME VID PRI CFI

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

The execution printout of command example 1 is the following:


BSC SP403 2006-02-08 12:20:10

REMOVE VLAN INTERFACE VLAN UNIT NAME ------------------ -------OMU VLAN3000 IF NAME VID PRI CFI -------- ---- --- --EL0 3000 4 1

CONFIRM COMMAND EXECUTION: Y/N ? Y COMMAND EXECUTED

The execution printout of command example 2 is the following:


QRR:BCSU::VLAN200:; BSC SP403 2006-02-08 12:21:16

REMOVE VLAN INTERFACE VLAN UNIT NAME ------------------ -------BCSU VLAN200 IF NAME VID PRI CFI -------- ---- --- --EL0 200 1 0

70 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRR DELETE VLAN INTERFACES

CONFIRM COMMAND EXECUTION: Y/N ? Y COMMAND EXECUTED

Semantic error messages

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

71 (92)

QR - TCP/IP Stack Data Handling

72 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRF DISTRIBUTE CONFIGURATION FILE

QRF DISTRIBUTE CONFIGURATION FILE


Function Use this command to propagate a configuration file within a network element. The file must be one of the configuration files which cannot be modified by MML commands, that is, one of the following:
.

/etc/protocols /etc/services /etc/hosts

Parameters Syntax Parameter explanations

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.

Propagate the changed etc/hosts file . QRF:"/etc/hosts";

Execution printouts

The execution printout of command example 1 is the following:

PROPAGATED FOLLOWING FILE (S): ETC/HOSTS COMMAND EXECUTED

Semantic error messages Execution error messages

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

73 (92)

QR - TCP/IP Stack Data Handling

74 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRX TEST HOST REACHABILITY (PING / TRACEROUTE)

QRX TEST HOST REACHABILITY (PING / TRACEROUTE)


Function Use the PING command to send the ICMP ECHO_REQUEST packet to the network hosts. The command uses the ICMP protocol's ECHO_REQUEST datagram to elicit an ICMP ECHO_RESPONSE from a host or gateway. Use the TRACEROUTE command to trace the route to a host by launching UDP probe packets with a small ttl (time to live) and then listening for an ICMP 'time exceeded' reply from a gateway. Parameters unit identification: plug-in unit identification; host, IP address: ping, trace: max number of hops, wait time for each hop, print hop address numerically;

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

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

75 (92)

QR - TCP/IP Stack Data Handling

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.

plug-in unit type


The type of the plug-in unit that sends the request. The program provides a list of plug-in units for you to choose from.

plug-in unit index


The index of the plug-in unit that sends the request. The program provides a list of indices for you to choose from.

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRX TEST HOST REACHABILITY (PING / TRACEROUTE)

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.

max number of hops


The maximum number of hops used in outgoing probe packets. The parameter value ranges from 2 to 30. The default value is 15. This parameter can be given only if the command parameter has the value TRACE.

wait time for each hop


The waiting time (in seconds) to wait for a response to a probe. The parameter value ranges from 2 to 254. The default value is 3. This parameter can be given only if the command parameter has the value TRACE.

print hop addresses numerically


The hop address printing style, numerical or symbolical. The default is numerical. YES NO Print hop addresses numerically Print hop address symbolically and numerically

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";

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

77 (92)

QR - TCP/IP Stack Data Handling

4.

Ping host 131.228.45.33 from PCUS-1 of BCSU-0 (active unit). QRX:BCSU,0:PCUS,1:IP=131.228.45.33;

5.

Traceroute host 131.228.45.33 from OMU-0. QRX:OMU,0::IP=131.228.45.33:TRACE:M=5,W=5,N=YES;

Execution printouts

The execution printout of command examples 1, 2, and 3 is the following:

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

The execution printout of command example 4 is the following:


PING, SENDING UNIT: BCSU-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

The execution printout of command example 5 is the following:


TRACEROUTE, SENDING UNIT: OMU-0 traceroute to 131.228.45.33 (131.228.45.33), 2 hops max, 40 byte packets 1 131.228.45.33 (131.228.45.33) 0.002 ms 0.002 ms 0.002 ms COMMAND EXECUTED

Semantic error messages

/*** COMPUTER UNIT DOES NOT HAVE TCP/IP SERVICE ***/

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRX TEST HOST REACHABILITY (PING / TRACEROUTE)

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

79 (92)

QR - TCP/IP Stack Data Handling

80 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRS INTERROGATE NETWORK STATUS

QRS INTERROGATE NETWORK STATUS


Function Use this command to display the contents of various network-related data structures symbolically. When you give only the unit identification parameter, this command shows the active Internet connections of the current computer unit. Parameters Syntax
QRS: <unit type>, [ <unit index> | [ <unit group> , <unit index> ] ]: [<plug-in unit type>, <plug-in unit index>]: [ <mode> | <ALL> def ], [ <interface name> ]: [ SYM = <addresses as symbols> | NO def ];

unit identification; mode, interface name: addresses as symbols;

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

81 (92)

QR - TCP/IP Stack Data Handling

The maximum value of this parameter is determined by the number of units.

plug-in unit type


The type of the target plug-in unit. The program provides a list of plug-in units for you to choose from.

plug-in unit index


The index of the target plug-in unit. The program provides a list of indices for you to choose from.

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRS INTERROGATE NETWORK STATUS

QRI:<unit type>,<unit index>:::YES;

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:

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

83 (92)

QR - TCP/IP Stack Data Handling

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

Foreign Address 131.228.117.141.1327 131.228.49.20.1071 131.228.117.227.2483

(state) ESTABLISHED ESTABLISHED ESTABLISHED

The execution printout of command example 2 is the following:


UNIT: BCSU-0 Active Internet connections Proto Recv-Q Send-Q Local Address tcp 0 0 131.228.45.176.24 tcp 0 0 131.228.45.176.24 tcp 0 270 131.228.45.176.24 COMMAND EXECUTED

Foreign Address 131.228.117.141.1327 131.228.49.20.1071 131.228.117.227.2483

(state) ESTABLISHED ESTABLISHED ESTABLISHED

The execution printout of command example 3 is the following:

84 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRS INTERROGATE NETWORK STATUS

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

Foreign Address axl01it.domain heprn01ntc-dhcp-.1327 tne05.1071 heprn01ntc-dhcp-.2483

(state) TIME_WAIT ESTABLISHED ESTABLISHED ESTABLISHED

The execution printout of command example 4 is the following:


UNIT: OMU-0 Active Internet connections (including servers) Proto Recv-Q Send-Q Local Address Foreign Address tcp 0 0 ws20027.telnet heprn01ntc-dhcp-.1327 tcp 0 0 ws20027.telnet tne05.1071 tcp 0 289 ws20027.telnet heprn01ntc-dhcp-.2483 tcp 0 0 *.qotd *.* tcp 0 0 *.time *.* tcp 0 0 *.daytime *.* tcp 0 0 *.chargen *.* tcp 0 0 *.discard *.* tcp 0 0 *.echo *.* tcp 0 0 *.finger *.* tcp 0 0 *.login *.* tcp 0 0 *.shell *.* tcp 0 0 *.telnet *.* tcp 0 0 *.ftp *.* tcp 0 0 *.sunrpc *.* udp 0 0 *.1028 *.* udp 0 0 *.1027 *.* udp 0 0 *.1026 *.* udp 0 0 *.time *.* udp 0 0 *.daytime *.* udp 0 0 *.chargen *.* udp 0 0 *.discard *.* udp 0 0 *.echo *.* udp 0 0 *.ntalk *.* udp 0 0 *.biff *.* udp 0 0 *.sunrpc *.* udp 0 0 *.syslog *.* 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

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

85 (92)

QR - TCP/IP Stack Data Handling

Ipkts Ierrs Opkts Oerrs Coll

Input packets Input errors Output packets Output errors Collision

The execution printout of command example 5 is the following:


UNIT: Name el0 el0 lo0 lo0 OMU-0 Mtu 1500 1500 32976 32976

Network Link 131.228 Link your-net

Address 00:00:4b:30:21:34 ws20027 localhost

Ipkts Ierrs 2196426 0 2196426 0 163 0 163 0

Opkts Oerrs 18294 0 18294 0 163 0 163 0

Coll 25 25 0 0

COMMAND EXECUTED

The execution printout of command example 6 is the following:


UNIT: OMU-1 el0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 1500 inet 3.3.3.3 netmask 0xff000000 broadcast 3.255.255.255 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

The execution printout of command example 7 is the following:


UNIT: OMU-1 Routing tables Internet:

86 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRS INTERROGATE NETWORK STATUS

Destination default localhost 131.228.148.0 hiomo3-rsm-gw.nt tirion.ntc.nokia COMMAND EXECUTED

Gateway hiomo3-rsm-gw.ntc. 127.0.0.1 link#1 0:e0:34:9c:70:0 0:0:3b:80:3c:d5

Flags UGS UH U UH UH

The execution printout of command example 8 is the following:


UNIT: OMU-1 ip: 673596 total packets received 382 bad header checksums 0 with size smaller than minimum 0 with data size < data length 0 with length > max ip packet size 0 with header length < data size 0 with data length < header length 0 with bad options 0 with incorrect version number 0 fragments received 0 fragments dropped (dup or out of space) 0 malformed fragments dropped 0 fragments dropped after timeout 0 packets reassembled ok 600680 packets for this host 71791 packets for unknown/unsupported protocol 0 packets forwarded 743 packets not forwardable 0 redirects sent 16879 packets sent from this host 173 packets sent with fabricated ip header 0 output packets dropped due to no bufs, etc. 0 output packets discarded due to no route 0 output datagrams fragmented 0 fragments created 0 datagrams that can't be fragmented icmp: 101 calls to icmp_error 0 errors not generated because old message was icmp Output histogram: echo reply: 416 destination unreachable: 101 0 messages with bad code fields 0 messages < minimum length 0 bad checksums 0 messages with bad length Input histogram: echo reply: 226 destination unreachable: 7 echo: 416 time exceeded: 50 416 message responses generated igmp:

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

87 (92)

QR - TCP/IP Stack Data Handling

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

Semantic error messages

/*** COMPUTER UNIT DOES NOT HAVE TCP/IP SERVICE ***/

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)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRS INTERROGATE NETWORK STATUS

Execution error messages

If an error occurs, the system outputs a general MML execution error message.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

89 (92)

QR - TCP/IP Stack Data Handling

90 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en

QRP PRIORITISE INTERFACE

QRP PRIORITISE INTERFACE


Function Parameters Syntax
QRP: <unit type>, [ <unit index> | [ <unit group>, <unit index> ] ]: <interface name>: [del];

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.

DN9828275 Issue 14-1 en

# Nokia Siemens Networks

91 (92)

QR - TCP/IP Stack Data Handling

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

PRIORITISED INTERFACE FROM OMU-0:EL0 COMMAND EXECUTED

The execution printout of command example 2 is the following:


DX 200 DX200-LAB 1999-05-25 13:08:14

PRIORITISED INTERFACE FROM OMU-0:EL0 REMOVED COMMAND EXECUTED

Execution error messages

If an error occurs, the system outputs a general MML execution error message.

92 (92)

# Nokia Siemens Networks

DN9828275 Issue 14-1 en