Docstoc

EDU41DDY

Document Sample
EDU41DDY Powered By Docstoc
					Special Utilities

AD Utilities Topics

Copyright © 2007, Oracle. All rights reserved.

Objectives

At the end of this module, you should be able to do the following: • Monitor worker processes • Restart and shutdown a worker • Troubleshoot worker processes • Relink AD programs • Describe the upgrade process

1-2

Copyright © 2007, Oracle. All rights reserved.

Module Overview

This module consists of the following topics: • AD Controller • Review worker status • Restart a failed worker • AD Relink • Upgrade

1-3

Copyright © 2007, Oracle. All rights reserved.

AD Controller

With AD Controller you can: • Review worker status • Restart a failed worker • Restart a terminated worker • Shutdown a worker

1-4

Copyright © 2007, Oracle. All rights reserved.

AD Controller
AD Controller Menu ----------------------------------------------------1. 2. 3. 4. Show worker status Tell worker to restart a failed job Tell worker to quit Tell manager that a worker failed its job

5.
6. 7.

Tell manager that a worker acknowledges quit
Restart a worker on the current machine Exit

Enter your choice [1] :

1-5

Copyright © 2007, Oracle. All rights reserved.

Reviewing Worker Status
Worker -----1 2 3 4 Code -----Run Run Run Run Context ------------Generic R120 Generic R120 Generic R120 Generic R120 Filename ----------E.msb ESA.msb EL.msb PTB.msb Status -----------Completed Failed Running Running

5
6

Run
Run

Generic R120
Generic R120

D.msb
US.msb

Wait
Wait

1-6

Copyright © 2007, Oracle. All rights reserved.

Reviewing Worker Status
Status
Assigned Completed Failed Fixed, Restart Restarted

Description
The manager assigned a job to the worker and the worker has not started. The worker completed the job and the manager has not yet assigned it a new job. The worker encountered a problem. You fixed the problem and the worker should retry whatever failed. The worker is retrying a job or has successfully restarted a job. (Note that the status does not change to Running).

Running
Wait

The worker is running a job.
The worker is idle.

1-7

Copyright © 2007, Oracle. All rights reserved.

Worker Status Flow

Waiting

Assigned

Running

Completed

Failed

Fixed, Restart

Restarted

1-8

Copyright © 2007, Oracle. All rights reserved.

Resolving a Failed Worker

Worker -----1

Code -----Run

Context ------------Generic R120

Filename ----------E.msb

Status -----------Completed

2
3 4 5 6

Run
Run Run Run Run

Generic R120
Generic R120 Generic R120 Generic R120 Generic R120

ESA.msb
EL.msb PTB.msb D.msb US.msb

Failed
Running Running Wait Wait

1-9

Copyright © 2007, Oracle. All rights reserved.

Determining Why a Worker Failed

Perform the following steps to investigate the problem that caused the failure and restart a failed worker: 1. Review worker status and confirm the Failed status of the worker: the Filename column lists the name of the file that failed to run 2. Review the worker log file adworkXXX.log under $APPL_TOP/admin/<SID>/log to determine the source of the error 3. Resolve the error

1 - 10

Copyright © 2007, Oracle. All rights reserved.

Restarting a Failed Worker

Once you have resolved the error: 1. Tell the worker to restart a failed job (AD Controller option 2). When prompted, enter the number of the worker that failed. If all workers failed and all the problems have been fixed, type all. 2. Review worker status again. The Status column for the worker that failed should now say Fixed, Restart, or Restarted.

1 - 11

Copyright © 2007, Oracle. All rights reserved.

Restarting a Failed Patch Process

If a worker fails and cannot be restarted: 1. Tell the worker to shutdown/quit 2. Tell the manager that a worker failed its job 3. Tell the manager that a worker acknowledges quit 4. Restart the patch

1 - 12

Copyright © 2007, Oracle. All rights reserved.

Terminating a Hanging Worker Process

1. 2. 3. 4.

Determine what the worker process is doing. Get the worker’s process ID. Determine what processes the worker has started, if any. Stop the hanging process, using the command that is appropriate for your operating system. 5. Make necessary changes. Fix the issue that caused the worker to hang. 6. Restart the job or the worker.

