B9 Optional Features Activation on Running A1353-RA ed03.pdf

Alcatel BSS

B9 Optional Features Activation

on Running A1353-RA

OMC Document

Installation Manual

Release B9

3BK 17422 4041 RJZZA Ed.03

Status RELEASED

Short title Task Procedure

All rights reserved. Passing on and copying of this document, useand communication of its contents not permitted without writtenauthorization from Alcatel/Evolium.

BLANK PAGE BREAK

2 / 24 3BK 17422 4041 RJZZA Ed.03

Contents

ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.1 Principles of the Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.2 Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.3 Procedure Information for Optional Features Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

1.3.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.3.2 Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.3.3 Initial Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.3.4 Final Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.3.5 Necessary Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111.3.6 Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121.3.7 Impact on Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121.3.8 Supplies, Tools and Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

1.4 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 New Features Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2.1 PI 01: Update Optional Features File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.2 PI 02: ENS Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.3 PI 03: Declaration of Primary NMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.3.1 OMC-R Configuration for Q3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.3.2 Declaration of the Primary NMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

2.4 PI 04: Declaration of Secondary NMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.5 PI 05: Declaration of ALMAVision Based NMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.5.1 OMC-R Configuration for Q3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202.5.2 Registration of the ALMAVision Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.6 PI 06: Q3 Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212.7 RA 01: Reverse Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

2.7.1 Replace the Optional Features File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.7.2 Delete a Generic Declared NMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.7.3 Delete an ALMAVision Based NMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Appendix A : CMIP Licence Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3BK 17422 4041 RJZZA Ed.03 3 / 24

Contents

4 / 24 3BK 17422 4041 RJZZA Ed.03

Preface

PrefacePurpose This method describes the activation of optional features on an A1353-RA

Master Host, including the activation of Q3.

Whats New In Edition 03Changes were made in PI 01: Update Optional Features File (Section 2.1) dueto system behavior.

In Edition 02Set ALARM_AKNOWLEDGMENT parameter in: OMC-R Configuration forQ3 (Section 2.3.1).

In Edition 01Creation.

Audience This document is intended for:

Field service technicians

Project managersSite administrators

System support engineers (specialists)Occasional users (e.g. subcontractors)

Assumed Knowledge You must have a basic knowledge of the following topics:

Alcatel operations and maintenance concepts for BSS

Solaris operating system

Installation tools and materials.

3BK 17422 4041 RJZZA Ed.03 5 / 24

Preface

6 / 24 3BK 17422 4041 RJZZA Ed.03

1 General Information


This chapter provides general information about the principle of the operationsand requirements for the procedure.

3BK 17422 4041 RJZZA Ed.03 7 / 24


1.1 Principles of the OperationThis document describes the activation of new optional features on an OMC-R.It is used whenever the list of features is updated:

New features added/removed

ENS activation

Activation of Q3 for a single NMC (including the NMCs based onALMAVision platform)Activation of Q3 for two NMCs

Adding a second NMC when Q3 is already activated.

Several scenarios are defined, according to the type of modification asdescribed before.

8 / 24 3BK 17422 4041 RJZZA Ed.03


1.2 Scenarios

Scenario 1 Activation of new features on A1353-RAUpdate the list of optional features of A1353-RAPI01 Update Optional Features File

Scenario 2 ENS installationInstallation of A1353-RA remote inventory featurePI01 Update Optional Features FilePI02 ENS installation

Scenario 3 Q3 activation - mono NMCDeclaration of one NMC (primary NMC by default)Appendix ACheck in

/etc/opt/licenses/licenses_combined file ifCMIP licence is installed. If it is not installed,apply CMIP Licence Installation (Section A).

PI01 Update Optional Features FilePI03 Declaration of Primary NMCPI06 Q3 Activation

Scenario 4 Q3 activation - multi NMCDeclaration of two NMCs: a primary and a secondary NMCAppendix ACheck in


PI01 Update Optional Features FilePI03 Declaration of Primary NMCPI04 Declaration of Secondary NMCPI06 Q3 Activation

