Supported Platforms
The installation has been tested to operate on many operating system, application server, and database server combinations. For the software requirements for each of these combinations, refer to the Installing Application Server Prerequisite Software chapter in the Oracle Utilities Customer Program Management Installation Guide.
Operating Systems and Application Servers
This section describes the software that needs to be installed for each of the supported operating system and application server combinations, including:
Oracle Linux 8.x/9.x or Red Hat Linux 8.x/9.x Operating System
This section describes the software requirements for operating the application using the Oracle Linux or Red Hat Linux application server.
Supported Application Servers
Operating System
Chipset
Application Server
Oracle Enterprise Linux 8.x/9.x (64-bit; based on Red Hat Enterprise Linux (64-bit))
x86_64
Oracle WebLogic 14.1.2.x 64-bit version
Oracle Linux or Red Hat Enterprise Linux Operating System Running on x86_64 64-bit Architecture
UNIX Administrator User ID
The following user groups and accounts have to be created to install and administer the application:
Description
Default Value
Customer Defined Value
Oracle Utilities Customer Program Management Administrator User ID
cissys
 
Oracle Utilities Customer Program Management User Group
cisusr
 
Note: It is recommended that you change the default values for security reasons.
Throughout this document the administrator user id is often referred to as the “cissys” user ID. You should substitute that with the customer defined user ID when not using the default value. After the initial install, the software should always be managed using that user ID.
By default, the cissys userid is the only one given access to the files installed.
1. Create a group “cisusr” (user group).
2. Create a user “cissys” and a primary group “cisusr”. Set the primary shell for the cissys user to Korn Shell.
The shell scripts use the “>” to overwrite shell functionality. Your operating system may be configured to not allow this functionality by default in the users shell.
To avoid file access permission problems when executing scripts, consider placing the following command into cissys profile script:
set +o noclobber
Security Configuration
Various options exists to secure a system. In this application all files will be created with the minimum permissions required to ensure that group-readable, group-writable and group-executable files will have the correct user groups and to restrict the permissions available to legitimate users. In this way, a low privileged end user cannot directly edit configuration files and thereby bypass application security controls.
The following users and group categories must be defined to implement this security. For demonstration purposes the following users and groups will be used. These users must be created according to industry standards (including password policies). All users should be created with a default umask of 022 to ensure files created during normal operation have the correct permissions.
Replace these users and groups for your installation defaults:
User
Group
Description
cissys
cisusr
This user will be used to install the application and to apply patches. This user will own all the application files. The same care should be taken with this user ID as if it is 'root'. This user will be able to add, delete and modify and files within the application.
cisadm
cisusr
Administrative and Operation functions will be available to this user. This user will be able to stop and start the application and batch processes, but will not have access to modify any file other than generated log files
cisoper
-------
Low level operator. This user will only be able to read logs files and collect information for debugging and investigative purposes. Care should be taken in production to disable debugging as debugging information could contain potential sensitive data which this user should not have privy to.
Note: The Oracle Client and WebLogic should be installed as the user who will stop and start the application. For example, if you plan to run the application as the install user these components must belong to cissys.
Oracle Database Client 19c - Runtime Option
Install the Oracle Client as described in the Oracle Client installation documentation. Use the cissys account to install the Oracle Client. If another user installs the Oracle Client, make sure the cissys user ID has the proper execute permissions.
For the cissys user ID, ensure that the environment variable ORACLE_CLIENT_HOME is set up, and that ORACLE_CLIENT_HOME/perl/bin is the first Perl listed in the cissys account's PATH variable.
Oracle Java Development Kit V17 or Later (64-Bit)
At the time of release, obtain the Oracle Java packages from:
https://www.oracle.com/java/technologies/downloads/#java17
The Oracle WebLogic Server requires the 64-bit version. The main prerequisite for the web server is the version of Java mentioned above.
For the userid cissys, ensure that the environment variable JAVA_HOME is setup, and that java_home/bin and java_home/lib can be found in cissys’ PATH variable.
Oracle WebLogic Server 14.1.2.x (64-bit)
Oracle WebLogic software can be downloaded from the Oracle website. This application server will run as a 64-bit application.
• Download and install 64-bit Java (as documented above) before installing WebLogic.
• Download and install WebLogic Server 14.1.2.x.
Note: Starting Oracle Utilities Application Framework V4.5.0.0.0, WebLogic native installation is required. Refer to the Oracle WebLogic Configuration Guide for Oracle Utilities Application Framework (Doc ID 2413918.1) document on My Oracle Support.
Oracle Service Bus 14.1.2.x
Oracle Service Bus is required for implementations that plan to use middleware implementations of adapters or the generic adapter to process meter reading or device event data.
Oracle Service Bus 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.
Note: Oracle Service Bus 14.1.2.x requires Oracle WebLogic Server 14.1.2.x.
Note that Oracle Service Bus must be installed before installing the Oracle Utilities Customer Program Management. You can download Oracle Service Bus from the Oracle Fusion Middleware Software Downloads portal.
Oracle SOA Suite 14.1.2.x
Oracle SOA Suite, specifically BPEL Process Manager, is required for implementations that plan to use middleware implementations of adapters or the generic adapter to implement two-way communications for processing meter commands.
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.
Note: Oracle SOA Suite 14.1.2.x requires Oracle WebLogic Server 14.1.2.x.
Note that Oracle SOA Suite must be installed before installing the Oracle Utilities Customer Program Management. You can download Oracle SOA Suite from the Oracle Fusion Middleware Software Downloads portal.
Windows Server 2012 R2 Application Server
This section describes the software requirements for operating the application using the Windows application server.
Supported Application Servers
Operating System
Chipset
Application Server
Windows Server 2012 R2 (64-bit)
x86_64
Oracle WebLogic 14.1.2.x 64-bit version
Oracle Database Client 19c - Runtime Option
Install the Oracle Client as described in the Oracle Client installation documentation. Use the cissys account to install the Oracle Client. If another user installs the Oracle Client, make sure the cissys user ID has the proper execute permissions.
For the cissys user ID, ensure that the environment variable ORACLE_CLIENT_HOME is set up, and that ORACLE_CLIENT_HOME/perl/bin is the first Perl listed in the cissys account's PATH variable.
Oracle Java Development Kit V17 or Later (64-Bit)
At the time of release, obtain the Oracle Java packages from:
https://www.oracle.com/java/technologies/downloads/#java17
The Oracle WebLogic Server requires the 64-bit version. The main prerequisite for the web server is the version of Java mentioned above.
For the userid cissys, ensure that the environment variable JAVA_HOME is setup, and that java_home/bin and java_home/lib can be found in cissys’ PATH variable.
Oracle WebLogic Server 14.1.2.x (64-bit)
Oracle WebLogic software can be downloaded from the Oracle website. This application server will run as a 64-bit application.
• Download and install 64-bit Java (as documented above) before installing WebLogic.
• Download and install WebLogic Server 14.1.2.x.
Note: Starting Oracle Utilities Application Framework V4.5.0.0.0, WebLogic native installation is required. Refer to the Oracle WebLogic Configuration Guide for Oracle Utilities Application Framework (Doc ID 2413918.1) document on My Oracle Support.
Oracle Service Bus 14.1.2.x
Oracle Service Bus is required for implementations that plan to use middleware implementations of adapters or the generic adapter to process meter reading or device event data.
Oracle Service Bus 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.
Note: Oracle Service Bus 14.1.2.x requires Oracle WebLogic Server 14.1.2.x.
Note that Oracle Service Bus must be installed before installing the Oracle Utilities Customer Program Management. You can download Oracle Service Bus from the Oracle Fusion Middleware Software Downloads portal.
Oracle SOA Suite 14.1.2.x
Oracle SOA Suite, specifically BPEL Process Manager, is required for implementations that plan to use middleware implementations of adapters or the generic adapter to implement two-way communications for processing meter commands.
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.
Note: Oracle SOA Suite 14.1.2.x requires Oracle WebLogic Server 14.1.2.x.
Note that Oracle SOA Suite must be installed before installing the Oracle Utilities Customer Program Management. You can download Oracle SOA Suite from the Oracle Fusion Middleware Software Downloads portal.
 
