Transcript MultiSpeak 3.0 Interface

MULTISPEAK 3.0 UPDATES
RNI 3.1 SP1
© 2013 Sensus. All rights reserved.
C-PAMI-WGE-0006-01
Module Goals
2
The goals of this module are to:
Review the Sensus MultiSpeak 3.0 solution and
identify updates to that solution between release
2.2.4 and 3.1 SP1 of the RNI.
Section One
3
Sensus MultiSpeak 3.0
Solution
Section Objectives
4
Following this section, you should be able to:
1. List the functions Sensus supports from the
MultiSpeak v3.0 standard.
2. Describe the purpose of each function.
3. Recognize which methods are associated with
each function.
About the Sensus MultiSpeak Gateways
MultiSpeak 3.0 Solution
• Access RNI functionality through a well-defined
interface
• Secure the interface using authentication,
authorization, encryption
• Translate from internal RNI data structures to
external (e.g. MultiSpeak) data structures
• Manage data delivery
5
Sensus MultiSpeak v3.0 Function Support
MultiSpeak v3.0 Solution
• Meter Reading (MR)
• Outage Detection (OD)
• Connect-Disconnect (CD)
Customer Billing
Outage Management
OD
CD
MultiSpeak v3.0 web applications
FlexNet Gateway application server (Tomcat)
6
MR
About the MultiSpeak 3.0 Meter Reading (MR) Function
MultiSpeak 3.0 Solution
• Interface 2A of specification 3.0j
• Contains a Web service, MRCB
– Provides meter read data and lifecycle management
– Located at http://<rniweb.mycompany.com>/multispeak/mrcb
• Contains a Web service client, CBMR
– Performs meter synchronization with a remote CB system
– CBMR script (command line utility) available to trigger data
synchronization using these methods
• Appropriate LDAP/AD permissions required to
execute methods
7
MultiSpeak v3.0 Meter Reading (MR) Methods
MultiSpeak 3.0 Solution
API
MRCB
CBMR
8
Category
Method
PingURL
General
GetMethods
GetAMRSupportedMeters
Meter
management MeterAddNotification
MeterChangedNotification
ServiceLocationChangedNotification
MeterRemoveNotification
InitiateDisconnectedStatus
CancelDisconnectedStatus
InitiateUsageMonitoring
CancelUsageMonitoring
GetLatestReadingByMeterNo
Meter
reading
InitiateMeterReadingsByMeterNumber
GetAllMeters
Meter
management GetAllServiceLocations
MultiSpeak v3.0 Outage Detection (OD) Function
MultiSpeak 3.0 Solution
• Interface 5 of specification 3.0j
• Contains a Web service, ODOA
– Provides outage notifications
– Allows “Are you alive” ping to meter
– Located at http://<rniweb.mycompany.com>/multispeak/odoa
• Contains a Web service client, OAOD
– Sends notifications to remote OD system
– Real-time alarms
• Appropriate LDAP/AD permissions required to
execute methods
9
MultiSpeak 3.0 Outage Detection (OD) Methods
MultiSpeak 3.0 Solution
Web Service
Category
ODOA
General
Outage
detection
OAOD
10
Method
PingURL
GetMethods
InitiateOutageDetectionEventRequest
Notification ODEventNotification
MultiSpeak 3.0 Connect-Disconnect (CD) Function
MultiSpeak 3.0 Solution
• Interface 2B of specification 3.0j
• Contains a Web service, CDCB
– Manages the remote connection and disconnection of
meters
– Subset of methods defined by specification
– Located at http://<rniweb.mycompany.com>/multispeak/cdcb
• Contains a Web service client, CBCD
– Sends notifications to remote CB system
• Appropriate LDAP/AD permissions required to
execute methods
11
MultiSpeak 3.0 Connect-Disconnect (CD) Methods
MultiSpeak 3.0 Solution
Web Service
Category
CDCB
General
Meter
control
CBCD
12
Notification
Method
PingURL
GetMethods
InitiateConnectDisconnect
GetCDMeterState
GetCDSupportedMeters
CDStateChangedNotification
New in
RNI 3.1
Section Two
13
Summary of
MultiSpeak 3.0 Changes
from RNI 2.2.4 to 3.1
Section Objectives
14
Following this section, you should be able to:
1. Identify updates to the MultiSpeak 3.0 solution
for RNI version 3.1 SP1.
MultiSpeak 3.0 Updates
MultiSpeak 3.0 Updates
• Added remote connect/disconnect/arm for electric
and gas meters
• Added ability to open/close the valve in the Remote
Gas Shutoff SmartPoint module
• Added option to suppress metrology power failure
alarm
• Added option to not report an alarm on a power
failure associated with a tamper event
• Added Watt hour and Watts resolution in the
GetLatestReadingByMeterNo response
15
Additional MultiSpeak 3.0 Updates
MultiSpeak 3.0 Updates
• Added SOAP Action HTTP header to notifications and
CBMR requests
• Added MultiSpeak Message Header to SOAP fault
responses
• Added serviceLocationID (POD) parameter to
ODEventNotification method
• Added GetCDSupportedMeters method
16
Section Three
17
Configuring MultiSpeak
Parameters in the RNI
Section Objectives
18
Following this section, you should be able to:
1. Configure common gateway properties.
2. Configure logging levels.
3. Perform data synchronization.
Configuring MultiSpeak Gateway Properties: Steps 1-3
Configuring MultiSpeak 3.0 Parameters
1. In FlexWare, click Administration
> Configuration
2. Click
Customer/Network/Configuration
3. Click Configuration tab
Note: Gateway configurations are
named in the following manner:
[Gateway].[Function].[Method].[Property]
*The Method may be omitted if the configuration
is not specific to a method.
19
Configuring MultiSpeak Gateway Properties: Steps 4-7
Configuring MultiSpeak 3.0 Parameters
7
Save the changes
4
Select your company
from the list.
Do not change the
System Defaults
5
Locate the parameter to
change. Uncheck the
System Default value.
6
Select or enter the
desired value
Note: Any user can view values, but you must have the appropriate permissions to make changes.
20
Various Log Files Available for Troubleshooting
Configuring MultiSpeak 3.0 Parameters
21
Log Type
Log Files
Gateway
/opt/flexnet-gateway/logs
catalina.out
tomcat.log
[webapp].log
HTTPD
/var/log/httpd
access.log
error.log
FlexNetApp
/opt/flexnet/log
NCProgs
/opt/ncprogs/backspool
nc2tgb.dat
mctsbackspool.dat
About Logging Levels
Configuring MultiSpeak 3.0 Parameters
• Determines level of information to include in
notifications
• Levels
– WARN: Quiet level
– INFO: Audit level
– DEBUG: Troubleshooting level
• Logging granularity at Java class level
Default logging displays
start-up messages,
warnings and errors, and
when messages are sent
and received
22
Setting Logging Level for Gateway
Configuring MultiSpeak 3.0 Parameters
1. Log in to the gateway server
2. Navigate to the /opt/flexnet-gateway/conf
directory
3. Open the log4j.properties file for editing
4. Enter the following:
# Set the gateway service logger at INFO to log
incoming requests
log4j.logger.com.sensus.gateway.multispeak.ws.interce
ptor.MultiSpeakLoggingInterceptor=INFO
23
About Data Synchronization
Configuring MultiSpeak 3.0 Parameters
• MultiSpeak 3.0 gateway includes command line
utility to trigger data synchronization using
GetAllMeters and GetAllServiceLocations CBMR
web methods
24
Performing a Data Synchronization
Configuring MultiSpeak 3.0 Parameters
1. Log in to the Web server
2. Navigate to the /opt/flexnet-gateway/webapps/
multispeakv3-cb-client/WEB-Inf/bin directory
3. Run the CBMR script
cb.sh
4. Enter one of the following options:
– 3: Start synchronization of meters only
– 4: Start synchronization of service locations only
– 5: Start synchronization of both meters and service
locations
5. Enter information requested by the resulting
prompts
View the cb.log file for messages
regarding the synchronization
25
Questions
26
Learning Check
27
Question:
1. Which function is supported by the Sensus
MultiSpeak 3.0 solution?
a) Home Area Network
b) Demand Response
c) Meter Reading
d) Distribution Automation
Learning Check
28
Question:
2. What is the purpose of the Meter Reading
function?
a) Provides event information related to
managing outages
b) Provides meter read data and lifecycle
management
c) Manages the remote connection and
disconnection of meters
d) Sends notifications to remote OD system
Learning Check
29
Question:
3. What is the purpose of the Outage Detection
function?
a) Provides event information related to
managing outages
b) Manages meter synchronization with a
remote CB system
c) Manages the remote connection and
disconnection of meters
d) Provides meter read data and lifecycle
management
Learning Check
30
Question:
4. What is the purpose of the Connect Disconnect
function?
a) Manages meter synchronization with a
remote CB system
b) Provides event information related to
managing outages
c) Provides meter read data and lifecycle
management
d) Manages the remote connection and
disconnection of meters
Learning Check
Question:
5. Check the MultiSpeak function associated with
each method.
Method
MeterChangedNotification
GetAMRSupportedMeters
Meter
Reading
Outage
Detection
Connect
Disconnect








GetCDSupportedMeters
PingURL
InitiateUsageMonitoring


ODEventNotification
GetMethods
31

Learning Check
32
Question:
7. Which MultiSpeak 3.0 function was added for
electric and gas meters for RNI v3.1 SP1?
a) Meter Reading
b) Outage Detection
c) Connect Disconnect
d) None of the above
Learning Check
33
Question:
8. Indicate whether the following statements are
True or False.
a) MultiSpeakMsgHeader was added in SOAP
fault responses _______
True
b) SOAPAction HTTP headers were added to
False
Outage Detection requests _______
c) Option to suppress metrology power failure
True
alarm now supported _______
False
d) GetCDMeterIds method added _______
Learning Check
34
Question:
9. Data synchronization is performed in what
manner?
a) Using a web interface
b) Using a command line utility
c) Using a database query
d) None of the above
Learning Check
35
Question:
10. Which are the three logging levels available
with the MultiSpeak logs?
a) Info, Debug, Caution
b) Info, Warn, Debug
c) Normal, Caution, Warn
d) Normal, Debug, Warning