Date post: | 27-May-2015 |
Category: |
Education |
Upload: | sreenivasa-setty |
View: | 16,331 times |
Download: | 1 times |
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: [email protected] 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)