Skip Headers
Oracle® Communications Converged Application Server Installation Guide
Release 5.1

Part Number E27703-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

4 Installing the Software

This chapter describes how to start the Oracle Communications Converged Application Server installation program in graphical mode in different environments, and describes the sequence of screens that may appear in the installation process, depending on the type of installer you are using and the components you select.

Note:

In order 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 UNIX systems do. If you attempt to start the installation program in graphical mode on a system that cannot support graphical display, the installation program automatically starts in console mode.

This chapter contains the following sections:

Running the Installation Program

The Converged Application Server software must be installed on all server machines that will run an instance of Converged Application Server. Follow these installation procedures for the computers on which you will install the Administration Server and all managed servers.

Additional Installation Features

The installation program provides additional features you can use, depending on your needs and environment, including the following:

  • Choice of installation mode

    This guide shows the graphical-mode installation, the interactive, GUI-based method for installation. Installers also can be run in console mode, which is an interactive, text-based method used from the command line; and silent-mode, which is a non-interactive method that can be run from a script as well as the command line.

  • Option to create a detailed installation log.

    If you launch the installation from the command line or from a script, you can specify the -log option to generate a verbose installation log. The installation log stores messages (informational, warning, error, and fatal) about events that occur during the installation process. This type of file can be especially useful for silent installations.

Complete details about each of these installation features are provided in Oracle WebLogic Server 11g Release 1 (10.3.6) Installation Guide in the Oracle WebLogic Server documentation.

Creating an Installation Log

To create an installation log, add the following option to any of the commands that invoke the installer:

-log=logfile

where logfile is the name you assign to the log file, including an absolute or relative path. A relative path is relative to the directory where the installer is started.

For example, the following command starts the installer in console mode and creates a log file named install_log containing the installation's output.

java -jar occas510_ia_generic.jar-mode=console -log=install_log

Starting the Generic JAR File Installation Program

The Converged Application Server occas510_ja_generic.jar installation program is provided as a single JAR file for use with all supported operating systems.

Note:

No JDK is included in the generic installation. You must have installed a JDK appropriate to your operating system prior to using the JAR file installation program.

To start the JAR installation program, perform the following steps.

  1. Open a command shell.

  2. Go to the directory where you downloaded the installation program.

  3. Launch the installation program by entering the following command:

    java -jar occas510_ia_generic.jar
    
    • Include the -d64 flag in the installation command when using a 32/64-bit hybrid JDK (such as for the Solaris 64 platforms). For example, if installing in graphical mode:

      java -d64 -jar occas510_ja_generic.jar
      
    • If you are using the Sun 64-bit JDK, use the following command to install Converged Application Server:

      java -Xmx1024m -jar occas510_ja_generic.jar
      

    The installation program begins to install the software.

    See "Responding to the Oracle Installer Screens" for a description of each installation program screen.

Starting Platform-Specific Installation Programs on Linux or UNIX

To start the graphical-mode installation process with .bin installation files, follow these steps.

  1. Open a command shell.

  2. Go to the directory that contains the installation program.

  3. Launch the installation by entering the following commands:

    chmod a+x filename.bin

    ./filename.bin

    Where filename.bin is the name of your installation program. For example, for Oracle Communications Converged Application Server 5.1, the name of the Package installer file for Linux is occas510_ia_linux32.bin. Substitute the appropriate filename for the installation program you have obtained

    The installation program begins to install the software.

    See "Responding to the Oracle Installer Screens" for a description of each installation program screen.

Starting the Installation Program on Windows

To start the installation program in graphical mode on a Windows platform, follow these steps.

  1. Log in to the Windows system.

  2. Go to the directory that contains the installation program.

  3. Double-click the installation program occas510_ia_win32.exe.

    The installation program begins to install the software.

Using the Silent Mode Installer

Silent-mode installation is a way of choosing installation settings once and then using those settings to duplicate the installation on many machines. During installation in silent mode, the installation program reads your settings from an XML file that you create prior to beginning the installation. The installation program does not display any options during the installation process. Silent-mode installation works on both Windows and Linux/UNIX systems.

For general information on silent-mode installation, on WebLogic Server see “Running the Installation Program in Silent Mode” in Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server at:

About the silent.xml file

The entries in the silent.xml file correspond to the prompts that you would see if you used one of the interactive modes.

Incorrect entries in the silent.xml file can cause installation failures. To help you determine the cause of a failure, we recommend that you create a log file when you start the installation

The following is a sample version of a silent.xml file. Your input may be slightly different, depending on your installation.

