Oracle Web Service Manager 12.1.2 Installation July 2013

Oracle Corporation | Prakash Yamuna 1

Installation Instructions for Oracle WebService Manager 12.1.2 2013

Oracle Web Service Manager 12.1.2

Installation

July 2013

Step-by-Step Instruction Guide

Author: Prakash Yamuna

Oracle Corporation



Table of Contents 1 Getting Started ...................................................................................................................................... 3

1.1 Pre-Requisites ............................................................................................................................... 3

1.2 Overview ....................................................................................................................................... 3

2 Oracle Database 11.2.0.3 Installation ................................................................................................... 4

2.1 Change Password for SYS & SYSTEM ............................................................................................ 7

2.2 Verify DB Installation .................................................................................................................... 9

3 Fusion Middleware 12.1.2 Installation ............................................................................................... 11

4 Create Database Schema using RCU ................................................................................................... 16

5 Create WLS domain using FMW Config Wizard .................................................................................. 23

5.1 Verify the installation and OWSM status .................................................................................... 33

5.1.1 Check WSM Status by going to http://<localhost>:<port>/wsm-pm/validator ................. 34

5.1.2 Check EM Status by logging into EM – http://<localhost>:<port>/em ............................... 35

5.1.3 Check WSM status via checkWSMStatus() WLST command .............................................. 37

6 JDeveloper 12.1.2 Installation............................................................................................................. 39



1 Getting Started

1.1 Pre-Requisites

This How-To guide assumes that you have already downloaded the following products/components.

Download FMW 12.1.2 – this includes Oracle WebService Manager 12.1.2.

Download Database 11.2.0.3

Download JDeveloper 12.1.2

JDK7 is preinstalled

1.2 Overview

FMW 12.1.2 Installation can be broken down into following four phases:

Database Installation – see section 2

Fusion Middleware 12.1.2 Installation – see section 3

Create DB schemas using RCU – see section 4

Create WLS Domain – see section 5

JDeveloper 12.1.2 Installation – see section 6

This How-To describes installation procedures for Oracle Database 11.2.0.3. FMW 12.1.2 is certified with

Oracle DB 11gR1 and Oracle DB 12c. Please consult the relevant installation guides.

This How-To describes a typical developer installation it does not necessarily describe all installation

topologies.

Oracle WebServices Manager 12.1.2 requires a Database. Consult the FMW documentation for the

various databases that are supported with 12.1.2.

This install creates a WLS domain with a single WLS server – “Admin Server”.

Component Binaries

Oracle Fusion Middleware 12.1.2 D:\Downloads\wls_jrf_generic.jar

Oracle Database 11.2.0.3 D:\DB\database\setup.exe

JDeveloper D:\Oracle11gR1\Middleware\jdeveloper

Component Install Location

JDK D:\Java\jdk1.7.0_15

For the most part the Installation is self explanatory.

Note: The steps shown in this How-To are for Windows.



2 Oracle Database 11.2.0.3 Installation Click on setup.exe and follow the DB installation wizard.

Provide the information requested and click on “Next”

Note: In this How-To I have opted out from receiving security updates. This is not something Oracle

recommends. Please follow Oracle recommendations.



Click on “Next”

Click on “Next”



Click on “Next”

Make a note of the database name. Also I suggest changing the character set to Unicode and then click

“Next”.



I suggest saving the response file. In case you forget some of he parameters that were provided. They

will come in handy later. Click on “Install”.

2.1 Change Password for SYS & SYSTEM

Click on “Password Management” below to change the password for SYS and SYSTEM user.





2.2 Verify DB Installation

Verify the DB installation by logging into Enterprise Manager.





3 Fusion Middleware 12.1.2 Installation

In order to install Fusion Middleware 12.1.2 – you need to open the “cmd” prompt in Windows in

Administrator mode as show in the above screen shot.

In 12c the FMW distribution that contains OWSM is wls_jrf_generic.jar and the above screen shot

specifies how you can start the FMW 12.1.2 installation.



Click “Next”

Specify the Oracle Home location as shown in the screen shot below and click “Next”. Make a note of

the Oracle Home location as you will need this subsequently.



Click “Next”

Click “Next”



Click “Next”. I suggest saving the response file.

Click “Next”. I suggest saving the response file.



This completes the Installation. The next section covers running RCU to create the DB schemas

necessary for 12.1.2.



4 Create Database Schema using RCU To run RCU – you need to go into $ORACLE_HOME\oracle_common\bin as shown below.

