serv ice=printv

11/30/12 iew&library =a25003a0000a7700676p1&source=xdoc&item=d

QRN

- CONFIGURE IP ADDRESS

Function
Use this command to configure a new IP address for a network interface.
The EL0 and EL1 are used as the slav e interf aces f or bond0.

Parameters
unit identification; plug-in unit identification; interface name; IP address; netmask, address type and attributes;
destination IP address;
Syntax

Syntax
QRN: <unit type>, [<unit index> | <unit group> , <unit index>]:
[<plug-in unit type>, <plug-in unit index>]:
<interface name>, [<redundant ip address interface name>]:
<IP address>, [ <IPv4 netmask length> | 8/16/24 def |
<IPv6 prefix length> | <64> def ],
[[IP address type <L> | <P> | <L> def ] ,
[<attributes <V> | <I> | <D> | <M> | <C>]]:
[ <destination IP address> ];

Param eter explanations

Param eter explanations

unit type
The ty pe of the computer unit in which y ou want to conf igure the IP address.
The program prov ides a list of computer units to choose f rom. This parameter is obligatory .
unit group
The unit group number of the computer unit in which y ou want to conf igure the IP address.
The maximum v alue 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
The index of the computer unit in which y ou want to conf igure the IP address. This parameter can be omitted if a logical IP address is conf igured to a 2N
unit.
The maximum v alue of this parameter is determined by the number of units.
plug-in unit type
The ty pe of the plug-in unit in which y ou want to conf igure the IP address.
The program prov ides a list of plug-in units to choose f rom.
plug-in unit index
The index of the plug-in unit in which y ou want to conf igure the IP address.
The program prov ides a list of indices to choose f rom.
interface name
The name of the network interf ace to which y ou want to conf igure the IP address.
The name is one of the interf aces listed in the interf ace guide. This parameter is obligatory .
redundant IP address interface name
The name of the backup network interf ace of a redundant IP address.
The name of the interf ace is of the same ty pe as the name of the f irst interf ace. This parameter is optional.

127.0.0.1:43231/NED/NED?serv ice=printv iew&library =a25003a0000a7700676p1&source=xdoc&item=d

1/5