<?xml version="1.0" encoding="UTF-8" ?>
  <bea-installer>
  <input-fields>
    <data-value name="BEAHOME" value="d:/occas" />
    <data-value name="INSTALL_NODE_MANAGER_SERVICE" value="no" /> 
    <data-value name="WLNGEclipseConfig.dir" value="d:/eclipse/plugin"/>
    <data-value name="LOCAL_JVMS" value="C:\oracle\java\jdk160_18">
    </input-fields>
  </bea-installer>

The following error can be ignored:

com.bea.plateng.domain.script.ScriptException: The template to read must be a jar file containing a valid domain configuration

See the Oracle WebLogic Server Installation Guide for more information.

Returning Exit Codes to the Console

When run in silent mode, the installation program generates exit codes that indicate the success or failure of the installation. Table 4-1 describes these exit codes:

Table 4-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 are launching the silent-mode installation process from a script, you can choose to have these exit codes displayed to the console. The following is a sample command file that invokes the WebLogic Platform installation in silent mode and echoes the exit codes to the console from which the script is executed.

Example 4-1 Return exit codes

rem Execute the installer in silent mode
@echo off
occas510_win.exe -mode=silent  -silent_xml=silent.xml -log=logfilename

@rem Return an exit code to indicate success or failure of installation
set exit_code=%ERRORLEVEL%

@echo.
@echo Exitcode=%exit_code%
@echo.
@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
@echo.

Running the Silent-Mode Installer on All Platforms

To run the silent mode installer:

  1. Create a silent.xml file, as described in "About the silent.xml file".

  2. To run the silent installer, do one of the following:

    • To start the platform-specific Windows 32 installer in silent mode, enter:

      occas510_win.exe -mode=silent -silent_xml=silent.xml [-log=logfilename]
      
    • To start the generic 32/64 -bit hybrid installer in silent mode, enter:

      java -d64 -jar occas510_generic.jar -mode=silent -silent_xml=silent.xml [-log=logfilename]
      
    • To start the generic /64 -bit hybrid installer in silent mode, enter:

      java -Xmx1024m -jar occas510_generic.jar -mode=silent -silent_xml=silent.xml [-log=logfilename]
      

    The installation proceeds with no prompts.

Responding to the Oracle Installer Screens

The installation program displays a series of screens prompting for information from which to install the Converged Application Server software. To install the software, see the Oracle WebLogic Server Installation Guide in the Oracle WebLogic Server documentation for information on responding to the installation program prompts.

Using the GUI Installer

To run the generic GUI-based installer:

  1. After the installer starts, the Welcome window appears.

    You can cancel the installation at any time by clicking Exit.

  2. In the Welcome window, click Next to proceed with the installation.

    The Choose Middleware Home Directory window appears.

    The Middleware Home directory is the central support directory for all Oracle Middleware products installed on the target system.

  3. Do one of the following:

    • To install into an existing Middleware home:

      1. Select Use an existing Middleware Home.

      2. From the list of existing Middleware home directories, select a directory.

      3. Click Next.

        The Register for Security Updates window appears.

    • To create a new Middleware home:

      1. Select Create a new Middleware Home.

      2. In the Middleware Home Directory field, enter the path for the new Middleware home directory.

      3. Click Next.

        The Register for Security Updates window appears.

  4. In the Register for Security Updates window, enter your e-mail and Oracle Support password to be informed of security issues related to Converged Application Server and WebLogic Server.

    If you chose not to register, an Are You Sure? dialog box appears. Click Yes to continue.

  5. Click Next.

  6. In the Choose Install Type window, do one of the following:

    • Select Typical to install all components included with Converged Application Server and WebLogic Server.

    • Select Custom to customize the installation so that only products and components you choose are installed.

      1. Click Next.

      2. In the Choose Products and Components window, clear the checkbox for any component you do not wish to install.

      3. Click Next.

      4. In the JDK Selection window, check the checkbox for the JDK to install if you want to use a bundled JDK.

      5. In the JDK Selection window, click Browse... and navigate to the Java Home directory for an already installed JDK if you want to use that. Make sure you check the checkbox for the local JDK.

  7. Click Next.

    The Choose Product Installation Directories window appears.

  8. In the entry fields, enter the directories in which you want to install the Converged Application Server and WebLogic Server software.

  9. Click Next.

    The Installation Summary window appears.

  10. Make sure that the Installation Summary reflects all the products that you have chosen to install.

    If the list is not correct, you can use the Previous button to navigate back so you can make corrections.

  11. Click Next to start the installation.

    A progress bar indicates the status of the installation process.

  12. When the Installation Complete window appears, click Done.

    The installer exits.

  13. After installation is complete, set the WL_HOME variable to the directory in the product installation directory that you specified for WebLogic Server.

Where to Go From Here

After installing Converged Application Server, you must configure the Converged Application Server domain for your deployment. See Chapter 5, "Creating and Configuring a Domain" for more information.