Oracle Enterprise Repository 11g Quick Start Guide

Sreeni Setty

http://www.linkedin.com/in/sreenisetty

INTRODUCTION 3

PREFACE 3

SCOPE 4

INSTALLING AND CONFIGURING OER 11G 5

PRE-REQUISITES 5

INSTALLATION PLANNING 5

PRE-INSTALLATION STEPS 5

INSTALLATION STEPS 7

POST-INSTALLATION STEPS 11

STARTING THE APPLICATION 17

START THE ADMIN AND MANAGED SERVER 17

LOGIN AND VERIFY THE OER INSTALLATION 18

ADMINISTERING USERS 21

CREATE A USER 21

CREATE A REGISTRAR 21

MANAGING ASSET LIFECYCLE 22

SUBMIT AN ASSET 22

ACCEPT THE ASSET 23

APPROVE AND REGISTER THE ASSET 25

FIND THE REGISTERED ASSET AND VIEW DETAILS 26

APPENDIX 27

REFERENCES 27

Introduction

Preface

The promise of SOA is to deliver business agility at a lower cost of ownership primarily driven with the ability to reuse services. Achieving the promise depends on the effective management of the SOA

environment across the enterprise.

Successful SOA adoption requires governance – governance in terms of visibility, control on SOA life

cycle management, and analytics on service reuse and ROI.

Oracle’s SOA Governance Suite provides the governance infrastructure with its products: Oracle

Enterprise Repository, Oracle Service Registry, Oracle Web Services Manager, and Enterprise

Manager Management Pack Plus for SOA.

The governance infrastructure interoperate among the products in the suite as well as design-time

tools such as version control, integrated development environment, file stores, etc; and run-time

tools such as testing, build tools, defect tracking etc.

Oracle Enterprise Repository provides:

Visibility to Assets That currently exists, that is under development or being planned - including SOA Composites,

OSB Pipelines, and AIA Artifacts, etc. Dependencies among assets

Categorization of assets Control on SOA life cycle management

Out of the box work flows - AIA Project Lifecycle Workbench Communicate architectural standards and track compliance

Analytics on service reuse and ROI

Through reports on reuse, service performance, quality and compliance

Integration with JDeveloper and source code management tools for developer adoption Integration with Enterprise Manager for run-time metrics into Repository

Scope

This Quick Start Guide to Oracle Enterprise Repository 11g covers installation planning, installation

and configuration, administering and managing users, and steps into the asset life cycle management.

The screen shots used in the guide are taken from a standalone demo installation of the repository. The steps in the asset life cycle management include the core tasks performed in a typical repository

usage environment.

Refer to the appendix section for additional resources and information on the OER.

Installing and Configuring OER 11g

Pre-requisites

WebLogic Application Server 11g (10.3.3) - installed and configured Database 11g (11.2.0.1.0) – installed and configured

Refer to OFM WebLogic and SOA Suite 11g Installation Demonstration Guide:

http://www.slideshare.net/sreenisetty/ofm-soa-suite-11gr1-installation-demonstration

Installation Planning

In this installation, Oracle Enterprise Repository 11g (version 11.1.1.3.0) is configured as a standalone under the existing Middleware Home that was created while installing the WebLogic Server. A Managed Server for OER is created extending domain that contains the Managed Server for SOA. In the current installation, following values are referenced. MIDDLEWARE_HOME: C:\oracle\ofm

WL Domain Name: C:\oracle\ofm\user_projects\domains\soa_domain WLS Admin Server Port: 7001 (default)

Admin User Name: weblogic Admin Password: passw0rd SOA Managed Server Port: 8001 SOA Managed Server Name: soa_server1

OER Managed Server Port: 7101 (default). This is selected while installing the OER.

OER Managed Server Name: oer_server1

The managed server for OER contains the Oracle Enterprise Repository Web application deployment.

Pre-Installation Steps

1. Create database tablespaces OER_DATA, OER_LOB and OER_INDEX (each for data, blob and index)

Gather the database credentials. SYSTEM or SYSDBA privileges are required.

DB Server: localhost Port: 1521

SID: odb11g

User: SYSTEM Password: oracle

Run the below scripts in SQL*Plus .

CREATE TABLESPACE OER_DATA

