Configuration Tasks for the Adapter for Landis+Gyr
This section describes the tasks that should be taken after installing Oracle Utilities Smart Grid Gateway Adapter for Landis+Gyr, including:
Note: Oracle Enterprise Manager may be required for some of the security setups and for monitoring SOA. If Oracle Enterprise Manager is required, you need to extend the example SOA WebLogic domain and enable Enterprise Manager using WebLogic's configuration utility.
Deploying the OSB Adapter for Landis+Gyr
The OSB adapter can be deployed on the bundled WebLogic example server instance or on a separate WebLogic server instance. To deploy the OSB adapter, use the following procedures:
To Deploy on the Example WebLogic Instance
1. Create the following directories under <OSB_LOG_DIR>:
lg-cim-event
lg-cim-event-arch
lg-cim-event-error
lg-event
lg-event-arch
lg-event-error
lg-usage
lg-usage-arch
lg-usage-error
 
2. Start the example OSB WebLogic instance.
UNIX
cd $SPLEBASE/osbapp
./startWebLogic.sh
 
Windows
cd %SPLEBASE%\osbapp
startWebLogic.cmd
 
3. Create JMS queues and target them to the OSB admin server.
a. Create a JMS server “OSB-JMSServer” and target it to admin server.
b. Create a JMS module “D3-SystemModule”.
c. Under “D3-SystemModule” create a sub-deployment “D3-JMSFAServer” and target it to “OSB-JMSServer”.
d. Create the following JMS queues.
Queue Name: DestinationQueue-D3
JNDI Name: DestinationQueue-D3
Sub-deployment: D3-JMSFAServer
Targets: OSB-JMSServer
Queue Name: IMDDestinationQueue-D3
JNDI Name: IMDDestinationQueue-D3
Sub-deployment: D3-JMSFAServer
Targets: OSB-JMSServer
 
Queue Name: NotificationQueue-D3
JNDI Name: NotificationQueue-D3
Sub-deployment: D3-JMSFAServer
Targets: OSB-JMSServer
4. Deploy the OSB adapter on the example WebLogic instance.
UNIX
cd $SPLEBASE/osbapp
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-osb_LG.xml
-Dadmin.user=<ADMIN_USER> -Dadmin.password=<OSB_ADMIN_PASSWORD> -Douaf.user=<JMS_USER> -Douaf.password=<JMS_PASSWORD> -Dprocessing.archive=true -Dosb.user=<OSB_USER> -Dosb.password=<OSB_PASSWORD> -Douaf.filter.user=<JMS_USER> -Douaf.filter.password=<JMS_PASSWORD>
 
Note: Use the following command if this is an upgrade from a previous version:
cd $SPLEBASE/osbapp
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-osb_LG.xml update_osb -Dadmin.user=<ADMIN_USER> --Dadmin.user=<ADMIN_USER> -Dadmin.password=<OSB_ADMIN_PASSWORD> -Douaf.user=<JMS_USER> -Douaf.password=<JMS_PASSWORD> -Dprocessing.archive=true -Dosb.user=<OSB_USER> -Dosb.password=<OSB_PASSWORD> -Douaf.filter.user=<JMS_USER> -Douaf.filter.password=<JMS_PASSWORD>
This will not override any OSB custom changes
Windows
cd %SPLEBASE%\osbapp
%SPLEBASE%\product\apache-ant\bin\ant -buildfile deploy- osb_LG.xml
-Dadmin.user=<ADMIN_USER> -Dadmin.password=<OSB_ADMIN_PASSWORD> -Douaf.user=<JMS_USER> -Douaf.password=<JMS_PASSWORD> -Dprocessing.archive=true -Dosb.user=<OSB_USER> -Dosb.password=<OSB_PASSWORD> -Douaf.filter.user=<JMS_USER> -Douaf.filter.password=<JMS_PASSWORD>
 
Note: Use the following command if this is an upgrade from a previous version:
cd %SPLEBASE%/osbapp
%SPLEBASE%/product/apache-ant/bin/ant -buildfile deploy-osb_LG.xml update_osb -Dadmin.user=<ADMIN_USER> -Dadmin.user=<ADMIN_USER> -Dadmin.password=<OSB_ADMIN_PASSWORD> -Douaf.user=<JMS_USER> -Douaf.password=<JMS_PASSWORD> -Dprocessing.archive=true -Dosb.user=<OSB_USER> -Dosb.password=<OSB_PASSWORD> -Douaf.filter.user=<JMS_USER> -Douaf.filter.password=<JMS_PASSWORD>
 