11/30/12
IP address
The IP address of the network interf ace.
The address is specif ied in conv entional dot notation: (#.#.#.#) f or IPv 4 or (#:#:#:#:#:#:#:#) f or IPv 6.
For IPv 4 the parameter v alue ranges f or each part of the address f rom 0 to 255, except f or the f irst and the last part where the range is f rom 1 to 255.
For IPv 6 the range is f rom 0 to FFFF, except f or the f irst and last part where the range is f rom 1 to FFFF.
Only one IP address can be giv en at a time.
netmask length
This parameter giv es the length of the numerical part of the IP address in bits.
The v alues range f rom 4 to 32 f or IPv 4 addresses and f rom 1 to 128 f or IPv 6 addresses.
The parameter can be giv en only if an IP address is giv en.
The def ault length of the netmask f or IPv 4 addresses is determined by the IP address: f or a class A address it is 8, f or a class B address it is 16, and
f or a class C address it is 24. For point-to-point links it is alway s 32.
Examples of the corresponding netmasks: 255.0.0.0, 255.255.0.0, and 255.255.255.0. For IPv 6 addresses the def ault pref ix length is 64.
IP address type
The logical or phy sical IP address f or the network interf ace.
L

Logical IP address
This address belongs to the specif ied interf ace of the specif ied f unctional unit. The logical IP address f ollows the activ e unit. The
logical IP address can be giv en to 2N and N+1 units.

Phy sical IP address

This address is assigned to the specif ied computer unit permanently .

IP address attributes
Virtual and/or Internal attribute of the IP address.
V

Virtual IP address
The v irtual IP address can be conf igured concurrently to network interf aces in dif f erent units.

Internal IP address
This address is an internal address.

Dy namic IP address f or DHCP client

ETPSIG-M IP address

ETPSIG-C IP address

destination IP address
This parameter can only be conf igured to a point-to-point interf ace. It is the remote address of the link.

Exam ples

Exam ples
1.

Assign a phy sical IPv 4 address to the network interf ace EL0 of OMU-0.
QRN:OMU,0::EL0:"131.228.45.176",,P;

2.

Assign a phy sical IPv 4 address to the network interf ace EL0 of BCSU-0's PCUS-1.
QRN:BCSU,0:PCUS,1:EL0:"131.230.42.22",,P;

3.

Assign a phy sical IPv 4 address to the network interf ace EL0 of OMU-0 with a netmask of 20.
QRN:OMU,0::EL0:"131.228.45.178",20,P;

4.

Assign a logical IPv 6 address to the network interf ace EL0 of OMU units.
QRN:OMU::EL0:"3FFE:100:80:1:45:1:1:1",,L;

5.

Assign a logical IPv 4 address to the network interf ace EL0 of PAPU-2.
QRN:PAPU,2::EL0:"131.228.45.180",,L;

6.

Assign a logical IPv 4 address to the network interf ace AA0 of the IOCPEA plug-in unit.
QRN:PAPU,0:IOCPEA,1:AA0:"131.228.45.181",,L:"140.0.0.1";

7.

Assign a phy sical redundant IPv 4 address to two network interf aces EL0 and EL1 of OMU-0.
QRN:OMU,0::EL0,EL1:"131.228.45.183",,P;

8.

Assign a phy sical v irtual IPv 4 address to the network interf ace EL0 of SIGU-0 with a netmask of 32.
QRN:SIGU,0::EL0:"131.228.45.188",32,P,V;

9.

Assign a phy sical IPv 4 address to the network interf ace EMB0 of OMU-0.

127.0.0.1:43231/NED/NED?serv ice=printv iew&library =a25003a0000a7700676p1&source=xdoc&item=d

2/5

serv ice=printv
11/30/12 iew&library =a25003a0000a7700676p1&source=xdoc&item=d
QRN:OMU,0::EMB:"192.168.100.14",24,P;
10.

Assign a logic ETPSIG-C IPv 4 address to the network interf ace IFETH0 of SP-EX ETME-0.
QRN:ETME,0::IFETH0:"192.168.100.24",24,L,C;

Additional inform ation

Additional inform ation

To check the interf aces that hav e already been conf igured, use the QRIcommand.
A computer unit can contain one loopback network interf ace at most. The IP address of the loopback interf ace is alway s 127.0.0.1. For other interf ace
ty pes, IP addresses between 127.0.0.0 and 127.0.0.255 are not allowed.
Set the v irtual IP address netmask/pref ix length of the signalling unit (SIGU) to 32/128.
Y ou cannot giv e a network interf ace an IP address belonging to the 0.0.0.0/8 network. In addition, the subnetwork's broadcast addresses (those in which
all bits af ter the netmask are either one or zero) are f orbidden. For example, if the interf ace is in network 134.56.64.0/18, the addresses 134.56.64.0 and
134.56.127.255 are f orbidden. The program prev ents y ou f rom entering a f orbidden address.

Execution printouts

Execution printouts
The f ollowing abbrev iations are used in the execution printouts:
UNIT

Computer unit and plug-in unit whose network interf ace is conf igured

INTERFACE

Network interf ace name

IF NAME

Network interf ace name

ADMIN STATE

Administrativ e state of the interf ace

MTU

Maximum Transmission Unit of the network interf ace

ADDR ATTR

Attributes of the IP address

IP ADDRESS

IP addresses of the network interf ace

The execution printout of command example 1 is the f ollowing:

CONFIGURED NETWORK INTERFACE
UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------OMU-0
EL0
UP
1500 P
131.228.45.176/16
COMMAND EXECUTED
The execution printout of command example 2 is the f ollowing:
CONFIGURED NETWORK INTERFACE
UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------BCSU-0 PCUS-1
EL0
UP
1500 P
131.230.42.22/16
COMMAND EXECUTED
The execution printout of command example 3 is the f ollowing:
CONFIGURED NETWORK INTERFACE
UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------OMU-0
EL0
UP
1500 P
131.230.42.22/20
COMMAND EXECUTED
The execution printout of command example 4 is the f ollowing:
CONFIGURED NETWORK INTERFACE

127.0.0.1:43231/NED/NED?serv ice=printv iew&library =a25003a0000a7700676p1&source=xdoc&item=d

