4 Converged Application Server Pre-Installation Tasks

This chapter describes tasks you must complete before installing Oracle Communications Converged Application Server.

About Pre-Installation Tasks

You must perform certain tasks before installing Converged Application Server. Pre-installation tasks are broken down into the following categories:

Pre-Installation Tasks for All Converged Application Server Systems

Before installing the Converged Application Server software, complete the following pre-installation tasks:

General Pre-Installation Tasks

Complete the following general pre-installation tasks:

  • Allocate IP addresses for Converged Application Server interfaces, including:

    • Public-facing external interfaces

    • Internal-facing interfaces

    • Intra-system interfaces for private signaling between Converged Application Server nodes

    • If required by your organization, a separate systems management interface

  • Determine which logical interfaces map to which physical interfaces on each server.

  • Have access to a Domain Name Service (DNS) and Network Time Protocol (NTP) servers.

  • Optionally assign fully qualified domain names to each server.

  • Make a note of any required static routes.

Choosing an Installation Directory

When you install Converged Application Server, you are prompted to specify a Oracle_home directory. This directory serves as a repository for common files that are used by multiple Fusion Middleware products installed on the same machine. For this reason, the Oracle_home directory can be considered a central support directory for all of the Fusion Middleware products installed on your system.

The files in the Oracle_home directory are essential to ensuring that Converged Application Server and WebLogic Server operate correctly on your system. They facilitate checking of cross-product dependencies during installation.

For more information about selecting an installation directory, see "Understanding the Oracle WebLogic Server and Coherence Directory Structure" in Installing and Configuring Oracle WebLogic Server and Coherence.

Installing the Java Development Kit

Install Oracle Java Development Kit (JDK) plus the latest security update on each physical machine or VM in your Converged Application Server system. For a list of supported versions, see "Software Requirements".

To install and configure your JDK:

  1. Download the JDK from the Java SE Development Kit Downloads page at:

    http://www.oracle.com/technetwork/java/javase/downloads/

  2. Install the JDK per instructions provided with it.

  3. Add the JDK bin directory to the beginning of the PATH variable definition on the target system. For example:

    PATH=$JAVA_HOME/bin:$PATH
    export PATH
    

Pre-Installation Tasks for Proxy Registrar Domains

If your Converged Application Server system will use a Proxy Registrar domain, you must install and configure either an Oracle or MySQL database for use as a JDBC data source.

Before installing the Converged Application Server software, complete the following pre-installation tasks:

Creating an Oracle Database

Create two Oracle schemas. Create one for the Registrar bindings, and another for the User Service and Security Service. For instructions about installing the Oracle database software, creating a schema, and granting user privileges, see the Oracle database documentation.

Notes:

  • Oracle recommends that you create two schemas. However, you can choose to create a single schema for all of the Converged Application Server data sources, or you can create three schemas, with one for each data source. The choice you make depends on your database management preferences.

  • The following, abbreviated instructions are intended to provide an overview of the procedures to create a database for use with Converged Application Server. Refer to the documentation for your Oracle database deployment for information about creating a schema and granting privileges.

To create an Oracle database user:

  1. Start SQL*Plus (the Oracle SQL command-line tool).

  2. Log in to the Oracle database as an administrative user with sufficient privileges to create new database users.

  3. Create the users that you need in the database by entering the following command in SQL*Plus:

    SQL> CREATE USER username IDENTIFIED BY password DEFAULT TABLESPACE 
    user_tablespace TEMPORARY TABLESPACE temp_tablespace;
    

    Where username is the name identifying the database account to use when connecting to the database, password is the password associated with the user name, and temp_tablespace is the temporary tablespace to use when storing temporary tables.

  4. Grant the following privileges to the users you create for use with Converged Application Server:

    SQL> GRANT CREATE SESSION, CREATE TABLE, CREATE SEQUENCE TO username;
    SQL> ALTER USER username QUOTA UNLIMITED ON user_tablespace;
    
  5. Exit SQL*Plus.

Creating a MySQL Database

Create two MySQL databases. Create one database for the Registrar bindings, and another database for the User Service and Security Service. For instructions about installing the MySQL database software, creating a database, and granting user privileges, see the MySQL database documentation.

Notes:

  • Oracle recommends that you create two databases. However, you can create a single database for all of the Converged Application Server data sources, or you can create databases, with one for each data source. The choice you make depends on your database management preferences.

  • The following, abbreviated instructions are intended to provide an overview of the procedures to create a database for use with Converged Application Server. Refer to the documentation for your MySQL database deployment for information about creating databases and granting privileges.

  • If the MySQL database is installed on a case-sensitive operating system such as Linux or Solaris, set the MySQL variable lower_case_table_names to 1 to ensure that MySQL is case insensitive. For example:

    set-variable=lower_case_table_names=1
    

    For more information, see the documentation for your MySQL database deployment.

To create a MySQL database:

  1. Log in to the MySQL database as an administrative user.

  2. Create a MySQL database:

    mysql> CREATE DATABASE database_name;
    

    Where database_name is a label (or name) that you specify to identify the database.

  3. Verify that the database was created:

    mysql> SHOW DATABASES;
    
  4. Grant the following connect and resource privileges to the databases you create:

    mysql> GRANT ALTER, CREATE, DELETE, INDEX, INSERT, LOCK TABLES, SELECT, UPDATE ON database_name.* TO 'username'@'hostname' 
           IDENTIFIED BY 'password' WITH GRANT OPTION;
    

    Where username is the name identifying the database account to use when connecting to the database, password is the password associated with the username, and hostname identifies the network address of the host computer running that database.

  5. Exit MySQL:

    exit;
    

Recording Your Database Information

When you install and configure a database, you define system configuration values that you enter when you install and configure the Converged Application Server software. When you create the following values, write them down so you can use them during the installation process:

  • Vendor: The database vendor's name. For Converged Application Server, either Oracle or MySQL.

  • JDBC driver: The JDBC driver to use to connect to the database.

  • Database username: The user name for connecting to the database.

  • Database user password: The password for the specified user name.

  • Database SID or database name: If you are using an Oracle database, this is the Database System Identifier. If you are using a MySQL database, this is the name of the database.

  • Host name: The name or IP address assigned to the server hosting the database.

  • Port: The port number for connecting to the database. The default port numbers are port 1521 for the Oracle database, and port 3306 for the MySQL database.

Creating the Converged Application Server User Account

Create a user account for the primary user running Converged Application Server in your environment. All machines in your system must use the same user name.

To create the Converged Application Server user account:

  1. Log in to the target machine.

  2. Enter the following command:

    useradd passwd user_name
    

    where user_name is the name of the user, and passwd is the password for the user.

  3. Write down the user name. You will need to specify the user name when you install Converged Application Server.

Next Steps

After you complete the pre-installation tasks, install Converged Application Server. See "Installing Converged Application Server" for instructions.