Scenario 5 Q3 activation - multi NMCDeclaration of a secondary NMC, if primary NMC is alreadydeclaredPI04 Declaration of Secondary NMC

Scenario 6 Q3 activation for ALMAVision based NMCDeclaration of a NMC based on ALMAVision managerAppendix ACheck in


PI01 Update Optional Features FilePI05 Declaration of ALMAVision based NMC

3BK 17422 4041 RJZZA Ed.03 9 / 24


1.3 Procedure Information for Optional Features Activation

1.3.1 PrerequisitesSPS and TSI fulfilled

All the inputs listed in paragraph Necessary Information, have to beavailable

A1353-RA is installed and running in B9 version

Media with the new optional features file: floppy disk, harddisk (e-mail),tape, CD-ROM, etc. is available.

1.3.2 RestrictionsNone.

1.3.3 Initial StatusA1353-RA operational and running

BSS connected to A1353-RA and operational

RNO, NPA and LASER (if existing) connected to A1353-RA and operationalImpacted NMC (for scenarios 3, 4, 5 or 6) ready to be connected

1.3.4 Final StatusA1353-RA operational and running in the same software version

BSS connected to A1353-RA and operational as before

RNO, NPA and LASER (if existing) connected to A1353-RA and operationalas before

New features activated and/or NMC connected and/or ENS installed,according to the scenario performed

10 / 24 3BK 17422 4041 RJZZA Ed.03


1.3.5 Necessary InformationPI 01 For A1353-RA Master Host:

Axadmin password

PI 02 For A1353-RA Master Host:Root password

PI 03 For Primary NMC:Root password of the OMCThe Network Identifier of the OMCThe form of AETitleThe AETitle of NMCThe type of connection between OMC and NMCThe Service Access Point for all network layers

PI 04 For Secondary NMC:Root password of the OMCThe form of AETitleThe AETitle of NMCThe type of connection between OMC and NMCThe Service Access Point for all network layers

PI 05 For ALMAVision based NMC:Root password of the OMC

Axadmin password of the OMCThe Network Identifier of the OMCHostname and IP address of the NMC (not OMC)

PI 06 For A1353-RA Master Host:Axadmin password

Root password

3BK 17422 4041 RJZZA Ed.03 11 / 24


1.3.6 Schedule

PI PI Titles Scen. 1 Scen. 2 Scen. 3 Scen. 4 Scen. 5 Scen. 6

PI 01 Update OptionalFeatures File

15 min. 15 min. 15 min. 15 min. - 15 min.

PI 02 ENS Installation - 5 min. - -

PI 03 Declaration ofPrimary NMC

- - 10 min. 10 min. - -

PI 04 Declaration ofSecondary NMC

- - 5 min. 5 min. -

PI 05 Declaration ofALMAVision basedNMC

- - - 10 min.

PI 06 Q3 Activation - - 10 min. 10 min. -

TOTAL 15 min. 20 min. 35 min. 40 min. 5 min. 25 min.

1.3.7 Impact on ServiceNo impact.

1.3.8 Supplies, Tools and DocumentationTools

Designation Contents Observations

Media support Optional features file Except for scenario 5

Media support CMIP licence for Q3activation

if not already installed

Applicable documents

Designation Reference

[1] B9 - Technical Status Information (TSI) 3BK 17422 0003 PCZZA[2] B9 - Site Presentation Sheet (SPS) 3BK 17422 4002 RJZZA[3] Completion Check List 3BK 17422 4041 QZZZA

12 / 24 3BK 17422 4041 RJZZA Ed.03


1.4 ConventionsThe following conventions are used in the document:

Keyboard keys are indicated in the text as [ XX ]. For example, Click on[ Enter ] means click on the [ Enter ] key.System messages appear in Courier font:system message