DATAFILE ' C:\oracle\db\oradata\oer\oer_data.dbf' SIZE 300M AUTOEXTEND ON NEXT 10240K MAXSIZE UNLIMITED EXTENT MANAGEMENT LOCAL AUTOALLOCATE

LOGGING ONLINE SEGMENT SPACE MANAGEMENT AUTO;

CREATE TABLESPACE OER_LOB DATAFILE 'C:\oracle\db\oradata\oer\oer_lob.dbf' SIZE 300M AUTOEXTEND ON NEXT 10240K MAXSIZE UNLIMITED

EXTENT MANAGEMENT LOCAL AUTOALLOCATE LOGGING ONLINE SEGMENT SPACE MANAGEMENT AUTO;

CREATE TABLESPACE OER_INDEX DATAFILE 'C:\oracle\db\oradata\oer\oer_index.dbf' SIZE 300M AUTOEXTEND ON NEXT 5120K MAXSIZE UNLIMITED

EXTENT MANAGEMENT LOCAL AUTOALLOCATE LOGGING ONLINE

SEGMENT SPACE MANAGEMENT AUTO;

2. Create a Database User for installing OER. Grant the privileges to creation sessions and tables

CREATE USER OER IDENTIFIED BY OER_PWD DEFAULT TABLESPACE OER_DATA

TEMPORARY TABLESPACE TEMP; GRANT CREATE MATERIALIZED VIEW TO OER;

GRANT CREATE SEQUENCE TO OER; GRANT CREATE SESSION TO OER; GRANT CREATE SYNONYM TO OER; GRANT CREATE TABLE TO OER;

GRANT CREATE TRIGGER TO OER; GRANT CREATE VIEW TO OER; GRANT UNLIMITED TABLESPACE TO OER;

3. Download the JDBC driver for Java 1.6 (file name: ojdbc6.jar) from

http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/htdocs/jdbc_111060.html

4. Download the OER 11g installation software (file name: OER111130_generic.jar) from:

http://www.oracle.com/technology/software/products/middleware/htdocs/fmw_11_download.html

Installation Steps

Installable file (downloaded from Oracle

product site): OER111130_generic.jar

In a command prompt, navigate to the location where OER installable was

downloaded and run the jar file. java -jar OER111130_generic.jar

The OER installation wizard starts. Verify the prerequisites and proceed with installation.

Choose the middleware home directory

In this case, the middleware home directory is

C:\oracle\ofm

Select the target directory under middleware home for installing the OER C:\oracle\ofm\repository111

Choose the application server. In this case it is

WebLogic Server 11

Select the Application Server name and Port.

Server Name: WISFH1001.emrsn.org

OER Managed Server Port: 7101 (default)

Repository Application Name: oer Repository Web Application Name: oer-web

Installation progresses…

Installation creates a folder for OER under the

middleware home

Next, configure the OER to use the database that was created as part of the prerequisite.

Provide the tablespace names as created in the prerequisite step. Data Tablespace: OER_DATA

BLOB Tablespace: OER_DATA Index Tablespace: OER_INDEX

Note, enter the same value in BLOB

Tablespace as entered in Data Tablespace

Enter the Repository Database properties

Database Type: Oracle

Driver File Location: this should be the location of the jar file ojdbc6.jar that was

downloaded as part of prerequisite.

DBMS Name (SID): odb11g

User Name: OER (as created for the OER tablespace in prerequisites)

Password: OER_PWD (as created in prerequisites)

The installer wizard tests the connection to

the database.

The installer wizard builds and loads the OER Database

When the installation wizard completes, it

displays the completion message.

Post-Installation Steps

Extend existing domain to create a WebLogic managed server for OER.

Start the domain configuration wizard from <WEBLOGIC_HOME>/common/bin/config.cmd

Select Extend an existing WebLogic domain option in the domain

configuration wizard

Navigate the folder tree structure and select the domain name. In this case the domain name is soa_domain

Select the Oracle Enterprise Repository from the displayed to list to extend the domain for

Enter the database TNS

Wizard checks the database

connection

Select the option to configure Managed Servers

Verify the name for the Managed

Server for OER (oer_server1), the host name and the port.

oer_server1 is the default Managed

Server Name.

7101 is the default port.

Skip configuring in cluster

environment.

