Anda di halaman 1dari 23

Nokia Networks

GSM/EDGE BSS, Rel. RG40


(GSM 15), Operating
Documentation, Issue 04

WR - Software Package
Deployment Handling (for
mcBSC)
DN09131888
Issue 1-0

 
 
WR - Software Package Deployment Handling (for mcBSC)

The  information  in  this  document  applies  solely  to  the  hardware/software  product  (“Product”)  specified
herein, and only as specified herein.

This document is intended for use by Nokia Solutions and Networks' customers (“You”) only, and it may not
be used except for the purposes defined in the agreement between You and Nokia Solutions and Networks
(“Agreement”)  under  which  this  document  is  distributed.  No  part  of  this  document  may  be  used,  copied,
reproduced,  modified  or  transmitted  in  any  form  or  means  without  the  prior  written  permission  of  Nokia
Solutions  and  Networks.  If  you  have  not  entered  into  an  Agreement  applicable  to  the  Product,  or  if  that
Agreement has expired or has been terminated, You may not use this document in any manner and You
are obliged to return it to Nokia Solutions and Networks and destroy or delete any copies thereof.

The  document  has  been  prepared  to  be  used  by  professional  and  properly  trained  personnel,  and  You
assume full responsibility when using it. Nokia Solutions and Networks welcome Your comments as part of
the process of continuous development and improvement of the documentation.

This  document  and  its  contents  are  provided  as  a  convenience  to  You.  Any  information  or  statements
concerning the suitability, capacity, fitness for purpose or performance of the Product are given solely on
an “as is” and “as available” basis in this document, and Nokia Solutions and Networks reserves the right
to change any such information and statements without notice. Nokia Solutions and Networks has made all
reasonable efforts to ensure that the content of this document is adequate and free of material errors and
omissions,  and  Nokia  Solutions  and  Networks  will  correct  errors  that  You  identify  in  this  document.  But,
Nokia Solutions and Networks' total liability for any errors in the document is strictly limited to the correction
of such error(s). Nokia Solutions and Networks does not warrant that the use of the software in the Product
will be uninterrupted or error-free.

NO  WARRANTY  OF  ANY  KIND,  EITHER  EXPRESS  OR  IMPLIED,  INCLUDING  BUT  NOT  LIMITED  TO
ANY  WARRANTY  OF  AVAILABILITY,  ACCURACY,  RELIABILITY,  TITLE,  NON-INFRINGEMENT,
MERCHANTABILITY  OR  FITNESS  FOR  A  PARTICULAR  PURPOSE,  IS  MADE  IN  RELATION  TO  THE
CONTENT  OF  THIS  DOCUMENT.  IN  NO  EVENT  WILL  NOKIA  SOLUTIONS  AND  NETWORKS  BE
LIABLE  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, EVEN IN THE CASE OF
ERRORS IN OR OMISSIONS FROM THIS DOCUMENT OR ITS CONTENT.

This document is Nokia Solutions and Networks’ proprietary and confidential information, which may not be
distributed  or  disclosed  to  any  third  parties  without  the  prior  written  consent  of  Nokia  Solutions  and
Networks.

Nokia  is  a  registered  trademark  of  Nokia  Corporation.  Other  product  names  mentioned  in  this  document
may be trademarks of their respective owners, and they are mentioned for identification purposes only.

Copyright © 2016 Nokia Solutions and Networks. All rights reserved.

f Important Notice on Product Safety


  This product may present safety risks due to laser, electricity, heat, and other sources of danger.

Only  trained  and  qualified  personnel  may  install,  operate,  maintain  or  otherwise  handle  this
product and only after having carefully read the safety information applicable to this product.

The  safety  information  is  provided  in  the  Safety  Information  section  in  the  “Legal,  Safety  and
Environmental Information” part of this document or documentation set.

Nokia  Solutions  and  Networks  is  continually  striving  to  reduce  the  adverse  environmental  effects  of  its
products and services. We would like to encourage you as our customers and users to join us in working
towards a cleaner, safer environment. Please recycle product packaging and follow the recommendations
for power use and proper disposal of our products and their components.

If you should have questions regarding our Environmental Policy or any of the environmental services we
offer, please contact us at Nokia Solutions and Networks for any additional information.

2 DN09131888 Issue: 1-0
WR - Software Package Deployment Handling (for mcBSC)

Table of Contents
This document has 23 pages
   
WR - SOFTWARE PACKAGE DEPLOYMENT HANDLING.......... 4
   
WRA ADD UNITS TO TRIAL CONFIGURATION ......................... 5
   
WRR REMOVE UNIT FROM TRIAL CONFIGURATION ............ 11
   
WRD DESTROY TRIAL CONFIGURATION ............................... 14
   
WRS CUTOVER TO NEW SOFTWARE PACKAGE ...................16
   
WRO RETURN TO OLD SOFTWARE PACKAGE ......................19
   
WRC COMPLETE NEW CONFIGURATION ...............................22

Issue: 1-0 DN09131888 3
   

WR - SOFTWARE PACKAGE DEPLOYMENT WR - Software Package Deployment Handling (for
HANDLING mcBSC)

WR - SOFTWARE PACKAGE DEPLOYMENT


HANDLING
Use the commands in this command group to split the exchange configuration, in other
words, to form a trial configuration and perform a cutover to a new software package, or
to perform a switch-back, i.e. to return to the old software package. Use these
commands to control the deployment of software changes requiring the use of a trial
configuration.
Menu of the command group:
SOFTWARE PACKAGE DEPLOYMENT HANDLING COMMANDS

? ..... DISPLAY MENU


