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 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 ZIP file and extract occas_generic.jar.
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 Setup 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 Auto Updates screen appears.
If you already have an Oracle Technical Support account, use this screen to indicate how you would prefer to receive product and security updates.
Either enter your account details or select Skip Auto Updates, then 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 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.
At this point, Converged Application Server and Oracle WebLogic Server are installed and WebLogic Server is patched with patch set update 12.2.1.3.190416.
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] #Set this to true if you wish to skip software updates DECLINE_AUTO_UPDATES=true #My Oracle Support User Name MOS_USERNAME= #My Oracle Support Password MOS_PASSWORD=<SECURE VALUE> #If the Software updates are already downloaded and available on your local system, then specify the path to the directory where these patches are available and set SPECIFY_DOWNLOAD_LOCATION to true AUTO_UPDATES_LOCATION= #Proxy Server Name to connect to My Oracle Support SOFTWARE_UPDATES_PROXY_SERVER= #Proxy Server Port SOFTWARE_UPDATES_PROXY_PORT= #Proxy Server Username SOFTWARE_UPDATES_PROXY_USER= #Proxy Server Password SOFTWARE_UPDATES_PROXY_PASSWORD=<SECURE VALUE> #The oracle home location. This can be an existing Oracle Home or a new Oracle Home ORACLE_HOME=/home/wenxili/lwx_work/software/occas/install/occas710_test/occas710 #The federated oracle home locations. This should be an existing Oracle Home. Multiple values can be provided as comma seperated values FEDERATED_ORACLE_HOMES= #Set this variable value to the Installation Type selected. e.g. Converged Application Server, Complete with Examples. INSTALL_TYPE=Converged Application Server
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.