1 - 13

Copyright © 2007, Oracle. All rights reserved.

Restarting a Terminated Worker

1. Start AD Controller. 2. Review worker status. 3. Take the appropriate action for each worker status:
– If the worker shows Failed, restart the failed job. – If the worker shows Running or Restarted status, but the process is not really running, tell manager that a worker has failed its job. Then, tell manager to start the worker.

1 - 14

Copyright © 2007, Oracle. All rights reserved.

Restarting a Terminated Child Process

• Some worker processes spawn other processes called child processes • If you terminate a child process (that is hanging), the worker that spawned the process shows Failed as the status. • After you fix the problem, choose to restart the failed job. • Once the worker is restarted, the associated child processes are started as well.

1 - 15

Copyright © 2007, Oracle. All rights reserved.

Restarting an AD Utility After a Machine Crash
If your system crashes while running an AD utility: 1. Start AD Controller. 2. Select the following options:
– Option 4: Tell manager that a worker has failed its job (Specify all workers.) – Option 2: Tell worker to restart a failed job (Specify all workers.)

3. Restart the AD utility that was running when the machine crashed.

1 - 16

Copyright © 2007, Oracle. All rights reserved.

Shutting Down the Manager

1. Tell worker to shutdown/quit and enter all for the worker number. Each worker stops once it completes or fails its current job. 2. Verify that no worker processes are running. The command to do this may vary on different platforms. Two examples are:
– UNIX: $ ps -a | grep adworker – Windows: Invoke the Task Manager (Ctrl-Alt-Delete) to view processes.

3. When all workers have shut down, the manager (the AD utility) quits.

1 - 17

Copyright © 2007, Oracle. All rights reserved.

AD Relink

• AD Relink relinks Oracle Applications executable programs • Relinking may be necessary when executable programs become corrupt, are accidentally deleted, or need to be updated after the server libraries are updated

1 - 18

Copyright © 2007, Oracle. All rights reserved.

AD Relink

To run AD Relink: • Log on as applmgr and run the appropriate environment file • If you are relinking files on a concurrent processing server, shut down the affected concurrent managers • If you are relinking files on a forms server node, have all Oracle Applications users log off before proceeding

1 - 19

Copyright © 2007, Oracle. All rights reserved.

AD Relink Syntax

To relink one or more executable programs, run adrelink.sh with one of these two commands: $ adrelink.sh force={y|n} [<optional args>] <targets> or $ adrelink.sh force={y|n} [<optional args>] filelist=<file>

1 - 20

Copyright © 2007, Oracle. All rights reserved.

AD Relink

• Typing adrelink.sh at the command prompt will provide instructions on the AD Relink utility syntax • Typing adrelink.sh examples at the command prompt will also provide examples for running the AD Relink utility

1 - 21

Copyright © 2007, Oracle. All rights reserved.

Upgrade Paths

• Upgrading directly to Release 12 of Oracle Applications is supported for these Oracle Applications releases only: 11.5.7, 11.5.8, 11.5.9 (base, CU1, CU2), and 11.5.10 (base, CU1, CU2)

1 - 22

Copyright © 2007, Oracle. All rights reserved.

Module Summary

In this module, you should have learned how to do the following: • Monitor worker processes • Restart and shutdown a worker • Troubleshoot worker processes • Relink AD programs

1 - 23

Copyright © 2007, Oracle. All rights reserved.

Module Discussion

• • • •

Describe some of the functionalities of AD Controller In what types of situations might AD Controller be useful? How would you stop an AD utility gracefully? What is the best method of relinking multiple Oracle Applications programs?

1 - 24

Copyright © 2007, Oracle. All rights reserved.

Module Practice
• Managing worker processes • Restarting AD Administration • Running AD Relink

1 - 25

Copyright © 2007, Oracle. All rights reserved.


				
DOCUMENT INFO
Shared By:
Categories:
Tags:
Stats:
views:4
posted:8/29/2009
language:English
pages:25