A: ..... ADD UNITS TO TRIAL CONFIGURATION
R: ..... REMOVE UNIT FROM TRIAL CONFIGURATION
D: ..... DESTROY TRIAL CONFIGURATION
S: ..... CUTOVER TO NEW SOFTWARE PACKAGE
O: ..... RETURN TO OLD SOFTWARE PACKAGE
C; ..... COMPLETE NEW CONFIGURATION
Z; ..... RETURN TO MAIN LEVEL

4 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRA ADD UNITS TO TRIAL CONFIGURATION
mcBSC)

WRA ADD UNITS TO TRIAL CONFIGURATION


Function
Use this command to add units to the trial configuration. You can either select the added
unit yourself, or they can belong to the base trial configuration and be selected by
system. The OMU is moved to trial first.
Parameters
unit identification: old pack unit: unit state: control data;
Syntax

WRA: [<unit type>|BASE def],


[[<unit index>|<chosen by system> def]|
[<pair number>],
[<unit index>|<chosen by system>]]:
[<old pack unit>|<chosen by system> def]:
[<unit state>|WO def]:
[FCD|<controlled adding> def];
Parameter explanations
unit type
The identifier for the unit type.
The default value is BASE, which means that the units which belong to the base trial
configuration are transferred to the trial side. The units belonging to the base trial
configuration are determined by system.

pair number
The pair number given as a decimal.
For those unit types which require the pair number for unit identification, the pair number
is given in this parameter and the unit index in the next.

unit index
The number for the unit.
The value is a decimal number.
The default value is that the unit index is chosen by system.
In case of virtualization management unit, this is mandatory.

old pack unit


The number for the unit which does not make the cutover, given as a decimal.
This parameter defines the unit which is not included in the cutover and which stores the
old software if there is a quick return. In units with N+1 redundancy, the parameter also
determines the unit in WO state whose services the N+1 redundant unit should provide
in the trial configuration.
The unit can be freely chosen when the base trial configuration has not been defined and
the unit type is N+1 redundant. In units with 2N redundancy, the standby unit is
transferred to the trial configuration.

Issue: 1-0 DN09131888 5
   

WRA ADD UNITS TO TRIAL CONFIGURATION WR - Software Package Deployment Handling (for
mcBSC)

If an index is not supplied, system chooses the unit.
In case of virtualization management unit, this is mandatory.

unit state
The desired working state of the unit in the trial configuration at the accuracy of the main
state:

WO working (default value)

TE testing

SE separated.

control data
Controlled addition is default. In this command, FCD has no meaning.
Examples

1. Test a new software package in the exchange. Form a base trial configuration for this
purpose. When creating the trial configuration, always transfer the OMU to the new
configuration first.
WRA:OMU;
In this phase, the system restarts the OMU that you wish to transfer to trial, after
which you can enter the following command:
WRA:BASE;
To add the needed virtualization management units to trial configuration, you should
give the WRA command for each unit.
If there are redundant virtualization management units, then add more units to the
trial configuration.
WRA:VMU,2:3;

g Note: Before a trial configuration, make sure that the units are in normal working
states. To include VMU units to the trial configuration, make sure that for both VMU
there shall be a similar unit configuration containing only active units. To get the child
units of VMU that is transferred to trail side to SP-EX state by using the USW and USC
commands to perform switchovers. You can also try to put VMUs to BL working state
with the USC command to get them contain only redundant units.

2. Form the trial configuration by adding one unit at a time. First, add the OMU to the
trial configuration.
WRA:OMU;
Next, add CM-1 to the trial configuration.
WRA :CM,1;

g Note: Child units cannot be handled by the WRA command

After you have added the standby units of duplicated units, transfer the units with
N+1 replaceable and complementary redundancy to the trial configuration. E.g. add
the signalling unit CCSU-0, and mark the CCSU-3 to be left in the old software in
cutover.
WRA :CCSU,0:3;
WRA :VMU,2:3;

6 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRA ADD UNITS TO TRIAL CONFIGURATION
mcBSC)

Additional information
The OMU must be transferred to the trial configuration first. When the OMU is
transferred to the trial configuration, the status of the default package must be BU. The
status can be modified by means of the command WSD in the Software Package Status
Handling MML (SOSTAT).
After the OMU has been added to the trial, the basic trial configuration can be created or
units can be added one by one to the trial. When there is a 2N-OMU, the command must
be given from the MML terminal in the trial side, and its OMU must have the additional
information TRIA and NEWP. The spare CM is moved to trial after the OMU. When all
standby units of the 2N redundant units have been moved to trial, one of the units with
N+1 complementary redundancy is added, and after the latter, the standby unit of the
units with N+1 replaceable redundancy.
N.B. When the unit which have BL state has been added, it only shows in the trial
configuration after timeout. Therefore, the character (-) is displayed after the name of the
unit. If the unit is part of the trial configuration already and it is transferred again, the
character (+) is displayed after the name.
The SODEPL always checks first if the OMU has already been transferred to the trial
configuration. If this is not the case, the SODEPL does not accept other units but the
OMU. The command outputs the default package of the exchange. If the package is not
BU when the OMU is added to trial, an error notice is generated. When OMU is added to
the trial, the SODEPL asks you to confirm the command execution. If you confirm the
execution of the command, the SODEPL asks the Software Configuration Administration
Program Block (SOWADM) to make NW the default package for the OMU.
The SODEPL sends the RCXPRO in the OMU a message to add a unit. The SODEPL
waits until it receives an acknowledgement from the RCXPRO. The acknowledgement
specifies whether the command has been accepted and executed. After having received
the acknowledgement, the SODEPL outputs the data concerning the added unit and the
execution printout of the command on the terminal. If the unit that was added to the trial
was 1N-OMU, the SODEPL informs the RCXPRO that it is ready to restart the OMU and
asks the Dialogue Driver (DIALOG) to interrupt the MML session.
If it has not been possible to execute the command, the SODEPL outputs an error notice
on the terminal. If NW has already been made the default package for the OMU, the
SODEPL asks the SOWADM to change it back to BU.
If a base trial configuration is involved when the SODEPL receives an acknowledgement,
the data concerning the added unit is displayed, and the RCXPRO is asked to add the
next unit to the trial. This is continued until the RCXPRO acknowledges the completion of
the base trial configuration. Finally, the system outputs the execution printout for the
command.
When the base trial configuration has been relevant done, then Virtualization
Management Units (VMUs) are added to the trial configuration.
Execution printouts
In a non-redundant OMU, the execution printouts are otherwise the same as in the 2N-
OMU, but the OMU has no index.
The OMU is added to the trial configuration. The execution printout for the command
WRA:OMU; is e.g. as follows in the 2N-OMU:
DEFAULT PACKAGE IS: BU
CHECK THAT SCDFLE AND OTHER RELEVANT CONFIGURATION