Select the default Machine name for oer_server1

Verify the servers assignment to the

machines

Review the configuration summary

and proceed to extend the domain

The wizard copies files to add oer_server1

Refer to the

C:\oracle\ofm\user_projects\domains\soa_domain\startManagedWebLog

ic_readme.txt

oer_server1 is now added to the

domain

Starting the Application

Start the Admin and Managed Server

1. Start the Administration server: Navigate to domain folder

(C:\oracle\ofm\user_projects\domains\soa_domain) and run startWebLogic.cmd to start the admin server

2. Start the OER Managed server: Navigate to domain folder (C:\oracle\ofm\user_projects\domains\soa_domain\bin) and run startManagedWebLogic.cmd with oer_server1 as parameter to start the managed server

User Name: weblogic Password: passw0rd

3. Log in to the Domain's Administration Server Console application, and then select Environment -> Servers -> Control tab, and check the oer_server1 managed server status.

Admin credentials (as selected during WebLogic server installation:

Host URL: http://localhost:7001/console User name: weblogic

Password: passw0rd

Login and Verify the OER Installation

1. Login to the OER Application

URL: http://192.168.10.10:7101/oer (http://wisfh1001.emrsn.org:7101/oer) (the IP in this installation is for the loopback adapter network connection) User name: admin Password: admin (default)

The default password has to be changed upon the initial login.

New password: passw0rd

Re-login with the new password.

2. Verify the OER via the Oracle Enterprise Repository Diagnostics Testing Tool

The Diagnostics tool allows testing and troubleshooting of certain aspects of Oracle Enterprise Repository, including testing for:

Checking Product Version Information

Servlet Functionality

Required Libraries

Database Connectivity List System Paths

Run Pre-Compile Servlet By default the diagnostic tool is disabled. Enable it by setting the below parameter in the file MIDDLEWARE_HOME/user_projects/DOMAIN_ NAME/bin/setOERDomainEnv.cmd

OER_DIAG_OPTION=-DdiagPagesEnabled=true

Then, restart the Oracle Enterprise Repository managed server.

Login to the Diagnostic Tool:

URL: http://wisfh1001.emrsn.org:7101/oer/diag/index.jsp

Administering Users

Create a User

Login to OER Console as admin. Select Admin > Users > Create New User

Enter the following details:

User Name: user1 First Name: Test Last Name: User1 Email: testuser1@localhost.com Password: passw0rd Role: user Department: Default Department

Verify the created user in the Admin page Admin > Users > List All

Create a Registrar

Managing Asset Lifecycle

Submit an Asset

Login to OER Console with test user credentials. URL: http://wisfh1001.emrsn.org:7101/oer/index.jsp User Name: user1 Password: passw0rd

Click on the “Submit an Asset” option. This opens up Asset Submission Page

Enter the following details in the Asset

Submission Page and submit

Type: Artifact_WSDL Asset Name: HelloWorld_WSDL Version: 2.0 Description: HelloWorld WSDL File’s location URL: http://WISFH1001.emrsn.org:8001/soa-infra/services/default/HelloWorld/hello_client_ep?WSDL

Verify the successful submission

Accept the Asset

Login to OER Console as admin Click on the “Edit / Manage Assets” option.

URL: http://wisfh1001.emrsn.org:7101/oer/index.jsp

User Name: admin Password: passw0rd

This opens up Asset Editor Tool.

Java Web Start component (a browser plug in) is automatically downloaded if not found.

Asset Editor window opens up.

Expand the Submitted > Pending Review folder in the tree

Review the submitted asset / artifact details

and select Accept

The asset moves to Under Review folder

Approve and Register the Asset

Approval is performed by the user with Registrar role.

Open the Asset Editor, navigate to the

asset that is Under Review

Review and update the tabs - Overview, Taxonomy, Technical, Tests, and Support

tabs Approve the asset

The status of the asset changes to approved.

Navigate to the Administration tab and Register the asset.

Find the Registered Asset and View Details

As an admin: search in the Asset Editor to locate the asset.

Use the search filters in the OER Console

to locate the registered asset

As a user: Login to OER Console, and

search for a registered asset using various search filters to locate the asset

Appendix

References

Installation Guide for OER 11g (E15745-03) User Guide for OER 11g (E15747-02)