1. System Administrator's Guide
  2. Starting and Stopping ASAP

1 Starting and Stopping ASAP

This chapter describes how to start and stop Oracle Communications ASAP.

Starting ASAP

The Control server creates a list of ASAP processes for each ASAP territory and system. The list enables the components of all ASAP systems in a territory to be specified and maintained in a single database.

In a particular ASAP implementation, there can be many territories. A territory is the geographical area served by the ASAP system. A Control server manages all applications and processes within the territory. Territories are generally mutually exclusive because there is no communication between ASAP systems in different territories.

The Control server determines each application's details from the static database table tbl_appl_proc. This table specifies whether each application is a client or a server. It also specifies whether each application process should start automatically or manually, the sequence in which applications are to be started, and the diagnostic details of the process.

When ASAP is started, the Control servers on each machine in the network are started first. The primary Control server then either starts each ASAP application process individually (or sequentially) on its local machine, or instructs one of the secondary Control servers to start the application process on its machine. Every Control server determines the application details from a static database configuration table.

To shut down an ASAP application, you must submit a request to the Control server that manages the shutdown.

Using the Control server for all startup and shutdown activities provides a consistent approach to starting and stopping the system, and provides the ability to start ASAP processes on remote machines when ASAP is in a distributed environment.

Oracle recommends that you restart ASAP when:

  • adding, updating, or deleting configuration information.

  • adding, updating, or deleting service definitions.

  • loading database schemas.

  • rolling back the system clock (for example, to adjust for daylight savings time).

Scripts are provided to start up and shut down an entire ASAP instance or individual application components.

When the Control server is requested to start an ASAP application, the Control server performs the following steps:

  • If the local Control server is not the same as the Control server for the application as defined in the application process table (that is, this application server should be started by a remote Control server), the local Control server opens a network connection to the remote Control server. The remote Control server then starts the application on the remote machine before returning a successful indication back to the requesting client.

  • If the application server's Control server is the local Control server, this local Control server first verifies that the UNIX program executable file for the application server is located in the $PROGRAMS directory and is executable. At this point, the application process starts up and the details are returned to Control Server.

If the spawned application is a server, the parent Control server process goes into a retry loop and attempts to open a network connection to the newly created application process. If the connection to the application process is not established, a system event is issued and the Control server terminates the application server.

Note:

You must define the server application name within the brackets [ ] in the header for each Server Configuration Parameters section in the ASAP.cfg file. You must define the server application name for each section, for example, the CTRL, SARM, and NEP. There can be no empty brackets [ ] in any of the sections in the Server Configuration Parameters, otherwise system errors occur.

Starting All ASAP Servers

Use the start_asap_sys script located in the ASAP_home/scripts folder to start all ASAP servers (where ASAP_home is location of the ASAP installation).

Note:

You must deploy at least one cartridge for the SARM server to start.

After you start the Oracle WebLogic Server domain for ASAP and the ASAP database instance, you can call the start_asap_sys script to start the entire ASAP system.

Note:

The start_asap_sys script must be started from the host that the primary Control server resides on. However, if you want to start ASAP remotely, R-shell into the host where the primary Control server resides.

This script does the following:

  • Starts the ASAP Control server from the command line.

  • Verifies that the Control server is running.

  • Starts all configured ASAP application components in the ASAP system and territory in the sequence defined in the database.

Usage

start_asap_sys [-d] [ -n ] [ -a Profile] [ -m MasterCtrl ] [ SlaveCtrl ... ] [ -C Concur ]

or

start_asap_sys -h

Table 1-1 lists and describes the arguments for the start_asap_sys script.

Table 1-1 start_asap_sys Arguments

Argument Description

-d

The ASAP development option.

-a

An ASAP profile to be sourced before starting up remote Control servers.

-m

The SARM server. This option is specified with -m. The -p option can be used to specify compatibility with a previous version of this script.

-C

Starts ASAP services concurrently, rather than sequentially.

SlaveCtrl

The remote or secondary Control servers to start.

- n

Restars lapsed servers, excluding the Control server, and to resume ASAP.

-h

Displays command help.

When you start the ASAP servers, you must observe the following logic:

  • If you do not specify the SARM server in the command, the script obtains the SARM server specification from the environment variable $MASTER_CONTROL. You specify the SARM server in the command line using the -m option otherwise the script uses the $MASTER _CONTROL environment variable.

  • If you do not specify a Control server name, the remote Control servers identified in the environment variable $SLAVE_CONTROL_ SERVERS are started. $SLAVE_CONTROL_SERVERS should provide the real names of the remote Control servers as follows:

SLAVE_CONTROL_SERVERS="SlaveCtrl1[:Host1] ... 
SlaveCtrlN[:hostN]" export SLAVE_CONTROL_SERVERS

If $SLAVE_CONTROL_SERVERS is not set, only the SARM server is started.