Issue: 1-0 DN09131888 7
   

WRA ADD UNITS TO TRIAL CONFIGURATION WR - Software Package Deployment Handling (for
mcBSC)

FILES OF BU AND NW PACKAGES ARE COMPATIBLE!

CONFIRM COMMAND EXECUTION: Y/N ? Y


MSCi DX200-LAB 2013-09-28 12:41:14

DEFAULT PACKAGE CHANGED TO: NW


ADDING TO TRIAL CONFIGURATION:

UNIT MB STATE OLD UNIT INFO


OMU-1 01 TE-EX OMU-0 TRIA NEWP

COMMAND EXECUTED

In a non-redundant OMU, a message concerning the OMU restart is also output:
RESTART OF OMU IS ACTIVATED!

after which the OMU restart printouts are output on the service terminal.
The central memory CMis added to trial. The execution printout for command WRA:CM;
is as follows:
DEFAULT PACKAGE IS: NW
MSCi       DX200-LAB                         2013-09-28 12:41:14
ADDING TO TRIAL CONFIGURATION:

UNIT MB STATE OLD UNIT INFO


CMM-1 05 WO-RE CMM-0 TRIA NEWP RP 1 CTOT RCMD

When forming a basic trial configuration, the execution printout for command
WRA:BASE; is as follows:

DEFAULT PACKAGE IS: NW


MSCi DX200-LAB 2013-09-28 12:48:20

ADDING TO TRIAL CONFIGURATION:

UNIT MB STATE OLD UNIT INFO


CMM-0 04 WO-RE CMM-1 TRIA NEWP RP 1 CTOT FIMM RCMD
CHU-0-1 11 WO-RE CHU-0-0 TRIA NEWP RP 1 CTOT FIMM RCMD
CHU-1-0 12 WO-RE CHU-1-1 TRIA NEWP RP 1 CTOT FIMM RCMD
IPDU-1 75 WO-RE IPDU-0 TRIA NEWP NOSW RP 1 CTOT FIMM RCMD

COMMAND EXECUTED

If the FCD parameter is used in the command, the following text is output when the unit
is added to the trial
FORCED UNIT ADDING TO TRIAL CONFIGURATION REQUESTED

and when a basic trial configuration is created
FORCED CREATING OF BASE CONFIGURATION REQUESTED.
THIS MAY CAUSE FAILURES IN TRAFFIC!
CONFIRM COMMAND EXECUTION: Y/N ?

If a negative confirmation is given, the command execution is interrupted and the
following text is output:
COMMAND IGNORED

8 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRA ADD UNITS TO TRIAL CONFIGURATION
mcBSC)

Semantic error messages


If an error occurs, the system outputs a general MML semantic error message.
Execution error messages
/*** DX ERROR : XXX ***/
/*** Error text ***/

/*** ERROR INFO FILLED BY OBSERVER ***/


/*** DX ERROR : YYY ***/
/*** ERROR TEXT ***/
/*** OBSERVED BY PROGRAM BLOCK : AAAAAA, XXH ***/
/*** FAILED UNIT : TYPE-INDEX ***/
/*** FAILED PROGRAM BLOCK : BBBBBB, YYH ***/

The error text specifies the cause of the failure in more detail.
In some cases, the error text is followed by a general system error notice, returned by
the program block detecting the error, and by the name of the unit and the program block
in which the execution of the command failed.
If the error block described above is output when the base trial configuration is being
created, the following is also output:
DO YOU WANT TO CONTINUE BUILDING TRIAL CONFIGURATION (Y/N) ?

If the formation of the trial configuration is to be continued, the following text is also
output:
DO YOU WANT TO TRY SAME UNIT AGAIN OR NEXT UNIT (S/N) ?

If you wish to try to add the same unit type again, enter S. If you enter N, the system
selects the next unit type.
The other possible error texts and the instructions to execute the command are listed
below:
/*** RECOVERY FUNCTION <code> BUSY ***/
/*** OBJECT UNIT = type, index ***/

The RCXPRO has been reserved for some other recovery function. Wait for a short time
and then re-enter the command.
/*** ERROR: GIVEN COMMAND NOT ACCEPTED FROM TELE SIDE ***/

The command cannot be given from the traffic side. Connect the MML terminal to the
trial side OMU.
/*** ERROR: DEFAULT PACKAGE MUST BE: BU ***/

The status of the default package is not BU. Change the status of the default package to
BU by entering the WSD:STAT=BU; command so that you can add the OMU to the trial.
/*** ERROR: OMU IS NOT ON TRIAL SIDE ***/