Operator input is shown after a double right-oriented arrow, in Courier font.The UNIX prompt of the user is also displayed. For root user the prompt is#, for axadmin user axadmin@host$ and for metrica user host:metricawhere host is the hostname of the machine.

For root user the input looks like the following:# operator_input

For axadmin user the input looks like the following:axadmin@host$ operator_input

For metrica user the input looks like the following:host:metrica operator_input

Software buttons on a terminal screen are also indicated in the text as [ XX ].For example, click on [ OK ] means move the mouse pointer to the [ OK ]button on the screen and then click the left mouse button.

To describe a menu path chain, the menu entries are chained with a ->.Example:Tools -> Options -> Printer -> ...

3BK 17422 4041 RJZZA Ed.03 13 / 24


14 / 24 3BK 17422 4041 RJZZA Ed.03

2 New Features Activation


This chapter describes the tasks to be performed in order to update the optionalfeatures list of a running A1353-RA (including the activation of the Q3 featureand declaration of the NMCs).

3BK 17422 4041 RJZZA Ed.03 15 / 24


2.1 PI 01: Update Optional Features File

Apply the PI only on the Master Host.

The file containing the optional features description is prepared at Alcatelhomebase. The file has an encrypted tag, according to the new features tobe implemented on that A1353-RA Master Host.The encoded file is called oflcf.in and has to be available on a mediasupport (tape, floppy disk, hard disk, CD-ROM).In order to activate the new features it is necessary to replace the old file withthe new one and restart applications.1. Log in as axadmin user on A1353-RA Master Host. Make a backup of

the existing oflcf.in file:axadmin@host$ cd /alcatel/var/share/netconfaxadmin@host$ mv oflcf.in oflcf.in.old

2. Copy the new file in the above directory.The operation of copying the new file from the delivered media support isdepending on the media (i.e. if the file is on a tape, use tar command, if it ison a floppy disk use volcheck to mount the disk, then cp, etc.)

3. Check the presence of the new file:axadmin@host$ cd /alcatel/var/share/netconfaxadmin@host$ ls -l oflcf.in

The output of this command must be:-rw-r--r-- 1 axadmin gadmin oflcf.in

Pay attention to the owner and access rights of the file.4. Open the new optional features file oflcf.in and check the following

parameters:

NUMBER_OF_EGPRS_UNITS

NUMBER_OF_CS3CS4_UNITS

NUMBER_OF_AMRFR_UNITS

NUMBER_OF_AMRHR_UNITS

NUMBER_OF_DR_TRE

NUMBER_OF_TXDIV_TRE

If any of the above values is lower than 65535, any PRC activation mayfail. In this case calculate the sum of all on-site values for the impactedparameter. If the sum exceeds the value written in the file ofcfl.in ask thecustomer to reconfigure the network so that the values are below thelimits from the licence file.

5. If in oflcf.in file there were features modified (other from the above ones)you need to stop and start the OMC processes.To stop OMC processes run the following commands:

axadmin@host$ cd /alcatel/omc3/osm/scriptaxadmin@host$ sudo ./MF-shutdown

Wait for the end of the execution of the script, then restart OMC processes:axadmin@host$ sudo ./MF-start

16 / 24 3BK 17422 4041 RJZZA Ed.03


After the end of the script, click on DSM icon on A1353-RA iconbox and waituntil all processes are green. If not, please call Alcatel TAC level 2.

6. Update the Completion Check List (CCL).

2.2 PI 02: ENS Installation

The optional features file has to be updated before performing this PI(Refer to 1.2 Scenarios).Apply the PI only on the Master Host.

1. Switch to root user (using su - command) and launch the configurationscript:

#/alcatel/omc3/ens/usm/script/configure_omc_for_ens.pl

Wait for the end of script.2. After the configuration, click on DSM icon on A1353-RA iconbox.3. Check the processes of the group ens_ from subsystem

application_.

If the processes is in red color, please call Alcatel support.4. Close the DSM window.5. Update the Completion Check List (CCL).

2.3 PI 03: Declaration of Primary NMC