Refer to the Certification Matrix for Oracle Utilities Products (Document ID 1454143.1) on My Oracle Support to determine if support for newer versions of the listed products have been added.
Please note the following:
• Version numbers marked with a “+” are the MINIMUM version supported. That version and all future 4th digit updates will be supported.
Example: Oracle 19c means that 19 and any higher versions of Oracle 19 are supported.
• An “x” indicates that any version of the digit designed by the “x” is supported.
Example: Linux 8.x indicates that any version of Linux 8 (8.0, 8.1, 8.2 etc) will be supported.
Windows Server
• Windows Server is not supported for Production environments. Wherever Windows Server is referenced within this guide, it is supported for Test or Development environments only.
WebLogic Server
• Oracle WebLogic Server (Fusion Middleware Infrastructure) 14.1.2
• Customers must download Oracle WebLogic Server from the Oracle Software Delivery Cloud.
Oracle Database Server
Prerequisite database server software (on any vendor supported platform where x is vendor supported version):
• Oracle Database 19c Enterprise Edition 19.x
• Oracle Database 23ai Enterprise Edition 23.x
• Oracle Database 26ai Enterprise Edition 26.x
Oracle VM Support
This version of the application is supported on Oracle VM Server for x86 for supported releases of Oracle Linux and Microsoft Windows operating systems.
Refer to My Oracle Support knowledge base article KB183395 for Oracle’s support policy on VMWare.
SDK - Supported Combinations
Refer to the SDK documentation for supported platforms and installation instructions.
Application Server Memory Requirements
For each application server environment a minimum of 6 GB of real memory is required, plus 6 GB of swap space. The approximate disk space requirements in a standard installation are as follows (the size represents the MINIMUM required):
Location
Size
Usage
Install Dir ("$SPLEBASE") Location
10 GB recommended
5 GB minimum
Location where the application and Framework get installed. Startup, shutdown and other online log files are stored here. The size and space that is used should be monitored because various debugging options can significantly affect the size of log files.
Note: This does not include the size of the edge product.
Log Dir ("$SPLOUTPUT") Location
10 GB recommended
2 GB minimum
Used for storing batch log files and output from batch jobs. The size of this space should be influenced by which batches are run and how often, and the amount of debugging information that is collected.
Location of the application web work files on the web servers
5 GB recommended
2 GB minimum
Used by various web server vendors to expand the application. It should be considered when installing these products.
Refer to the individual web server documentation to determine the location of the temporary files.
Installation Temporary Area
10 GB minimum
The application gets installed from this location. You need enough space to un-compress the files and install the application.
Oracle Data Area
10 GB minimum
Location is where the Oracle database data files are stored. The size of this space should be based on the requirements of the production environment. For an initial or demo database install 4 GB should be sufficient.