The OMU is not on the trial side. Add OMU to trial.
/*** ERROR: UNIT IS NOT ON TRIAL SIDE: TYPE-INDEX ***/

The unit TYPE-INDEX is not in trial. Add the unit to the trial before adding the other units.
/*** ERROR: OMU IS ON TRIAL SIDE ***/

Issue: 1-0 DN09131888 9
   

WRA ADD UNITS TO TRIAL CONFIGURATION WR - Software Package Deployment Handling (for
mcBSC)

The OMU has already been added to the trial side.
/*** ERROR: SOME ACTIVE UNITS ARE NOT IN WOEX STATE ***/

Some active units are not in WO-EX state. Change unit state to normal unit state.
/*** ERROR: SOME UNITS HAVE FAULTY FLAG ***/

Some units have FAULTY flag. Remove faulty flag.
/*** ERROR: OMU IS NOT IN NORMAL WORKING STATE ***/

OMU is not in normal working state. Change OMU to normal WO state.
/*** ERROR: THE SELECTED NEW PACKAGE UNIT IS NOT REDUNDANT ***/

The selected unit is in WO-EX state and cannot be added to trial.
/*** ERROR: NO REDUNDANT UNIT TO BE SELECTED AS THE NEW PACKAGE UNIT ***/

There is no redundant unit to be selected as the new package unit.
/*** ERROR: ALL CHILD UNITS ARE NOT IN TRIAL ***/

The virtual manager unit cannot be added to trial because all of the child units are not in
trial.
/*** ERROR: A CHILD UNIT IS IN WO STATE ***/

The child of virtual manager unit is in WO state.
/*** ERROR: SUITABLE OLD PACKAGE UNIT IN WOEX STATE IS NOT FOUND ***/

Suitable unit in WOEX state in telecom side is not found.
/*** ERROR: THE SELECTED OLD PACKAGE UNIT IS NOT IN WOEX STATE ***/

The selected old package unit in telecom side is not in WOEX state.
/*** ERROR: UNIT IS NOT THE UPPERMOST UNIT IN HIERARCHY STATE ***/

Try to change virtualization management unit to trial configuration.
The system may also output a general MML execution error message.

10 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRR REMOVE UNIT FROM TRIAL CONFIGURATION
mcBSC)

WRR REMOVE UNIT FROM TRIAL


CONFIGURATION
Function
Use this command to remove units from the trial configuration.
Parameters
unit identification: control data;
Syntax

WRR: <unit type>,


[[<unit index>|<chosen by system> def]|
[<pair number>],
[<unit index>|<chosen by system> def]]:
[FCD|<controlled removing> def];
Parameter explanations
unit type
The identifier for the unit type.
This parameter is obligatory.

pair number
The pair number given as a decimal.
For those unit types which require the pair number for identification, the pair number is
supplied in this parameter and the unit index in the next.

unit index
The index for the unit, given as a decimal number.
The default value is that the unit index is chosen by system. In case of virtualization
management unit, this is mandatory.

control data
Controlled deletion is used. In this command, FCD has no meaning.
Examples

1. The system has chosen CCSU-0 to deal with the CCSU-1 circuits, because the
former was not suitable for routing. The unit is replaced by CCSU-2.
WRR:CCSU,1;
WRA:CCSU,1:2;
2. Remove 2n redundancy unit e.g STU-1 from the trial configuration:
WRR:STU;
3. Remove VMU-1 and its children from the trial configuration:
WRR:VMU,1;
Additional information

Issue: 1-0 DN09131888 11
   

WRR REMOVE UNIT FROM TRIAL CONFIGURATION WR - Software Package Deployment Handling (for
mcBSC)

The OMU must be in trial when units are removed from the trial configuration. However,
the OMU can also be temporarily removed from the trial side without destroying the trial
in progress. The command must be given from the MML terminal on the trial side, and its
OMU must have the additional information NEWP. The command must not be given if a
cutover has been performed to a new software package with the WRS command, and no
return has been completed to the old software package with the WRO command.
The command outputs the trial side's default package. When you remove the OMU from
trial, the SODEPL asks you to confirm the command execution. If you confirm the
execution of the command, the SODEPL asks the SOWADM to change the OMU default
package to BU.
The command sends a message to the RCXPRO program block in the OMU to remove
the unit from the trial configuration. The SODEPL waits until it receives an
acknowledgement from the RCXPRO, in which it notifies if the command has been
accepted and executed. After having received the acknowledgement, the SODEPL
outputs the execution printout of the command on the terminal. If the unit removed from
trial was OMU, the SODEPL informs the RCXPRO that it is ready to restart the OMU,
and asks the DIALOG to interrupt the MML session.
If the command could not be executed, the SODEPL outputs an error text. If BU has
already been made the default package of the OMU, the SODEPL asks the SOWADM to
change it back to NW.
If the adding of virtualization management unit has only partially succeeded, the already
added children can be removed one by one.
Execution printouts
When removing the central memory from the trial, the execution printout of command
WRR:CMM,; is:
EXECUTION STARTED

DEFAULT PACKAGE IS: NW


MSCi DX200-LAB 2013-09-28 12:58:14

REMOVING FROM TRIAL CONFIGURATION:

 UNIT MB STATE OLD UNIT INFO


 CMM-0 04 SP-EX CMM-1        -

COMMAND EXECUTED

In a non-redundant OMU, the execution printouts are otherwise the same as in 2N-OMU,
but OMU has no index.
When the OMU is removed from trial by using the command WRR:OMU; e.g. the
following is output in the 2N-OMU:
DEFAULT PACKAGE IS: NW
OMU-1 WILL BE RESTARTED AS RESULT OF COMMAND

CONFIRM COMMAND EXECUTION: Y/N ? Y

