Sign In

Table
Homeof/ Contents
Communications / Oracle Communications ASAP, Release 7.3
Oracle Communications ASAP Installation Guide

Communications ASAP Installation Guide

Preface

ASAP Installation Overview

Planning Your ASAP Installation

Page 8 of 16
ASAP System Requirements

Configuring the Operating System

Installing and Configuring Oracle

Database and Client
Installing and Configuring Oracle WebLogic
Server 5 Installing and Configuring Oracle Database and Client
Installing ASAP
This chapter describes the tasks relating to the Oracle database that you perform before installing Oracle Communications ASAP.
Installing the Order Control Application
Client
ASAP Post-Installation Tasks

Verifying the ASAP Installation

About Creating and Configuring the Oracle Database
Upgrading ASAP The ASAP Installer checks for a database to connect to during the installation process. Ensure that a database is up and running before you start
Uninstalling ASAP installing ASAP. If you already have a database up and running, create one or more tablespaces for the ASAP schemas data and index segments.

Pre-Production Checklist
For information about installing Oracle Database, see the Oracle Database installation documentation.
Index
Oracle recommends that the installation and configuration of Oracle Database be performed by an experienced Oracle Database Administrator
(DBA). In addition, some UNIX administrative skills are required to uncompress software, create users and groups, and similar tasks.
Feedback Download

Share to:
Downloading and Installing the Oracle Database Software
Oracle requires that you use the 64-bit Oracle database software.

To download and install the 64-bit Oracle database software:

1. Sign on to the My Oracle Support web site:

https://support.oracle.com/CSP/ui/flash.html

2. Click the Patches and Updates link.

The Patch Search screen appears.

3. In the Patch Name or Number field, enter 17694377 and click Search.

The patchset list appears.

4. Select Patch 17694377: 12.1.0.2.0 PATCH SET FOR ORACLE DATABASE SERVER for the 64-bit version of your platform.

5. Click Download.

The File Download screen appears.

6. Click p17694377_121020_platform_1of8.zip and p17694377_121020_platform_2of8.zip for the database (where platform is the 64-bit
version of the operating system).

Specifically, the files to download for each platform are:

Select Platform (64-bit) Download Files

Linux x86-64 p17694377_121020_Linux-x86-64_1of8.zip

p17694377_121020_Linux-x86-64_2of8.zip

Oracle Solaris on SPARC (64-bit) p17694377_121020_SOLARIS64_1of8.zip

p17694377_121020_SOLARIS64_2of8.zip

HP-UX Itanium p17694377_121020_HPUX-IA64_1of8.zip

p17694377_121020_HPUX-IA64_2of8.zip

IBM AIX on POWER Systems (64-bit) p17694377_121020_AIX64-5L_1of8.zip

p17694377_121020_AIX64-5L_2of8.zip

A download progress screen appears.

7. Install the database according to an Oracle database installation guide applicable to your installation requirements.

Downloading and Installing the Oracle Client Software

Oracle requires that you use the 32-bit Oracle Client software, even if ASAP is installed on a 64-bit platform. You must install either the 12.1.0.2 or
11.2.0.4 version of the Oracle Client software.

Downloading Oracle Client Software for Oracle Client 12.1.0.2

To download and install the 32-bit Oracle Client software for Oracle Client 12.1.0.2:

1. Sign on to the My Oracle Support web site:

https://support.oracle.com/CSP/ui/flash.html

2. Click the Patches and Updates link.

The Patch Search screen appears.

3. In the Patch Name or Number field, enter 17694377 and click Search.

The patchset list appears.

4. Select Patch 17694377: 12.1.0.2.0 PATCH SET FOR ORACLE DATABASE SERVER for the 32-bit version of your platform (even if
your platform is 64-bit).

5. Click Download.

The File Download screen appears.

6. Click one of the following files for the Oracle database client:

Select Platform (32-bit) Download File

Linux x86 p17694377_121020_LINUX.zip

Oracle Solaris on SPARC (32-bit) p17694377_121020_SOLARIS.zip

HP-UX Itanium (32-bit) p17694377_121020_HPUX-IA32.zip

IBM AIX on POWER Systems (32-bit) p17694377_121020_AIX.zip

A download progress screen appears.

7. Install the client according to the installation instructions in the downloaded ZIP file.

Note:
Oracle recommends using the Administrator Installation Type for your client.

Note:
Oracle Database defines NLS (National Language Support) values to set up language-specific databases. Ensure that the
Oracle Database server and the Oracle Database client use the same NLS_LANG settings. This improves performance
because there is no translation of character sets.