This will not override any OSB custom changes.
Create the following JMS configuration in the Oracle Utilities Meter Data Management application Admin Server:
1. Create a JMS module “LG-SystemModule” and target it to the Managed Server where the Oracle Utilities Meter Data Management application is running.
2. Under the JMS module, create a new Foreign Server "OSBForeignServer-D3" and accept the default targets.
3. Under the Foreign Server, navigate to the General tab and configure the following:
a. JNDI Initial Context Factory: weblogic.jndi.WLInitialContextFactory
b. JNDI Connection URL: URL for OSB Sever in the format - t3://<osb hostname>:<osb port number> (Use t3s for SSL)
c. JNDI Properties Credential: Credentials for user with access to OSB server
d. Confirm JNDI Properties Credential: Same as JNDI Properties Credential
e. JNDI Properties: java.naming.security.principal=<User with access to OSB server for which credentials were provided>
4. Under Destinations, create the following foreign destinations:
Name: DestinationQueue-D3
Local JNDI Name: ForegnDestinationQueue-D3
Remote JNDI Name: DestinationQueue-D3
Name: IMDDestinationQueue-D3
Local JNDI Name: ForegnIMDDestinationQueue-D3
Remote JNDI Name: IMDDestinationQueue-D3
Name: NotificationQueue-D3
Local JNDI Name: ForegnNotificationQueue-D3
Remote JNDI Name: NotificationQueue-D3
5. Under Connection Factories, create the following foreign connection factories:
Name: DestinationQueueConnectionFactory-D3
Local JNDI Name: ForegnDestinationQueueConnectionFactory-D3
Remote JNDI Name: weblogic.jms.XAConnectionFactory
Name: IMDDestinationQueueConnectionFactory-D3
Local JNDI Name: ForegnIMDDestinationQueueConnectionFactory-D3
Remote JNDI Name: weblogic.jms.XAConnectionFactory
Name: NotificationQueueConnectionFactory-D3
Local JNDI Name: ForegnNotificationQueueConnectionFactory-D3
Remote JNDI Name: weblogic.jms.XAConnectionFactory
To Deploy on a Separate WebLogic Instance
Refer to Configuration of Oracle Fusion Middleware Components on a Separate Server from Oracle Utilities Meter Data Management for more information about deploying OSB components on a separate WebLogic server.
1. Create the following directories under <OSB_LOG_DIR>.
lg-cim-event
lg-cim-event-arch
lg-cim-event-error
lg-event
lg-event-arch
lg-event-error
lg-usage
lg-usage-arch
lg-usage-error
 
2. Copy the following jars to the lib folder under the WebLogic's domain directory.
spl-d1-osb-2.4.0.0.0.jar
 
This jar is present under the following location:
UNIX: $SPLEBASE/etc/lib
Windows: %SPLEBASE%\etc\lib
3. Start the separate WebLogic instance.
4. Create JMS queues and target them to the OSB admin server.
Create a JMS server “OSB-JMSServer” and target it to admin server.
Create a JMS module “D3-SystemModule”.
Under “D3-SystemModule” create a sub-deployment “D3-JMSFAServer” and target it to “OSB-JMSServer”.
Create the following JMS queues:
Queue Name: DestinationQueue-D3
JNDI Name: DestinationQueue-D3
Sub-deployment: D3-JMSFAServer
Targets: OSB-JMSServer
 
Queue Name: IMDDestinationQueue-D3
JNDI Name: IMDDestinationQueue-D3
Sub-deployment:: D3-JMSFAServer
Targets: OSB-JMSServer
 
Queue Name: NotificationQueue-D3
JNDI Name: NotificationQueue-D3
Sub-deployment: D3-JMSFAServer
Targets: OSB-JMSServer
5. Deploy the OSB adapter on the separate WebLogic instance.
For SSL deployment, refer to the Deploying OSB adapter on SSL section.
UNIX
cd $SPLEBASE/osbapp
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-osb_LG.xml
-Dadmin.user=<ADMIN_USER> -Dadmin.password=<OSB_ADMIN_PASSWORD> -Douaf.user=<JMS_USER> -Douaf.password=<JMS_PASSWORD> -Dprocessing.archive=true -Dosb.user=<OSB_USER> -Dosb.password=<OSB_PASSWORD> -Douaf.filter.user=<JMS_USER> -Douaf.filter.password=<JMS_PASSWORD>
 
