apps diag part ii

8/8/2019 Apps Diag Part II

1/33

Oracle Applications 11i SystemAdministration Diagnostic &

Troubleshooting


2/33

2

Topics

Basic Applications Diagnostics and Troubleshooting Tools

Application Security

Concurrent Processing

Useful Scripts


3/33

3

Basic Applications Diagnosticsand Troubleshooting Tools

Basic Applications Tools

(Help) About Oracle Applications - Prime Use: Shows Applications version, Form short name, Form version

(Help) Record History - Prime Use: Shows primary table/view form is using(Help) Diagnostics Examine - Prime Use: Shows values of fields not visible on form

(Help) Diagnostics Examine choose $DESCRIPTIVE_FLEXFIELD$ block -Prime Use: Shows user-friendly names of Descriptive Flexfields

(Help) Diagnostics Examine choose $ENVIRONMENT$ block Prime Use: Shows values of primary environment variables

(Help) Diagnostics Examine choose $PROFILES$ block Prime Use: Shows value in effect for any given profile option for that user.

(Help) Diagnostics Examine choose SYSTEM block and LAST_QUERY field.Prime Use: Shows the SELECT statement that was last executed by your form.

Note: Should also mention the FORM_STATUS and ERROR_ITEM fields in this block.


4/33

4

(Help) Diagnostics Display Database Error - Prime Use: Shows any database error message

(Help) Diagnostics Properties Item - Prime Use: Shows forms canvas to which a field belongs

(Help) Diagnostics

Trace (checkbox) - Prime Use: Turning on/off forms tracing. Trace file (*.trc) is putinto user_dump_dest.

(Navigate) Concurrent Program Define

Utilities: SQL Trace profile option

Application Developer responsibility - Log on as Applications Developer responsibility,A. (Navigate) Concurrent -> Programs - to see all concurrent programs

B. (Navigate) Application -> Form - to see all formsC. (Navigate) Application -> Messages - to see Apps. Error messages

D. (Navigate) Application -> Database -> Tables - to see all tables

E. (Navigate) Application -> Database -> Sequence - to see all sequences

F. (Navigate) Application -> Database -> View - to see all views

Basic Applications Tools


5/33

5

Application Security

ResponsibilityResponsibility

Responsibility Determines :

How much of an applications functionality a user can use

What reports and concurrent program a user can access

Which application data these reports and concurrent programs can access.

Components of a ResponsibilityComponents of a Responsibility

Data GroupRequest GroupMenuFunction and menu exclusion


6/33

6

Data GroupData Group

A data group defines the mapping between Oracle Application product

and Oracle ID

An Oracle username and password allow access to an

applications table in an Oracle database.

Each Oracle username in a datagroup determines the

database table and privileges accessible by the corresponding application


7/33

7

Request GroupRequest Group

A request group defines the concurrent program that may

be run by an application user under a particular responsibility

Request group can include

Individual Report and concurrent program

Request Set


8/33

8

FormsForms

form is a user interface to insert ,update and delete data into and from

Database. A form must be registered with Oracle Application Object Library

FunctionFunction

Form Function - A function that invokes an Oracle Forms form

Sub function - A non form function is a securable subset of forms

functionality , which means a function executed from within a form

One can navigate to a form function ( form) using the navigate window

A sub function can only be run from a form


9/33

9

MenuMenu

A menu is a hierarchical arrangement of application functions,

that are displayed in the navigator windowmenus can also point to non form function that do not display in

the navigator

Each responsibility is associated with a menu

A menu consists of menu entries , which could be a submenu or afunction


10/33

10

Create a test User

Create a test Responsibility

Create a test Application

Create a test Data Group

Create a test Oracle IDCreate a test Request Group

Create a test Form

Create a test Form Function

Create a test Menu

Set Signon Audit profile option


11/33

11

Running Security and User Reports

Function Security Menu Report

Function Security Navigator Report

Function Security Function Report

Active Users Report

Active Responsibilities Report

Report Group Responsibilities Report

Reports and Sets by Responsibility Report

Users of a Responsibility Report

Sign-On Audit Forms Report

Sign-On Audit Users Report

Sign-On Audit Responsibilities Report

Sign-On Audit Unsuccessful Logins Report

Sign-On Audit Concurrent Requests Report


12/33

12

Concurrent Processing

Concurrent ProgramConcurrent Program

A concurrent program is an executable file that runs simultaneously with

other concurrent programs and with online operations.

Any long running data intensive program

Operating system script

Oracle Reports

When submitted through a Standard Submission form a concurrent

program generates a concurrent request

A concurrent manager intercept a concurrent request and starts the

process


13/33

13

Request Group

A request group is a collection of reports and concurrent programs

A system administrator defines request group in order to control user