8. Run the Net Configuration Assistant (netca) and perform Local Net Service Name configuration, to ensure that the database client can
connect to your database server.

9. After you install Oracle Client 12.1.0.2, go to the Oracle_Client_Home/lib directory and add a libnnz11.so symbolic link:

cd Oracle_Client_Home/lib
ln -s libnnz12.so libnnz11.so

Note:
The ASAP installation will not work if you do not add libnnz11.so to the Oracle_Client_Home/lib directory of the Oracle 12c
client.

Downloading Oracle Client Software for Oracle Client 11.2.0.4

To download and install the 32-bit Oracle Client software for Oracle Client 11.2.0.4:

1. Sign on to the My Oracle Support web site:

https://support.oracle.com/CSP/ui/flash.html

2. Click the Patches and Updates link.

The Patch Search screen appears.

3. In the Patch Name or Number field, enter 13390677 and click Search.

The patchset list appears.

4. Select Patch 13390677: 11.2.0.4.0 PATCH SET FOR ORACLE DATABASE SERVER for the 32-bit version of your platform (even if
your platform is 64-bit).

5. Click Download.

The File Download screen appears.

6. Click one of the following files for the Oracle database client:

Select Platform (32-bit) Download File

Linux x86 p13390677_112040_LINUX_4of7.zip

Oracle Solaris on SPARC (32-bit) p13390677_112040_SOLARIS_1of2.zip

HP-UX Itanium (32-bit) p13390677_112040_HPUX-IA32_1of2.zip

IBM AIX on POWER Systems (32-bit) p13390677_112040_AIX_1of2.zip

A download progress screen appears.

7. Install the client according to the installation instructions in the downloaded ZIP file.

Note:
Oracle recommends using the Administrator Installation Type for your client.

Note:
Oracle Database defines NLS (National Language Support) values to set up language-specific databases. Ensure that the
Oracle Database server and the Oracle Database client use the same NLS_LANG settings. This improves performance
because there is no translation of character sets.

8. Run the Net Configuration Assistant (netca) and perform Local Net Service Name configuration, to ensure that the database client can
connect to your database server.

Installing, Creating, and Configuring an ASAP Database Instance

(Single or Oracle RAC)
This section describes the overall workflow for creating and configuring a single database instance or an Oracle Real Application Clusters (RAC)
database instance for use with ASAP.

To install, create, and configure Oracle RAC or Single database instance for ASAP:

1. After installing the Oracle database and client, apply any appropriate software patches.

Note:
See "Patch Requirements" for the required software patches.
Some of the scripts that run with Oracle Database patch installation can take several hours to complete. Plan accordingly, and
ensure that all patch scripts run correctly to completion and return to the UNIX prompt.

2. Create a database instance.

Note:
Review and apply recommended database instance initialization parameters listed in "Configuring the Oracle Database
Initialization Parameters". Some default database initialization parameters must be configured for ASAP to run.
For an Oracle RAC database, follow the additional database connection recommendations described in "Configuring Oracle
RAC Database Connectivity."

3. Ensure that you have determined the database tablespace and Oracle Database Server configuration that you require. See "Configuring
the Oracle Database Connection Mode."

4. Start the Oracle Database instance.

5. Create one or more ASAP tablespaces and redo log files. (Oracle recommends that your Oracle DBA create the ASAP tablespaces.)

For more information, see "Recommended Tablespace and Redo Log Sizes for ASAP" and "Creating Oracle Database Tablespaces,
Tablespace User, and Granting Permissions."

6. Switch to an Oracle Database admin account (for example, SYS) and execute the ora_system_procs.sh script to populate the common
PL/SQL functions used by multiple instances of ASAP.

Note:
The ASAP_src/asap_utils/ora_system_procs.sh script should not be run more than once against a single Oracle Database
server.

7. Verify the Oracle Database installation and configuration.

Configuring the Oracle Database Connection Mode

Configure your Oracle database to accept connections from ASAP using the dedicated connection mode. For each Oracle database connection, a
dedicated server process is created which does work on behalf of the ASAP user session. All interactions with the Oracle Shared Global Area (SGA)
and data files are done through this dedicated server processes. A server process is started for every user session connecting to the database.

Configuring the Oracle Database Maximum Memory Target

Table 5-1 provides the recommended Oracle database maximum memory target for the automatic memory manager (AMM). You can set this value
when you create your database using the dbca utility.

Table 5-1 RDBMS server configurations for ASAP

System Size Automatic Maximum Memory Target Number of Sessions

Small 4 GB 100-120 per development instance.

