Upgrade Procedure
The upgrade installation procedure consists of:
Database Component Upgrade
Upgrading the Oracle Utilities Smart Grid Gateway database component must be complete before proceeding with the following sections.
Refer to the Upgrade Install section in the Oracle Utilities Smart Grid Gateway Database Administrator’s Guide for instructions to upgrade the database component.
Note: When implementing Oracle Utilities Smart Grid Gateway with Oracle Utilities Meter Data Management, both the Smart Grid Gateway and Meter Data Management database components should be installed in the same database.
Application Components Upgrade
A successful upgrade consists of the following steps:
Upgrading the Oracle Utilities Application Framework Application Component to V25.4
This section describes how to upgrade the application component of Oracle Utilities Application Framework, including:
Copying and Decompressing Install Media
The Oracle Utilities Application Framework installation file is delivered in jar format for both UNIX and Windows platforms. If you are planning to install multiple Oracle Utilities Application Framework environments operated by different Oracle Utilities administrator user IDs, you must complete the following installation steps for each administrator user ID.
To copy and decompress the install media:
1. Login to the application server host with the Oracle Utilities Application Framework administrator user ID.
2. Download the Oracle Utilities Application Framework V25.4 Multiplatform from Oracle Software Delivery Cloud.
3. Create a temporary directory, such as c:\ouaf\temp or /ouaf/temp. (Referred to below as <TEMPDIR>.)
Note: This directory must be located outside any current or other working Oracle Utilities application environment. All files that are placed in this directory as a part of the installation can be deleted after completing a successful installation.
4. Copy the downloaded application zip file to the <TEMPDIR>.
5. Decompress the file.
cd <TEMPDIR>
unzip -q <INSTALL MEDIA ZIP FILE NAME>
A sub-directory named FW-V25.4 is created. It contains the installation software for the Oracle Utilities Framework Application server.
Setting Permissions for the cistab file in UNIX
Every Oracle Utilities Application Framework environment installed on a server must be registered in the /etc/cistab file located on that server. On UNIX servers, generally only the root user ID has write permissions to the /etc directory. Since the installation process is run by the Oracle administrator user ID (cissys), this user ID may not be able to write to /etc/cistab table.
The install utility checks permissions and if it identifies a lack of the necessary permissions, it generates a script in the <TEMPDIR>/FW-V25.4 directory named cistab_<SPLENVIRON>.sh. Run the generated script using the root account before continuing with the installation process. The script initializes the cistab file in /etc directory (if it is the first Oracle Utilities Framework application environment on the server) and registers a new environment.
The generated script also changes the owner of /etc/cistab file to the Oracle Utilities Framework administrator user ID, so that the next time a new environment is created by the same Oracle Utilities Framework administrator user ID, you do not need to run the generated script with the root user ID. Instead the install utility itself proceeds with the registration.
If you are reinstalling an existing environment, only the validation of /etc/cistab entry is done by the install utility, no new registration occurs. The install utility interactively instructs you about every step that needs to occur in each specific case.
If you are planning to upgrade an existing environment it is your responsibility to take a backup prior to the installation process. The installation utility does not create a backup of existing environment.
Upgrading the Application Component Over Oracle Utilities Smart Grid Gateway V25.4
This section outlines the steps for upgrading the application component of Oracle Utilities Application Framework over Oracle Utilities Smart Grid Gateway 25.4.
Note: Customers who have a version prior to 2.2.0.3.0 must install 2.2.0.3.0 before upgrading to 25.4.
1. Login to the Application Server host as administrator (the default is cissys on UNIX) or as a user with Administrator privileges (on Windows).
2. Change directory to the bin folder.
cd <install_dir>/bin
where <install_dir> is the location where the Oracle Utilities Meter Data Management Base application component is installed.
3. Initialize the environment.
UNIX
./splenviron.sh -e <ENV NAME>
Windows
splenviron.cmd -e <ENV NAME>
4. Stop the environment, if it is running.
UNIX
$SPLEBASE/bin/spl.sh stop
Windows
%SPLEBASE%\bin\spl.cmd stop
5. Change the directory to <TEMPDIR>/FW-V25.4.
Note: While installing the FW V25.4 from the previous environment to V25.4, the install utility removes the existing environment and re-creates the environment. Make a backup before you proceed with installing FW V25.4 to retain any configurations for future reference.
6. Start the application installation utility.
UNIX
ksh ./install.sh
Windows
install.cmd
The Oracle Utilities Application Framework specific menu appears.
7. Follow the messages and instructions that are produced by the application installation utility.
9. Below is the mandatory list of configurable items along with descriptions for a few items. Where you see <Mandatory>, enter values suitable to your environment. You can assign default values to the rest of the menu items.
************************************
* Environment Installation Options *
************************************
1. Environment ID, Roles, Third Party Software Configuration
Environment ID | <Default> |
Server Roles | batch, online |
Oracle Client Home Directory | <Mandatory for Initial Install> |
Web Java Home Directory | <Mandatory for Initial Install> |
Hibernate JAR Directory | <Mandatory for Initial Install> |
ONS JAR Directory | <Optional> |
Web Application Server Home Directory | <Mandatory for Initial Install> |
Additional JAR Directory | <Optional> |
2. Keystore Options
Import Keystore Directory | <Default> |
50. Environment Installation Options
Environment Mount Point | <Mandatory> |
Log Files Mount Point | <Mandatory> |
Environment Name | <Mandatory> |
Install Application Viewer Module | true |
Install Sample CM Source Code | true |
Each item in the above list should be configured for a successful install.
Choose option (1,2,50, <P> Process, <X> Exit):
Once you enter 'P' after entering mandatory input values in the above menu, the system populates another configuration menu.
***********************************************************
* Environment Configuration *
***********************************************************
1. Environment Description
Environment Description | <Mandatory> |
2. Business Application Server Configuration
Business Server Host | <Mandatory> - Hostname on which application being installed |
Business Server Application Name | SPLService |
3. Web Application Server Configuration
Web Server Host | <Mandatory> |
WebLogic SSL Port Number | <Mandatory> |
WebLogic Console Port Number | <Mandatory> |
Web Context Root | ouaf |
WebLogic JNDI User ID | <Mandatory> |
WebLogic JNDI Password | <Mandatory> |
WebLogic Server Name | myserver |
Web Server Application Name | SPLWeb |
This Is A Production Env. And The Client Is Live | WEB_ISLIVEPRODUCTION |
Deploy Application Viewer Module | true |
Enable The Unsecured Health Check Service | false |
MDB RunAs User ID | <Mandatory> |
Super User IDs | <Mandatory> |
4. Database Configuration
Application Server Database User ID | <Mandatory> |
Application Server Database Password | <Mandatory> |
XAI Database User ID | <Mandatory> |
XAI Database Password | <Mandatory> |
Batch Database User ID | <Mandatory> |
Batch Database Password | <Mandatory> |
Web JDBC DataSource Name | <Optional> |
Database Name | <Mandatory> |
Database Server | <Mandatory> |
Database Port | 1521 |
ONS Server Configuration | <Optional> |
Database Override Connection String | <Optional> |
Character Based Database | false |
Oracle Client Character Set NLS_LANG | AMERICAN_AMERICA.AL32UTF8 |
5. General Configuration Options
Batch RMI Port | <mandatory> |
RMI Port number for JMX Business | <optional> |
RMI Port number for JMX Web | <optional> |
JMX Enablement System User ID | <optional> |
JMX Enablement System Password | <optional> |
Coherence Cluster Name | <mandatory> |
Coherence Cluster Address | <mandatory> |
Coherence Cluster Port | <Mandatory> |
Coherence Cluster Mode | prod<Mandatory> |
6. OUAF TrustStore Options
Import TrustStore Directory | <Mandatory> for Prod |
Each item in the above list should be configured for a successful install.
Choose option (1,2,3,4,5,6 <P> Process, <X> Exit):
10. When the parameter setup is complete, proceed with the option P. The utility writes the configured parameters and their values into the configuration file.
11. Once the install or upgrade has finished, the installation log location is displayed on the screen. If the log does not list any error messages, the installation of the application component of Oracle Utilities Application Framework is complete.
Alternatively, you can follow these steps to upgrade a Oracle Utilities Application Framework version which is lower than 25.4 to version 25.4 or higher.
Note that these instructions refer to Unix platforms. For Windows, use the “.cmd” extension instead of “.sh” and provide the syntax for respective environmental variables and directories.
1. Install the prerequisite software on the server.
• Java 17
• Oracle FMW Infrastructure 14
• Oracle Database Client 19c
2. Shut down the environment that you need to upgrade.
3. Take a full backup of the environment.
4. Run the following command:
splenviron.sh -e <ENV_NAME>
5. Run the following command:
ksh ./install.sh -u
6. Run the “configureEnv.sh -i” command and set Oracle Client Home, Web Java Home, and Web Application Server Home.
7. Run the “splenviron.sh -e <ENV_NAME>” command.
8. Run the “configureEnv.sh” and update Domain Home Location (menu block_52), ports, and server, if needed.
9. Run the “configureEnv.sh -ic” command.
10. Run the “configureEnv.sh -c” command.
11. Run the “initialSetup.sh” command.
12. Review and incorporate the content of the most recent $SPLEBASE/tools/examples/bin/setUserOverride.sh in your WebLogic 14 domain.
13. Redeploy and restart the environment and batch.
Upgrading Oracle Utilities Meter Data Management V25.4 Application Component
This section describes how to install the Oracle Utilities Meter Data Management, including:
To proceed with the Oracle Utilities Meter Data Management installation you need to be connected to the target Oracle Utilities Application Framework environment.
You must initialize the Oracle Utilities Application Framework environment. For detailed instructions, refer to the Installing the Oracle Utilities Application Framework V4.5.0.1.1 Application Component section.
Copying and Decompressing the Install Media
The Oracle Utilities Meter Data Management installation file is delivered in jar format for both UNIX and Windows platforms.
To copy and decompress the install media:
1. Login to the application server host with the Oracle Utilities Application Framework administrator user ID.
2. Download the Oracle Utilities Meter Data Management V25.4 Multiplatform.zip from Oracle Software Delivery Cloud.
3. Create a temporary directory such as c:\ouaf\temp or /ouaf/temp. (Referred to below as <TEMPDIR>)
Note: This directory must be located outside any current or other working Oracle Utilities application environment. All files that are placed in this directory as a part of the installation can be deleted after completing a successful installation.
4. Unzip Oracle Utilities Meter Data Management V25.4 Multiplatform.zip to get the file MDM_V25.4.zip from the delivered package and copy to the <TEMPDIR>. To use FTP to transfer this file, use the BINARY option.
5. Decompress the file:
cd <TEMPDIR>
unzip MDM_V25.4.zip
cd App
For UNIX and Windows platforms, a sub-directory named MDM.V25.4 is created. The contents of the installation directory are identical for both platforms. The directory contains the install software for the application product.
Installing the Oracle Utilities Meter Data Management Application Component
To install the Oracle Utilities Meter Data Management application component:
1. Login to the application server host as Oracle Utilities Application Framework Administrator (default cissys).
2. Change directory:
cd <install_dir>/bin
where <install_dir> is the location where the Oracle Utilities Application Framework application component is installed.
3. Initialize the environment by running the appropriate command:
UNIX
./splenviron.sh -e <ENV NAME>
Windows
splenviron.cmd -e <ENV NAME>
4. Navigate to <TEMPDIR>/MDM.V25.4 directory.
5. Run the install script.
Note: On UNIX, ensure that you have the proper execute permission on install.sh.
UNIX
ksh ./install.sh
Windows
install.cmd
6. Choose option P to proceed with the installation.
Note: The rest of the menu items can be ignored if you are installing only Oracle Utilities Meter Data Management.
The Oracle Utilities Meter Data Management installation is complete if no errors occurred during the installation.
Configuring Oracle Fusion Middleware Components on a Separate Server from Oracle Utilities Meter Data Management
This section applies to an Oracle Utilities Smart Grid Gateway configuration in which Oracle Service Bus (OSB) or Oracle SOA Suite is installed on a separate host from the Oracle Utilities Application Framework’s host. In this configuration, the Oracle Utilities installation scripts must have access to the libraries in the OSB and SOA servers' directories to deploy OSB projects and SOA composites successfully.
Follow these procedures to configure access to a remote OSB server:
• Create a network share to the osb folder within the Middleware Home on the remote OSB server.
• Provide the following values for Menu Item 8 (OSB Configuration) during the installation for Oracle Utilities Meter Data Management:
Note: Use the completed OSB configuration worksheet to assist you in this step. See the Installation and Configuration Worksheets.
• OSB Home is the location of the osb folder, accessed by way of network share.
• OSB Host Server is the host name of the OSB server.
• OSB Port Number is the port of the OSB admin server.
• OSB SSL Port Number is the port of the OSB SSL admin server.
• OSB Managed Server Port Number is the port of the OSB Managed Server.
• OSB Managed Server SSL Port Number is the port of the OSB SSL Managed Server
Follow these procedures to configure access to a remote SOA Suite server:
• Create a network share to the soa folder within the Middleware Home on the remote SOA Suite server.
• Provide the following values for Menu Item 9 (SOA Configuration) during the installation for Oracle Utilities Meter Data Management.
Note: Use the completed SOA configuration worksheet to assist you in this step. See the Installation and Configuration Worksheets.
• SOA Home is the location of the soa folder, accessed by way of network share.
• SOA Host Server is the host name of the SOA managed server.
• SOA Port Number is the port of the SOA managed server.
• SOA SSL Port Number is the port of the SOA SSL managed server.
Upgrading the Oracle Utilities Smart Grid Gateway V2.2.0.3 SOA Suite Application Components
This section describes how to upgrade the SOA Suite application components of Oracle Utilities Smart Grid Gateway, including:
Note: SOA Suite is NOT required with native implementations of Smart Grid Gateway adapters. See Smart Grid Gateway Implementations in the Oracle Utilities Meter Solution Administrative User Guide for more information.
Upgrading the MV90 Adapter for Itron
This section describes the installation of the MV90 Adapter for Itron, including:
Pre-installation Tasks for the MV90 Adapter
This section describes the steps that should be taken before installing Oracle Utilities Smart Grid Gateway MV90 Adapter, including:
Copying and Decompressing the Installation Media
The installation file is delivered in jar format for both UNIX and Windows platforms.
Oracle Utilities Smart Grid Gateway is delivered as part of the Oracle Utilities Meter Data Management installation package. Refer to the
Supported Platforms and Hardware Requirements for versions and installation details regarding the database and operating system. Also, see
Installing Prerequisite Software for prerequisite third-party software installation instructions.
Download the installation package and proceed as follows:
• Login to the host server as the Oracle Utilities Application Framework administrator user ID (default cissys). This is the same user ID that was used to install the Oracle Utilities Application Framework.
Initializing the Oracle Utilities Application Framework Environment
1. Login as Oracle Utilities Application Framework Administrator (default cissys).
2. Initialize the Meter Data Management environment that you want to install the product into.
UNIX
$SPLEBASE/bin/splenviron.sh -e $SPLENVIRON
Windows
%SPLEBASE%\bin\splenviron.cmd -e %SPLENVIRON%
3. Stop the environment if running.
Upgrading the MV90 Adapter
To install the Oracle Utilities Smart Grid Gateway MV90 Adapter:
1. Run the install script.
UNIX
ksh ./configureEnv.sh
Windows
configureEnv.cmd
Note: On UNIX, ensure that you have the proper execute permission on install.sh.
2. Select menu item 8 to configure OSB.
3. Choose option P to proceed with the installation.
4. Run initialSetup.sh.
UNIX
$SPLEBASE/bin/initialSetup.sh
Windows
%SPLEBASE%\bin\ initialSetup.cmd
Once the install has finished successfully, execute the post-installation steps described in
Configuration Tasks for the MV90 Adapter.
Upgrading the Adapter Development Kit
This section describes the installation of the Adapter Development Kit, including:
Pre-installation Tasks for the Adapter Development Kit
This section describes the steps that should be taken before installing Oracle Utilities Smart Grid Gateway, including:
Copying and Decompressing the Installation Media
The installation file is delivered in jar format for both UNIX and Windows platforms.
Oracle Utilities Smart Grid Gateway is delivered as part of the Oracle Utilities Meter Data Management installation package. Refer to the
Supported Platforms and Hardware Requirements for versions and installation details regarding the database and operating system. Also, see
Installing Prerequisite Software for prerequisite third-party software installation instructions.
Download the installation package and proceed as follows:
• Login to the host server as the Oracle Utilities Application Framework administrator user ID (default cissys). This is the same user ID that was used to install the Oracle Utilities Application Framework.
Installation Tasks for the Adapter Development Kit
This section describes the installation of the Adapter Development Kit, including:
Initializing the Oracle Utilities Application Framework Environment
1. Login as Oracle Utilities Application Framework Administrator (default cissys).
2. Initialize the Application Framework environment that you want to install the product into.
UNIX
$SPLEBASE/bin/splenviron.sh -e $SPLENVIRON
Windows
%SPLEBASE%\bin\splenviron.cmd -e %SPLENVIRON%
Upgrading the Adapter Development Kit
To install the Oracle Utilities Smart Grid Gateway Adapter Development Kit:
1. Run the install script.
UNIX
ksh ./configureEnv.sh
Windows
configureEnv.cmd
Note: On UNIX, ensure that you have the proper execute permission on install.sh.
The Configuration menu for Oracle Utilities Smart Grid Gateway appears.
2. Select menu item 8 to configure OSB.
3. Select menu item 9 to configure SOA.
4. Select menu item 10 to configure the SOA Configuration Plan.
5. Select menu item 21 to configure the URI of the head-end system.
6. When you are done setting up the parameters, choose option P to proceed with the installation.
7. Run initialSetup.sh.
UNIX
$SPLEBASE/bin/initialSetup.sh
Windows
%SPLEBASE%\bin\ initialSetup.cmd
Once the install has finished successfully, execute post-installation steps described
Configuration Tasks for the Adapter Development Kit.
Upgrading the Adapter for Networked Energy Services
This section describes the installation of the Adapter for Networked Energy Services, including:
Pre-installation Tasks for the Adapter for Networked Energy Services
This section describes the steps that should be taken before installing Oracle Utilities Smart Grid Gateway, including:
Copying and Decompressing the Installation Media
The installation file is delivered in jar format for both UNIX and Windows platforms.
Oracle Utilities Smart Grid Gateway is delivered as part of the Oracle Utilities Meter Data Management installation package. Please refer to the
Operating Systems and Application Serversfor versions and installation details regarding the database and operating system. Also see
Installing Prerequisite Software for prerequisite third-party software installation instructions.
Download the installation package and proceed as follows:
• Login to the host server as the Oracle Utilities Application Framework administrator user ID (default cissys). This is the same user ID that was used to install the Oracle Utilities SApplication Framework.
Initializing the Oracle Utilities Application Framework Environment
1. Login as Oracle Utilities Application Framework Administrator (default cissys).
2. Initialize the Oracle Utilities Application Framework environment that you want to install the product into.
UNIX
$SPLEBASE/bin/splenviron.sh -e $SPLENVIRON
Windows
%SPLEBASE%\bin\splenviron.cmd -e %SPLENVIRON%
Upgrading the Adapter for Networked Energy Services
To install the Oracle Utilities Smart Grid Gateway Adapter for Networked Energy Services:
1. Run the following install script.
UNIX
ksh ./configureEnv.sh
Windows
configureEnv.cmd
Note: On UNIX, ensure that you have the proper execute permission on install.sh.
The configuration menu for Oracle Utilities Smart Grid Gateway appears.
2. Select menu item 8 to configure OSB.
3. Select menu item 9 to configure SOA.
4. Select menu item 10 to configure the SOA Configuration Plan.
5. Select menu item 17 to configure the URI for the NES head-end system web services.
6. When you are done setting up the parameters, choose option P to proceed with the installation.
7. Run initialSetup.sh.
UNIX
$SPLEBASE/bin/initialSetup.sh
Windows
%SPLEBASE%\bin\ initialSetup.cmd
Once the install has finished successfully, execute postinstallation steps described in
Configuration Tasks for the Adapter for Networked Energy Services.
Upgrading the Adapter for Itron OpenWay
This section describes the installation of the Adapter for Itron OpenWay, including:
Pre-installation Tasks for the Adapter for Itron OpenWay
This section describes the steps that should be taken before installing Oracle Utilities Smart Grid Gateway, including:
Copying and Decompressing the Installation Media
The installation file is delivered in jar format for both UNIX and Windows platforms.
Oracle Utilities Smart Grid Gateway is delivered as part of the Oracle Utilities Meter Data Management installation package. Please refer to the
Supported Platforms and Hardware Requirements for versions and installation details regarding the database and operating system. Also see
Installing Prerequisite Software for prerequisite third-party software installation instructions.
Download the installation package and proceed as follows:
• Login to the host server as the Oracle Utilities Application Framework administrator user ID (default cissys). This is the same user ID that was used to install the Oracle Utilities Application Framework.
Installation Tasks for the Adapter for Itron OpenWay
This section describes the installation of the Adapter for Itron OpenWay, including:
Initializing the Oracle Utiliies Application Framework Environment
1. Login as Oracle Utilities Application Framework Administrator (default cissys).
2. Initialize the Oracle Utilities Application Framework environment that you want to install the product into.
UNIX
$SPLEBASE/bin/splenviron.sh -e $SPLENVIRON
Windows
%SPLEBASE%\bin\splenviron.cmd -e %SPLENVIRON%
Upgrading the Adapter for Itron OpenWay
To install the Oracle Utilities Smart Grid Gateway Adapter for Itron OpenWay:
1. Run the install script.
UNIX
ksh ./configureEnv.sh
Windows
configureEnv.cmd
Note: On UNIX, ensure that you have the proper execute permission on install.sh.
The configuration menu for Oracle Utilities Smart Grid Gateway appears.
2. Select menu item 8 to configure OSB.
3. Select menu item 9 to configure SOA.
4. Select menu item 10 to configure the SOA Configuration Plan.
5. Select menu item 22 to configure the URI of the head-end system.
6. When you are done setting up the parameters, choose option P to proceed with the installation.
7. Run initialSetup.sh.
UNIX
$SPLEBASE/bin/initialSetup.sh
Windows
%SPLEBASE%\bin\ initialSetup.cmd
Once the install has finished successfully, execute post-installation steps described in
Configuration Tasks for the Adapter for Itron OpenWay.
Upgrading the Adapter for Landis+Gyr
This section describes the installation of the Adapter for Landis+Gyr, including:
Pre-installation Tasks for the Adapter for Landis+Gyr
This section describes the steps that should be taken before installing Oracle Utilities Smart Grid Gateway, including:
Copying and Decompressing the Installation Media
The installation file is delivered in jar format for both UNIX and Windows platforms.
Oracle Utilities Smart Grid Gateway is delivered as part of the Oracle Utilities Meter Data Management installation package. Please refer to the
Operating Systems and Application Servers for versions and installation details regarding the database and operating system. Also see
Installing Prerequisite Software for prerequisite third-party software installation instructions.
Download the installation package and proceed as follows:
• Login to the host server as the Oracle Utilities Application Framework administrator user ID (default cissys). This is the same user ID that was used to install the Oracle Utilities Application Framework.
Initializing the Oracle Utilities Application Framework Environment
1. Login as Oracle Utilities Application Framework Administrator (default cissys).
2. Initialize the Oracle Utilities Application Framework environment that you want to install the product into.
UNIX
$SPLEBASE/bin/splenviron.sh -e $SPLENVIRON
Windows
%SPLEBASE%\bin\splenviron.cmd -e %SPLENVIRON%
Upgrading the Adapter for Landis+Gyr
To install the Oracle Utilities Smart Grid Gateway Adapter for Landis+Gyr:
1. Run the install script.
UNIX
ksh ./configureEnv.sh
Windows
configureEnv.cmd
Note: On UNIX, ensure that you have the proper execute permission on install.sh. The configuration menu for Oracle Utilities Smart Grid Gateway appears.
2. Select menu item 8 to configure OSB.
3. Select menu item 9 to configure SOA.
4. Select menu item 10 to configure the SOA Configuration Plan.
5. Select menu item 16 to configure the URI of the head-end system.
6. When you are done setting up the parameters, choose option P to proceed with the installation.
7. Run initialSetup.sh.
UNIX
$SPLEBASE/bin/initialSetup.sh
Windows
%SPLEBASE%\bin\ initialSetup.cmd
Once the install has finished successfully, execute post-installation steps described in
Configuration Tasks for the Adapter for Landis+Gyr.
Upgrading the Adapter for Sensus RNI
This section describes the installation of the Adapter for Sensus RNI, including:
Pre-installation Tasks for the Adapter for Sensus RNI
This section describes the steps that should be taken before installing Oracle Utilities Smart Grid Gateway, including:
Copying and Decompressing the Installation Media
The installation file is delivered in jar format for both UNIX and Windows platforms.
Oracle Utilities Smart Grid Gateway is delivered as part of the Oracle Utilities Meter Data Management installation package. Please refer to the
Operating Systems and Application Servers for versions and installation details regarding the database and operating system. Also see
Installing Prerequisite Software for prerequisite third-party software installation instructions.
Download the installation package and proceed as follows:
• Login to the host server as the Oracle Utilities Application Framework administrator user ID (default cissys). This is the same user ID that was used to install the Oracle Utilities Application Framework.
Initializing the Oracle Utilities Application Framework
1. Login as Oracle Utilities Application Framework Administrator (default cissys).
2. Initialize the Oracle Utilities Application Framework environment that you want to install the product into.
UNIX
$SPLEBASE/bin/splenviron.sh -e $SPLENVIRON
Windows
%SPLEBASE%\bin\splenviron.cmd -e %SPLENVIRON%
Upgrading the Adapter for Sensus RNI
To install the Oracle Utilities Smart Grid Gateway Adapter for Sensus RNI:
1. Run the install script.
UNIX
ksh ./configureEnv.sh
Windows
configureEnv.cmd
Note: On UNIX, ensure that you have the proper execute permission on install.sh.
The configuration menu for Oracle Utilities Smart Grid Gateway appears.
2. Select menu item 8 to configure OSB.
3. Select menu item 9 to configure SOA.
4. Select menu item 10 to configure the SOA Configuration Plan.
5. Select menu item 18 to configure the URI of the head-end system.
6. When you are done setting up the parameters, choose option P to proceed with the installation.
7. Run initialSetup.sh.
UNIX
$SPLEBASE/bin/initialSetup.sh
Windows
%SPLEBASE%\bin\ initialSetup.cmd
Once the install has finished successfully, execute post-installation steps described in
Configuration Tasks for the Adapter for Sensus RNI.
Upgrading the Adapter Silver Spring Networks
This section describes the installation of the Adapter for Silver Spring Networks, including:
Pre-installation Tasks for the Adapter for Silver Spring Networks
This section describes the steps that should be taken before installing Oracle Utilities Smart Grid Gateway, including:
Copying and Decompressing the Installation Media
The installation file is delivered in jar format for both UNIX and Windows platforms.
Oracle Utilities Smart Grid Gateway is delivered as part of the Oracle Utilities Meter Data Management installation package. Refer to the
Supported Platforms and Hardware Requirements for versions and installation details regarding the database and operating system. See
Installing Prerequisite Software for prerequisite third-party software installation instructions.
Download the installation package and proceed as follows:
• Login to the host server as the Oracle Utilities Application Framework administrator user ID (default cissys). This is the same user ID that was used to install the Oracle Utilities Application Framework.
Initializing the Oracle Utilities Application Framework
1. Login as Oracle Utilities Application Framework Administrator (default cissys).
2. Initialize the Oracle Utilities Application Framework environment that you want to install the product into.
UNIX
$SPLEBASE/bin/splenviron.sh -e $SPLENVIRON
Windows
%SPLEBASE%\bin\splenviron.cmd -e %SPLENVIRON%
Upgrading the Adapter for Silver Spring Networks
To install the Oracle Utilities Smart Grid Gateway Adapter for Silver Spring Networks:
1. Run the install script.
UNIX
ksh ./configureEnv.sh
Windows
configureEnv.cmd
Note: On UNIX, ensure that you have the proper execute permission on install.sh.
The configuration menu for Oracle Utilities Smart Grid Gateway appears.
2. Select menu item 8 to configure OSB.
3. Select menu item 9 to configure SOA.
4. Select menu item 10 to configure the SOA Configuration Plan.
5. Select menu item 19 to configure the URI of the head-end system.
6. Select menu item 20 to configure the JMS source destination bridge.
7. Select menu item 70 to configure the test harness.
8. When you are done setting up the parameters, choose option P to proceed with the installation.
9. Run initialSetup.sh.
UNIX
$SPLEBASE/bin/initialSetup.sh
Windows
%SPLEBASE%\bin\ initialSetup.cmd
Once the install has finished successfully, execute post-installation steps described i
n Configuration Tasks for the Adapter for Silver Spring Networks.