Note: Use the following command if this is an upgrade from a previous version:
 
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-osb_LG.xml update_osb -Dadmin.user=<ADMIN_USER> -Dadmin.user=<ADMIN_USER> -Dadmin.password=<OSB_ADMIN_PASSWORD> -Douaf.user=<JMS_USER> -Douaf.password=<JMS_PASSWORD> -Dprocessing.archive=true -Dosb.user=<OSB_USER> -Dosb.password=<OSB_PASSWORD> -Douaf.filter.user=<JMS_USER> -Douaf.filter.password=<JMS_PASSWORD>
This will not override any OSB custom changes.
Windows
cd %SPLEBASE%\osbapp
 
%SPLEBASE%\product\apache-ant\bin\ant -buildfile deploy-osb_LG.xml
-Dadmin.user=<ADMIN_USER> -Dadmin.password=<OSB_ADMIN_PASSWORD> -Douaf.user=<JMS_USER> -Douaf.password=<JMS_PASSWORD> -Dprocessing.archive=true -Dosb.user=<OSB_USER> -Dosb.password=<OSB_PASSWORD> -Douaf.filter.user=<JMS_USER> -Douaf.filter.password=<JMS_PASSWORD>
 
Note: Use the following command if this is an upgrade from a previous version:
%SPLEBASE%/product/apache-ant/bin/ant -buildfile deploy-osb_LG.xml update_osb -Dadmin.user=<ADMIN_USER> -Dadmin.user=<ADMIN_USER> -Dadmin.password=<OSB_ADMIN_PASSWORD> -Douaf.user=<JMS_USER> -Douaf.password=<JMS_PASSWORD> -Dprocessing.archive=true -Dosb.user=<OSB_USER> -Dosb.password=<OSB_PASSWORD> -Douaf.filter.user=<JMS_USER> -Douaf.filter.password=<JMS_PASSWORD>
 
This will not override any OSB custom changes.
Create the following JMS configuration in the Oracle Utilities Meter Data Management application Admin Server:
1. Create a JMS module “LG-SystemModule” and target it to the Managed Server where the Oracle Utilities Meter Data Management application is running.
2. Under the JMS module, create a new Foreign Server "OSBForeignServer-D3" and accept the default targets.
3. Under the Foreign Server, navigate to the General tab and configure the following:
a. JNDI Initial Context Factory: weblogic.jndi.WLInitialContextFactory
b. JNDI Connection URL: URL for OSB Sever in the format - t3://<osb hostname>:<osb port number> (Use t3s for SSL)
c. JNDI Properties Credential: Credentials for user with access to OSB server
d. Confirm JNDI Properties Credential: Same as JNDI Properties Credential
e. JNDI Properties: java.naming.security.principal=<User with access to OSB server for which credentials were provided>
4. Under Destinations, create the following foreign destinations:
Name: DestinationQueue-D3
Local JNDI Name: ForegnDestinationQueue-D3
Remote JNDI Name: DestinationQueue-D3
Name: IMDDestinationQueue-D3
Local JNDI Name: ForegnIMDDestinationQueue-D3
Remote JNDI Name: IMDDestinationQueue-D3
Name: NotificationQueue-D3
Local JNDI Name: ForegnNotificationQueue-D3
Remote JNDI Name: NotificationQueue-D3
5. Under Connection Factories, create the following foreign connection factories:
Name: DestinationQueueConnectionFactory-D3
Local JNDI Name: ForegnDestinationQueueConnectionFactory-D3
Remote JNDI Name: weblogic.jms.XAConnectionFactory
Name: IMDDestinationQueueConnectionFactory-D3
Local JNDI Name: ForegnIMDDestinationQueueConnectionFactory-D3
Remote JNDI Name: weblogic.jms.XAConnectionFactory
Name: NotificationQueueConnectionFactory-D3
Local JNDI Name: ForegnNotificationQueueConnectionFactory-D3
Remote JNDI Name: weblogic.jms.XAConnectionFactory
Deploying the SOA Adapter for Landis+Gyr
The SOA adapter can be deployed on the bundled WebLogic example server instance or on a separate WebLogic server instance.
Note: Oracle Enterprise Manager may be required for some of the security setups and for monitoring SOA. If Oracle Enterprise Manager is required, you need to extend the example SOA WebLogic domain and enable Enterprise Manager using WebLogic’s configuration utility.
To deploy the SOA adapter, follow the procedures below.
To Deploy on the Example WebLogic Instance
1. Edit the startWeblogic script located at below locations for JAVA_OPTIONS:
UNIX
cd $SPLEBASE/soaapp
./startWebLogic.sh
 
