This chapter describes how to install the Oracle Communications Converged software.
Before you install Converged Application Server, complete all pre-installation tasks described in "Converged Application Server Pre-Installation Tasks".
You can install Converged Application Server by using the GUI installation or the silent installation. The silent installation enables you to perform a non-interactive installation of Converged Application Server. You can use the silent installation to install Converged Application Server quickly on multiple systems.
For installation instructions, see the following sections:
To run the installation program in graphical mode, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for Solaris and Linux systems do.
To install Converged Application Server:
Log in to the target machine.
Download the Converged Application Server software from the Oracle software delivery website at:
Go to the directory where you downloaded the installation program.
Launch the installation program by entering the following command from the JDK directory on your system:
java -jar occas_generic.jar
The installation program starts.
If no other Oracle products are installed on the system, the Installation Inventory screen appears. Specify the location where you want to create your central inventory. Make sure that the operating system group name selected on this screen has write permissions to the central inventory location.
For more information about the central inventory, see "Understanding the Oracle Central Inventory" in Installing Software with the Oracle Universal Installer.
If an Installation Inventory exists, the Oracle Communications Converged Application Server Installation Welcome screen appears.
Click Next.
The Installation Location screen appears.
Use this screen to specify the location of your Oracle home directory.
For more information about the Oracle Fusion Middleware directory structure, see "Selecting Directories for Installation and Configuration" in Planning an Installation of Oracle Fusion Middleware.
Click Next.
The Installation Type screen appears.
Select one of the following options:
Converged Application Server Installation: This option includes everything you need to install, configure, and run Converged Application Server.
Complete Installation: In addition to the Converged Application Server software, this option also includes example converged applications. The examples are installed in your Oracle_home/occas/samples/sipserver/examples directory. Oracle_home is the directory that serves as the repository for common files that are used by Oracle Communications products installed on the same machine, such as Converged Application Server and WebLogic Server. For more information about the examples, see Converged Application Server Developer's Guide.
Click Next.
The Prerequisite Checks screen appears.
This screen verifies that your system meets the minimum requirements.
If there are any warnings or errors, make sure that your environment meets all of the prerequisites. See "Converged Application Server System Requirements" for more information.
Click Next.
The Security Updates screen appears.
If you already have an Oracle Technical Support account, use this screen to indicate how you would prefer to receive security updates.
If you do not have one and are sure you want to skip this step, clear the check box and verify your selection in the follow-up dialog box.
Click Next.
The Installation Summary screen appears.
Use this screen to verify the installation options you selected. If you want to save these options to a response file, click Save Response File and provide a location and name for the response file. Response files can be used later in a silent installation.
Note:
If you only want to save a response file, exit the installer now.For more information about silent installation, see "Installing Converged Application Server Using the Silent Installation".
Review the selections you have made, and click Install.
The Installation Progress screen appears and the installation begins.
Note:
After the installation begins, if you click Cancel, the installation process stops but the files that are already copied are not removed.When the installation completes, click Next.
The Installation Complete screen appears.
The next step is to launch the configuration wizard to create your WebLogic Server domain. There are two ways to launch the configuration wizard:
Select Automatically Launch the Configuration Wizard on this screen. After you click Finish to close the installer, the configuration wizard starts and you can begin to configure your domain. Proceed to "Creating a Converged Application Server Domain".
Do not select Automatically Launch the Configuration Wizard on this screen. After you click Finish to close the installer, manually start the configuration wizard to begin configuring your domain. Proceed to "Starting the Configuration Wizard".
Silent mode is a way of setting installation options once and then using those settings to duplicate the installation on many machines. The installation program reads your settings from a Response File that you create before you begin installation. The installation program does not display any options during the installation process.
The entries in the Response File (response.rsp) correspond to the prompts that you would see if you used GUI mode.
Incorrect entries in response.rsp can cause installation failures. To help you determine the cause of a failure, Oracle recommends that you create a log file when you start the installation.
The following shows a sample version of a response.rsp file. Your input may be slightly different, depending on your installation.
[ENGINE]
#DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0
[GENERIC]
#The Oracle home location. This can be an existing Oracle Home or a new Oracle Home
ORACLE_HOME=Oracle_home
#Set this variable value to the Installation Type selected. e.g. Converged Application Server.
INSTALL_TYPE=Converged Application Server
#Provide the My Oracle Support Username. If you wish to ignore Oracle Configuration Manager configuration provide empty string for user name.
MYORACLESUPPORT_USERNAME=
#Provide the My Oracle Support Password
MYORACLESUPPORT_PASSWORD=<SECURE VALUE>
#Set this to true if you wish to decline the security updates. Setting this to true and providing empty string for My Oracle Support username
will ignore the Oracle Configuration Manager configuration
DECLINE_SECURITY_UPDATES=true
#Set this to true if My Oracle Support Password is specified
SECURITY_UPDATES_VIA_MYORACLESUPPORT=false
#Provide the Proxy Host
PROXY_HOST=
#Provide the Proxy Port
PROXY_PORT=
#Provide the Proxy Username
PROXY_USER=
#Provide the Proxy Password
PROXY_PWD=<SECURE VALUE>
#Type String (URL format) Indicates the OCM Repeater URL which should be of the format [scheme[Http/Https]]://[repeater host]:[repeater port]
COLLECTOR_SUPPORTHUB_URL=
The silent installation program generates exit codes that indicate the success or failure of the installation. Table 5-1 describes these exit codes:
Table 5-1 Installation Program Exit Codes
| Code | Description |
|---|---|
|
0 |
Installation completed successfully. |
|
-1 |
Installation failed due to a fatal error. |
|
-2 |
Installation failed due to an internal XML parsing error. |
If you start the silent installation process from a script, you can have these exit codes displayed to the console. Example 5-1 shows a sample command file that runs the WebLogic Platform installation while in silent mode and echoes the exit codes to the console from which the script is executed.
#!/bin/bash
#rem Execute the installer in silent mode
java -jar occas_generic.jar -silent -responseFile /home/user/bin/response.rsp
exit_code=$?
echo ${exit_code}
echo Exit Code Key
echo ---------------
echo 0=Installation completed successfully
echo -1=Installation failed due to a fatal error
echo -2=Installation failed due to an internal XML parsing error
rem Execute the installer in silent mode
To perform a silent installation:
Log in to the target system.
Download the Converged Application Server software from the Oracle software delivery website at:
Create a response file, as described in "About the Response File".
Go to the directory where you downloaded the Converged Application Server software.
Start the installer by entering the following command:
java -jar occas_generic.jar -silent -responseFile ResponseFile
The installer checks for all required software and writes errors to a log file if it detects any missing or unavailable components, or if there are any connectivity-related issues.
Check whether the installer completed successfully by retrieving the exit codes, as described in "Returning Exit Codes to the Console".
After you install Converged Application Server, you must configure a Converged Application Server domain. See "Creating and Configuring Converged Application Server Domains" for instructions.