AvSv programmer guide, additional configuration example

[marioa]

Two examples listed bellow, communicated on users list, show good use cases that are beneficial to OpenSAF users.

Proposal is to adding these examples bellow to AvSv? documentation.
This will:

• even better illustrate how to use SNMP for configuring AMF
• better emphasizes configuration capabilities of OpenSAF

——Original Message——
From: users-bounces@…
users-bounces@… On Behalf Of Arya Ravi-G20265
Sent: den 26 oktober 2007 17:48
To: Long, Qing Yang (TSG-GDCC-SH/CMEP); Sreenivasan
Prabhu-G20200; users@…
Subject: Re: [Users] Adding a node to OpenSAF cluster

Hi Long Qingyang,

Please see the following sample configuration using snmp
mibsets to configure a component, csi, SU, SI and all. There
are dependencies between different-different mib
configurations so you need to make sure that the
configuration is done in a particular order as mentioned
below(Either follow the mib descriptions). You may add a
complete new configuration or you can modify the existing
one. Every mib object description talks about if it has any
dependency, if you do not want to look into mib files than
follow the configuration order mentioned below.


Thanks- Arya

Node Configuration: (Configure as many as node is needed)
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfNodeSuFailoverMax.\"safNode=PL_2_3\" u 2
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfNodeSuFailoverProb.\"safNode=PL_2_3\" x "00
00 03 A3 52 94 40 00"
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB
localhost SAF-AMF-MIB::saAmfNodeAdminState.\"safNode=PL_2_3\" i 2
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186 NCS-AVSV-MIB::ncsNDNodeId.\"safNode=PL_2_3\" u 3
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186 SAF-AMF-MIB::saAmfNodeRowStatus.\"safNode=PL_2_3\" i 1

SG Configuratin: (Configure SGs )
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186 SAF-AMF-MIB::saAmfSGRedModel.\"safSg=SG_TEST\" i 1
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSGNumPrefInserviceSUs.\"safSg=SG_TEST\"
u 2
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSGCompRestartProb.\"safSg=SG_TEST\" x "00
00 03 A3 52 94 40 00"
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSGSuRestartProb.\"safSg=SG_TEST\" x "00 00
03 A3 52 94 40 00"
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSGCompRestartMax.\"safSg=SG_TEST\" u 10
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186 SAF-AMF-MIB::saAmfSGSuRestartMax.\"safSg=SG_TEST\" u 10
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186 SAF-AMF-MIB::saAmfSGRowStatus.\"safSg=SG_TEST\" i 1

SU Configuration: (Configure SUs on a node or different nodes)
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSURank.\"safSu=SuT_TEST,safNode=PL_2_3\"
u 1
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSUNumComponents.\"safSu=SuT_TEST,safNode=PL_
2_3\" u 1
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSUParentSGName.\"safSu=SuT_TEST,safNode=PL_2
_3\" s "safSg=SG_TEST"
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSURowStatus.\"safSu=SuT_TEST,safNode=PL_2_3\" i 1

SI Configuration: (Configure SIs)
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186 SAF-AMF-MIB::saAmfSIRank.\"safSi=Si_TEST\" u 1
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186 SAF-AMF-MIB::saAmfSINumCSIs.\"safSi=Si_TEST\" u 1
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSIParentSGName.\"safSi=Si_TEST\" s "safSg=SG_TEST"
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186 SAF-AMF-MIB::saAmfSIRowStatus.\"safSi=Si_TEST\" i 1

CSI Configuration: (Configure CSIs )
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCSType.\"safCsi=Csi_TEST,safSi=Si_TEST\"
s "safCsi=Csi_TEST"
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCSIRank.\"safCsi=Csi_TEST,safSi=Si_TEST\" u 1
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCSIRowStatus.\"safCsi=Csi_TEST,safSi=Si_TEST\" i 1

SUsPerSI Configuration:
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSUsperSISUName.\"safSi=Si_TEST\".1 s
"safSu=SuT_TEST,safNode=PL_2_3"
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfSUsperSIRowStatus.\"safSi=Si_TEST\".1 i
1

CSTypeParam Configuration:
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompCSTypeSupportedRowStatus.\"safComp=CompT
_TEST,safS
u=SuT_TEST,safNode=PL_2_3\".\"safCsi=Csi_TEST\" i 4
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCSTypeParamRowStatus.\"safCsi=Csi_TEST\".\"t
est\" i 4

Component Configuration: (Configure components)
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompCapability.\"safComp=CompT_TEST,safSu=Su
T_TEST,saf
Node=PL_2_3\" i 4
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompCategory.\"safComp=CompT_TEST,safSu=SuT_
TEST,safNo
de=PL_2_3\" i 0
nmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompInstantiateCmd.\"safComp=CompT_TEST,safS
u=SuT_TEST
,safNode=PL_2_3\" s "/home/g20265/comp_clc/test_1.sh"

snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompCleanupCmd.\"safComp=CompT_TEST,safSu=Su
T_TEST,saf
Node=PL_2_3\" s "/home/g20265/comp_clc/comp_term.pl"

snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompTerminateTimeout.\"safComp=CompT_TEST,sa
fSu=SuT_TE
ST,safNode=PL_2_3\" x "00 00 03 A3 52 94 40 00"
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompNumMaxInstantiate.\"safComp=CompT_TEST,s
afSu=SuT_T
EST,safNode=PL_2_3\" u 5
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompNumMaxActiveCsi.\"safComp=CompT_TEST,saf
Su=SuT_TES
T,safNode=PL_2_3\" u 1
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompNumMaxStandbyCsi.\"safComp=CompT_TEST,sa
fSu=SuT_TE
ST,safNode=PL_2_3\" u 1
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompAMEnable.\"safComp=CompT_TEST,safSu=SuT_
TEST,safNo
de=PL_2_3\" i 2
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB -r 0
10.232.92.186
SAF-AMF-MIB::saAmfCompRowStatus.\"safComp=CompT_TEST,safSu=SuT
_TEST,safN
ode=PL_2_3\" i 1





From: users-bounces@…
users-bounces@… On Behalf Of Long, Qing Yang
(TSG-GDCC-SH/CMEP)
Sent: Thursday, October 25, 2007 8:23 PM
To: Sreenivasan Prabhu-G20200; users@…
Subject: Re: [Users] Adding a node to OpenSAF cluster




Thanks Prabhu.
These commands you provide works well. Paynode
"PL_2_20" can run up.

But this is only basic configuration. No application
is configured on this node. It is empty and useless.
And only one OpenSAF process is running:
"/opt/opensaf/payload/bin/ncs_pcap NID_SVC_ID=18".

Some HA-Aware applications should be added to this node.
How to add "service group", "service unit", "service instance"
etc. including all kinds of software components?
For example: "CompT_SC_CPND", "CompT_SC_MQND",
"CompT_SC_GLND", "safComp=CompT_IFND", "safComp=CompT_EDS",
"safComp=CompT_AvSvDemo" etc.

When "PL_2_20" is running, it is just like "PL_2_3"
which is configured by XML files. How to configure these
software components using snmpset?

Best regards.


Long Qingyang



From: Sreenivasan Prabhu-G20200 prabhu@…
Sent: Thursday, October 25, 2007 9:04 PM
To: Long, Qing Yang (TSG-GDCC-SH/CMEP); users@…
Subject: RE: [Users] Adding a node to OpenSAF cluster


Hi Long Qingyang


You can configure a running opens system using MIBS.

for example to add a node configuration dynamically on a
running system.
say to add a payload node on slot 20 (0x02140f), give the
following SNMP commands on your active controller.

snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB
localhost
SAF-AMF-MIB::saAmfNodeSuFailoverProb.\"safNode=PL_2_20\" x
"00 00 00 00
05 F5 E1 00"
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB
localhost
SAF-AMF-MIB::saAmfNodeSuFailoverMax.\"safNode=PL_2_20\" u 2
snmpset -v2c -c public -m /usr/share/snmp/mibs/SAF-AMF-MIB
localhost
SAF-AMF-MIB::saAmfNodeAdminState.\"safNode=PL_2_20\" i 2
snmpset -v2c -c public -m /usr/share/snmp/mibs/NCS-AVSV-MIB
localhost NCS-AVSV-MIB::ncsNDNodeId.\"safNode=PL_2_20\" u
134928 snmpset -v2c -c public -m
/usr/share/snmp/mibs/SAF-AMF-MIB localhost
SAF-AMF-MIB::saAmfNodeRowStatus.\"safNode=PL_2_20\" i 1

after wards you need to add SU's, components etc.. on this new node.
Refer SAF-AMF-MIB & NCS-AVSV-MIB for more details.

Note: copy all mibs to /usr/share/snmp/mibs on active controller
export MIBDIRS=/usr/share/snmp/mibs from your shell.

Thanks
Prabhu



From: users-bounces@…
users-bounces@… On Behalf Of Long, Qing Yang
(TSG-GDCC-SH/CMEP)
Sent: Thursday, October 25, 2007 6:56 AM
To: users@…
Subject: [Users] Adding a node to OpenSAF cluster


Hello friends,
I need your help about the following questions

1. OpenSAF uses NCSSystemBOM.xml and AppConfig?.xml to
configure a cluster node and software components.
How to achieve this function: Add a node to OpenSAF cluster
when OpenSAF is running ?
Do you have C language program which implementing this function?

2. Or do you have a step by step operation guide to add a
node to OpenSAF cluster manually?


Thanks.


Long Qingyang