access to reports and concurrent programs

Only a system administrator can define a request group

Request Set

Request set is a set of reports and concurrent programs with commonrun and print options.

End user and system administrator can define request set


14/33

14

Concurrent Processing Components

Internal Concurrent Manager - The Internal Concurrent

Manager (ICM) is the "manager" of all concurrent processingthat occurs within Oracle Applications. ICM is an instance ofthe program, FNDLIBR.

The ICM controls all of the other concurrent managers

Conflict Resolution Manager - The Conflict Resolution

Manager (CRM) is a running instance of the program,FNDCRM. Its job is to remove a substantial burden from theICM, that is of resolving conflicts, such as requestincompatibilities.


15/33

15

Parallel Concurrent Processing - Parallel Concurrent Processing(PCP) is the ability to distribute concurrent processing over multiplemachines. This architecture has following advantages.

1. High performance

2. Fault Tolerance3. Single Point of Control

The biggest advantage for PCP is fault tolerance. You will see slightlyhigher performance. You will see the most improvement on concurrent

processing jobs that are compute-intensive. Data-intensive jobs will nothave as significant an improvement, except where PCP is combinedwith Oracle Parallel Server (OPS).

The APPLDCP environment variable is used to indicate whether PCP ison or off.


16/33

16

InternalMonitor- When you are using PCP, you must allow for thepossibility that the Internal ConcurrentManager on the master systemcan fail. In this case, Oracle Applications uses a special process, calledthe Internal Monitor (IM), that watches for just such an event. If it

happens, IM will attempt to start an ICM on its machine. That ICM wouldthen become the master.

When IM is running, it is running an instance of the program, FNDIMON.

The Standard Manageraccepts any and all requests. It has nopredefined specialization rules and is active all the time. It is notrecommended to add specialization rules to the standard manager as it

can cause problems.


17/33

17

ConcurrentManagers - Concurrent Managers are the primaryworkhorse of the concurrent processing system. Most concurrentmanagers run the standard concurrent library called FNDLIBR. There

are additional concurrent libraries (e.g., INVLIBR, ARLIBR, PALIBR, etc.).

NOTE: Yes, concurrent managers and the ICM run the same program,FNDLIBR.


18/33

18

Transaction Managers - TransactionManagers (TMs) are the processby which Applications handles synchronous tasks that can not afford towait in the queue. An example of a Transaction Manager occurs inOrderManagement. When some enters an order, that order is checked

against inventory, work in process, orders, and several other systems tosee if we can deliver this to the customer when we promise.

TMs are immediate concurrent programs that work only when signaledby a client. Unlike CMs that continuously poll the system looking forwork, TMs wait until signaled. Also, the TMs do not establish on-goingconnections with the client. Once the request has been sent to the TM,the connection remains only long enough for the TM to obtain theanswer and return the result set.


19/33

19

Generic Service Management (GSM)

An E-Business Suite system depends on a variety of services such asForms Listeners, HTTP Servers, Concurrent Managers, WorkflowMailers, etc. Such services are composed of one or more processesthat must be kept running for the proper functioning of the E-Business

Suite. Until recently many of these processes had to be individuallystarted and monitored by system administrators. Management of theseprocesses was complicated by the fact that these services could bedistributed across multiple host machines. The new ServiceManagement feature for Release 11i helps to greatly simplify themanagement of these processes by providing a fault tolerant serviceframework and a central management console built into OracleApplications Manager 11i.

Service Management is an extension of Concurrent Processing, whichprovides a powerful framework for managing processes on multiplehost machines.


20/33

20

Generic Service Management (GSM)

With Service Management, the Internal Concurrent Manager (ICM)manages the various service processes across multiple hosts. Oneach host, a Service Manager acts on behalf of the ICM, allowing theICM to monitor and control service processes on that host

Set System Profile Concurrent GSMEnabled to YNeed to configure FNDSM listener & corresponding tnsnames.ora,FND_TOP/bin/gsmstart.sh

Important: If GSM is not correctly configured, problems may occurwith the managers failing to start. In this case, the GSM functionalitymay be turned off by resetting this Profile to 'N' and bouncing themanagers (i.e. shutting down the icm and restarting it). This willallow concurrent managers to run while the configuration error isresolved.

For more detailed information about GSM and its functionality refer

to OracleMetalinkNote 165041.1.


21/33

21

Concurrent Processing Tasks

Submit an individual concurrent request

Submit a concurrent request set

Scheduling a concurrent requestMonitoring a concurrent request

Viewing a concurrent request's log file

Viewing a concurrent request's output


22/33

22

Concurrent Processing Tasks

Create a request set

Create a request group

Create a concurrent executableCreate a concurrent program

Create a concurrent manager

Stop and restart a concurrent manager

Stop and restart the ICM

