CMGD HSS EPS Provision user guide

abaoshirly

Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
CMGD HSS EPS Provision user guide
Contents
1 Introduction..........................................................................................2
1.1 Prerequisites .......................................................................................2
2 Preparation..........................................................................................2
2.1 Install and configure the Hardware, Network, Operating System and
PG software.........................................................................................2
2.2 Configure the Network-Elements ........................................................3
3 Installation ...........................................................................................3
3.1 Installing Software ...............................................................................3
3.2 Uninstalling Software...........................................................................4
4 Configurations .....................................................................................4
4.1 Configure the CAI3G ENDPOINT URI ................................................4
4.2 Configure template mapping ...............................................................4
4.2.1 CAMMEL Template Mapping ..............................................................5
4.2.2 Template Mapping...............................................................................5
4.3 Configure log4j.xml for glassfish server ..............................................6
5 Access Control ....................................................................................8
5.1 Attribute Rules.....................................................................................8
6 Logs...................................................................................................11
7 Interface Description .........................................................................11
8 Reference List ...................................................................................16Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
REVISION INFORMATION
Revision Date Prepared Information
A 2013-4-26 Jobs Jia User Guide for CMCC LTE
1 Introduction
This document contains instructions regarding how to install and configure PG
CA for CMCC LTE.
1.1 Prerequisites
The following are the prerequisites to make full use of this document:
• The hardware and operating system have been completely installed and
configured, see <Hardware Installation and IP Infrastructure Setup for
Provisioning Server on EBS>.
• Provisioning Server software has been completely installed and
configured, see <Installing Provisioning Server>.
2 Preparation
2.1 Install and configure the Hardware, Network, Operating System
and PG software
For more information, please refer to <Hardware Installation and IP
Infrastructure Setup for Provisioning Server on EBS> and <Installing
Provisioning Server>.
Hardware installation.
Hardware configuration.
Network configuration including DMX, routers, switches.
LOTC installation.
Disk preparation.
VIP installation.
SNMP configuration.Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
Licenses installation.
HSS Validator Plugin installation.
Provisioning Gateway (PG) Software installation.
2.2 Configure the Network-Elements
For more information, please refer to <User Guide for Provisioning Server>.
Add and configure Network-Elements including HSS, AUC, HLR, CUDB.
Add and configure Network Element Groups.
Add and configure Routing.
3 Installation
This section covers how to install and uninstall the software of PG CA for
CMCC LTE.
3.1 Installing Software
• Copy the PG CA software to the /cluster/rpms directory.
• Add the RPM permanently to all PL nodes. For example, on a four node
cluster it will be node-id 3 and 4, on a six node cluster it will be node-id 3,
4, 5 and 6.
# cluster rpm -a <PG CA RPM NAME>.rpm -n <node-id>
# cluster rpm –A –n <node-id>
• Following steps must be performed on all traffic handling PL nodes. For
example, on a four node cluster it will be node-id 3 and 4, on a six node
cluster it will be node-id 3, 4, 5 and 6.
• Restart PG server.
# dvemon stopall
# dvemon startall
• Check that the details of the installed PG CA corresponds to the
expected:
# rpm -qil <PG CA RPM NAME>Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
3.2 Uninstalling Software
• Remove the RPM permanently from all PL nodes. For example, on a
four node cluster it will be node-id 3 and 4, on a six node cluster it will be
node-id 3, 4, 5 and 6.
# cluster rpm –r <PG CA RPM NAME>.rpm –n <node-id>
# cluster rpm –A –n <node-id>
• Following steps must be performed on all traffic handling PL nodes. For
example, on a four node cluster it will be node-id 3 and 4, on a six node
cluster it will be node-id 3, 4, 5 and 6.
• Restart PG server.
# dvemon stopall
# dvemon startall
4 Configurations
This section convers how to configure the PG CA.
4.1 Configure the CAI3G ENDPOINT URI
• Enter into the directory of configuration file:
# cd /cluster/home/dveadm/CARepository/LTE/conf/
• Open the configuration file (conf.properties) with VI and modify the
parameter CAI3G_ENDPOINT_URI according to site environment. As
usual, the IP address should be changed to the traffic VIP.
#vi conf.properties
NOTE:
• By default, the parameter CAI3G_ENDPOINT_URI is
http://localhost:8080/CAI3G1.2/services/CAI3G1.2
• When reboot pg node or reinstall the rpm package, the configuration file
will not be reset.
4.2 Configure template mapping
The template-mapping configuration files store in the following directory:
/cluster/home/dveadm/CARepository/LTE/templatesEricsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
NOTE:
• When reboot pg node or reinstall the rpm package, the configuration file
will not be reset.
4.2.1 CAMMEL Template Mapping
# cd /cluster/home/dveadm/CARepository/LTE/templates/ Format:OCSITCSI-MappedProfileId
#vi OTCSITemplateMapping.dat
E.G.:
1-2-3
OCSI:1
TCSI:2
MappedProfileId:3
4.2.2 Template Mapping
4.3 Configure EPS check IMSI
You can configure conf.properties:
# cd /cluster/home/dveadm/CARepository/LTE/conf/
#vi conf.properties
Default value is true
#Turn on
#EPS_CHECK_IMSI=true
#Turn off:
EPS_CHECK_IMSI=falseEricsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
4.4 Configure log4j.xml for glassfish server
After install the rpm package, you should configure the log4j.xml of glassfish
server in each PL node for printing the logs of PG CA correctly.
• cd /home/asuser/nodes/<node-id>/domains/dve-domain/config
• vi log4j.xml
• add the following content to the label <log4j:configuration
xmlns:log4j="http://jakarta.apache.org/log4j/" debug="false"> of the xml
file:
<!-- ================================= -->
<!-- Preserve CMCC HSS EPS messages in a local file -->
<!-- ================================= -->
<!-- A time/date based rolling appender -->
<appender name="CMCCLOG"
class="org.apache.log4j.RollingFileAppender">
<errorHandler
class="org.apache.log4j.helpers.OnlyOnceErrorHandler" />
<param name="File" value="../logs/cmcc.log" />
<param name="Append" value="true" />
<!-- We will create maximum 10 files, each of 15 MB -->
<param name="MaxFileSize" value="15MB" />
<param name="MaxBackupIndex" value="10" />
<layout class="org.apache.log4j.PatternLayout">
<!-- The default pattern: Date Priority [Category]
Message\n -->
<param name="ConversionPattern" value="%d
[%15.15t] %-5p [%c] %m%n" />
</layout>
</appender>Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
<category name="com.ericsson.hss.service.sv.modisdn">
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>
<category name="com.ericsson.hss.service.EPSMultiSCService">
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>
<category
name="com.ericsson.hss.service.eps.EPSMultiSCServiceImpl">
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>
<category
name="com.ericsson.hss.service.handler.CAI3G12Handler">
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>
<category
name="com.ericsson.hss.service.session.Cai3gSessionControl">
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>
<category
name="com.ericsson.hss.service.eps.EPSSOAPHandler">
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
<category
name="com.ericsson.dve.inbound.cai3g12.CAI3G12Operation">
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>
<category name="com.ericsson.exception.CAI3GFaultMapper">
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>
<category name="com.ericsson.hss.service.CommonSVService">
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>
<category
name="com.ericsson.hss.service.sv.hss.HssEPSMultiSCGetSVHandler"
>
<priority value="DEBUG" />
<appender-ref ref="CMCCLOG" />
</category>
5 Access Control
This section covers how to configure Access Control in the Multi Activation
GUI. It consists of the Users, Attribute Rules and Administration Domains. For
details, please refer to <User Guide for Provisioning Server>.
5.1 Attribute Rules
The value specified in Restriction Rule is the value that is allowed in
Provisioning Request. If other values than the specified value occur, the
request will be rejected. The restriction rule will apply for all authorized
operations in all triggers where that attribute occurs.
• Log into admin GUI via internet browser:Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
http://<hostname>:8080/management
• Choose tab Access Control - Attribute Rules
• Chick Add button to add an attribute rule for a specified user
• Choose the user that you want to set, and chick Next button. And on the
left side, you can choose different domain.Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
• After you choose a domain, you will see related configuration options.
Add conditions according to your request. You can also hold on SHIFT
to choose more than one condition and chick AND button to merge
these conditions. Instead, you can chick Split button to split these
conditions.
• After configured, chick Apply button to save the attribute rule. Choose
Access Control – Policies and chick Apply button to make the rules
effective.Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
6 Logs
On the PL nodes, you can find the log file in the following directory:
/home/asuser/nodes/<node-id>/domains/dve-domain/logs/cmcc.log
(or /cluster/ home/asuser/nodes/<node-id>/domains/dvedomain/logs/cmcc.log)
7 Interface Description
Interface Interface Description PG Operation Remark
ADD_KI
The command has
completed loading the card
authentication parameters
KI and KI parameters with
added encryption and
authentication algorithm
parameter type.
CreateSubscription
RMV_KI Remove IMSI KI
corresponding data. DeleteSubscription
This command can
only be carried out for
non-account card,
otherwise it will return
the error "4002:
CARD IN USE"
ADD_SUB
Add subscribers, before
executing this
command must load KI.This
command is used to create
CS, PS and EPS fusion
users.
CreateSubscription
/
CreateEPSMultiSC
ADD_TPLSUB
Using pre-defined templates
for account opening.Before
executing this
command must load KI.
CreateSubscription
/
CreateEPSMultiSC
RMV_SUB For existing CS, PS and DeleteSubscription/Ericsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
EPS fusion users cancel the
account,
and also according to the
conditions corresponding to
the user authentication data
deleted.
DeleteEPSMultiSC
ADD_CSPSSUB
Add CS/PS subscribers,
before executing this
command must load KI.
CreateSubscription
ADD_TPLCSPSSUB
Using pre-defined templates
for CS/PS
subscribers.Before
executing this
command must load KI.
CreateSubscription
RMV_CSPSSUB
For existing CS/PS
subscribers cancel the
account,
and also according to the
conditions corresponding to
the user authentication data
deleted.
DeleteSubscription
ADD_EPSSUB
To have an account of the
CS and PS users to
create EPS basic data
before executing this
command must perform
ADD_CSPSSUB account.
CreateEPSMultiSC
RMV_EPSSUB Remove the basic data of
one subscribers. DeleteEPSMultiSC
LST_SUB List the information of one
subscribers. GetEPSMultiSC
MOD_IMSI
International Mobile
Subscriber Identity
(IMSI) Changeover
CreateIMSIChange
over
MOD_ISDN
International Subscriber
Directory Number
Changeover
GetEPSMultiSC
DeleteEPSMultiSC
DeleteSubscription
CreateSubscription
CreateEPSMultiSC
MOD_CATEGORY Modify subscriber category. SetSubscriberData
LST_CATEGORY List subscriber category. GetSubscriberData
MOD_NAM Modify Network Access
Mode. SetSubscriberData
LST_NAM List Network Access Mode. GetSubscriberData
MOD_CCGLOBAL Modify the charge global. SetSubscriberData
LST_CCGLOBAL List the charge global. GetSubscriberData
MOD_TS Subscribe/Unsubscribe the
telservice. SetSubscriberDataEricsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
TS11(Telephony),TS21(Sho
rt Message
MT/PP),TS22(Short
Message
MO/PP),TS61/TS62(Data
Service).
LST_TS List the telservice of
subcriber. GetSubscriberData
MOD_TPLGPRS Modify the GPRS. SetSubscriberData
MOD_GPRS_CONT
EXT Modify the GPRS context. SetSubscriberPDP Context
LST_GPRS List GPRS. GetSubscriberPDP
Context
MOD_TPLEPS Modify the EPS data using
the templete. SetEPSMultiSC
MOD_EPSDATA Modify the basic data of
EPS. SetEPSMultiSC
MOD_EPS_CONTE
XT Modify EPS context. SetEPSMultiSC
LST_EPS List EPS. GetEPSMultiSC
MOD_DIAMRRS
This command is used to
provide or revoke the
subscriber's roaming
restrictions based on
Diameter.
PG not support.
LST_DIAMRRS
List the subscriber's
roaming restrictions
based of Diameter.
PG not support.
MOD_LCK Modify Subscriber locked
Status. SetSubscriberData
LST_LCK List Subscriber locked
Status. GetSubscriberData
MOD_RR Modify Subscriber Roaming
Restriction. SetSubscriberData
LST_RR List Subscriber Roaming
Restriction. GetSubscriberData
MOD_ODB Modify Operator
Determined Barring. SetSubscriberData
LST_ODBDAT List Operator Determined
Barring. GetSubscriberData
MOD_ARD Modify Access Restriction
Data.
SetSubscriberData/
SetEPSMultiSC
LST_ARD List Access Restriction
Data.
SetSubscriberData/
SetEPSMultiSC
MOD_BS Subscribe/Unsubscribe the
BS. SetSubscriberDataEricsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
LST_BS List BS. GetSubscriberData
MOD_CFU Sign/Unsign Call forwarding
unconditional. SetSubscriberData
REG_CFU Regester Call forwarding
unconditional.
CreateSupplement
aryService
ERA_CFU Earse Call forwarding
unconditional.
DeleteSupplement
aryService
MOD_CFB
Sign/Unsign Call forwarding
on mobile
subscriber busy.
SetSubscriberData
REG_CFB Regester Call forwarding on
mobile subscriber busy.
CreateSupplement
aryService
ERA_CFB Earse Call forwarding on
mobile subscriber busy.
DeleteSupplement
aryService
MOD_CFNRY Sign/Unsign Call forwarding
on no reply. SetSubscriberData
REG_CFNRY Regester Call forwarding on
no reply.
CreateSupplement
aryService
ERA_CFNRY Earse Call forwarding on no
reply.
DeleteSupplement
aryService
MOD_CFNRC
Sign/Unsign Call forwarding
on mobile
subscriber not reachable.
SetSubscriberData
REG_CFNRC
Regester Call forwarding on
mobile subscriber not
reachable.
CreateSupplement
aryService
ERA_CFNRC
Earse Call forwarding on
mobile subscriber not
reachable.
DeleteSupplement
aryService
MOD_CFD Sign/Unsign Default call
forwarding. SetSubscriberData
LST_CFALL List all call forwarding
characteristic. GetSubscriberData
MOD_CB
Sign/Unsign call barring
service.
(BAOC、 BOIC、
BOICEXHC、 BAIC、
BICROM)
SetSubscriberData
ACT_BAOC Active barring of all
outgoing calls.
CreateSupplement
aryService
DEA_BAOC Deactive barring of all
outgoing calls.
DeleteSupplement
aryService
ACT_BOIC Active barring of all
outgoing international calls.
CreateSupplement
aryService
DEA_BOIC Deactive barring of all
outgoing international calls.
DeleteSupplement
aryService
ACT_BOICEXHC
Active barring of all
outgoing international calls
except those directed to the
CreateSupplement
aryServiceEricsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
home plmn country.
DEA_BOICEXHC
Deactive barring of all
outgoing international calls
except those directed to the
home plmn country.
DeleteSupplement
aryService
ACT_BAIC Active barring of all
incoming calls.
CreateSupplement
aryService
DEA_BAIC Deactive barring of all
incoming calls.
DeleteSupplement
aryService
ACT_BICROM
Active barring of all
incoming calls when
roaming outside
the home public land mobile
network (plmn) country.
CreateSupplement
aryService
DEA_BICROM
Deactive barring of all
incoming calls when
roaming outside
the home public land mobile
network (plmn) country.
DeleteSupplement
aryService
LST_CBAR List call barring of one
subscriber. GetSubscriberData
MOD_BARPWD Modify the password of call
barring service. SetSubscriberData
MOD_CBCOU Modify the controllor of call
barring. SetSubscriberData
MOD_CLIP Sign/Unsign Calling Line
Identification Presentation. SetSubscriberData
LST_CLIP List Calling Line
Identification Presentation. GetSubscriberData
MOD_CLIR Sign/Unsign Calling Line
Identification Restriction. SetSubscriberData
LST_CLIR List Calling Line
Identification Restriction. GetSubscriberData
MOD_COLP
Sign/Unsign Connected
Line Identification
Presentation.
SetSubscriberData
LST_COLP List Connected Line
Identification Presentation. GetSubscriberData
MOD_COLR
Sign/Unsign Connected
Line Identification
Restriction
SetSubscriberData
LST_COLR List Connected Line
Identification Restriction. GetSubscriberData
MOD_PLMNSS Modify PLMN
Supplementary Service. SetSubscriberData
MOD_OSS
Sign/Unsign other
supplementary service.(CW
， HOLD， MPTY)
SetSubscriberData
LST_OSS List other supplementary GetSubscriberDataEricsson Internal
CMGD HSS EPS PROVISIONING USER
GUIDE
Prepared (also subject responsible if other) No.
RDCGUFE
Approved Checked Date Rev Reference
2013-04-26 A
service.(CW， HOLD，
MPTY)
LST_SS List all supplementary
service. GetSubscriberData
MOD_LCS Supply/Revoke Location
Service. PG not support.
LST_LCS List Location Service. PG not support.
MOD_CARP
Sign/Unsign CS
Allocation/Retention
Priority.
SetSubscriberData
LST_CARP List CS Allocation/Retention
Priority. GetSubscriberData
MOD_CAMEL Sign/Unsign CAMEL
Service.(OCSI, TCSI)
CreateCAMELSub
scriptionData Refer to 4.2.1
LST_CAMEL List CAMEL Service.(OCSI,
TCSI)
GetCAMELSubscri
ptionData
SND_CANCELC
When the location is reset,
the cancellation procedure
towards VLR and the
SGSN , in which the mobile
subscriber is currently
saved, is initiated.
SetMobileSubscrib
erLocation
8 Reference List
CMCC Documents
[1] EPS-HSS Provisioning Interface Specification 1.3.6
Ericsson Documents
[1] Glossary of Terms and Acronyms, 0033-3/CSH 109 118 Uen
[2] Hardware Installation and IP Infrastructure Setup for Provisioning Server
on EBS, 27/1531-3/CSH 109 118 Uen B
[3] Installing Provisioning Server, 1/1531-3/CSH 109 118 Uen E
[4] System Administrators Guide for Provisioning Server, 13/1543-3/CSH 109
118 Uen
[5] User Guide for Provisioning Server, 38/1553-3/CSH 109 118 Uen