MSCi DX200-LAB 2013-09-28 00:12:52

DEFAULT PACKAGE CHANGED TO: BU

12 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRR REMOVE UNIT FROM TRIAL CONFIGURATION
mcBSC)

REMOVING FROM TRIAL CONFIGURATION:

UNIT MB STATE OLD UNIT INFO


OMU-1 01 SP-RE OMU-0 RP 1 CTOT RESTART OF OMU-1 IS ACTIVATED!

In the 2N-OMU, the MMI system is deactivated in the OMU which was started, and the
MMI system asks the user to connect to the active OMU.
Semantic error messages
If an error occurs, the system outputs a general MML semantic error message.
Execution error messages
/*** DX ERROR : XXX ***/
/*** Error text ***/

/*** ERROR INFO FILLED BY OBSERVER ***/


/*** DX ERROR : YYY ***/
/*** ERROR TEXT ***/
/*** OBSERVED BY PROGRAM BLOCK : AAAAAA, XXH ***/
/*** FAILED UNIT : TYPE-INDEX ***/
/*** FAILED PROGRAM BLOCK : BBBBBB, YYH ***/

The error text specifies the cause of the failure in more detail.
In some cases, the error text is followed by a general system error notice, returned by
the program block detecting the error, and by the name of the unit and the program block
in which the execution of the command failed.
The other possible error texts and the instructions for the command execution are listed
below:
/*** RECOVERY FUNCTION <code> BUSY ***/
/*** OBJECT UNIT = type, index ***/

The RCXPRO has been reserved for some other recovery function. Wait for a short time
and then re-enter the command.
/*** ERROR: GIVEN COMMAND NOT ACCEPTED FROM TELE SIDE ***/

The command cannot be given from the traffic side. Connect the MML terminal to the
trial side OMU.
/*** ERROR: OMU IS NOT ON TRIAL SIDE ***/

OMU is not on the trial side. Add OMU to the trial side.
/*** ERROR: NEWP OMU IS NOT ON TRIAL SIDE ***/

The unit cannot be removed from trial because the OMU with the additional information
NEWP is not on the trial side. Execute the switch-back command WRO before removing
the unit from trial.
/*** ERROR: UNIT IS NOT THE UPPERMOST UNIT IN HIERARCHY STATE ***/

Try to change virtualization management unit to trial configuration.
The system may also output a general MML execution error message.

Issue: 1-0 DN09131888 13
   

WRD DESTROY TRIAL CONFIGURATION WR - Software Package Deployment Handling (for
mcBSC)

WRD DESTROY TRIAL CONFIGURATION


Function
Use this command to destroy the trial configuration and to restore the situation that
prevailed before the trial configuration was formed.
Parameters
control data;
Syntax
WRD: [FCD|<controlled deleting> def];
Parameter explanations
control data
Controlled deletion is used. In this command, FCD has no meaning.
Examples

1. Delete the trial configuration and restore the normal redundancy of the units.
WRD;
Additional information
The command must be given from the MML terminal on the trial side and its OMU must
have the additional information NEWP. The command cannot be given if a cutover has
been performed to a new software package with the WRS command, and no return has
been made to the old software package with the WRO command.
The command first outputs the default software package on the trial side. The SODEPL
asks the SOWADM to change the OMU default package to BU and sends the RCXPRO
program block in the OMU a message concerning each unit that should be handled so
as to clear the trial configuration. The RCXPRO informs in its acknowledgement whether
the command has been accepted and executed. If so, the SODEPL outputs an execution
text on the terminal. At the end of the command, the SODEPL informs the RCXPRO that
it is ready to restart the OMU, so it asks the DIALOG to interrupt the MML session.
If the command could not be executed, the SODEPL outputs an error text. If the OMU
default package has already been changed to BU, the SODEPL asks the SOWADM to
change it back to NW.
Execution printouts
In a non-redundant OMU, the execution printouts are otherwise the same as in the 2N-
OMU, but the OMU has no index.
When destroying the trial configuration, the execution printout for command WRD; is as
follows in 2N-OMU:
DEFAULT PACKAGE IS: NW
COMMAND WILL DESTROY TRIAL CONFIGURATION
OMU-1 WILL BE RESTARTED AS RESULT OF COMMAND

CONFIRM COMMAND EXECUTION: Y/N ?

MSCi DX200-LAB 2013-09-28 00:12:52

DEFAULT PACKAGE CHANGED TO: BU


DESTROYING TRIAL CONFIGURATION

14 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRD DESTROY TRIAL CONFIGURATION
mcBSC)

UNIT MB STATE OLD UNIT INFO


STU-0 02 SP-RE STU-1 RP 1 CTOT
CM-1 05 SP-RE CM-0 RP 1 CTOT
OMU-1 01 SP-RE OMU-0 RP 1 CTOT
RESTART OF OMU-1 IS ACTIVATED!

The restart outputs for the OMU are output on the service terminal.
Semantic error messages
If an error occurs, the system outputs a general MML semantic error message.
Execution error messages
/*** DX ERROR : XXX ***/
/*** Error text ***/

/*** ERROR INFO FILLED BY OBSERVER ***/


/*** DX ERROR : YYY ***/
/*** ERROR TEXT ***/
/*** OBSERVED BY PROGRAM BLOCK : AAAAAA, XXH ***/
/*** FAILED UNIT : TYPE-INDEX ***/
/*** FAILED PROGRAM BLOCK : BBBBBB, YYH ***/

The error text specifies the cause of the failure in more detail.
In some cases, the error text is followed by a general error text of the system, returned
by the program block detecting the error, and by the name of the unit and program block
in which the execution of the command failed.
The other possible error texts and the instructions to execute the command are listed
below:
/*** RECOVERY FUNCTION <code> BUSY ***/
/*** OBJECT UNIT = type, index ***/

