Oracle Utilities Work and Asset Management

Quick Install Guide

Release 2.2.0

E81397-01

April 2017

Oracle Utilities Work and Asset Management Quick Install Guide for Release 2.2.0

Copyright © 2000, 2017 Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Preface

This guide provides an overview of installing Oracle Utilities Work and Asset Management Release 2.2.0 and is intended for anyone interested in the process of installing Oracle Utilities Work and Asset Management.

To complete installation you should have:

•

Administrative privileges on the host where you are installing the software.

•

Experience installing and configuring application servers and other software (preferable).

Related Documents

For more information on this release, refer to the following documents:

Installation Guides

•

Oracle Utilities Work and Asset Management Release Notes

•

Oracle Utilities Work and Asset Management Quick Install Guide

•

Oracle Utilities Work and Asset Management Installation Guide

•

Oracle Utilities Work and Asset Management Database Administrator (DBA) Guide

•

Oracle Utilities Work and Asset Management Licensing Information User Manual

User Guides

•

Oracle Utilities Work and Asset Management and Oracle Utilities Operational Device Management Business User’s Guide

•

Oracle Utilities Work and Asset Management and Oracle Utilities Operational Device Management Administrative User Guide

Supplemental Documents

•

Oracle Utilities Work and Asset Management Server Administration Guide

•

Oracle Utilities Work and Asset Management Security Guide

Updates to Documentation