For example:

SLAVE_CONTROL_SERVERS="CTRLSVR1:192.168.10.251
CTRLSVR1:192.168.10.252"

  • If an ASAP profile is specified in the command line, it is sourced before starting the remote Control servers.

  • If no ASAP profile is specified, the profile specified in the environment variable Environment_Profile is sourced before starting the Control servers.

  • If Environment_Profile is not set, remote Control servers are not started.

  • To start a Control server on a host, the ASAP user must have permission to use rsh to the host from the current host.

Starting the Control Server

Use the start_control_sys script located in the ASAP_home/scripts folder to start the ASAP Control server (where ASAP_home is location of the ASAP installation).

This script observes the same logic as start_asap_sys.

After you start the WebLogic Server domain for ASAP and the Oracle database, you can call the start_control_sys script to start the ASAP Control server(s). Application servers are not started with this script.

The start_control_sys script does the following:

  • Starts the ASAP Control server. The standard input, output, and error from this startup are sent to the ASAP.Console file. The ASAP.Console file contains standard input, standard output, and errors that are sent to a console screen. The ASAP.Console file records any startup errors.

  • Verifies that the Control server is running.

Usage

start_control_sys [-d] [ -a Profile ] [ -m MasterCtrl ] [ SlaveCtrl ... ]

or

start_asap_sys -h

Table 1-2 lists and describes the arguments for the start_control_sys script.

Table 1-2 start_control_sys Arguments

Argument Description

-d

The ASAP development option.

-a

An ASAP profile to be sourced before starting up remote Control servers.

-m

The SARM server. This option is specified with -m. The -p option can be used to specify compatibility with a previous version of this script.

SlaveCtrl

The remote or secondary Control servers to start.

-h

Displays command help.

Starting the ASAP Daemon

When using an ASAP application that interfaces with the WebLogic Server (such as the SACT, or SADT), you must start the WebLogic Server first, and then start the ASAP Daemon prior to starting the specified ASAP applications.

Note:

The start_asap_sys script also starts the ASAP Daemon.

When you use an application that uses the WebLogic Server, and that application calls an IO operation against the ASAP instance, the WebLogic Server sends a remote file request or a remote command to the ASAP daemon. All WebLogic Server IO operations against the ASAP instance are handled by the daemon server process.

You can start the ASAP daemon through using a start server command, or through a wrapping script. If starting the ASAP daemon using the start server command, start ASAP first.

Starting ASAP Daemon Using a Start Command

Oracle recommends that you start the ASAP daemon using the following command.

After you have started ASAP, type:

startc -d $DAEM

The ASAP daemon is started.

Starting ASAP Daemon Using a Wrapping Script

You can optionally use the following script to start the ASAP daemon server:

asapd -start -d -host host -port port [-asap_base asap_base_dir]

You can use the following script to stop the ASAP Daemon Server:

asapd -stop -d -url host:port

The following command displays help information (see Table 1-3): 

asapd -h

Table 1-3 asapd Arguments

Argument Description

-d

Indicates non-interactive mode only.
-host=[hostname or IP address]

Specifies the host name or IP address of the local host.

Note: The -host <host> argument is required and it must be specified before -port <port>.

-port <port>

Provides a port number in local host; Remote starting is not supported.

-asap_base=[ASAP base directory]

This optional argument specifies the ASAP base path that the current ASAP instance works on. In a development environment, if the base path is missing, the script attempts to obtain the path from the environment.

Before running this script, make sure the environment variable $DAEM is defined.

For more information on configuring the ASAP daemon, refer to ASAP Online Help.

Confirming that ASAP Started Successfully

To verify the status of each server process, use the following procedure:

  1. From a UNIX terminal, source the ASAP_home/Environment_Profile (where ASAP_home is location of the ASAP installation). 

    . ./Environment_Profile

  2. Enter the following command:

    status

           **** ASAP Application Status ****
 
#  CPU           PID         Program                             Application   Location
-- ---------     --------    ------------------------------      -----------   --------
1  00:00:05      3820454     $ASAP_BASE/programs/ctrl_svr        CTRLAK99      LOCAL
2  00:00:05      3820721     java                                NEP_AK99      LOCAL
3  00:00:05      3820800     $ASAP_BASE/programs/asc_nep         NEP_AK99      LOCAL
4  00:00:07      3820882     $ASAP_BASE/programs/sarm            SARMAK99      LOCAL                    
5  00:00:02      3820971     java                                DAEMAK99      LOCAL      
           
                         **** End of Application Status ****

  3. Verify that all the server processes you wanted to start appear in the output from the status command.

Stopping ASAP

To shut down ASAP, a script called stop_asap_sys is provided in the ASAP_home/scripts folder (where ASAP_home is location of the ASAP installation). This script terminates the ASAP applications in the inverse order to which they were started.