Unix Commands
Unix Commands
err=2
fi
--------------------------------------------------------------------------------
---------------
In Applications Manager, the shell scripts are called run-time extensions.
--------------------------------------------------------------------------------
--------------------
Taking Actions on Tasks
To take actions on one or more tasks, use the
awexe aw_quemgr call.
Format
awexe aw_quemgr tranmode=<letter> jobids=<space separated run_ids
inside single quotes> so_user_name=<Applications Manager user name> password=<use
r password>
The following tranmode letters correspond to an action:
H
Hold task(s) RReset task(s) DDelete task(s) KKill task(s)
Example
In the example below, user
PBROWN deletes run_id 65711.00.
> awexe aw_quemgr tranmode=D jobids=65711.00 so_user_name=PBROWN
password=8uwc76
Success
jobids processed
--------------------------------------------------------------------------------
-----------------------------------------------------------------
Getting Process Flow Names from Component Run IDs
Format
awexe get_chain_name jobid=<run ID number>
Example
An example is shown below.
> awexe get_chain_name jobid=689046
SAMPLE
-------------------------------------------------------------------
Retrieving a Substitution Variable
Format
awexe get_var_value subvar=<subvar name>
Example
In the example below, the value for the
#today substitution is returned.
> awexe get_var_value subvar=#today
27-jan-09
--------------------------------------------------------------------------------
Viewing a Queue Summary
awexe q
The
awexe q call returns the following columns: queue, max threads, tasks in the Bac
klog, active or inactive status, priority, and thread schedule sequence
--------------------------------------------------------------------------------
------------------------------------------------------
Viewing Tasks in the Backlog
awexe jq
-----------------------------------------------------------
Viewing Tasks in History
awexe jh
-------------------------------------------------------
Viewing an RMI and Agent Connection Summary
awexe rmi_status
--------------------------------------------------------
Viewing an Applications Manager User Login Report
awexe show_users
--------------------------------------------------------------
Administration-1.8
automation engine, agents, RMI server, and Web server
UC4 _client _login _report
At client start-up, the client will connect to the RMI server specified in Optio
ns.properties file
location of Options.properties file is /home/web/classes
Automation Engine--
The automation engine is the execution logic or brain of Applications Manager. I
t monitors job
and process flow schedules and, at the appropriate time, sends them to the desig
nated local or remote agent for execution. The automation engine communicates wi
th the Applications Manager database, where all object definitions are stored.
Local Agent--
At a minimum, a basic Applications Manager setup will include a single automatio
n engine and
its local agent. The local agent runs programs or executes scripts on the host m
achine where the Applications Manager automation engine is installed. It receive
s commands from the automation engine.
Applications Manager Database--
Applications Manager uses object definitions stored in an Oracle database to giv
e it an
advantage over all other schedulers. When you create a job, process flow, or oth
er Applications Manager object, the definition is stored in the Applications Man
ager Oracle relational database. You can then use the objects to build more comp
lex objects. For example, you might define a database login, then assign that lo
gin to many different jobs. If the login changes, you change it in one place, an
d Applications Manager uses the new definition everywhere it is referenced. This
object-oriented approach makes it easy to update and maintain the Applications
Manager system.
Client--
You access Applications Manager through a Java client. The client machine is the
PC used to
access the Applications Manager graphical user interface. This means you can acc
ess Applications Manager from any PC, Apple Macintosh, or Sun Workstation that h
as a Web browser. Client software provides access to all Applications Manager fu
nctions and features. The clients communicate directly with the Applications Man
ager automation engine. You can have any number of clients.
Remote Agent--
In larger systems, you may have one or more Applications Manager remote agents o
n other
servers. A remote agent must be installed on each machine where tasks are execut
ed. Any number of remote agents can report to a single automation engine. Remote
agents may run on UNIX, Windows, VMS, and OS/400 platforms.
The automation engine will schedule and control task execution on all the agents
assigned to it.
The agent monitors tasks until they complete.
RMI Server : The RMI Server is the process that servers information to the Java
client and runs the
Applications Manager automation engine. It connects to Oracle instances through
JDBC over SQL*Net.
________________________________________________________________________________
______
Basic Steps for Installing an Applications Manager Remote Agent
The basic steps for installing a remote agent are:
1. Define the remote agent object in Applications Manager.
2. Create a user login.
3. Install the Applications Manager remote agent software.
4. Start the Network Listener Service (for Windows).
5. Verify the installation.
Step 1 is described in
topic 4.2 Defining Remote Agents. Steps 2-5 are described in the Installation Gu
ide.
________________________________________________________________________________
________
**All Applications Manager agents are now multi-threaded Java agents. There are
no longer C
agents. The AgentService process runs on all agents. The awcomm process runs onl
y on the automation engine machine. Normally an additional process called RmiSer
ver is also run on the automation engine machine.
There is only one network connection between an agent and the RMI server and tha
t connection
is always initiated by the AgentService process. This connection supports two wa
y communications. That is to say the RMI server can communicate with the remote
AgentService over the same port. This also functions as automatic agent failover
in the event of the automation engines RMI server failing.
The WatchWorx Process
When started, the WatchWorx process monitors all other Applications Manager proc
esses on an
agent or automation engine and attempts to restart them if they go down. For mor
e information, see topic 8.3 The watchworx Process.
The awcomm Process
The
awcomm process provides a port directory service for the automation engine machi
ne. It stores the name of each automation engine and its listening port, and mak
es it available to AgentService processes. There is no awcomm on remote agent ma
chines and there is usually one awcomm process on an automation engine machine.
For more information on the awcomm process, see topic 8.4 The awcomm Process.
The AgentService Process
The
AgentService process establishes a unique port. The port communicates with the R
miServer processe(s). If the port numbers are not specified in the awenv.ini fil
e, Applications Manager will determine the first available port between 49152 an
d 65535. AgentService performs required agent functions to launch, manage, and m
onitor tasks as instructed by the automation engine. AgentService also services
requests to view local output.
The
AgentService process for the automation engines local agent connects directly to
the database, but the AgentService processes for remote agents connect to the au
tomation engines RmiServer process.
The
AgentService process functions as automatic agent failover in the event of the a
utomation engines RMI server failing provided an additional RmiServer process is
online.
Automation Engine/RmiServer Process
The RMI server for the Applications Manager automation engine is responsible for
initiating
and monitoring task execution. Because the automation engine is incorporated wit
h the RMI server, there is no separate automation engine process.
The automation engine monitors the Applications Manager task queue and job/proce
ss flow
schedules and determines when scheduled tasks are eligible for execution. When a
task is eligible for execution, the automation engine collects the necessary in
formation from the database. Then the automation engine requests that the agents
AgentService process create the pr and pm program execution files and launches t
he pm script. After the task has been launched, the AgentService process monitor
s the task until it goes to completion.
The RMI Server process serves out information to the Applications Manager Java c
lient. It gets
its Oracle SQL*Net connect information from the awenv.ini file in the site direc
tory, and decrypts its login information from the Masters.properties file. For m
ore information on the RmiServer process
The program execution processes include
awexe and awrun. Program execution processes run only when executed, whereas the
other processes are persistent.
The awexe process allows you to issue various Applications Manager functions fro
m the operating system command line or from scripts
The awrun process allows you to submit tasks from the command line or in scripts
.
To check if a specific port is being used, issue the following command:
netstat -an|grep <port number>
The awcomm process is the first process that is brought up when you execute the
startso command
if it is not already running. It reads recovery information from the net_conn.d
at file in the data directory.
DependenciesFor the RmiServer process to work correctly, the following condition
s must be met:
The awcomm and automation engines AgentService process must be up and running to
get the database SID connection information.
Net8 (SQL*Net) must be running for the RMI server target database.
______________________________________________________________________________
master.properties : appworx/data
options.properties:appworx/web/classes
keyfile.in :appworx/data---that is vendor manangement License , with out this Ap
pworx will not work
While purchasing the Product, UC4 will give us keyes/license to use the product
______________________________________________________________________________
3. The automation engine initiates the program execution sequence by requesting
the AgentService process.
The AgentService process creates the pr (task parameters) and pm (task environme
nt variables) files.
The pm file initiates the BODY script
________________________________
The awexe process is used for the product install, import and export, task start
ing and
completion, and startso and stopso commands.
The awexe process is what is known as a thin client. It connects to the AgentServi
ce process.
The awexe process can only run items that are listed in the awserver_sql.dat and
awserver_sqlusr.dat files in the Applications Manager data directory.
The proper variables (AW_HOME, AGENT, PATH=$AW_HOME/bin:$PATH) must be set for t
hem to execute correctly, an Applications Manager user must exist that matches t
he OS user, and the user must have the correct Awexe Range.
Awexe calls are used for the install, import and export, the command line utilit
y, task starting and completion, startso and stopso, etc.
Starting/Running Routine
The awexe process submits requests to AgentService. To see if the OS user can ex
ecute the statement, the AgentService process validates the operating system (OS
) user and the awexe command number against the range of allowable commands assi
gned to the user.
If the permissions are correct, the statement is executed and the results are pa
ssed back to awexe.
eMeasure for Middleware : B-2013-132783
eMeasure for DBA : B-2013-132784