Windows
cd %SPLEBASE%\soaapp
startWebLogic.cmd
 
2. Add “-Djava.security.auth.login.config=${DOMAIN_HOME}/config/SGGLogin.config -Djavax.net.ssl.trustStore=<<JAVA_TRUST_STORE_LOCATION>>” to the JAVA_OPTIONS
3. Start the example SOA WebLogic instance:
UNIX
cd $SPLEBASE/soaapp
./startWebLogic.sh
 
Windows
cd %SPLEBASE%\soaapp startWebLogic.cmd
 
4. Deploy the SOA adapter on the example WebLogic instance.
For the SSL deployment procedure, refer to the section Deploying SOA Composites on SSL.
UNIX
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-soa_MDF.xml
-Dserver.user=<SOA_USER> -Dserver.password=<SOA_PASSWORD> -DsysPropFile=soa.properties
 
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-soa_LG.xml
-Dserver.user=<SOA_USER> -Dserver.password=<SOA_PASSWORD> -DsysPropFile=soa.properties
 
Windows
%SPLEBASE%\product\apache-ant\bin\ant -buildfile deploy
-soa_MDF.xml
-Dserver.user=<SOA_USER> -Dserver.password=<SOA_PASSWORD> -DsysPropFile=soa.properties
 
%SPLEBASE%\product\apache-ant\bin\ant -buildfile deploy-soa_LG.xml
-Dserver.user=<SOA_USER> -Dserver.password=<SOA_PASSWORD> -DsysPropFile=soa.properties
5. Deploy the TestHarness SOA composites on example WebLogic instance.
For the SSL deployment procedure, refer to the section Deploying SOA Composites on SSL.
UNIX
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-soa_LG.xml deployTestHarness -Dserver.password=<SOA_USER>
-Dserver.password=<SOA_PASSWORD> -DsysPropFile=soa.properties
 
Windows
Note: Open the command prompt as Administrative mode and then select the environment to deploy SOA.
cd %SPLEBASE%/soaapp
 
%SPLEBASE%\product\apache-ant\bin\ant -buildfile
deploy-soa_LG.xml deployTestHarness -Dserver.password=<SOA_USER>
-Dserver.password=<SOA_PASSWORD> -DsysPropFile=soa.properties
To Deploy on a Separate WebLogic Instance
Refer to Configuration of Oracle Fusion Middleware Components on a Separate Server from Oracle Utilities Meter Data Management for more information about deploying SOA components on a separate WebLogic server.
1. Create WebLogic SOA Domain and select Enterprise Manager option also.
2. Copy the following jar file to the lib folder under the WebLogic domain directory, spl-d1-soa- security.jar.
This jar is present under the following location:
UNIX
$SPLEBASE/etc/lib
 
Windows
%SPLEBASE%\etc\lib
Append the following XML snippet to <MIDDLEWARE_HOME>\user_projects\domains\<SOA Domain>\config\fmwconfig\system-jazn-data.xml:
<grant>
<grantee>
<codesource>
<url>file:${domain.home}/lib/spl-d1-soa-security.jar</url>
</codesource>
</grantee>
<permissions>
<permission>
<class>oracle.security.jps.service.credstore.CredentialAccessPermi ssion</class>
<name>context=SYSTEM,mapName=*,keyName=*</name>
<actions>*</actions>
</permission>
</permissions>
<permission-set-refs>
</permission-set-refs>
</grant>
 