3/5

serv ice=printv iew&library =a25003a0000a7700676p1&source=xdoc&item=d

UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------OMU-0
EL0
UP
1500 L
3FFE:100:80:1:45:1:1:1/64
OMU-1
EL0
UP
1500 L
(3FFE:100:80:1:45:1:1:1/64)
COMMAND EXECUTED
The execution printout of command example 5 is the f ollowing:
CONFIGURED NETWORK INTERFACE
UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------PAPU-2
EL0
UP
1500 L
131.228.45.180/16
COMMAND EXECUTED
The execution printout of command example 6 is the f ollowing:
CONFIGURED NETWORK INTERFACE
UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------PAPU-0
IOCPEA-1
AA0
UP
1500 L
131.228.45.181/32
-> 140.0.0.1
COMMAND EXECUTED
The execution printout of command example 7 is the f ollowing:
CONFIGURED NETWORK INTERFACE
UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------OMU-0
EL0
UP
1500 P
131.228.45.183/16
EL1
UP
1500 P
(131.228.45.183/16)
COMMAND EXECUTED
The execution printout of command example 8 is the f ollowing:
CONFIGURED NETWORK INTERFACE
UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------SIGU-0
EL0
UP
1500 PV
131.228.45.188/32
COMMAND EXECUTED
The execution printout of command example 9 is the f ollowing:
CONFIGURED NETWORK INTERFACE
UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------OMU-0
EMB0
UP
1500 P
192.168.100.14/24
COMMAND EXECUTED
The execution printout of command example 10 is the f ollowing:
If there is not enough SP ETME to insure module redundancy , a warning message will be printed, and conf irmation will be required:
/* THERE WILL BE NO ENOUGH SPARE ETME FOR MODULE REDUNDANCY */
CONFIRM COMMAND EXECUTION: Y/N ? Y
If the user still wants to execute the command (no more redundancy ), press Y .
Printout will be the f ollowing:
CONFIGURED NETWORK INTERFACE
127.0.0.1:43231/NED/NED?serv ice=printv iew&library =a25003a0000a7700676p1&source=xdoc&item=d

serv ice=printv
11/30/12 iew&library =a25003a0000a7700676p1&source=xdoc&item=d
UNIT
ADMIN
ADDR
INTERFACE STATE MTU ATTR IP ADDRESS
------------ ----- ----- ----- ----------------------------------------------ETME-0
IFETH0
UP
1500 LC (192.168.100.24/24)
COMMAND EXECUTED

Sem antic error m essages

Sem antic error m essages

/*** COMPUTER UNIT DOES NOT HAVE TCP/IP SERVICE ***/
Y ou hav e giv en a computer unit which does not hav e TCP/IP serv ices av ailable. Change the computer unit to one which has TCP/IP serv ices.
/*** INVALID INTERFACE NAME ***/
Y ou hav e giv en an incorrect network interf ace name. Re-enter the command so that the network interf ace is one of the ones shown in the interf ace
guide.
/*** IP ADDRESS IS ILLEGAL ***/
Y ou hav e giv en the IP address in the wrong f ormat, or the address is f orbidden.
For more inf ormation, see Additional Information and re-enter the command so that the giv en conditions are met.
The sy stem may also output a general MML semantic error message.

Execution error m essages

Execution error m essages

/*** IP ADDRESS ALREADY IN USE ***/
Y ou hav e tried to conf igure an IP address which has already been conf igured.
/*** MAXIMUM NUMBER OF IP ADDRESSES EXCEEDED ***/
Y ou hav e giv en a network interf ace the elev enth logical or phy sical IP address. The maximum number of IP addresses is 10 phy sical and 10 logical IP
addresses f or IPv 4 and IPv 6. If a conf igured interf ace exists, check its inf ormation using the QRIcommand.
/*** NETWORK INTERFACE DOES NOT EXIST ***/
Y ou hav e giv en an incorrect network interf ace name. Giv e the command again so that the network interf ace is one of the ones shown in the interf ace
guide.
The sy stem may also send a general MML execution error message.

DN0993509

Id: 0900d8058088fccf

2011 Nokia Siemens Networks

5/5