Medium 8 GB 800 per high performance production ASAP

instance.

Large 16 GB -

Configuring the Oracle Database Initialization Parameters

In Oracle Database instance installations, you can use either init$ORACLE_SID.ora or spfile$ORACLE_SID.ora.to specify initialization parameters.

The most secure way of modifying Oracle Database parameters, is to specify them on the SQL*PLUS command line, storing them in the spfile. This
way, each modification is parsed as you enter it and the parameters are correctly entered.

To show the value of a parameter in the spfile, and then change it, use the following procedure:

1. Start sqlplus.

2. Log in using /as sysdba.

3. Enter:

SHOW PARAMETER PROCESSES

ALTER SYSTEM SET PROCESSES='200' SCOPE=spfile;

To show all parameters that start with certain characters, use a common abbreviation. For example, the following command shows all parameters
that start with DB.

SQL> SHOW PARAMETER DB

Note:
Some parameters will not take effect until the database instance is stopped, and then restarted. The command startup force can
accomplish this.

To manually edit parameters in the init$ORACLE_SID.ora file, convert it to an spfile.

Note:
Do not manually edit the spfile$ORACLE_SID.ora. Editing an spfile corrupts it. This can prevent you from starting an instance, or cause
an active instance to fail.

To convert the INIT.ora file to an spfile:

1. Start sqlplus.

2. Log in using as sysdba for the user-name.

sqlplus sys/password as sysdba

Where password is the password for your sys database user account.

3. Enter:

create spfile from pfile;

File created.

CREATE SPFILE [='spfile_name'] FROM PFILE [='pfile_name'];

COMMIT;

To return parameters to the INIT.ORA type parameter file from an spfile:

1. Start sqlplus.

2. Log in using as sysdba for the user-name.

sqlplus sys/password as sysdba

3. Enter:

create pfile from spfile;

File created.

CREATE PFILE [='pfile_name'] FROM SPFILE [='spfile_name'];

COMMIT;

Recommended Oracle Database Initialization Parameter Settings

This section provides recommended Oracle Database initialization parameter values for use with ASAP in a production system. The suggested
values are guidelines only. The optimum values for your system will depend on the particulars of your installation, and your processing requirements.

Table 5-2 lists suggested Oracle Database initialization parameter values.

Note:
You must configure the following parameters. However, the particular values you implement will depend on your chosen configuration.

Table 5-2 Database Initialization (init$ORACLE_SID.ora) Parameters

Parameter and Value Description

PROCESSES =500 (small) 1000 (medium), 3000 (large with under 14 PROCESSES specifies the maximum number of operating system user
NEP server), and 5000 (large with over 14 NEP servers) processes that can simultaneously connect to Oracle Database. Its
value should allow for all background processes such as locks, job
queue processes, and parallel execution processes.

The default values of the SESSIONS and TRANSACTIONS

parameters are derived from this parameter. Therefore, if you change
the value of PROCESSES, you should evaluate whether to adjust the
values of those derived parameters.

For more information on Configuration Variables, see the ASAP

System Administrator's Guide.

SESSIONS = 1600 This parameter sets the maximum number of connections to the Oracle
Database.
or up to 600 per online instance (production)

100 - 120 per online instance (development)

COMMIT_WAIT = 'WAIT' This parameter controls when the redo for a commit is flushed to the
redo logs.

FILESYSTEMIO_OPTION = 'SETALL' Specifies I/O operations for file system files.

Creating Oracle Database Tablespaces, Tablespace User, and

Granting Permissions
In "ASAP Oracle Database Tablespace Sizing Requirements" you determine how you will map ASAP server schemas to tablespaces, what the
tablespaces will be named, and what their size requirements are.

Typically, all environments for testing can share the tablespaces. However, in Oracle Database you can distribute the ASAP components by
specifying different default tablespaces for each environment before installing the ASAP database definitions.

Some ASAP implementations may require a tablespace layout that differs from the layout recommended here. The ASAP administrator, in
conjunction with the Oracle DBA, can create any tablespace layout that is required.

Oracle recommends that tablespaces be created with the following default properties:

Size – as determined using the sizing information provided in "Recommended Tablespace and Redo Log Sizes for ASAP."

Storage Clause:

Initial 256 GB

Next 256 KB

Percent increase 0

Maxextents Unlimited

Note:
In development systems, a database can remains idle for longer than the default database connection time-out setting. This can cause the
database to terminate the connections to the ASAP servers generating the ORA-02396 event. This scenario can be avoided by setting the
database connection time-out parameter to a higher value.
This scenario is unlikely to occur in a production system.