3. Copy the SGGLogin.config file from below location to the config directory of Weblogic SOA domain and edit the startWeblogic script located of Weblogic SOA domain-> bin for JAVA_OPTIONS:
This SGGLogin.config is present under the following location:
UNIX: $SPLEBASE/soaapp/config
Windows: %SOA_HOME%\soaapp\config
a. Copy the file.
UNIX: <Weblogic_SOA_domain>/config
Windows: <Weblogic_SOA_domain>\config
b. Add “-Djava.security.auth.login.config=${DOMAIN_HOME}/config/SGGLogin.config -Djavax.net.ssl.trustStore=<<JAVA_TRUST_STORE_LOCATION>>” to the JAVA_OPTIONS to
UNIX: <Weblogic_SOA_domain>/bin/startWeblogic.sh
Windows: <Weblogic_SOA_domain>\bin\startWeblogic.cmd
4. Start the separate WebLogic instance.
5. Deploy the SOA adapter on the separate WebLogic instance.
For the SSL deployment procedure, refer to the Deploying SOA Composites on SSL section.
UNIX
cd $SPLEBASE/soaapp
 
For WebLogic 12c:
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-soa_MDF.xml
-Dserver.user=<ADMIN_USER> -Dserver.password=<ADMIN_PASSWORD> -DsysPropFile=soa.properties
 
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-soa_LG.xml
-Dserver.user=<ADMIN_USER> -Dserver.password=<ADMIN_PASSWORD> -DsysPropFile=soa.properties
 
Windows
cd %SPLEBASE%\soaapp
 
For WebLogic 12c:
%SPLEBASE%\product\apache-ant\bin\ant -buildfile deploy
-soa_MDF.xml
-Dserver.user=<ADMIN_USER> -Dserver.password=<ADMIN_PASSWORD> -DsysPropFile=soa.properties
 
%SPLEBASE%\product\apache-ant\bin\ant
-buildfile deploy-soa_LG.xml
-Dserver.user=<ADMIN_USER> -Dserver.password=<ADMIN_PASSWORD> -DsysPropFile=soa.properties
 
6. Deploy the TestHarness SOA composites on the separate WebLogic instance.
For the SSL deployment procedure, refer to the section Deploying SOA Composites on SSL.
UNIX
For WebLogic 12c:
$SPLEBASE/product/apache-ant/bin/ant -buildfile deploy-soa_LG.xml
deployTestHarness -Dserver.user=<ADMIN_USER>
-Dserver.password=<ADMIN_PASSWORD> -DsysPropFile=soa.properties
 
Windows
cd %SPLEBASE%\soaapp
 
For WebLogic 12c:
%SPLEBASE%\product\apache-ant\bin\ant -buildfile deploy-soa_LG.xml
deployTestHarness -Dserver.user=<ADMIN_USER>
-Dserver.password=<ADMIN_PASSWORD> -DsysPropFile=soa.properties
Configuring Security for the SOA System
Security is managed through policies attached to the input and output points of each composite. More information on policies and their configuration can be found in the Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite, Chapter 10: Configuring Policies.
This section describes how to configure security credentials for the SOA system, including:
Configuring Security for the SOA System to Communicate with the Application Framework
Configuring security for the SOA system involves using Oracle Enterprise Manager to create the following security credentials:
A Credential Map
A Credential Key for the WebLogic Server
A Credential Key for the Oracle Utilities Application Framework
Use the following procedure to create the security credentials:
1. In Oracle Enterprise Manager, expand the WebLogic domain, right-click the domain, and choose Security, Credentials.
2. On the Credentials page, click Create Map.
3. In the Create Map dialog, name the map oracle.wsm.security and click OK.
4. Click Create Key and enter the following values:
Select Map: oracle.wsm.security
Key: sgg.d3.credentials
Type: Password
Username: A valid WebLogic user name
Password: A valid WebLogic password
5. Click OK.
6. Click Create Key again and enter the following values:
Select Map: oracle.wsm.security
Key: sgg.d3.ouaf.credentials
Type: Password
Username: A valid OUAF user name
Password: A valid OUAF password
7. Click OK.
Configuring Security for the SOA System to Communicate with the Head-End System
Configuring security for the SOA system involves creating the security credentials in Oracle Enterprise Manager, and then creating a web service policy that uses the credentials to communicate with the head-end system. These configuration tasks are described in the following sections:
Creating the Security Credentials
To create the security credential in the Credential File Store (CFS):
1. In Oracle Enterprise Manager, navigate to WebLogic Domain and select the required SOA domain.
2. In the WebLogic Domain menu, navigate to Security, Credentials.
3. Click Create Map to set up a new credentials store.
4. In the Create Map dialog box, enter a unique value in the Map Name field.
5. Click OK.
6. Select the new map in the Credentials list and click Create Key.
7. In the Create Key dialog box, enter the appropriate values in the fields.
8. In the Type field, select Password.
9. Click OK.
Importing the Policy Templates and Policies
Follow the procedure below to import policy templates and policies.
1. Import the policy template jar using Enterprise Manager.
Linux
cd $SPLEBASE/soaapp
$SPLEBASE/product/apache-ant/bin/ant -buildfile package-soa-policy.xml –Dproduct=d1
 