The RCXPRO has been reserved for some other recovery function. Wait for a short time
and then re-enter the command.
/*** ERROR: GIVEN COMMAND NOT ACCEPTED FROM TELE SIDE ***/

The command cannot be given from the traffic side. Connect the MML terminal to the
trial side OMU.
/*** ERROR: OMU IS NOT ON TRIAL SIDE ***/

The OMU is not on the trial side. Add OMU to the trial side.
If cutover WRS has been executed last, cancel the cutover by entering command WRO
before clearing the trial configuration (in case OMU is non-redundant).
/*** ERROR: NEWP OMU IS NOT ON TRIAL SIDE ***/

The OMU with additional information NEWP is not on the trial side. Cancel the cutover
by entering the command WRO before clearing the trial configuration.
The system may also output a general MML execution message.

Issue: 1-0 DN09131888 15
   

WRS CUTOVER TO NEW SOFTWARE PACKAGE WR - Software Package Deployment Handling (for
mcBSC)

WRS CUTOVER TO NEW SOFTWARE


PACKAGE
Function
Use this command to perform a cutover for the units in trial configuration to the traffic
side. After the command has been executed, the trial side units transmit traffic by using
the new software package. Of each unit type transferred to the trial side, one unit,
selected through command WRA, remains in the old software in case of a switch-back.
Parameters
control data;
Syntax
WRS: [FCD|<controlled cutover> def];
Parameter explanations
control data
A controlled cutover is used by default. FCD indicates a forced cutover.
The use of the parameter FCD is only necessary, if all units types have not been added
to the trial configuration.
Examples

1. A trial configuration has been formed by using command WRA. Perform a cutover to a
new software package:
WRS;
2. A trial configuration has been formed by entering the command WRA, but all units are
not split, e.g only one member VLRU pair has been taken to trial configuration. This
means that all units which have not been selected with command WRA to remain to
run the old software build are taken also into the new Tele system.
WRS:FCD;
Additional information
The command must be given from the MML terminal on the trial side, and its OMU must
have the additional information NEWP. Before the cutover command is executed, at least
the OMU and the CM must be on the trial side. The command cannot be given several
times in a row.
The command first outputs the default package on the trial side. Once the SODEPL has
received your confirmation to execute the command, it sends the cutover message to the
RCXPRO program block of the OMU and waits for an acknowledgement. The RCXPRO
notifies in the acknowledgement whether the command has been accepted and
executed. After having received the acknowledgement, the SODEPL asks the SOWADM
to update the Package Management History File (PAHIFI) and outputs the execution
printout for the command on the terminal. Finally, the SODEPL informs the RCXPRO
that it is ready to restart OMU and asks the DIALOG to interrupt the MML session. In the
2N-OMU, also the traffic side OMU is started..
If the command could not be executed, an error text is output.
Execution printouts
In a non-redundant OMU, the execution printouts are otherwise the same as in the 2N-
OMU, but the OMU has no index.

16 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRS CUTOVER TO NEW SOFTWARE PACKAGE
mcBSC)

The execution printout of cutover command WRS; is as follows in the 2N-OMU:
WRS:;

EXECUTION STARTED

DEFAULT PACKAGE IS: NW


CURRENT TRIAL UNITS ARE:

UNIT MB STATE OLD UNIT INFO


OMU-1 01 WO-EX TRIA NEWP
STU-0 02 WO-EX TRIA NEWP
CMM-0 04 WO-EX TRIA NEWP
CMU-0 0A WO-EX TRIA NEWP
CHU-0 10 WO-EX TRIA NEWP
GISU-0 3A WO-EX TRIA NEWP NOSW
GISU-1 3B WO-EX TRIA NEWP NOSW
IPDU-1 75 WO-EX TRIA NEWP NOSW
VMU-0 82 WO-EX TRIA NEWP NOSW

CUTOVER TO NEW SOFTWARE PACKAGE REQUESTED


OMU-1 AND OMU-0 WILL BE RESTARTED AS RESULT OF COMMAND

CONFIRM COMMAND EXECUTION: Y/N ?

MSCi DX200-LAB 2013-09-29 15:04:38

UNITS CUT OVER IS IN PROGRESS

If the FCD parameter is given in the command, the following is output:
EXECUTION STARTED

DEFAULT PACKAGE IS: NW


CURRENT TRIAL UNITS ARE:

UNIT MB STATE OLD UNIT INFO


OMU-1 01 WO-EX TRIA NEWP
CMM-0 04 WO-EX TRIA NEWP
CHU-0-1 11 WO-EX TRIA NEWP
CHU-1-0 12 WO-EX TRIA NEWP
IPDU-1 75 WO-EX TRIA NEWP NOSW

CUTOVER TO NEW SOFTWARE PACKAGE REQUESTED


OMU-1 AND OMU-0 WILL BE RESTARTED AS RESULT OF COMMAND

CONFIRM COMMAND EXECUTION: Y/N ? Y

FORCED CUTOVER REQUESTED

THIS MEANS THAT ALL UNITS WHICH ARE NOT SELECTED WITH WRA COMMAND TO
REMAIN TO RUN THE OLD SW BUILD ARE TAKEN INTO THE NEW TELE SYSTEM

CONFIRM COMMAND EXECUTION: Y/N ?

MSCi DX200-LAB 2013-09-29 12:43:42

Issue: 1-0 DN09131888 17
   

WRS CUTOVER TO NEW SOFTWARE PACKAGE WR - Software Package Deployment Handling (for
mcBSC)

UNITS CUT OVER IS IN PROGRESS