To create the tablespaces, tablespace users, and grant permissions in the Oracle Database:

1. Log in to your Oracle database as a sysdba.

2. Start the Oracle database.

3. Create the tablespaces.

For example:

create tablespace "ASAPDATA_TS" logging datafile '/u01/app/oracle/oradata/ASAP72/ASAPDATA_TS1.dbf' size 3199

create tablespace "ASAPINDEX_TS" logging datafile '/u01/app/oracle/oradata/ASAP72/ASAPINDEX_TS1.dbf' size 31

CREATE USER "ASAP_SYS" PROFILE "DEFAULT" IDENTIFIED BY "ASAP_SYS" DEFAULT TABLESPACE "ASAPDATA_TS" TEMPORARY

GRANT CREATE ANY CONTEXT TO "ASAP_SYS" WITH ADMIN OPTION;

GRANT CREATE ANY TABLE TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT CREATE ANY VIEW TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT CREATE SNAPSHOT TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT CREATE SYNONYM TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT CREATE TABLE TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT CREATE USER TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT CREATE VIEW TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT GRANT ANY PRIVILEGE TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT QUERY REWRITE TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT UNLIMITED TABLESPACE TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT SELECT ON "SYS"."V_$PARAMETER" TO "ASAP_SYS" WITH GRANT OPTION;
GRANT "CONNECT" TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT "DBA" TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT "EXP_FULL_DATABASE" TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT "IMP_FULL_DATABASE" TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT "RESOURCE" TO "ASAP_SYS" WITH ADMIN OPTION;
GRANT EXECUTE ON SYS.DBMS_LOCK TO "ASAP_SYS" WITH GRANT OPTION;
GRANT SELECT ON DBA_TABLESPACES TO "ASAP_SYS" WITH GRANT OPTION;

Creating Oracle Database Users

Each ASAP server schema requires an Oracle user name and password. You can pre-configure these accounts and supply the needed information
during the installation; however, this step is optional. The ASAP installation will automatically create the needed users unless you indicate they have
already been created.

To create the Oracle Database users using SQL Plus commands:

1. Start SQL Plus and log in as the Oracle admin user.

sqlplus -s Oracle_admin/Oracle_admin_pw@Oracle_SID

Where Oracle_admin and Oracle_admin_pw is an Oracle Database administration account and password and Oracle_SID is the Oracle
Database SID.

2. Create the users. In the example below, you would replace the ASAP_envID tags with the actual ASAP environment ID you want to use
when you install ASAP.

create user admASAP_envID identified by admASAP_envID default tablespace Tablespace_name temporary tablespac
grant connect, resource, unlimited tablespace to admASAP_envID ;
create user sarmASAP_envID identified by sarmASAP_envID default tablespace Tablespace_name temporary tablesp
grant connect, resource, unlimited tablespace to sarmASAP_envID ;
create user nepASAP_envID identified by nepASAP_envID default tablespace Tablespace_name temporary tablespac
grant connect, resource, unlimited tablespace to nepASAP_envID;
create user srpASAP_envID identified by srpASAP_envID default tablespace Tablespace_name temporary tablespac
grant connect, resource, unlimited tablespace to srpASAP_envID;
create user ctrlASAP_envID identified by ctrlASAP_envID default tablespace Tablespace_name temporary tablesp
grant connect, resource, unlimited tablespace to ctrlASAP_envID;
commit;

3. Record the actual names used in the table "Installing ASAP Using the GUI Installer."

To create the Oracle Database users using the ASAP sample create users script:

1. Download the ASAP installation software as described in "Downloading the ASAP Installation Files."

2. Using a text editor, open ASAP_src/asap_utils/sample-create-user.ksh.

3. Edit the following variables:

ENV_ID=env_id: Where env_id is the environment ID that you will use for your ASAP installation.

USER=db_user: Where db_user is database user with sufficient privileges to create new tablespace users.

PASSWORD=db_pw: Where db_pw is database password for the database user with sufficient privileges to create new
tablespace users.

ORACLE_SID=sid: Where sid is the database SID value.

TEMP_TS=temp_ts: Where temp_ts is the temporary tablespace associated to each user.

4. Run the ASAP_src/asap_utils/sample-create-user.ksh script.

If you use different user names, ensure that you supply the same names during the ASAP server installation.

Patch the Oracle Database Server Software

You may need to apply a patch to the Oracle Database Server software after installation. For details, see "Patch Requirements."

Configuring Oracle RAC Database Connectivity