Click “Next”



Click on “Next”

Click on “Next”; this will result in a dialog shown below.



Click on “OK”

Ensure you select the schemas show in the above screenshot. “Metadata Services” schema is required

by OWSM since it uses MDS for persistence. “Audit Services” and related schemas and “Oracle Platform

Security Services” are required by OPSS. OWSM depends on OPSS and hence are required. Click “Next”

to proceed.



Click “OK”.

Specify the schema password and Click “Next”.



Click “Next”

Click “OK”.



Click “OK”.

Click on “Create” to create the tables.



This completes the DB schema creation process. Click on “Close”



5 Create WLS domain using FMW Config Wizard

Select “create a new domain” and click on “Next”



IMPORTANT: Select the “Oracle WSM Policy Manager” template and “Oracle Enterprise Manager”

template. This will automatically select the “Oracle JRF” and “Weblogic Coherence Cluster Extension”

templates.

Click on “Next”



Specify where you want the Weblogic Domain to be created and Click on “Next”

Specify the password for the built-in “weblogic” account and click “Next”.



Select the appropriate “Domain Mode” and click “Next”. In this example – I have selected the mode as

“Development.

Specify the DB information so the appropriate Datasources can be created and click on “Get RCU

Configuration”.



Once the Config wizard validates the DB information, click on “Next”.



In 12.1.2 - the config wizard will auto-populate the schema information for creation of the JDBC

Datasources. Click “Next”.

This will result in the datasources being created. Click “Next” after the datasources are created

successfully.



IMPORTANT: In 12.1.2 OWSM leverages a feature called cross component wiring – this is the ability to

wire various fusion middleware components automatically. However for this feature to work you

need to enable “Server Groups” feature. In this example – I created a WLS domain with a single WLS

server (Admin Server). So select the “Administration Server” and click “Next”.

WARNING: If you have selected the Oracle WSM Policy Manager template and do not perform this

step then your domain creation will fail! The Config Wizard does not automatically prompt for you to

select the Server Groups based on the templates that were selected.



As mentioned previously, select the “Server Groups” appropriately. In this example I have selected all

the three Server Groups. Depending on features that you need – you can select the appropriate ones.

Click “Next”



Click on “Create” to the WLS domain.



After the domain is created – click “Next”.

Click “Finish” to complete the WLS domain creation process.



5.1 Verify the installation and OWSM status

The next step is to verify the installation and ensure OWSM is running correctly. There are multiple

aspects to validate to ensure OWSM is running correctly.

Ensure the WSM Policy Manager is running. This is covered in section 0

Ensure Enterprise Manager – Fusion Middleware Control is running and specifically the WSM

pages are working correctly. This is covered in section 0

Ensure the WSM Agent is able to connect to the WSM Policy Manager and enforce policies for

Web Services. This is covered in section 0



5.1.1 Check WSM Status by going to http://<localhost>:<port>/wsm-

pm/validator

You will be promoted for username/password. Enter the username/password for a valid user. This

should list screen shot below.



5.1.2 Check EM Status by logging into EM – http://<localhost>:<port>/em

Login into EM. Click on “domain name” on LHS browse tree. Then click on the “Weblogic Domain” menu

item and select “WSM Policies” menu item as shown in the screen shot below.





5.1.3 Check WSM status via checkWSMStatus() WLST command

One of the most frequent issues people run into with OWSM is either the WSM Agent is not able to

connect to the WSM Policy Manager or it is not able to enforce policies.

The checkWSMStatus() WLST command helps diagnose these issues. Specifically checkWSMStatus()

WLST command provides status on a number of things:

a) It checks if the WSM Policy Manager is reachable

b) It checks if the WSM Agent was able to connect to the WSM Policy Manager

c) It checks if the WSM Agent is able to enforce policies by invoking a diagnostic web service.

d) In addition it checks if the Keystore and credential store have been set up appropriately.



Note: Out of the box the Keystore and credential store are not setup by default and hence this check will

fail.

This is OK. However if the Keystore/Credential store are not setup the some of the out of the box OWSM

policies will not work. Ex: OWSM Message Protection policies will not work if the Keystore/Credential

store is not setup correctly.



6 JDeveloper 12.1.2 Installation Installing JDeveloper is very similar and the next few screenshots show how to Install JDeveloper 12.1.2







Documents

Oracle Web Service Manager 12.1.2 Installation July 2013