Apply the PI only on the Master Host.Refer to SPS for all necessary information.

2.3.1 OMC-R Configuration for Q31. Refer to the SPS to find out the value of the ALARM_ACKNOWLEDGMENT

parameter.As axadmin search this parameter in the file/alcatel/omc3/q3im/conf/param.cfg. If needed updatethe file.

2. Perform the following commands as root user:# cd /alcatel/omc3/q3im/script# ./configure_omc_for_q3.pl

where is the identifier of the OMC (refer to SPS for this value).3. Update the Completion Check List (CCL).

3BK 17422 4041 RJZZA Ed.03 17 / 24


2.3.2 Declaration of the Primary NMC1. Logged as root, execute the next script with the following parameters:

# ./declareNmc.pl -primary [-form1|-form2] / [-rfc1006|-x25],,,

where:

form1 and form2 are the form of the AETitle, usually -form2

is the AETitle of the NMC

rfc1006 and x25 are the types of connection between OMC3 and NMC(rfc1006 for IP connection and x25 for x25 connection) is the Service Access Point for the Presentation layer

is the Service Access Point for the Session layer

is the Service Access Point for the Transport layer

is the Service Access Point for the Network layer (In case of IPconnection, is the IP address of NMC).

If you do not use one parameter be sure to mark its place by commas, withoutany space (see next example, where TSAPS is not used)

2. The following lines are given as example:./declareNmc.pl -primary -form2 1.2.3.4.4.0 -rfc1006/ POWE,prs,,192.168.17.43

or./declareNmc.pl -primary -form2 1.2.3.4.4.0 -rfc1006/ 0x0604,0x0501,,192.168.17.43

3. The following message appears:Are you sure to declare this NMC?(y/n)

4. Press [ Y ].5. Update the Completion Check List (CCL).

18 / 24 3BK 17422 4041 RJZZA Ed.03


2.4 PI 04: Declaration of Secondary NMC


1. Logged as root, execute the next script with the following parameters:# cd /alcatel/omc3/q3im/script# ./declareNmc.pl ,,,

where:

form1 and form2 are the form of the AETitle, usually -form2

is the AETitle of the NMC

rfc1006 and x25 are the types of connection between OMC3 and NMC(rfc1006 for IP connection and x25 for x25 connection) is the Service Access Point for the Presentation layer

is the Service Access Point for the Session layer

is the Service Access Point for the Transport layer

is the Service Access Point for the Network layer (In case of IPconnection, is the IP address of NMC).

If you do not use one parameter, be sure to mark its place by commas, withoutany space (see next example, where TSAPS is not used)

2. The following line is given as an example:declareNmc.pl -form2 1.2.3.4.4.0 -rfc1006POWE,prs,,192.168.17.43

3. Update the Completion Check List (CCL).

3BK 17422 4041 RJZZA Ed.03 19 / 24


2.5 PI 05: Declaration of ALMAVision Based NMC


2.5.1 OMC-R Configuration for Q31. Perform the following commands as rooton the OMC-R master host:

# cd /alcatel/omc3/q3im/script# ./configure_omc_for_q3.pl

where is the identifier of the OMC (refer to SPS for this value).2. Update the Completion Check List (CCL).

2.5.2 Registration of the ALMAVision Agent1. Perform the following command as root on the OMC-R master host:

# ./declareAlma.pl -i -h Where and is the IP address and hostnameof NMC.

2. Log out from the graphical environment.3. Log in as axadmin again.4. In the A1353-RA main window, click on DSM.5. In the DSM window, select the menu path:

File -> Load config6. Select dsm.cfg and click on [ Apply ].7. Stop the rnl subsystem by right-clicking on them and selecting Stop in the

pop-up menu. Click on [ Yes ] for confirmation, wait until processes arestopped.

8. Restart all processes by right-clicking on omc3 subsystem and selectingStart in the pop-up menu and click on [ Yes ] for confirmation.After some time, the processes will change colors fromblue to:

