3 Installation Tasks

This chapter guides you through the installation of Oracle WSM, which places a single instance of each Oracle WSM component on a single machine. After performing the installation, you have the option to expand your Oracle WSM deployment by installing Oracle WSM on other hosts.

This chapter includes the following sections:

• Prepare Your Database for an Advanced Installation

• Start the Installation Process

• Install Oracle Web Services Manager

• To Remove Oracle WSM

3.1 Prepare Your Database for an Advanced Installation

Skip this section if you are performing a Basic installation on Windows.

If you are installing on Linux or performing an Advanced installation on Windows, you must prepare your existing database by loading the SOA schema ORAWSM into it.Your existing database must be one of the following:

• Oracle9i Release 2 (9.2.0.7) or later

• Oracle Database Express Edition 10g Release 2 (10.2.0.1)

• Oracle Database 10g Release 2 (10.2.0.2) or later

You must have access to the database as the SYS user with SYSDBA privileges.

To load the Oracle SOA Suite schemas into your database:

1. Log in to the machine where your Oracle database is installed or a remote Oracle client with a sqlplus installation that enables you to connect to the database remotely.

2. Set the ORACLE_HOME environment variable to the instance that contains sqlplus.

3. Make sure you can connect to the database as a user with SYSDBA privileges:

   ORACLE_HOME/bin/sqlplus "SYS/SYS_PASSWORD@SERVICENAME as SYSDBA"
   
   

4. On Oracle SOA Suite Disk1, locate the irca.sh command (Linux) or irca.bat command (Windows).

   If you downloaded and unzipped your installation directory:

   cd INSTALLATION_DIRECTORY/Disk1/install/soa_schemas/irca
   

   If you are installing from a CD-ROM, insert Disk1 into the CD-ROM drive and:

   cd mount_point/install/soa_schemas/irca
   
   

5. On Linux:

   Run the irca.sh command as follows:

   ./irca.sh 
   
   

   On Windows:

   Run the irca.bat command as follows:

   ./irca.bat 
   
   

6. When prompted for schemas to add, enter ORAWSM.

7. When the command completes successfully, you will have installed the necessary

   SOA schemas into your database. You can find more information in the README.txt file located in the same directory as the irca.sh command.

3.2 Start the Installation Process

Start the installation process, as follows:

1. Log in as the install user, described under Install User.

2. Insert the CD-ROM or DVD.

   
   

   Note: On Linux, if the CD-ROM or DVD fails to mount, follow the mount procedure documented inOracle Application Server Installation Guide for Linux x86or in your operating system documentation.

   
   

3. Invoke the installer.

   On Windows, it is Disk1\setup.exe.

   On Linux, it is Disk1/runInstaller.

3.3 Oracle Inventory Directory

If Oracle Web Services Manager is the first Oracle product to be installed on a computer, the installer displays a screen where you specify an "inventory" directory (also called the "oraInventory" directory). This inventory directory is used by the installer to keep track of all Oracle products installed on the computer. The inventory directory is separate from the Oracle home directories for Oracle WSM and Oracle Application Server. Do not use the oracle user's home directory as the inventory directory because home directories might not have the proper permissions.

If you have installed an Oracle product previously on the computer, the installer uses the existing inventory directory. Ensure that you have write permissions on that directory. The best way of ensuring this is to run the installer as the same operating system user who installed the existing Oracle products. Oracle recommends creating an operating system user to perform all tasks related to installation of Oracle products.

3.4 Install Oracle Web Services Manager

Perform the following steps:

1. Choose an installation directory and install mode

   Figure 3-1 shows the Oracle Web Services Manager 10g (10.1.3.1.0) Installation screen.

   Figure 3-1 Oracle WSM Installation Screen

   
   

   This screen requires you to specify the directory where you want to install Oracle Web Services Manager 10g (10.1.3.1.0). If you specify a new directory, Oracle Universal Installer will perform a Basic installation. If you specify an existing Oracle home, it will perform an Advanced installation. On a system with existing installations, you can choose from a list. Click Browse to browse the file system. The existing instance must be Oracle Application Server 10g Release 3 (10.1.3.1) or later.

   
   

   Note: The Oracle WSM Basic and Advanced installations types are sometimes referred to as Developer and Production installations, respectively. The Application Server Type on Oracle Web Services Manager 10g (10.1.3.1.0) Installation screen is listed as Developer install if you have specified a new directory and Advanced install if you have specified an existing Oracle home.

   
   

