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.
2. 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
3. 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.
4. 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.
5. 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:oracleofm
WL Domain Name: C:oracleofmuser_projectsdomainssoa_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
6. SID: odb11g
User: SYSTEM
Password: oracle
Run the below scripts in SQL*Plus .
CREATE TABLESPACE OER_DATA
DATAFILE ' C:o racledboradataoeroer_da ta.dbf' SIZE 300M
AUTOEXTEND ON NEXT 10240K MAXSIZE UNLIMITED
EXTENT MANAGEMENT LOCAL AUTOALLOCATE
LOGGING
ONLINE
SEGMENT SPACE MANAGEMENT AUTO;
CREATE TABLESPACE OER_LO B
DATAFILE 'C:o racledboradataoeroer_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:o racledboradataoeroer_ind ex.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 O ER_PWD
DEFAULT TABLESPACE O ER_DATA
TEMPORARY TABLESPACE TEMP;
GRANT CREATE MATERIALIZED VIEW TO O ER;
GRANT CREATE SEQUENCE TO OER;
GRANT CREATE SESSION TO O ER;
GRANT CREATE SYNO NYM TO OER;
GRANT CREATE TABLE TO OER;
GRANT CREATE TRIGGER TO O ER;
GRANT CREATE VIEW TO OER;
GRANT UNLIMITED TABLESP ACE 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
7. 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:oracleofm
8. Select the target directory under middleware
home for installing the OER
C:oracleofmrepository111
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
10. 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.
11. 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.
12. Start the domain configuration
wizard from
<WEBLOGIC_HOME>/common/bin/c
onfig.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
13. Select the Oracle Enterprise
Repository from the displayed to list
to extend the domain for
Enter the database TNS
Wizard checks the database
connection
14. 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.
15. 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
16. The wizard copies files to add
oer_server1
Refer to the
C:oracleofmuser_projectsdomain
ssoa_domainstartManagedWebLog
ic_readme.txt
oer_server1 is now added to the
domain
17. Starting the Application
Start the Admin and Managed Server
1. Start the Administration server: Navigate to domain folder
(C:oracleofmuser_projectsdomainssoa_domain) and run startWebLogic.cmd to start the
admin server
2. Start the OER Managed server: Navigate to domain folder
(C:oracleofmuser_projectsdomainssoa_domainbin) 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
18. 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)
19. 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:
21. 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
22. 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
23. 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
25. 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.
26. 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