Canceling a concurrent request

Holding a concurrent request

Terminating a concurrent request


23/33

23

Purging the request table

When tables FND_CONCURRENT_REQUESTS andWhen tables FND_CONCURRENT_REQUESTS and

FND_CONCURRENT_PROCESSES reaches to above 20K rows, theFND_CONCURRENT_PROCESSES reaches to above 20K rows, theperformance diminishes. You may want to run Purge Concurrentperformance diminishes. You may want to run Purge ConcurrentRequest on a regular basis.Request on a regular basis.

The Purge Concurrent Requests job can be used to purge:The Purge Concurrent Requests job can be used to purge:

Requests, Mgr logs, and All requests depending on what isRequests, Mgr logs, and All requests depending on what is

chosen. Use the following options: Enter = All, Mode = AGE,chosen. Use the following options: Enter = All, Mode = AGE,

Mode Value = 15Mode Value = 15

The std.mgr log continuously grows where it may good toThe std.mgr log continuously grows where it may good to

archive it regularly.archive it regularly.


24/33

24

Concurrent Processing Scripts

Analyze a concurrent request

Analyze all pending concurrent requests

Clean the concurrent manager tables

Retrieve all log files for a concurrent request

Get a concurrent programs incompatibilities

List responsibilities that can run a given concurrent programAvailable at http://ap9019pc.us.oracle.com/

ccm.sql - Available at metalink NOTE:171855.1

Useful Scripts


25/33

25

$FND_TOP/sql has many useful script to debug CM.

afimlock.sql - To list the Locks that the ICM is waiting forafimchk.sql - To check the status of ICMafrqrun.sql - Lists all Running, Terminating, Paused Requestsafrqwait.sql - Selects all the Pending Requestsafcmrrq.sql - Lists managers that are currently running a request(username, request id, program name, start date, etc).


26/33

26

Diagnostic Database Scripts

Describe Database Space

Describe Data Files

Describe a Database Object

Count Database Objects by Type

Table Definitions

Describe Tablespace

Describe Database Users


27/33

27

Diagnostic Applications Scripts

Some important scripts are as below:

Located in $AD_TOP/sql

Check and List Compilation Errors - aderrch2.sqlList Job Timing Information - adtimdet.sql

Count Objects by Type - adutcobj.sql

Applications Configuration Script - adutconf.sql

List Product Dependencies - adutfpd.sql

List Pinned Objects - ADXCKPIN.sqlReport Database Configuration - ADXRCSDC.sql

Report Table Sizes - ADXRSFTS.sql

Show Extent Failure - ADXRSSIE.sql

Show User Space - ADXRSSUS.sql


28/33

28

Controlling Servers scripts

Stopping servers

Starting servers

Located in $COMMON_TOP/admin/scripts

Some important scripts are as below:

Forms ServerListener - adfroctl.sh

Forms Server - adfmsctl.sh

Report Review Agent - adalnctl.shReports Server - adrepctl.sh

ConcurrentManagers - adcmctl.sh

Net8 Listener - addlnctl.sh

Apache Listener - adapcctl.sh

Oracle 8i database server - addbctl.sh


29/33

29

Checking Certification

MetaLink (External):http://metalink.oracle.com/

Certify - Oracle's Certification Matrix (Internal):http://certify.us.oracle.com/

Certify User's Guide (Internal):http://certify.us.oracle.com/certifyuserguide.pdf

Certify FAQ (Internal):

http://certify.us.oracle.com/certfaq.htmlRDBMS Patch Set Tracking System:http://ess30.us.oracle.com:8002/

Interoperability Patches:http://sac.us.oracle.com/download/index.html


30/33

30

Apache and Jserv

Httpd.conf

Oracle_apache.conf calls plsql.conf,6iserver.conf. Hasdirectives for oracle

Jserv.conf

Main jserv config file.

Jserv.properties

Userd by the JVM. Has the port in which Jserv listens

Root.properties

This groups the class files for micro JVMs

Stores the property class.autoreload


31/33

31

Apache and Jserv

Files are cached in webcache $OA_HTML/_pages

DAD config is in$APACHE_TOP/Apache/modplsql/cfg/wdbsvr.app

This stores the DAD config with Apps password

For DB connectivity uses DBC file in $FND_TOP/secure

This has the guest and gateway user id

It can be created using adgendbc.sh script


32/33

32

Forms server

Jinitiator stored in $COMMON_TOP/util/jinitiator

For digitally signing,$AD_TOP/bin/adjkey initialize

adjbuild.sh

Forms server config is stored in $OA_HTML/bin/appsweb.cfg All forms in $AU_TOP/forms/US

To check form version use adident command.


33/33

33

Question ?Comments/ Suggestion

apps diag part ii

Documents