2. Provide Application Server Details

   The Application Server Details section of the Welcome screen contains the following fields:

   • Application Server Type

     This is an informational field that you cannot change. It contains Basic Install or Advanced Install, followed by Oracle Containers for J2EE.

   • HTTP Host:Port

     For a Basic installation, this field is disabled. The installer will use the current system as the host and port 3115. For a Advanced installation, specify the fully-qualified host and port of the HTTP listener for the service instance. The format is host:port.

   • OC4J Instance

     For a Basic installation, this field is set to home and cannot be changed. For a Advanced installation, specify the instance into which the applications should be deployed.

   • Administrator Username

     For a Basic installation, this field is set to oc4jadmin and cannot be changed. For a Advanced installation, the default is oc4jadmin, but you can change it to a different username. This user must have permission to create and delete shared libraries and to deploy and undeploy applications.

   • Administrator Password

     Specify a password for the administrator. In a Basic installation, you set the password using this field and confirm it in the next field. Passwords are subject to the following restrictions:

     • The minimum length is 5 characters.

     • The maximum length is 30 characters.

     • At least one of the characters must be a number.

     • Passwords can contain only alphanumeric characters from your database character set, the underscore (_), the dollar sign ($), and the number sign (#).

     • Passwords must begin with an alphabetic character. Passwords cannot begin with a number, the underscore (_), the dollar sign ($), or the number sign (#).

     • Passwords cannot be Oracle reserved words. The Oracle Database SQL Reference lists the reserved words. You can find this guide on Oracle Technology Network (http://www.oracle.com/technology/documentation). Or you can just avoid using words that sound like they might be reserved words.

     For an Advanced installation, specify the current administrator password.

   • Confirm Password

     For a Basic installation, confirm the password you chose for the administrator. This field is disabled in an Advanced installation.

3. Provide Database Details

   The Database Details section of the Welcome screen contains the following fields:

   • Database Type

     For a Basic installation on Windows, this field is set to OLite. For a Basic installation on Linux and for an Advanced installation, this field is set to Oracle. You cannot change this field.

   • Driver Type

     For the OLite database, this field is set to Thin and you cannot change it. For Oracle Database, select Thick or Thin as the JDBC driver type.

   • Name

     For the OLite database, this field is set to orawsm and you cannot change it. For Oracle Database, specify the database service name.

   • Database Connect String

     For the OLite database, this field is not used. For Oracle Database, specify the fully-qualified host name and the port. For a single database server the format is host:port. For a RAC database, the format is host1:port1^host2:port2...

   • User ID

     For the OLite database, this field is not used. For Oracle Database, specify the User ID (schema). The default is ORAWSM.

   • Password

     For OLite, you set the password using this field and confirm it in the next field. For Oracle Database, specify the current password for the specified user.

   • Confirm Password

     For OLite, confirm the password you chose for the system user. This field is disabled for Oracle Database.

4. Click Next.

5. Specify outgoing HTTP proxy information for your installation.

   Figure 3-2 Specify Proxy Information

   
   

   If your computer is located behind a firewall, specify the following information:

   • HTTP Proxy Host

     The fully-qualified name of the proxy host, for example: www-proxy.mydomain.com

   • HTTP Proxy Port

     The port to connect to on the proxy host, for example: 80

   • Bypass Proxy for Addresses:

     A list of addresses for which the proxy should be bypassed, for example:

     *mydomain.com;*mydomain2.com
     
     

     You can specify the local host as either localhost or <local>.

     If you have set proxy information in a browser, Oracle Universal Installer uses that information as the default. Figure 3-3 shows a sample setting.

     
     

     Note: If you specify a proxy host and port, and you have configured or will configure the Oracle WSM applications to communicate with each other through the localhost interface (the default), then you must specify localhost in the Bypass Proxy for Addresses field. If you do not do so, requests for localhost will be directed to your proxy server, which will usually result in an error.

     
     

6. Click Next.

7. Oracle Universal Installer displays a summary of the Oracle WSM components that will be installed. Click Install.

8. The Install screen, followed by the Oracle WSM Configuration Assistant screen, show the progress of the installation.

   
   

   Note: During initialization of the database, you might see errors due to tables not found in the database. You may safely ignore these errors.

   
   
   
   

   See Also: Appendix B, "Troubleshooting the Installation" for help resolving installation errors.

   
   

9. When the End of Installation screen appears, click Exit, then confirm by clicking Yes in the dialog that appears.

3.5 To Remove Oracle WSM

To uninstall Oracle Web Services Manager, perform the following steps:

1. Undeploy all applications by using wsmadmin undeploy.

   
   

   See Also: The appendix on wsmadmin in Oracle Web Services Manager Deployment Guide for more information.

   
   

2. Log in as the user who performed the installation of Oracle Web Services Manager.

3. Insert the CD-ROM or DVD.

4. Invoke the installer.

   On Windows, it is Disk1\uninstall.bat.

   On Linux, it is Disk1/runUninstaller.

5. In the Inventory panel, check the instance you want to remove.Figure 3-3 shows an Inventory panel with OWSMHome1 selected.

   Figure 3-3 Inventory Panel

   
   

6. Click Remove.

7. To uninstall the product, click Yes in the Confirmation dialog that follows. Click No to cancel the removal.

   
   

   Tip: You can uninstall Oracle products from any instance of Oracle Universal Installer by using the Inventory panel. Select the products you want to remove and click Remove.

   
   

8. A progress bar appears. When Oracle Universal Installer has finished uninstalling the product, the Inventory panel will no longer show the product you selected for removal. Close Oracle Universal Installer.

9. Delete the Oracle home where you installed Oracle WSM.

10. Optionally, delete files created by the installer in the inventory directory and in temporary directories.