ASAP uses the availability features of the Oracle RAC system. ASAP supports an active/passive failover Oracle RAC database configuration. If you
have installed ASAP in an Oracle RAC system, ASAP automatically connects to the active secondary database node when the primary database
node fails over to the secondary. ASAP Control Server remains running during the Oracle RAC node switchover. If a transaction is in progress when
the Oracle RAC node fails over and, as a result, if any ASAP server shuts down, ASAP Control Server automatically restarts the failed ASAP
processes.

Follow the recommendations in the Oracle RAC documentation and use cluster node Virtual IP Addresses (VIP) when configuring Oracle LOCAL
listeners (LOCAL_LISTENER). For more information on listener configuration and Oracle RAC installation, refer to the Oracle Real Application
Clusters Installation Guide and the Oracle Database Net Services Administrator's Guide.

To configure the TNSNAMES.ora file for Oracle RAC support:

1. Using a text editor, open TNSNAMES.ora file in the Oracle_Home/network/admin/ directory, where Oracle_Home is the directory in
which the Oracle database is installed.

2. Configure the TNSNAMES.ora file entries listed in Table 5-3.

Table 5-3 TNSNAMES.ora Entries

Entry Description

LOAD_BALANCE This parameter specifies whether load balancing is enabled

between Oracle RAC databases. This parameter is embedded in
the ADDRESS_LIST parameter in the tnsnames.ora file.

Set this attribute to NO. ASAP does not support active/active

RAC databases configuration.

FAILOVER This parameter specifies whether connect-time failover is

enabled between primary and secondary Oracle RAC databases.
This parameter is embedded in the ADDRESS_LIST parameter
in the tnsnames.ora file

Set this attribute to TRUE. ASAP supports the active/passive

Oracle RAC database configurations.

ADDRESS This parameter contains the address information for an Oracle

RAC database. Include two instances of this attribute for the
primary and secondary Oracle RAC databases. This parameter
is embedded in the ADDRESS_LIST parameter in the
tnsnames.ora file

The ADDRESS parameters includes the following parameters:

PROTOCOL: Specifies the protocol used to connect to

the Oracle RAC database. For example, TCP.

HOST: Specifies the host name or IP address for the RAC

database.

PORT: Specifies the port number for the Oracle RAC

database.

SERVER This parameter directs the listener to connect the client to a

specific service handler. Set this parameter to DEDICATED.

SERVICE_NAME This parameter identifies the Oracle Database database service

to access. Set the value to a value specified by the
SERVICE_NAMES parameter in the initialization parameter file.

FAILOVER_MODE This parameter contains the connection information required for

an Oracle RAC active/passive failover database configuration
and transparent application failover (TAF). It instructs Oracle Net
to fail over to a different listener if the first listener fails during run
time. Do not confused this parameter with the connect-time
failover FAILOVER parameter.

This parameter is embedded in the CONNECT_DATA parameter

in the tnsnames.ora file.

The FAILOVER_MODE parameter includes the following

parameters:

TYPE: Set TYPE to session. TYPE=session establishes

a new connection to the Oracle active instance, and any
work in progress is lost. ASAP will replay all such failed
transactions related to the Control Server.

METHOD: Specify the method to be used for establishing

the connection.

METHOD=preconnect directs TAF to create two

connections at transaction startup time: one to the
primary database and a backup connection to the backup
database.

METHOD=basic directs TAF to create a connection to the

primary database at transaction startup time. Connection
to the backup database is established only after the
connection to the primary database fails.

RETRIES: Specify the number of times you want ASAP to

retry the connection when the connection to the database
fails. For example, RETRIES=11.

DELAY: Specify the interval in seconds between

connection retries. For example, DELAY= 6.

For example:

DB_CONNECT=
(DESCRIPTION =
(ADDRESS_LIST =
(LOAD_BALANCE=NO)
(FAILOVER=TRUE)
(ADDRESS =
(PROTOCOL = TCP)
(HOST = test.system.com)
(PORT = 1521)
)
(ADDRESS =
(PROTOCOL = TCP)
(HOST = test.system.com)
(PORT = 1521)
)
)
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = TEST)
(FAILOVER_MODE=
(TYPE=select)
(METHOD=basic)
(RETRIES=30)
(DELAY=15)
)
)
)

3. Install ASAP.

4. Perform the post installation tasks described in "Configuring ASAP to Support TAF for Oracle RAC."

 Previous Page Page 8 of 16 Next Page 

About Oracle Contact Us Legal Notices Terms of Use Your Privacy Rights | Cookie Preferences | Ad Choices


Copyright © 2005, 2017, Oracle and/or its affiliates. All rights reserved.