Windows
cd %SPLEBASE%/soaapp
$SPLEBASE/product/apache-ant/bin/ant -buildfile package-soa-policy.xml –Dproduct=d1
 
a. In Oracle Enterprise Manager, navigate to WebLogic Domain and select the required SOA domain.
b. Right-click the domain and navigate to Web Services, WSM Policies.
c. Click Web Services Assertion Templates at the top of the page.
d. Click Import and import the sgg-d1-policy.jar file.
This file is located in the following directory:
UNIX: $SPLEBASE/soaapp/policies/jars
Windows: %SPLEBASE%\soaapp\policies\jars
2. Import the policy template jar using Enterprise Manager.
Linux
cd $SPLEBASE/soaapp
$SPLEBASE/product/apache-ant/bin/ant -buildfile package-soa-policy.xml –Dproduct=d3
 
Windows
cd %SPLEBASE%/soaapp
$SPLEBASE/product/apache-ant/bin/ant -buildfile package-soa-policy.xml –Dproduct=d3
 
a. In Oracle Enterprise Manager, navigate to WebLogic Domain and select the required SOA domain.
b. Right-click the domain and navigate to Web Services, WSM Policies.
c. Click Web Services Assertion Templates at the top of the page.
d. Click Import and import the sgg-d3-policy.jar file.
This file is located in the following directory:
UNIX: $SPLEBASE/soaapp/policies/jars
Windows: %SPLEBASE%\soaapp\policies\jars
Creating the Web Service Policy for the Security Credentials
To create a web service policy for the security credentials:
1. In Oracle Enterprise Manager, navigate to WebLogic Domain and select the required SOA domain.
2. In the WebLogic Domain menu, navigate to Web Services, Policies.
3. Select the policy oracle/wss_http_token_client_policy.
4. Click Create Like.
a. Give the policy a unique name and an appropriate description.
b. Under Assertions, remove the Log Message and the HTTP Security policies.
c. Click Add.
d. Enter a name for the new assertion.
e. In the Assertion Template field, select sgg/d1_csf_access_client_xpath_template.
f. Click OK.
5. In the Assertion Content field, edit property values in the XML according to the example below. The following table lists the property values that should be edited:
Field
Default Value
Description
csf-map
 
Required. The credential store map to use. This value is specified in the task Creating the Security Credentials.
csf-key
 
Required. The key in the credential store map that will resolve to a username-password pair. This value is specified in the task Creating the Security Credentials.
namespaceDefinitions
 
Prefix-namespace definitions used in the xpath fields below. Each should be in the form prefix=namespace. Multiple definitions should be separated by spaces. Default namespaces cannot be set.
soapElement
Header
The context node for xpath searches, either the SOAP header or the SOAP body. Legal values are "header" and "body."
userid.xpath
 
The xpath to the location to inject the username in the SOAP element. The statement must resolve to an attribute or element that already exists.
password.xpath
 