... ...
RESTART OF OMU-1 AND OMU-0 IS ACTIVATED!

The OMU restart outputs (in the 2N-OMU, for both of them) are output on the service
terminal.
Semantic error messages
If an error occurs, the system outputs a general MML semantic error message.
Execution error messages
/*** DX ERROR : XXX ***/
/*** Error text ***/

/*** ERROR INFO FILLED BY OBSERVER ***/


/*** DX ERROR : YYY ***/
/*** ERROR TEXT ***/
/*** OBSERVED BY PROGRAM BLOCK : AAAAAA, XXH ***/
/*** FAILED UNIT : TYPE-INDEX ***/
/*** FAILED PROGRAM BLOCK : BBBBBB, YYH ***/

The error text describes the cause of the failure in more detail.
In some cases, the error text is followed by a general error text of the system, returned
by the program block detecting the error, and by the name of the unit and the program
block in which the execution of the command failed.
The other possible error texts and instructions for the command execution are listed
below:
/*** RECOVERY FUNCTION <code> BUSY ***/
/*** OBJECT UNIT = type, index ***/

The RCXPRO has been reserved for some other recovery function. Wait for a short time
and then re-enter the command.
/*** ERROR: GIVEN COMMAND NOT ACCEPTED FROM TELE SIDE ***/

The command cannot be given from the traffic side. Connect the MML terminal to the
trial side OMU.
/*** ERROR: NEWP OMU IS NOT ON TRIAL SIDE ***/

The OMU with additional information NEWP is not on the trial side. The cutover has
been performed with the WRS command, and the switch-back command WRO, has not
been given after it.
/*** ERROR: OMU IS NOT ON TRIAL SIDE ***/

The OMU is not on the trial side. Add the OMU and the units corresponding to the trial
configuration to the trial side.
/*** ERROR: SOME ACTIVE UNITS ARE NOT IN WOEX STATE ***/

Some active units are not in WOEX state. Change unit state to normal unit state.
/*** ERROR: SOME UNITS HAVE FAULTY FLAG ***/

Some units have FAULTY flag. Remove faulty flag.
The system may also output a general MML execution message.

18 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRO RETURN TO OLD SOFTWARE PACKAGE
mcBSC)

WRO RETURN TO OLD SOFTWARE


PACKAGE
Function
Use this command to perform a switch-back, i.e to return the units containing the new
software package to the trial side. After the command has been executed, the original
trial configuration is used again, and traffic is transmitted through all units containing the
old software package. The trial configuration consists of those units which were originally
selected by entering the WRA command.
Parameters
control data;
Syntax
WRO: [FCD|<controlled switch back> def];
Parameter explanations
control data
A controlled switch-back is used. FCD indicates a forced switch-back. In this command,
FCD has no meaning.
Examples

1. A trial configuration has been created in the exchange and a cutover to a new
software package has been carried out. Now return to the old software package:
WRO;
Additional information
The command must be given from the MML terminal on the traffic side, and its OMU
must have the additional information NEWP. The command cannot be given several
times in a row.
The command first outputs the default package on the traffic side. After having received
your acknowledgement to execute the command, the SODEPL sends the RCXPRO
program block in the OMU a cutover message. The SODEPL waits until it receives an
acknowledgement from the RCXPRO. In the acknowledgement, the RCXPRO indicates
whether the command has been accepted and executed. Having received the
acknowledgement, the SODEPL asks the SOWADM to update the PAHIFI file and
outputs the execution printout of the command on the terminal. Finally, the SODEPL
informs the RCXPRO that it is ready to restart OMU and asks the DIALOG to interrupt
the MML session. In the 2N-OMU, the trial side OMU is also started.
If the command could not be executed, an error text is output.
Execution printouts
In a non-redundant OMU, the execution printouts are otherwise the same as in 2N-OMU,
but OMU has no index.
The execution printout for command WRO; is as follows in the 2N-OMU:
DEFAULT PACKAGE IS: NW
SWITCH BACK TO OLD SOFTWARE PACKAGE REQUESTED
OMU-0 AND OMU-1 WILL BE RESTARTED AS RESULT OF COMMAND

CONFIRM COMMAND EXECUTION: Y/N ? Y

Issue: 1-0 DN09131888 19
   

WRO RETURN TO OLD SOFTWARE PACKAGE WR - Software Package Deployment Handling (for
mcBSC)

If a forced switch-back has been given, the following is output:
DEFAULT PACKAGE IS: NW
SWITCH BACK TO OLD SOFTWARE PACKAGE REQUESTED
OMU-0 AND OMU-1 WILL BE RESTARTED AS RESULT OF COMMAND

CONFIRM COMMAND EXECUTION: Y/N ?

THIS MEANS THAT ALL UNITS EXCEPT THOSE SELECTED WITH WRA COMMAND TO
RUN THE NEW SW BUILD ARE TAKEN BACK INTO THE ORIGINAL TELE SYSTEM

CONFIRM COMMAND EXECUTION: Y/N ?

MSCi DX200-LAB 2013-09-29 12:52:37

UNITS SWITCH BACK IS IN PROGRESS

The OMU printouts (in the 2N-OMU, for both of them) are output to the service terminal.
Semantic error messages
If an error occurs, the system outputs a general MML semantic error message.
Execution error messages
/*** DX ERROR : XXX ***/
/*** Error text ***/

/*** ERROR INFO FILLED BY OBSERVER ***/


/*** DX ERROR : YYY ***/
/*** ERROR TEXT ***/
/*** OBSERVED BY PROGRAM BLOCK : AAAAAA, XXH ***/
/*** FAILED UNIT : TYPE-INDEX ***/
/*** FAILED PROGRAM BLOCK : BBBBBB, YYH ***/

