Oracle Enterprise Repository 11g - Quick Start Guide
2 likes7,313 views
The document is a comprehensive guide for installing and configuring Oracle Enterprise Repository (OER) 11g, detailing prerequisites, installation steps, and post-installation procedures. It covers user administration, asset lifecycle management, and includes various operational aspects within a service-oriented architecture (SOA) governance environment. The guide serves as a resource for setting up the repository and effectively managing assets, ensuring compliance and performance analytics.
Oracle Enterprise Repository 11g - Quick Start Guide
- 1. Oracle Enterprise Repository 11g Quick Start Guide Sreeni Setty http://www.linkedin.com/in/sreenisetty
- 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
- 9. 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.
- 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
- 24. The asset moves to Under Review folder
- 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
- 27. Appendix References Installation Guide for OER 11g (E15745-03) User Guide for OER 11g (E15747-02)