2
Installation

This chapter describes the basic installation and configuration of Oracle Dynamic Services, which is the Java deployment view described in Section 1.3.1.

The installation requires that the person installing this software have sysadmin privileges, is a database administrator, and has application development skills.

After you have completed the installation steps described in this chapter, you will have an understanding of the system requirements needed to install Dynamic Services and will have installed the DSSYS schema. You must continue to Chapter 3 to configure the DSAdmin utility, and use this utility to register and execute a service to ensure that Dynamic Services is properly installed and running.

To configure and use other deployment views of Dynamic Services, such as HTTP/HTTPS, PL/SQL, or HTTP/Java Messaging Services (JMS), or to set up LDAP as a central master registry, see the appropriate sections described in Chapter 4. Chapter 4 also describes other advanced features such as enabling persistent auditing, manually fine-tuning Dynamic Services properties, and installing the management console.

2.1 System Requirements

The following are the system requirements:

• Oracle release: Oracle9i Standard Edition or Enterprise Edition Release 1 (9.0.1) is required to install and use Oracle Dynamic Services.

  Note: <ORACLE_HOME> is referred to as the installation directory of the Oracle9i Release 1 (9.0.1) distribution.

• Oracle Dynamic Services supports Oracle9i Standard Edition and Enterprise Edition running JDK 1.2.2.
• Java version: JDK 1.2.2 or later (Java2) distribution.

  Note: <JAVA2_HOME> is the installation directory of the JDK 1.2.2 or later distribution.

Ensure you have a full installation of Oracle9i Release 1 (9.0.1) (a full installation in this case includes a typical Oracle9i Release 1 (9.0.1) installation. Follow Oracle9i installation instructions to complete a full installation.

2.2 Dynamic Services Distribution

For release 9.0.1, Oracle Dynamic Services is installed using the Oracle Universal Installer into the ds directory within your <ORACLE_HOME> directory. The distribution contains the subdirectories shown in Table 2-1.

Table 2-1 Oracle Dynamic Services ds Directory Contents  

Subdirectories	Description
bin	Contains the DSAdmin command-line utility for registering or unregistering a service, and running the test service executions.
demo/consumer	Contains the sample client code for the service consumer.
demo/dsadmin	Contains the sample Oracle Dynamic Services script files.
demo/services	Contains the sample service packages.
doc	Contains the documentation about Dynamic Services including the README.txt file, the Oracle Dynamic Services FAQ file (dsfaq.txt), and the JavaDoc API (apidoc.zip), which contains those classes that are necessary for service consumers and service developers to build and run services.
etc	Contains miscellaneous configuration files.
etc/Apache_JServ	Contains a sample servlet zone configuration file.
etc/dsadmin	Contains a collection of system scripts and a properties file.
etc/services	Contains the service packages needed for the monitor services.
etc/xsd	Contains the XML schema for the service descriptor and supplied adaptors.
jsp/management	Contains the Management Console application.
ldif	Contains the Lightweight Directory Access Protocol (LDAP) schema definitions for the Oracle Internet Directory (OID) registry.
lib	Contains the jar file of the Dynamic Services code.
sql	Contains SQL scripts for installing in Oracle9i the support necessary for Oracle Dynamic Services.
logs	Contains log files used by JMS daemon.

2.3 Installing the DSSYS Schema

The DSSYS schema SQL scripts do the following:

• Create the tablespaces for the DSSYS schema.
• Connect to the schema as DSSYS/<DSSYS-password>.
• Create all object and table definitions.
• Install the Dynamic Services registry.
• Initialize the user profile registry.
• Create a table for caching service responses.
• Install the Dynamic Services cache manager package.
• Create the Dynamic Services properties table.
• Load the Dynamic Services properties package.
• Initialize queues and events.
• Create the Dynamic Services user roles.

To install the DSSYS schema, perform the following tasks:

1. Using a command-line shell, change the current directory to the directory where the DSSYS schema installation script is located, shown as follows:

   On UNIX systems:

   cd <ORACLE_HOME>/ds/sql
   
   

   On Windows NT systems:

   cd <ORACLE_HOME>\ds\sql
   
   

2. Connect as SYS to the Oracle9i 9.0.1 instance using SQL*Plus as follows:

   sqlplus sys/<sys-password>
   
   

   The DSSYS schema installation script assumes the connected SYS user has the required privileges to create users.

   Note: The dsinstall.sql script invokes a dssys_ts_init.sql script responsible for the creation of tablespaces that are needed by the DSSYS schema. Review the dssys_ts_init.sql script and customize it before running the dsinstall.sql script. For example, you may want to store these tablespaces on another disk.

3. Run the dsinstall.sql script by issuing the following command in SQL*Plus:

   SQL> @dsinstall.sql
   
   

   The install script creates a log file of its execution so that it can be checked for errors. The log file is created within the same directory and is named dsinstall.log. To check if the installation had errors, run the following file at the UNIX prompt:<ORACLE_HOME>bin/showerrors (showerrors.bat on Windows NT) as follows:

   On UNIX systems:

   <ORACLE_HOME>/ds/bin/showerrors
   
   

   On Windows NT systems:

   <ORACLE_HOME>\ds\bin\showerrors.bat
   
   

   The showerrors command only reports failure errors or installation errors. If there are none shown, then there are no errors to report.

   Note: The bin/showerrors directory path on UNIX systems or the bin\showerrors directory path on Windows NT systems is relative to the Oracle Dynamic Services installation home. On UNIX systems, you must edit the bin/showerrors file, or on Windows NT, you must edit the bin\showerrors.bat file and enter the correct location for your <ORACLE_HOME> location.

4. To verify the installation of the schema, exit SQL*Plus and try to reconnect to the database as the DSSYS user by issuing the following command:

   sqlplus dssys/<dssys-password>
   
   

   Note: The default password for user DSSYS after installation is DSSYS. For security reasons, you should change the default password and modify the appropriate files in the installation.

2.4 Dynamic Services Configuration

After the installation is complete, you must first configure and run the DSAdmin utility before you can register and execute services, which is the test that your Dynamic Services installation and DSAdmin utility configuration is working properly. To configure the DSAdmin utility and register and execute a service, you must continue to Chapter 3.