The error text describes the cause of the failure in more detail.
In some cases, the error text is followed by the general error notice of the system,
returned by the program block detecting the error, and by the name of the unit and the
program block in which the command failed.
The other possible error texts and the instructions to execute the command are listed
below:
/*** RECOVERY FUNCTION <code> BUSY ***/
/*** OBJECT UNIT = type, index ***/

The RCXPRO has been reserved for some other recovery function. Wait for a short time
and then re-enter the command.
/*** ERROR: GIVEN COMMAND NOT ACCEPTED FROM TRIAL SIDE ***/

The command cannot be given from the trial side. Connect the MML terminal to the
traffic side OMU.
/*** ERROR: NEWP OMU IS ON TRIAL SIDE ***/

20 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRO RETURN TO OLD SOFTWARE PACKAGE
mcBSC)

The traffic side OMU does not have the additional information NEWP, but the OMU which
has the additional information NEWP is not on the traffic side. The switch-back WRO
command cannot be performed before the cutover has been performed by the WRS
command.
/*** ERROR: OMU NOT IS ON TRIAL SIDE ***/

The OMU is not on the trial side. Add the OMU and the units corresponding to the trial
configuration to the trial.
/*** ERROR: OMU IS ON TRIAL SIDE ***/

The OMU (non-redundant) is on the trial side. The switch-back WRO command cannot be
performed before the cutover has been performed by the WRS command.
The system may also output a general MML execution error message.

Issue: 1-0 DN09131888 21
   

WRC COMPLETE NEW CONFIGURATION WR - Software Package Deployment Handling (for
mcBSC)

WRC COMPLETE NEW CONFIGURATION


Function
Use this command to end the trial function. Enter the command when a deletion
command WRD or a cutover command WRS has been given before, and you wish to end
the trial. The command completes the traffic side by adding the trial side units to it. The
trial side is deleted, and the additional data associated with the trial testing of units is
zeroed. Return to the old software package is not possible once the WRC command has
been executed.
Parameters
The command has no parameters.
Syntax
WRC;
Examples

1. The trial configuration has been deleted and you wish to zero any additional data or,
a cutover has been performed and the redundancy in the functional units is to be
restored to what it was previously.
WRC;
Additional information
If the command is given in the 2N-OMU after the WRS command, it must be given from
the MML terminal on the traffic side.
The command first outputs the default package on the traffic side and asks you to
confirm the command execution.
If the command has been given after the WRS command, the SODEPL asks the
SOWADM to make the default package on the traffic side OMU as the default package.
After this, the SODEPL sends the RCXPRO program block on the OMU a message
concerning each unit that should be handled in order to transfer the units to the traffic
side. In its acknowledgement the RCXPRO informs whether the command is accepted
and executed. Having received the acknowledgement, the SODEPL outputs an
execution text on the terminal.
If the command could not be executed, the SODEPL outputs an error text. If the OMU
default package has already been made the default package on the traffic side, the
SODEPL asks the SOWADM to return the earlier default package as the default
package.
Execution printouts
In a non-redundant OMU, the execution printouts are otherwise the same as in 2N-OMU,
but the OMU has no index.
The execution printout for the command WRC; is as follows in the 2N-OMU:
DEFAULT PACKAGE IS: BU
COMPLETION OF UNITS REQUESTED

OLD UNITS ARE LOADED WITH NEW SOFTWARE PACKAGE


THUS THERE IS NO RETURN TO OLD SOFTWARE PACKAGE

CONFIRM COMMAND EXECUTION: Y/N ? Y

MSCi DX200-LAB 2013-09-29 00:12:52

22 DN09131888 Issue: 1-0
   

WR - Software Package Deployment Handling (for WRC COMPLETE NEW CONFIGURATION
mcBSC)

DEFAULT PACKAGE CHANGED TO: NW


COMPLETING OF UNITS:

UNIT MB STATE OLD UNIT INFO


OMU-0 00 SP-RE OMU-0 -
OMU-1 01 WO-EX OMU-0 -
STU-0 02 SP-EX STU-0 -
... ...
Semantic error messages
If an error occurs, the system outputs a general MML semantic error message.
Execution error messages
/*** DX ERROR : XXX ***/
/*** Error text ***/

/*** ERROR INFO FILLED BY OBSERVER ***/


/*** DX ERROR : YYY ***/
/*** ERROR TEXT ***/
/*** OBSERVED BY PROGRAM BLOCK : AAAAAA, XXH ***/
/*** FAILED UNIT : TYPE-INDEX ***/
/*** FAILED PROGRAM BLOCK : BBBBBB, YYH ***/

The error text specifies the cause of the failure in more detail.
In some cases, the error text is followed by a general error notice of the system, returned
by the program block detecting the error, and by the name of the unit and program block
in which the execution of the command failed.
The other possible error texts and the instructions to execute the command are listed
below:
/*** RECOVERY FUNCTION <code> BUSY ***/
/*** OBJECT UNIT = type, index ***/

The RCXPRO has been reserved for some other recovery function. Wait for a short time
and then re-enter the command.
/*** ERROR: GIVEN COMMAND NOT ACCEPTED FROM TRIAL SIDE ***/

The command cannot be given from the trial side. Connect the MML terminal to the
traffic side OMU.
/*** ERROR: OMU IS ON TRIAL SIDE ***/

The command cannot be executed, because the OMU is on the trial side. Remove the
OMU from trial.
/*** ERROR: SOMAFI UPDATE NOT SUCCEEDED ON BOTH DISKS ***/

Failure to update the Software Configuration Management File (SOMAFI) on one of the
disks.
The system may also output a general MML execution error message.

Issue: 1-0 DN09131888 23