Oracle® Communications Service Broker Installation Guide Release 6.1 Part Number E29451-01 |
|
|
PDF · Mobi · ePub |
Oracle Communications Service Broker uses Oracle Universal Installer. This chapter describes how to use the Oracle Universal Installer to install Service Broker with either the graphical installation wizard or in silent mode.
The installation procedures provide options to install all Service Broker products and components. These procedures also enable you to install a compatible JDK, and Berkeley or Oracle Enterprise database.
You must run the installer as a non-root user. The Service Broker software is installed to the Oracle home directory. See "Choosing an Oracle Home" for more information.
For more information about using Oracle Universal Installer, see Oracle Universal Installer and OPatch User's Guide.
An Oracle home (referred to as Oracle_home in all Service Broker documentation) is the parent directory on a host computer into which the Service Broker software is installed.
The Oracle_home location is defined in an environment variable.
Each Oracle_home has a name and a directory path associated with it that you set during installation:
The name identifies the program group associated with a particular home and the Oracle services installed on this home. The Oracle home name must be between 1 to 128 characters long, and can include only alphanumeric characters and underscores.
The path is the full path to an Oracle_home directory where products are installed.
If you run the installer for the first time on a host, Oracle recommends that you designate an Oracle_home location that is either an empty directory or a non-existing directory for the installer to create.
Oracle Universal Installer supports the installation of multiple Oracle_home directories on the same host. However, if you run the installer multiple times, Oracle recommends that you choose the same Oracle_home directory for the additional installations to prevent installing multiple versions of the same administrative software.
An Oracle_home inventory or local inventory directory contains only information relevant to a particular Oracle_home. Each Oracle_home directory contains an inventory subdirectory. See "Choosing an Oracle Central Inventory" for more information.
For information on securing the Oracle_home directory, see the Oracle Communications Service Broker Security Guide.
The Oracle central inventory directory contains installation logs corresponding to all installations performed on a particular host. The installation logs for an installation are identified by the timestamp in the log file names.
When you install the first Oracle product on a host, the installer prompts you to specify the location of the central inventory directory:
Linux:
/etc/oraInst.loc
Solaris:
/var/opt/oracle/oraInst.loc
You can run the Service Broker installer using a graphical installation wizard, or in silent mode using a response file.
In graphical mode, you step through the installation GUI screens, providing information in the dialog boxes when prompted. This method is useful when performing a small number of installations.
In silent mode, your installation choices are determined beforehand in a response file, so you can automate the process of installing multiple servers on multiple hosts. Silent mode is also useful for installing on a host that cannot display the graphical installer.
Some Service Broker features require a database for storing persistent data. Service Broker supports either an Oracle 11g DB or a Berkeley DB. See "Software Requirements" for more information.
If you already have either database installed, you can use it. Otherwise, you can install the Berkeley database that is bundled with the installer, or you can provide a compatible Oracle database.
The following Service Broker products and applications require a database.
Online Mediation Controller Degraded Mode and Subscriber Store: Require either an Oracle or a Berkeley Database.
Policy Controller: Subscriber Store Requires either an Oracle or a Berkeley Database.
Social Voice Communicator: Requires an Oracle Database.
Virtual Private Network: Requires an Oracle Database.
You must have a compatible JDK installed on every host that runs a server. During installation you can select one of these certified JDKs that are included with the installer:
Oracle JRockit JDK (64-bit)
Oracle JDK (64-bit)
Note:
JRockit includes a high-performance JVM, profiling, monitoring and diagnostics tools, and predictable latency.You can instead choose to use a compatible JDK that you have already installed. However, for production environments Oracle recommends that you install one of the bundled JDKs.
See "Supported Operating Systems and JDKs" for information about supported JDKs.
To install the Service Broker family of products using Oracle Universal Installer in graphical mode:
In a command shell, as a non-root user, navigate to the installer directory:
installer_directory/
operating_system/Disk1/install
Where:
installer_directory is the directory to which you extracted the product installation archive.
operating_system is the identifier for the operating system you are using, such as sparc64 or linux64.
Enter the following command to start the installer:
./runInstaller
The Oracle Universal Installer wizard appears in graphical mode.
The installer displays a series of screens that prompt you for information that is described in Table 4-1. Follow the instructions in the table.
Table 4-1 Installer Screens in Graphical Mode
In this screen | Perform the following action |
---|---|
Welcome |
Click Next to proceed with the installation. You may cancel the installation at any time by clicking Cancel. |
Specify Home Details |
Specify the name for the installation. For example: ocsb61 Specify the Oracle_home directory that will serve as the parent directory for all Service Broker products installed on the target system. See "Choosing an Oracle Home" for details about the Oracle_home directory. Make sure that the Oracle_home directory has read and write privilleges. If you already have a home directory on your system, you can select that directory (recommended) or create a new home directory. To select an existing home directory:
To create a new Oracle_home directory:
Click Next to continue. |
Product update registration page |
(Optional) Register your installation with My Oracle Support. By registering, Oracle Support notifies you immediately of any security updates that are specific to your installation. To register your installation:
To decline registration:
For more information about the advantages of registering your installation with My Oracle Support, see Oracle Configuration Manager Installation and Administration Guide. Click Next to continue. |
Available Product Components |
Choose the Service Broker products and components to install. You can install any combination of products and components: Products (Choose at least one)
Components (Choose at least one)
Java
Optional Components
|
Available Product Components, continued |
Java. Select a certified JDK to install for use in your production environment or provide a path to your own existing JDK to use in a test and evaluation environment. For test and development environments, multiple Service Broker installations can share a single JDK if they reside on the same machine. See "System Requirements" for details about supported JDKs. Oracle Berkeley DB. If the Service Broker deployment does not require a Berkeley, database clear this option. See "Choosing a Database" for more information. Online Mediation Controller samples: Provides an example integration between a (third-party) Media Server that has IVR functionality and the Online Mediation Controller top-up Web Services API. Service Controller samples: Provides example NGIN (Next Generation Intelligent Network) applications for integration with Oracle Converged Application Server. Example applications include: Ringback Tones, Local Number Portability, Location Service, Presence (state/location of a mobile device), and screening according to the calling and called numbers. Click Next. The Summary screen appears. See Oracle Communications Service Broker Concepts Guide for information about each product option. |
Choose Existing JDK Installation |
This screen is only displayed if you selected an existing JDK instead of installing a new one. Use your own JDK in a test and evaluation environment only. Specify the path to the JDK in the Base directory: field. Click Next to continue. |
Specify Inventory directory and credentials |
This screen is displayed only during the first installation of Oracle products on a system. Specify the full path of the Oracle inventory directory. Choose the operating system group that has write permissions to the inventory directory. Click Next to continue. |
Summary |
This screen displays a summary of the installation, including general information about the installation type, directories, the product components to be installed, the approximate installed size of each component, and the total size of all components to be installed. Click Install. |
Install |
This screen is displayed while the components are being installed. The screen displays the status of the installation. You can cancel the installation at any time by clicking the Stop installation button. |
Execute Configuration scripts |
This screen is displayed only during the first installation of Oracle products on a system. As indicated, run the configuration script, oraInstRoot.sh, in a new console as the root user. The script configures permissions for the Oracle inventory directory. When the script completes the configuration, click the OK button in the Execute Configuration scripts screen. |
End of Installation |
This screen describes the outcome of the installation. Click Exit to exit the installation program. Click Yes to confirm your choice. |
When the installation is completed, the directory structure described in "Directory Structure After Installation" is created on your server.
This section explains how to install the Service Broker family of products using Oracle Universal Installer in silent mode.
Before you run the installer, specify the installation parameters you want to use, such as the Oracle_home directory path and the products and components you want to install, by editing parameters in the silentInstall.properties file.
To learn about the parameters, see the descriptions in the "Installation Parameters in the silentInstall.properties File" section.
Note:
The installer validates format and platform compatibility where applicable. However, it will not check spelling so be sure to enter values into the properties file carefully.If you omit any required value in the properties file, the installer will prompt you to enter the value at the command prompt.
To install Service Broker in silent mode:
In a command shell, navigate to the following directory:
installer_directory/
operating_system/Disk1/install/
Open the silentInstall.properties file for editing, and modify the installation parameters as required. Table 4-2 lists and describes the installation parameters.
Save and close the file.
As a non-root user, enter the following command to start the installer:
./silentInstaller.sh
The installation progress is output to the console.
If this is the first Oracle product installation on this machine, when prompted, follow the on-screen instructions to run the oraInstRoot.sh script located in your /oraInventory
directory. You must run the script as the root user.
The directory structure described in "Directory Structure After Installation" is created on your server.
Table 4-2 lists the installation parameters in silentInstall.properties file that the silent installer uses.
Table 4-2 Parameters in the silentInstall.properties File
Parameter | Description |
---|---|
|
The path to the directory of your Java JDK. If you are installing a JDK with this property file, it is installed in this directory. If you are using your own pre-installed JDK, then reference its path here. The path should be the same as the No default value is specified. Example:
|
|
The name of the installation directory. Mandatory Example:
|
|
The full path to your installation directory. Mandatory This path is from / to and including the parent directory of Example:
|
|
Specifies the Service Broker products to install. Mandatory Components to install using the syntax: {"component:version","component:version"} Where component is the Service Broker product to install and version is its version. The component may be one of the following:
Default value:
Example
|
|
Indicates whether you want to receive security updates related to Oracle products. Boolean. Mandatory Enter true to decline security updates, or false to receive security updates. No default value is specified. Example:
|
|
Indicates whether you want to receive security updates through your Oracle My Oracle Support account. Boolean. Mandatory Enter true to receive security updates using My Oracle Support, or false to decline security updates. If you have not registered with Oracle Support, go to the following My Oracle Support Web site and register to obtain a My Oracle Support account:
No default value is specified. Example:
|
|
Specifies your My Oracle Support email address or other email address where you wish to be notified of updates. Mandatory if No default value is specified. Example:
|
|
Specifies the password for your Oracle support account. Mandatory if No default value is specified. Example:
|
Figure 4-1 illustrates the high-level directory structure that is created during installation.
Table 4-3 describes each directory and its contents.
Table 4-3 Installed Directories and Content Descriptions
Directory | Description |
---|---|
Oracle_home |
Base directory for your installation. Oracle_home is specified during the installation. |
Oracle_home |
Contains binaries for the Administration Server, and the start scripts and modules related to the Administration Console. |
Oracle_home |
Contains binaries for the processing server or signaling server, and the start scripts and modules related to the server. |
Oracle_home |
Contains the Java JDK (with the HotSpot JVM). This directory is created only if you specified to install the Java JDK during the installation. |
Oracle_home |
Contains the Oracle JRockit JDK. This directory is created only if you specified to install the Oracle JRockit JDK during the installation. |
Oracle_home |
Contains the Service Controller and Online Mediation Controller samples.This directory is created only if you specified to install the samples during the installation. |
You can deinstall Service Broker or any of its components by running the Oracle Universal Installer. When you deinstall, the installer removes all files and folders that it originally installed. It does not remove any files and folders you created or modified such as domain directories and configuration files.
See "Deinstalling Using Graphical Mode" for instructions on deinstalling Service Broker or one of its components using Oracle Universal Installer in graphical mode.
See "Deinstalling Service Broker Products Using Silent Mode" for instructions on deinstalling Service Broker or one of its components using Oracle Universal Installer in silent mode.
To deinstall Service Broker or any of its components using the Oracle Universal Installer in graphical mode:
In a command shell, navigate to the installer directory:
installer_directory/
operating_system/Disk1/install
Enter the following command to start the installer:
./runInstaller
Oracle Universal Installer appears in graphical mode.
In the Welcome screen, click Deinstall Products.
The Inventory screen displays all Oracle homes on the host.
In the Contents tab, select the Oracle home or product within the Oracle home that you want to deinstall.
Selecting the Oracle home removes all products within that Oracle home. Alternatively, expand the Oracle home and select individual components within that home to deinstall.
Tip:
To save a text copy of the inventory tree and selected components before you remove components, click Save As. Navigate to a directory where you want to save the tree, enter the file name to use, and click Save.Click Remove.
The Confirmation screen opens.
Click Yes to confirm your selection.
The installer deinstalls the selected components.
Click Close to close the Inventory screen.
To deinstall Service Broker or one of its components in silent mode, you run the runInstaller utility specifying the -deinstall and -silent options.
You can supply deinstallation parameters either at the command line or in a response file. If you want to use a response file, you must prepare the deinstall response file before you run the silent deinstall. The response file is located in the installation directory for your platform:
installer_directory/
operating_system/Disk1/stage/Response/ocsb.Complete.rsp
Table 4-4 describes the parameter-value pairs that you need to set in the installer response file.
Table 4-4 Parameters for Deinstalling Components
Name | Description |
---|---|
|
Specify the component to deinstall. Mandatory Use the following syntax: {“component","version"} where component is the Service Broker product to remove and version is its version. The component value may be one of the following:
Examples:
|
|
The name of the installation directory. Mandatory Example:
|
|
The full path to your installation directory. This path is from / to and including the parent directory of Mandatory Example:
|
|
Caution: If you use this parameter, it will remove the entire installation directory. Specify the full path to the Oracle home directory to remove. Optional Use the following syntax: {path_to_Oracle_home} Example:
|
You can use the runInstaller script to display a list of the installed components and their versions:
In a command shell, navigate to the installer directory:
installer_directory/
operating_system/Disk1/install
Enter the following command:
./runInstaller -deinstall
The installed components are listed in the output.
To deinstall Service Broker or one of its components:
In a command shell, navigate to the installer directory:
installer_directory/
operating_system/Disk1/install
Enter one of the following commands to run the installer.
To specify components to deinstall on the command line, enter:
./runInstaller -deinstall -silent DEINSTALL_LIST='{"
component","version"}'
ORACLE_HOME
={path_to_Oracle_home} ORACLE_HOME_NAME
={name_of_installation_directory}
where component, version, and ORACLE_HOME and ORACLE_HOME_NAME are specified as described in Table 4-4, "Parameters for Deinstalling Components".
Important:
The curly brackets surrounding the DEINSTALL_LIST must be enclosed by single quotes (') on the command line, but do not use single quotes (') if you use the deinstall response file.
If you use the REMOVE_HOMES parameter, the entire installation directory is removed.
For example:
./runInstaller -deinstall -silent DEINSTALL_LIST='{"service_controller","6.1.0.0.0"}' ORACLE_HOME=/home/oracle/OHome1
ORACLE_HOME_NAME=ocsb61
To use an installer response file on the command line in which the components to deinstall are specified, enter:
./runInstaller -deinstall -silent -responseFile
full_path_to_response_file