soa11g installation
TRANSCRIPT
`
Best Practices and Troubleshooting
While installing
The SOA11g server
Page | 1
Contents
Contents..........................................................................................................................................................................2
1 Introduction..................................................................................................................................................................3
1.1 Order Of Installation Tasks..................................................................................................................................3
2 Step 1 : Preparing to Install..........................................................................................................................................4
2.1 System Requirements...........................................................................................................................................4
2.2 Install Database....................................................................................................................................................4
2.2.1 Steps to Install Database (Oracle Database 10g Express Edition)................................................................5
3 Step 2 : Create Schemas using RCU............................................................................................................................8
3.1 Steps to Create Schemas.......................................................................................................................................8
4 Step 3 : Install the Oracle WebLogic Server.............................................................................................................21
4.1 Steps to Install WebLogic Server.......................................................................................................................22
5 Step 4 : Install Oracle SOA Suite..............................................................................................................................31
5.1 Steps to Install Oracle SOA Suite (11.1.1.2.0)...................................................................................................32
6 Step 5 : Apply the Patch Set (11.1.1.3.0)...................................................................................................................38
6.1 Steps to run Patch Set Installer...........................................................................................................................38
7 Step 6 : Create WebLogic Domain and Configure Oracle SOA Suite......................................................................42
7.1 Steps to Create WebLogic Domain and Configure SOA Suite..........................................................................42
8 Post-Installation tasks................................................................................................................................................51
8.1 Launching the Server..........................................................................................................................................51
8.2 Verify the Installation.........................................................................................................................................52
Page | 2
1 Introduction
Oracle WebLogic Server is a scalable, enterprise-ready Java Platform, Enterprise Edition (Java EE) Application
Server. The WebLogic Server infrastructure supports the deployment of many types of distributed applications and
is an ideal foundation for building applications based on Service Oriented Architecture (SOA).
Complete implementation of the WebLogic Server provides a standard set of APIs for creating distributed
applications that can access a wide variety of services, such as databases, messaging services, and connections to
external enterprise systems. End-user clients access these applications using Web browser clients or Java clients.
WebLogic Server enables enterprises to deploy applications in a robust, secure, highly available, and scalable
environment. These features allow enterprises to configure clusters of WebLogic Server instances to distribute load,
and provide extra capacity in case of hardware or other failures. Extensive security features protect access to
services, keep enterprise data secure, and prevent malicious attacks.
1.1 Order Of Installation Tasks
Page | 3
Step 1 : Prepare the System environment for Installation. If there is no database (supported version),
install it. Ensure it is up and running.
Step 2 : Create Oracle SOA Suite schemas by running the RCU(Repository Creation Utility).
Step 3 : Install the Oracle WebLogic Server.
Step 4 : Install Oracle SOA Suite.
Step 5 : To upgrade the Oracle SOA Suite Software, run the Patch Set Installer.
Step 6 : Run the Configuration Wizard to create the Weblogic Domain and Configure the Oracle SOA
Suite.
2 Step 1 : Preparing to Install
2.1 System Requirements
Ensure that your system environment meets the general installation requirements for Oracle Fusion Middleware as
well as WebLogic Server, Oracle SOA Suite and RCU. Ensure that there is required hardware and software,
minimum disk space and memory and required system libraries, packages, or patches present in the system.
2.2 Install Database
Installation of Oracle SOA Suite requires a database of the supported version. This database must be up and running.
It does not have to be on the same system where you are installing the products. The database must also be
compatible with Repository Creation Utility (RCU), which is used to create the schemas.
Page | 4
2.2.1 Steps to Install Database (Oracle Database 10g Express Edition)
1. In the Oracle Database 10g Express Edition - Install Wizard welcome window, click Next.
2. In the License Agreement window, select I accept and then click Next.
Page | 5
3. In the Choose Destination Location window, accept the default then click Next.
4. In the Specify Database Passwords window, enter the password to use for the SYS and SYSTEM database accounts. Then click Next.
5. In the Summary window, review the installation settings, click Install. If not satisfied with the settings click Back and modify the settings as necessary.
Page | 6
6. In the InstallShield Wizard Complete window, click Launch the Database homepage to display the Database Home Page. Then click Finish.
Page | 7
3 Step 2 : Create Schemas using RCU
Prior to installation, Oracle Fusion Middleware components require the existence of schemas in a database. These
schemas are created and loaded in your database using the Repository Creation Utility (RCU).
3.1 Steps to Create Schemas
1. Open cmd prompt.
2. Go to rcuHome\BIN (D:\ofm_rcu_win_11.1.1.3.0_disk1_1of1\rcuHome\BIN) and run “rcu.bat” file.
3. Then we will get Welcome Screen of Repository Creation Utility (RCU). Click Next.
4. In Create Repository Screen, select Create and click Next.
Page | 8
5. Provide the database connection details in the next screen and click Next.
Host Name: Specify the name of the machine on which your database resides in the format host.domain.com
Port: Specify the database listener port number. The default port number for Oracle databases is 1521.
Service Name: Specify the service name for the database.
Username: Specify the name of a user with DBA or SYSDBA privileges.
Password: Specify the password for your database user.
Role: Select the database user’s role from the drop-down list. The SYS user requires the SYSDBA role.
Page | 9
6. In the next screen, Checking Prerequisites screen, you might encounter the following Errors.
Page | 10
Ignore it.
Click OK.
7. Next is the Select Components Screen.Select Create a New Prefix. Default is DEV.Select the necessary schemas for the product you want to install. Dependencies are automatically selected.Schemas required for Oracle SOA Suite products :
SOA Infrastructure Business Activity Monitoring User Messaging Service
Page | 11
Click Next.
8. A "Checking Prerequisites" screen will appear. If there are errors, details about the error will be displayed at the bottom of the screen.
Fix the error messages and click Next again.
Some common errors encountered are :
Page | 12
As a result of the above errors, Prerequisite Check for SOA Infrastructure fails.
Page | 13
ERROR :
RCU-6083:Failed - Check prerequisites requirement for selected component: SOAINFRA. Please refer to RCU log
at C:\ofm_rcu_win_11.1.1.3.0_disk1_1of1\rcuHome\rcu\log\logdir.2010-08-02_13-50\rcu.log for details. RCU-
6107:DB Init Param Prerequisite failure for: processes Current Value is 100. It should be greater than or equal
to 200. RCU-6092:Component Selection validation failed. Please refer to log at C:\
ofm_rcu_win_11.1.1.3.0_disk1_1of1\rcuHome\rcu\log\logdir.2010-08-02_13-50\rcu.log for details.
SOLUTION :
Page | 14
Configure the Database in order to get the required value of the parameter- ‘processes’ using the following Scripts:
SQL> connect sys/password as sysdba;
Connected.
SQL> alter system set processes = 1000 scope = spfile;
System altered.
SQL> commit;
Commit complete.
SQL> shutdown immediate
Database closed.
Database dismounted.
ORACLE instance shut down.
SQL> connect sys/password as sysdba;
Connected to an idle instance.
SQL> startup
ORACLE instance started.
Total System Global Area 805306368 bytes
Fixed Size 1289996 bytes
Variable Size 213909748 bytes
Database Buffers 587202560 bytes
Redo Buffers 2904064 bytes
Database mounted.
Database opened.
To see the parameters execute the script given below:
Page | 15
SQL> show parameter sessions
NAME TYPE VALUE
------------------------------------ ----------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
java_max_sessionspace_size integer 0
java_soft_sessionspace_limit integer 0
license_max_sessions integer 0
license_sessions_warning integer 0
logmnr_max_persistent_sessions integer 1
sessions integer 1105
shared_server_sessions integer
After fixing the error, click Next.
Prerequisite check will be complete.
Click OK.
9. Next is the Schema Passwords screen.
Select Use same password for all schemas and provide the password and Confirm it. Click Next.
Page | 16
10. In Map Tablespaces Screen, click Next.
.
A "Creating Tablespaces" screen will appear. If there are errors, details of the error will be displayed on the Map Tablespaces Screen.
Page | 17
Fix the error messages and click Next again
11. In the next screen click OK.
12. Next is the Creating Tablespaces Screen. After the tablespaces have been created without errors, click OK.
Page | 18
13. In the Summary Screen, click Create.
14. A "CREATE" screen will appear. If there are errors, some details of the error will be displayed on the
Summary Screen.
Page | 19
Fix the error messages and click Next again.
After the schemas are created with no errors, click OK .
15. In the Completion Summary Screen, review the information on this screen and click Close.
If problems are encountered during schema creation, you can troubleshoot the issue using the log files. If errors are
encountered during a Create operation, or if a Create operation fails for any component, the Cleanup for failed
Page | 20
components checkbox appears on the Completion Summary Screen and is selected by default. If selected, RCU will
perform cleanup operations for the component that failed during the Create operation. If you choose not to select this
checkbox, you can cleanup the failed component at a later time by performing a Drop operation for the failed
component(s).
4 Step 3 : Install the Oracle WebLogic Server
At the time of Oracle 11g JDeveloper installation, WebLogic Server gets installed automatically. If you do not
already have one, follow the instructions in this section to install Oracle WebLogic Server.
Before installation, determine the appropriate installation mode. There are 3 installation modes : graphical mode,
console mode, or silent mode.
Graphical mode
It is an interactive, GUI-based method for installing. It can be run on both Windows and UNIX
systems.
Console mode
It is an interactive, text-based method for installing from the command line, on either a UNIX system
or a Windows system.
Silent mode
It is a non-interactive method of installing. It uses an XML properties file to specify the installation
options. It can be run from either a script or from the command line. In this mode we can define the
installation configuration only once, and then use that configuration to duplicate the installation on
many machines.
Components installed in a typical WebLogic Server installation are :
Page | 21
Core Application Server
Administration Console
Configuration Wizard and Upgrade Framework
Web 2.0 HTTP Pub-Sub Server
WebLogic SCA
WebLogic JDBC Drivers
Third-Party JDBC Drivers
WebLogic Server Clients
WebLogic Web Server Plug-Ins
UDDI and XQuery Support
Coherence Product Files
Oracle Enterprise Pack for Eclipse
4.1 Steps to Install WebLogic Server
1. Go to the directory that contains the installation program.
2. Double-click the installation file (wls1033_win32.exe).
If you launch the installation from the command line or from a script, you can specify the -log option to
generate a verbose installation log. The installation log stores messages (informational, warning, error, and
fatal) about events that occur during the installation process. This type of file can be especially useful for
silent installations.
To create a verbose log file during installation, include the -log=full_path_to_log_file option in the
command line.
For example, to create a verbose log file for the Oracle WebLogic Server net installer for
Windows,enter:
wls1033_win32.exe -log=D:\Oracle\Middleware\logs\server_install.log
The path must specify a file. You cannot create a folder simply by including a name for it in a pathname;
your path should specify only existing folders. If your path includes a nonexistent folder when you execute
the command, the installation program does not create the log file.
The installation program begins to install the software.
3. Initial screen is the Welcome screen. The Welcome screen is displayed each time you start the installer Click Next.
Page | 22
4. In Choose Middleware home directory screen, specify the Middleware home directory that will serve as the
central support directory for all Fusion Middleware products installed on the target system, including
WebLogic Server. The default Middleware home directory is C:\Oracle\Middleware. Each Fusion
Middleware product will be installed in its own product directory in the Middleware home directory.
If you already have a Middleware home directory on your system, you can select that directory
(recommended) or create another Middleware home directory.
If you choose to create a directory by typing a new directory name in the Middleware Home
Directory field, the installation program automatically creates one for you. You can also click Browse
and select an existing directory from the Middleware Home Directory screen.
Sometimes when we select ‘Use an existing Middleware Home’ option and provide a Middleware Home
which contain products whose maintenance level is not compatible with the one being installed, we will get
an error. In such a case use ‘Create a new Middleware Home’ option.
Click Next.
Page | 23
5. In Register for Security Updates screen, specify whether you want to register the Oracle WebLogic Server
installation with My Oracle Support. By registering, Oracle Support notifies you immediately of any
security updates that are specific to your installation.
If you want to register your installation, enter your My Oracle Support email address and your My Oracle
Support password.
If you want to decline registration, uncheck the I wish to receive security updates via My Oracle
Support check box. An Are You Sure? dialog box appears. Click Yes to continue.
Page | 24
6. Select the installation type. Click Next.
Typical—All the software components included in your installation program are installed on your
system. Typical installation does not include the Server Examples.
Custom— If you do not want to install some of these components, or if you want to install additional
components, perform a Custom installation.
Page | 25
7. In Choose Products and Components specify the components to be installed by selecting or clearing the
appropriate check boxes. Click Next.
8. JDK Selection screen displays a list of JDKs. This list contains JDKs that are available for (and common
across) previous installations of all the selected WebLogic Server components.
Select the JDK that you want to install with the product.
You can also browse for and select a local JDK (at least 1.6.0_05) installed on your machine.
Click Next.
Page | 26
9. Next is the Choose Product Installation Directories screen. We can accept the default product directories or
specify new directories for each product you are installing. The product directories that are listed on this
screen depend on the products selected for installation. We may have to specify up to three installation
directories, one each for Oracle WebLogic Server, Oracle Enterprise Pack for Eclipse, and Oracle
Coherence.
Page | 27
If we are adding components to an existing product installation, confirm the product installation directory. These are
the directories in which we previously installed WebLogic Server, Oracle Enterprise Pack for Eclipse, or Oracle
Coherence.
The selected components are installed in the product installation directory we specified during the initial installation.
10. In Install Windows Service Screen we need to choose whether we want to install the Windows services
indicated, specifically the Oracle WebLogic Server Node Manager service. Node Manager is used to
monitor, start, and stop server instances in a WebLogic domain.
If Yes, enter the Node Manager Listen Port in the appropriate field. The default is 5556.
Click Next
Page | 28
11. In Choose Shortcut Location screen, select one of the options and click Next.
All Users Start menu folder
Select this option to provide all users registered on the machine with access to the installed software.
Local User's Start menu folder
Selecting this option ensures that other users registered on this machine do not have access to the installed
software.
12. In the Summary screen, review the details and click Next.
Page | 29
13. Once the installation is complete, we get the Installation Complete screen.
Page | 30
5 Step 4 : Install Oracle SOA Suite
Prior to the application of patchset 2 (11.1.1.3.0), it is necessary to install SOA Suite 11.1.1.2.0.
If we try to install Oracle SOA Suite 11.1.1.3.0 directly without installing SOA Suite 11.1.1.2.0, we will encounter the following errors :
INST-07100 : The Oracle Home provided does not contain Oracle SOA Suite 11.1.1.2.0
INST-07293 : Middleware home location specified does not have the required Oracle Homes installed in it.
Before applying 11.1.1.3.0 to SOA, make sure we have Oracle WebLogic Server version 10.3.3
Some schemas [PORTAL, OID, SOAINFRA..] must be updated in database to bring schemas to 11.1.1.3.0.
Page | 31
5.1 Steps to Install Oracle SOA Suite (11.1.1.2.0)
1. Go to 11g SOA Suite setup folder and then click on “setup.exe”.
The installer requires the location of a Java Runtime Environment (JRE) on the system.When we installed Oracle
WebLogic Server, a JRE was installed on your system. You can use this location (the location of the jre directory) to
start the installer. JRE is also installed when we install Oracle Jdeveloper. We can also use this location.
Provide the JRE location and press Enter.
Page | 32
This opens the Installer.
2. Initially we will get the Welcome Screen. Click Next.
Page | 33
3. Next is the Prerequisite Check screen. If there is a problem, a short error message appears at the bottom of
the screen. Fix the error and click Retry to try again.
Click Continue to ignore the error and warning messages and continue with the installation.
Click Abort to stop prerequisite checking for all components.
When finished, click Next to continue.
Page | 34
4. Next is the Specify Installation Location screen. In the Oracle Middleware Home field, specify the absolute
path to your existing Oracle Middleware Home directory where WebLogic Server is installed.
In the Oracle Home Directory field, specify the directory inside the Oracle Middleware Home where you
want to install your products:
If we specify a directory that already exists, it must be an empty directory and it must be inside the Oracle
Middleware Home.
If we specify a new directory, it will be created inside the Oracle Middleware Home.
This will be the Oracle Home directory(SOA Oracle Home). Runtime components
cannot write to this directory.
Page | 35
5. Review the information on Installation Summary screen, and click Install to begin the installation.
6. Next is the Installation Progress screen. Once the installation is complete click Next.
Page | 36
7. Installation Complete screen summarizes the installation that was just completed.
If we want to save this summary information to a text file for future reference, click Save.
Click Finish to dismiss the screen.
Page | 37
6 Step 5 : Apply the Patch Set (11.1.1.3.0)
To upgrade the Oracle Fusion Middleware components, use Patch Set installer.
Back up Middleware home directory and all sub-directories, along with Domain home and Oracle instance home
directories because if patch installation in unexpectedly interrupted, or if we choose to cancel out of the installation
before it is complete, it might not be possible to install the patch unless the environment is restored to the previous
configuration before running the Patch Set Installer again. There is no deinstallation option with the Patch Set
Installer.
Before running Patch Set Installer, stop all servers and processes.
The Patch Set Installer requires Oracle WebLogic Server version 10.3.3.
6.1 Steps to run Patch Set Installer
1. Go to the directory containing the setup file and run ‘setup.exe’.
2. Provide the JRE location.
Page | 38
3. Patch Set Installer starts and A Welcome screen appears.
4. Next is the Specify Installation Location Screen
Specify your existing Oracle Middleware home and product Oracle home locations.
Page | 39
Click Next to continue.
5. In Installation Summary Screen, verify the details and click Install.
6. Installation Progress Screen shows the progress of the installation
Once the installation is complete, click Next.
Page | 40
7. Click Finish to dismiss the screen
Page | 41
7 Step 6 : Create WebLogic Domain and Configure Oracle SOA Suite
After successfully running the installer, configure Oracle SOA Suite using the Oracle Fusion Middleware
Configuration Wizard.
7.1 Steps to Create WebLogic Domain and Configure SOA Suite
1. Start the Configuration Wizard – ‘config.cmd’. This Configuration Wizard is located in SOA_ORACLE_HOME\common\bin.
2. Next we get the Welcome Screen.
Select Create a New WebLogic Domain and click Next.
Page | 42
3. In Select Domain Source Screen, select Generate a domain configured automatically to support the
following products, then select required products.
Click Next.
4. Next is the Specify Domain Name and Location Screen.
Page | 43
Specify the following domain information:
Domain name: The name of the domain you want to create. The default name is base_domain.
Domain location: The absolute path to the directory where this domain should be created.
Application location: The absolute path to the directory where applications created in this domain
should reside.
Click Next.
5. In Configure Administrator Username and Password Screen, specify the following credentials for your
administrator:
User name: The name of the administrator for this domain. The default name is weblogic.
User password: The administrator’s password.
Confirm user password: Re-enter the administrator’s password.
Description: Enter a description for this user, or leave the default description as is. This field is optional.
Click Next.
Page | 44
6. Next is the Configure Server Start Mode and JDK Screen
In the "WebLogic Domain Startup Mode" portion of the screen, Select Development Mode.
In the "JDK Selection" portion of the screen, select the JDK that is recommended for your platform in
Development Mode.
Click Next.
Page | 45
7. Next is the Configure JDBC Component Schema Screen.
Configure the schema information for each data source listed on this screen. When you make changes to
any field on this screen, the changes are applied to selected data sources only. The changes are saved
automatically as you type.
Provide the following information:
Vendor: Select the vendor for your database from the drop-down list.
Driver: Select the driver type from the drop-down list.
Schema Owner: Specify the schema owner for the schema; this is the name of the schema for this
component in the following format: prefix_schema-name
This information was specified on the Select Components Screen when the schemas were created using
RCU.
Password: Specify the password for the schema. You specified this password on the Schema Passwords
Screen when creating the schemas using RCU
DBMS/Service: Specify the service name for your database. This is the database on which the schema
resides.
Host Name: Specify the name of the machine where your database is running.
Port: Specify the database listen port number.
BAM Schema
Page | 46
SOA Infrastructure
User Messaging Service
Page | 47
OWSM MDS Schema
SOA MDS Schema
Page | 48
8. In Test Component Schema Screen, verify that the connections to your data sources are successful.
Click Next.
9. Next is the Select Optional Configuration Screen.
Do not select anything on this screen.
Page | 49
Click Next.
10. In Configuration Summary Screen, verify the information and click Create.
11. Next is the Creating Domain Screen.
When the domain has been successfully created, click Done to dismiss the Configuration Wizard.
Page | 50
The last line in the summary information is the URL of the Administration Server. Make a note of this
URL so that you can access the Administration Server after it has been started.
8 Post-Installation tasks
8.1 Launching the Server
To get the deployments up and running, you must start the Administration Server and various Managed Servers.
1. To start the Administration Server, run the startWebLogic.cmd script in the directory where the new
domain is created.
On UNIX operating systems:
MW_HOME/user_projects/domains/domain_name/startWebLogic.sh
On Windows operating systems:
MW_HOME\user_projects\domains\domain_name\startWebLogic.cmd
2. To start the Managed Servers, run the startManagedWebLogic.cmd script in the bin directory inside the
directory where the new domain is created.
Page | 51
This command also requires a server name. The servers that need to be started are:
soa_server1 (Oracle SOA Server)
bam_server1 (Oracle BAM Server)
Example:
chdir/d G:\Oracle\Middleware\user_projects\domains\base_domain\bin
startManagedWebLogic.cmd soa_server1 http://master:7001
stopManagedWebLogic.cmd soa_server1 http://master:7001
startManagedWebLogic.cmd bam_server1 http://master:7001
If we do not know the names of the managed servers that need to be started, we can view the contents of the
following file : Middleware_Home\user_projects\domains\domain_name\startManagedWebLogic_readme.txt
Or, access the Administration Server console at the following URL:
http://host:admin_server_port/console (http://btp3sb40:7001/console)
Supply the username and password that was specified on the Configure Administrator Username and Password
Screen of the Configuration Wizard. Then, navigate to Environment > Servers to see the names of the managed
servers.
8.2 Verify the Installation
Start your browser and enter the following URLs:
To access the Administration Server:
http://host:admin_server_port (http://btp3sb40:7001)
To access the Administration Server console:
http://host:admin_server_port/console (http://btp3sb40:7001/console)
To access Enterprise Manager:
http://host:admin_server_port/em (http://btp3sb40:7001/ems)
SOA Suite 11g: Unable to start domain (Error occurred during initialization of VM)
By Chris Tomkins on May 13, 2010 1:01 PM
Page | 52
If you have recently installed SOA Suite, created a domain and then tried to start it only to find it fails with the error:
Error occurred during initialization of VM Could not reserve enough space for object heap Could not create the Java virtual machine.
the solution is to edit the file <domain home>\bin\setSOADomainEnv.cmd/sh (depending on your platform) and modify the line:
set DEFAULT_MEM_ARGS=-Xms512m -Xmx1024m
to something like:
set DEFAULT_MEM_ARGS=-Xms512m –Xmx1000m
Save the file and then try to start your domain again. Everything should now work at least it does on the Dell Latitude 630 laptop with 4Gb RAM that I have.
Page | 53