Additional and updated information about the product is available from the Knowledge Base section of My Oracle Support (http://support.oracle.com). Please refer to My Oracle Support for more information. Documentation updates are also posted on the Oracle Technology Network documentation page as they become available (http://docs.oracle.com/cd/E72219_01/documentation.html).

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text on the screen, or text that you enter.

Acronyms

The following acronyms are used in this document:

•

ODM - Oracle Utilities Operational Device Management

•

WAM - Oracle Utilities Work and Asset Management

•

OUAF - Oracle Utilities Application Framework

Additional Resources

For more information and support, visit the Oracle Support Web site at: http://www.oracle.com/support/index.html

Overview

This section provides an overview of the Oracle Utilities Work and Asset Management (WAM) product and installation process, including:

This section includes the following:

•

Product Overview

•

Installation Overview

•

Installation Types

•

Package Contents

•

Readiness Checklist

Refer to the Oracle Utilities Work and Asset Management Business User Guide and Release Notes for a detailed overview of the business processes and new functionality in this release.

Product Overview

Oracle Utilities Work and Asset Management is housed in the Oracle WebLogic J2EE Web Application Server. The system is comprised of two layers: web and service. The application is accessed by using a browser to connect to the web layer.

Oracle Utilities Work and Asset Management data is stored in the Oracle Database. For processing large amounts of data, the system provides a thread pool worker (batch server) which interacts with the same database.

The following figure provides an overview of the Oracle Utilities Work and Asset Management product:

Refer to the Business User’s Guide for information about the features and functionality in this release.

Installation Overview

Oracle Utilities Work and Asset Management consists of several components, all of which need to be installed for a successful installation. Certain prerequisite software may need to be installed before installing each of these components.

The following figure details the workflow for the initial and demo installation process.

The following figure details the workflow for the upgrade installation process.

Refer to the Prerequisite Software List for the list of prerequisite software.

Installation Types

The first step in the installation procedure is to determine the installation type that meets your business requirements. The following are the possible installation types:

•

Initial Installation - Installing Oracle Utilities Work and Asset Management as a clean/new install - a base installation, typically used for a production environment

•

Upgrade Installation - an upgrade installation from v2.1.1 to v2.2.0 or from v2.1.1.1 to v2.2.0.

•

Demo Installation - a base installation with pre-populated demo data, typically used for demonstration or training purposes

The following sections describe these installation types in detail.

Package Contents

The following documentation and installation packages are part of the product package.

This section includes information about:

•

Documentation

•

Installation Packages

Documentation

Installation Guides

•

Oracle Utilities Work and Asset Management Release Notes

•

Oracle Utilities Work and Asset Management Quick Install Guide

•

Oracle Utilities Work and Asset Management Installation Guide

•

Oracle Utilities Work and Asset Management Database Administrator (DBA) Guide

•

Oracle Utilities Work and Asset Management Licensing Information User Manual

User Guides

•

Oracle Utilities Work and Asset Management and Oracle Utilities Operational Device Management Business User’s Guide

•

Oracle Utilities Work and Asset Management and Oracle Utilities Operational Device Management Administrative User Guide

Supplemental Documents

•

Oracle Utilities Work and Asset Management Server Administration Guide

•

Oracle Utilities Work and Asset Management Security Guide

Installation Packages

•

Oracle Utilities Work and Asset Management v2.2.0.0.0 Release Notes.zip

•

Oracle Utilities Work and Asset Management v2.2.0.0.0 Install Documentation.zip

•

Oracle Utilities Work and Asset Management v2.2.0.0.0 Quick Install Guide.zip

•

Oracle Utilities Work and Asset Management v2.2.0.0.0 Multiplatform.zip

•

Oracle Utilities Work and Asset Management v2.2.0.0.0 Oracle Database Multiplatform.zip

•

Oracle Utilities Application Framework v4.3.0.3.0 Multiplatform.zip

•

Oracle Utilities Application Framework v4.3.0.3.0 Single Fix Prerequisite Rollup for Oracle Utilities Work and Asset Management v2.2.0.0.0.zip

•

Oracle Utilities Work and Asset Management v2.2.0.0.0 Reports.zip

•

Oracle Utilities Work and Asset Management v2.2.0.0.0 ESRI Integration.zip

Readiness Checklist

The following checklist provides steps to complete to install Oracle Utilities Work and Asset Management.

For more information, refer to the instructions in the Oracle Utilities Work and Asset Management Installation Guide.

1.

Confirm that the recommended hardware is ready. Refer to Supported Platforms and Hardware Requirements for more details.

2.

Install prerequisite software. Refer to the Planning the Installation section for more details.

3.

Download the Oracle Utilities Work and Asset Management v2.2.0 components from Oracle Software Delivery Cloud.

4.

Go through the Installation and Configuration Worksheets to understand the configuration menu.

5.

Determine the type of installation then follow the guidelines provided for that type:

•

Initial Installation

•

Upgrade Installation

•

Demo Installation

6.

Perform post-installation tasks, as applicable.

7.

Install optional products, as applicable.

Note : For Esri integration functionality, you must purchase Esri ArcGIS Server 10.2 software or online cloud subscription from Esri.

Supported Platforms and Hardware Requirements

This installation is certified to operate on many operating system, application server and database server combinations. The following sections provide information on the supported platforms and requirements, including:

•

Operating Systems and Application Servers

•

Hardware Requirements

•

Application Server Memory Requirements

•

ESRI Integration Supported Versions

•

Support for Software Patches and Upgrades

Operating Systems and Application Servers

The table below details the MINIMUM operating system and application server combinations on which this version of Oracle Utilities Work and Asset Management is supported.

Operating System and Web Browser

(Client)

Operating System

(Server)

Chipset

Application Server

Database

Windows 7, 8.1, 10

(Internet Explorer 11,

Firefox ESR 45)

AIX 7.1 TL01+

AIX 7.2 TL00+

POWER

WebLogic 12.1.3.0+

WebLogic 12.2.1.1+

Oracle 12.1.0.1+

Oracle Linux 6.5+, 7.x

(based on Red Hat Enterprise Linux )*

x86_64

WebLogic 12.1.3.0+

WebLogic 12.2.1.1+

Oracle 12.1.0.1+

Oracle Solaris 11

SPARC

WebLogic 12.2.1.1+

WebLogic 12.1.3.0+

Oracle 12.1.0.1+

Windows Server 2012 R2

(Not supported in production)

x86_64

WebLogic 12.1.3.0+

WebLogic 12.2.1.1+

Oracle 12.1.0.1+

Refer to the Product Support Matrix (Doc ID 1454143.1) 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 12.1.0.1+ means that 12.1.0.1 and any higher 12.1.0.x versions of Oracle are supported.The "x" indicates that any version of the digit designed by the "x" is supported.

Example : Linux 7.x indicates that any version of Linux 7 (7.0, 7.1, 7.2 etc) will be supported.

•

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 12.1.3.0+ is currently supported for both embedded and native installations. Starting at Weblogic 12.2.*, embedded installations will be not be supported. Only the native installation will be supported.

Hardware Requirements

The following section outlines client side hardware requirements for Oracle Utilities Work and Asset Management.

Client Side Hardware Requirements

Configuration

Processor

Memory (RAM)

Monitor (Display)

Minimum

1 GHz or faster 64-bit (x64) processor

2 GB

1280x1024

Recommended*

3 GHz or faster 64-bit (x64) processor

4 GB

1280X1024

* The Recommended configuration supports better performance of the client.

Application Server Memory Requirements

For each application server environment a minimum of 4 GB of real memory is required, plus 6 GB of swap space. The approximate disk space requirements in a standard installation are as follows:

Location

Size

Usage

Install Dir Location

10 GB minimum

This location is 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.

Log Location

5 GB minimum

This location is 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 minimum

This location is 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

4 GB

The application gets installed from this location. You need enough space to un-compress the files and install the application.

Oracle Data Area

4 GB minimum

This 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.

ESRI Integration Supported Versions

This section provides information on ArcGIS Server and ArcGIS Desktop compatibility with Oracle Utilities Work and Asset Management.

ArcGIS Server Version Compatibility

Oracle Utilities Work and Asset Management can potentially send outbound messages to the ArcGIS Server in either SOAP or REST formats. Please refer to the table below for certified message formats at each supported ArcGIS Server version.

ArcGIS Server Version

REST (Work Location and Asset)

SOAP (Work Location)

SOAP (Asset)

10.2.1

Yes

Yes

Yes

10.4.1

Yes

Yes/No (if specific .NET framework patches are available in OS)

Yes

10.5

Yes

Yes (With TimeReference tag)

Yes

ArcGIS Desktop Version Compatibility

The following versions of ArcGIS Desktop are supported with Oracle Utilities Work and Asset Management.

•

10.2.1

•

10.4.1

Support for Software Patches and Upgrades

Due to the ongoing nature of software improvement, vendors will periodically issue patches and service packs for the operating systems, application servers and database servers on top of specific versions that Oracle products have already been tested against.

If it is necessary to apply an upgrade, please do so in a test environment that is running on the same platform as your production environment prior to updating the production environment itself. The exception to this is Hibernate software version 4.1.0. This version should not be upgraded.

Always contact Oracle Support prior to applying vendor updates that do not guarantee backward compatibility.

Planning the Installation

This section provides information for planning an Oracle Utilities Work and Asset Management installation, including:

•

Installation Considerations

•

Prerequisite Software List

•

Installing Prerequisite Software

•

Readiness Checklist

Before Installation

Refer to My Oracle Support for up-to-date additional information about installing Oracle Utilities Work and Asset Management.

Prerequisite Oracle Utilities Application Framework Patches

Oracle Utilities Application Framework patches must be installed prior to installing Oracle Utilities Work and Asset Management. This step is included as part of the installation instructions.

Installation Considerations

Refer to the Installation Considerations section in the Oracle Utilities Work and Asset Management Installation Guide for detailed instructions on installing the prerequisite software.

Prerequisite Software List

Refer to the Prerequisite Software List section in the Oracle Utilities Work and Asset Management Installation Guide for detailed instructions on installing the prerequisite software.

Before you install Oracle Utilities Work and Asset Management, you must install prerequisite software. Refer to the respective installation documentation of the software for instructions on downloading and installing.

This section includes information on the following:

•

Prerequisite Software for Database Server

•

Prerequisite Software for Application Server

•

Web Browser Requirements

Prerequisite Software for Database Server

The prerequisite software for the database component of Oracle Utilities Work and Asset Management includes:

•

Oracle Database Server 12.1.0.1+ Standard or Enterprise EditionThis is required for installing the database component of the Oracle Utilities Work and Asset Management product.

Prerequisite Software for Application Server

The prerequisite software for the application component of Oracle Utilities Work and Asset Management is as follows:

•

Oracle 12.1.0.1 Client

•

Oracle Client 12c — Runtime Option

•

IBM Java Software Development Kit

•

Hibernate 4.1.0 FINAL and hibernate-search-5.5.4.Final-dist

•

Oracle WebLogic Server 12.1.3.0+ (64-bit) or Oracle WebLogic 12c (12.2.1.1+) 64-bit, as required.

Web Browser Requirements

The web browsers listed here are supported when used on each of the operating systems indicated:

Browsers

Windows OS

Internet Explorer 11

Firefox ESR 45

Windows OS 7, 8.1, 10 (64-bit)

Installing Prerequisite Software

Refer to the Installing Prerequisite Software section in the Oracle Utilities Work and Asset Management Installation Guide for detailed instructions on installing the prerequisite software.

Readiness Checklist

The following checklist provides steps to complete to install Oracle Utilities Work and Asset Management.

For more information, refer to the instructions in the Oracle Utilities Work and Asset Management Installation Guide.

1.

Confirm that the recommended hardware is ready. Refer to Supported Platforms and Hardware Requirements for more details.

2.

Install prerequisite software. Refer to the Planning the Installation section for more details.

3.

Download the Oracle Utilities Work and Asset Management v2.2.0 components from Oracle Software Delivery Cloud.

4.

Go through the Installation and Configuration Worksheets to understand the configuration menu.

5.

Determine the type of installation then follow the guidelines provided for that type:

•

Initial Installation

•

Upgrade Installation

•

Demo Installation

6.

Perform post-installation tasks, as applicable.

7.

Install optional products, as applicable.

Note : For Esri integration functionality, you must purchase Esri ArcGIS Server 10.2 software or online cloud subscription from Esri.

Installing Oracle Utilities Work and Asset Management- Initial Installation

This section provides an overview of installing Oracle Utilities Work and Asset Management v2.2.0 as a new installation.

Before You Install

Refer to My Oracle Support for up-to-date additional information on Oracle Utilities Work and Asset Management.

Initial Installation Procedure

The initial installation procedure consists of:

•

Database Component Installation Installation of the database component of Oracle Utilities Work and Asset Management must be complete before you can proceed with the following sections. Refer to the chapter "Installing the Oracle Utilities Work and Asset Management Database- Initial Installation" of the Oracle Utilities Work and Asset Management Database Administrator Guide, which provides instructions on installing the database component.

•

Application Components Installation Refer to the chapter "Oracle Utilities Work and Asset Management Database - Initial Installation" of the Oracle Utilities Work and Asset Management Installation Guide, which provides instructions on installing the application components.

Upgrading Oracle Utilities Work and Asset Management

This section provides an overview of what is needed to upgrade Oracle Utilities Work and Asset Management, including:

•

Upgrade Paths

•

Before You Upgrade

•

Upgrade Procedure

Upgrade Paths

•

from v2.1.1.1 to v2.2.0

•

from v2.1.1 to v2.2.0

Note : Before you can upgrade you must have a prior version installed. Otherwise, you should follow the procedures described in the Initial Installation Procedure section of the Oracle Utilities Work and Asset Management Installation Guide.

Before You Upgrade

Review the list of operating system, application server and database server combinations that this version of Oracle Utilities Work and Asset Management is certified to operate on, in the Supported Platforms and Hardware Requirements section.

For further assistance, contact My Oracle Support before you upgrade.

Note: If you are upgrading a previously installed application server, it is recommended that you make a backup before you start the upgrade procedure. The upgrade installation will remove your existing environment including your configurations.

Upgrade Procedure

The upgrade installation procedure consists of::

•

Database Component Upgrade Upgrade of the database component of Oracle Utilities Work and Asset Management must be complete before you can proceed with the following sections. Refer to the chapter "Upgrading the Oracle Utilities Work and Asset Management Database" of the Oracle Utilities Work and Asset Management Database Administrator Guide, which provides instructions on upgrading the database component.

•

Application Components Upgrade To proceed with upgrading to Oracle Utilities Work and Asset Management v2.2.0 follow instructions as detailed in the chapter "Upgrading Oracle Utilities Work and Asset Management" of the Oracle Utilities Work and Asset Management Installation Guide.

Installing Oracle Utilities Work and Asset Management -Demo Installation

This section provides an overview of the procedure for setting up an application instance of Oracle Utilities Work and Asset Management which can be used for demonstration or training purposes.

Before You Install

Refer to My Oracle Support for up-to-date additional information on Oracle Utilities Work and Asset Management.

Demo Installation Procedure

The demo installation procedure consists of:

•

Database Component Installation Installation of the database component of Oracle Utilities Work and Asset Management must be complete before you can proceed with the following sections. Refer to the chapter "Installing the Oracle Utilities Work and Asset Management Database - Demo Installation" of the Oracle Utilities Work and Asset Management Database Administrator Guide, which provides instructions on installing the database component with pre-populated demo data.

•

Application Components Installation Refer to the chapter "Installing Oracle Utilities Work and Asset Management- Demo Installation" of the Oracle Utilities Work and Asset Management Installation Guide, which provides instructions on installing the application components.