green, if all is OK.

red, if problems occur:If the process remains in red color, call Alcatel support.

9. Close the DSM window.10. Update the Completion Check List (CCL).

20 / 24 3BK 17422 4041 RJZZA Ed.03


2.6 PI 06: Q3 Activation

Apply the PI only on the Master Host.

If you are logged as root in the CDE graphical environment, log out and log inagain as axadmin. Start A1353-RA iconbox (if not already started).1. In the A1353-RA main window, click on DSM.2. In the DSM window, select the menu path:

File -> Load config3. Select dsm.cfg and click on [ Apply ].4. Select the q3im process. Right-click and select Start from the pop-up

menu. The q3im process starts.After some time, the q3im process will change colors from blue to:

green, if all is OK.

red, if problems occur:

If the process remains in red color, please call Alcatel TAC for support.

5. Close the DSM window.6. Update the Completion Check List (CCL).

3BK 17422 4041 RJZZA Ed.03 21 / 24


2.7 RA 01: Reverse ProcedureDepending on the scenario performed and the problem that appeared duringthe scenario, the reverse procedure might be composed of different operations.

2.7.1 Replace the Optional Features File1. If problems occur due to the activation of the new features:

Rename the old file from oflcf.in.old to oflcf.in.2. Update the Completion Check List (CCL).

2.7.2 Delete a Generic Declared NMC

Stop the q3im process from DSM before the NMC will be undeclared.

1. If problems occur during the declaration of a generic NMC, perform thefollowing commands as root to undeclare it.

2. Undeclare the NMC using the parameters retrieved:# cd /alcatel/omc3/q3im/script# ./undeclareNmc.pl

3. A list of current NMCs are displayed. Chose the number corresponding tothe NMC to be deleted:Press [ Y ] to confirm.

4. Restart q3im process from DSM.5. Update the Completion Check List (CCL).

2.7.3 Delete an ALMAVision Based NMCIf problems occur during the declaration of a NMC based on ALMAVisionmanager, perform the following commands as root to undeclare the NMC:1. Start OSM as axadmin user (default password omc3).

Follow the menuparth: NMC Management > List NMC & OMC NetworkID. A list with the declared NMCs will be displayed.

2. Remove the NMC:# cd /alcatel/omc3/q3im/script# ./undeclareAlma.pl -i -h

Where and is the IP address and hostnameof the ALMAVision NMC.

3. The following line is given as example:undeclareAlma.pl -i 139.54.17.83 -h NMC1

4. Restart q3im process.5. Close the DSM window.6. Update the Completion Check List (CCL).

22 / 24 3BK 17422 4041 RJZZA Ed.03

Appendix A : CMIP Licence Installation

Appendix A: CMIP Licence Installation1. Before Q3 activation the CMIP licence must be installed on Master.

Copy the CMIP license in /install/data directory with following name:_CMIP_9.0.lic

Content of _CMIP_9.0.lic file has to be as below:## Product : Solstice CMIP RT, 9.0# Date : 09-Sep-2004#SERVER hostname hostid 1726DAEMON lic.SUNW /etc/opt/licenses/lic.SUNWINCREMENT CMIP lic.SUNW 9.000 30-nov-2004 11ABBD1D1FF8A07B25EDC "0"

#LICENSE_FILE CMIP 9.000 osinmg9.0 1

2. As root user start the License Installation Tool:# /etc/opt/licenses/lit

Click on [ ... ] button, select the /install/data/_CMIP_9.0.licfile and click on [ OK ] button.To install the CMIP licence click on [ Install ] button.The massage License installation was successful is displayed.Click on [ Exit ] button.

3BK 17422 4041 RJZZA Ed.03 23 / 24

Appendix A : CMIP Licence Installation

BLANK PAGE BREAK

24 / 24 3BK 17422 4041 RJZZA Ed.03

Documents

B9 Optional Features Activation on Running A1353-RA ed03.pdf