The xpath to the location to inject the password in the SOAP element. The statement must resolve to an attribute or element that already exists.
isDebuggingActive
false
Reserved for internal use.
<orasp:SGGCredentialStoreInsertionXPath xmlns:orawsp="http://schemas.oracle.com/ws/2006/01/policy" orawsp:Silent="true" orawsp:name="CSF_CIM_L+G" orawsp:description="Properties to add CSF credentials to a SOAP message" orawsp:Enforced="true" orawsp:category="security/authentication" xmlns:orasp="http://schemas.oracle.com/ws/2006/01/securitypolicy">
<orawsp:bindings>
<orawsp:Implementation>com.splwg.d1.sgg.soa.common.security.policy.CredentialStorageFacilityAccessAssertationExecutor</orawsp:Implementation>
<orawsp:Config orawsp:name="CSFKeyInsertionConfig" orawsp:configType="declarative">
<orawsp:PropertySet orawsp:name="CSFKeyProperties">
<orawsp:Property orawsp:type="string" orawsp:contentType="required" orawsp:name="csf-map">
<orawsp:Description>Which CSF map to use</orawsp:Description>
<orawsp:Value>CSF_map_name</orawsp:Value>
</orawsp:Property>
<orawsp:Property orawsp:type="string" orawsp:contentType="required" orawsp:name="csf-key">
<orawsp:Description>Which key in the map to use</orawsp:Description>
<orawsp:Value>CSF_CIM_Key</orawsp:Value>
</orawsp:Property>
</orawsp:PropertySet>
<orawsp:PropertySet orawsp:name="XPathProperties">
<orawsp:Property orawsp:type="string" orawsp:contentType="required" orawsp:name="soapElement">
<orawsp:Description>The segment of the soap message to which to write. Legal Values are "header" &amp; "body"</orawsp:Description>
<orawsp:Value>header</orawsp:Value>
</orawsp:Property>
<orawsp:Property orawsp:type="string" orawsp:contentType="optional" orawsp:name="namespaceDefinitions">
<orawsp:Description>A space-separated list of prefix-namespace pairs. For example: ns1=http://myurl.com/ns1 ns2=http://oracle.com xsd=http://www.w3.org/2001/XMLSchema</orawsp:Description>
<orawsp:Value>ns1=http://www.landisgyr.com/iec61968/2010/03</orawsp:Value>
</orawsp:Property>
<orawsp:Property orawsp:type="string" orawsp:contentType="required" orawsp:name="userid.xpath">
<orawsp:Description>The xpath relative to the soapElement property at which to insert the user id.</orawsp:Description>
<orawsp:Value>./UserName</orawsp:Value>
</orawsp:Property>
<orawsp:Property orawsp:type="string" orawsp:contentType="required" orawsp:name="password.xpath">
<orawsp:Description>The xpath relative to the soapElement property at which to insert the password.</orawsp:Description>
<orawsp:Value>./Password</orawsp:Value>
</orawsp:Property>
</orawsp:PropertySet>
<orawsp:PropertySet orawsp:name="DebugProperties">
<orawsp:Property orawsp:type="boolean" orawsp:contentType="optional" orawsp:name="isDebuggingActive">
<orawsp:Description>controls debugging output</orawsp:Description>
<orawsp:Value>false</orawsp:Value>
<orawsp:DefaultValue>false</orawsp:DefaultValue>
</orawsp:Property>
</orawsp:PropertySet>
</orawsp:Config>
</orawsp:bindings>
</orasp:SGGCredentialStoreInsertionXPath>
 
6. Save the policy.
7. Attach the policy to the MR_CB reference on the CommissionDecommission composite.
a. In Oracle Enterprise Manager, navigate to the CommissionDecommission composite.
b. From the Attach To/Detach From menu, select MR_CB.
c. In the Available Policies window, select the policy that you just created.
d. Click Attach to attach the policy to the MR_CB reference.
8. Attach the policy to the CD_CB reference on the ConnectDisconnect composite
a. Navigate to the ConnectDisconnect composite.
b. From the Attach To/Detach From menu, select CD_CB.
c. In the Available Policies window, select the policy that you just created.
d. Click Attach to attach the policy to the CD_CB reference.
9. Attach the policy to the MR_CB reference on the OnDemandRead composite.
a. Navigate to the OnDemandRead composite.
b. From the Attach To/Detach From menu, select MR_CB.
c. In the Available Policies window, select the policy that you just created.
d. Click Attach to attach the policy to the MR_CB reference.
Starting the Application
The OSB WebLogic server instance should be up and running before starting the main application.
Creating WebLogic Domain
Create the WebLogic native domain and deploy the application. For instructions refer to the Native Installation Oracle Utilities Application Framework (Doc ID: 1544969.1) document on My Oracle Support.
The MDB user configured in Menu 3 during the Oracle Utilities Application Framework installation has to be created in the Oracle Utilities Application Framework application and WebLogic console, and should be part of the “cisusers” group.
Note: The first time you start Oracle Utilities Meter Data Management, you need to log into the WebLogic console and give system access to cisusers role. The WebLogic console application can be accessed through the following URL: http://<hostname>:<portname>/ console.