126 lines
8.6 KiB
HTML
126 lines
8.6 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="concept" />
|
||
|
|
<meta name="DC.Title" content="Start the agent platform" />
|
||
|
|
<meta name="abstract" content="After you define the agent platform and optionally secure your platform, you will need to start all the Java Virtual Machines associated with your agent services using iSeries CL commands." />
|
||
|
|
<meta name="description" content="After you define the agent platform and optionally secure your platform, you will need to start all the Java Virtual Machines associated with your agent services using iSeries CL commands." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahxagentsetup.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahxagentconfigure.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahxagentsecurepref.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahxagentconfigure.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahxagentsecure.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzahxagentstartplatform" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>Start the agent platform</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzahxagentstartplatform"><a name="rzahxagentstartplatform"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Start the agent platform</h1>
|
||
|
|
<div><p>After you define the agent platform and optionally secure your
|
||
|
|
platform, you will need to start all the Java™ Virtual Machines associated with your
|
||
|
|
agent services using <span class="keyword">iSeries™</span> CL
|
||
|
|
commands.</p>
|
||
|
|
<p>After you have set up the agent platform and optionally configured security,
|
||
|
|
you need to start the agent platform. Because the platform is made up of one
|
||
|
|
or more Java Virtual Machines, to start the platform you need
|
||
|
|
to start all of the JVMs that make up the platform.</p>
|
||
|
|
<p>The following instructions provide information on how to start the agent
|
||
|
|
platform on an <span class="keyword">iSeries</span> server:</p>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Start the agent platform on an <span class="keyword">iSeries</span> server</h4><div class="p">The
|
||
|
|
following commands handle the starting and stopping of an agent platform on
|
||
|
|
an <span class="keyword">iSeries</span> server: <span class="cmdname">Start
|
||
|
|
Agent Services (STRAGTSRV)</span> and <span class="cmdname">End Agent Services (ENDAGTSRV)</span> commands. <div class="note"><span class="notetitle">Note:</span> By
|
||
|
|
using the code examples, you agree to the terms of the <a href="codedisclaimer.htm">Code license and disclaimer information</a>.</div>
|
||
|
|
</div>
|
||
|
|
<ul><li><span class="cmdname">Start Agent Services (STRAGTSRV)</span> command<p>When you
|
||
|
|
run STRAGTSRV a separate JVM will be started for each pool on the system you
|
||
|
|
are running the command from. This command starts a QAHASBMTER job that will
|
||
|
|
find all of the JVMs (agent pools) that need to be started. When it discovers
|
||
|
|
an agent pool, it will start a separate QAHASBMTEE job for each pool. Once
|
||
|
|
the command has completed successfully, there should be a separate QAHAPLTFRM
|
||
|
|
job in QSYSWRK with a status of SIGW for each pool. STRAGTSRV has the following
|
||
|
|
keywords:</p>
|
||
|
|
<dl><dt class="dlterm">PREFDIR</dt>
|
||
|
|
<dd>Sets the location of the following files: able.preferences and ableplatform.preferences.
|
||
|
|
Leaving the PREFDIR parameter at the default value will start or end the platform
|
||
|
|
defined by the ableplatform.preferences and able.preferences file in the <span class="uicontrol">/QIBM/ProdData/OS400/able/</span> directory.
|
||
|
|
Multiple platforms could be started on the same system by using the PREFDIR
|
||
|
|
parameter to point to different directories. When doing this you must be careful
|
||
|
|
that two platforms do not overlap at all by using the same ports on a system.</dd>
|
||
|
|
<dt class="dlterm">HOMEDIR</dt>
|
||
|
|
<dd>Sets the location of the home directory.</dd>
|
||
|
|
<dt class="dlterm">ClASSPATH</dt>
|
||
|
|
<dd>Allows you to add any additional classpath that each JVM should include.
|
||
|
|
STRAGTSRV automatically sets the default classpath to: <pre>classpath=
|
||
|
|
/QIBM/ProdData/Java400/:/qibm/proddata/os400/able:
|
||
|
|
/qibm/proddata/os400/able/ableplatform.jar:
|
||
|
|
/qibm/proddata/os400/able/able.jar:
|
||
|
|
/qibm/proddata/os400/able/ablebeans.jar:
|
||
|
|
/qibm/proddata/os400/able/jas.jar:
|
||
|
|
/qibm/proddata/os400/able/Jlog.jar:
|
||
|
|
/qibm/proddata/os400/Java400/ext/ibmjgssiseriesprovider.jar:
|
||
|
|
/qibm/proddata/os400/jt400/lib/jt400Native.jar:
|
||
|
|
/qibm/proddata/os400/Java400/ext/db2_classes.jar:
|
||
|
|
/qibm/proddata/os400/able/auifw.jar: </pre>
|
||
|
|
</dd>
|
||
|
|
<dt class="dlterm">SBMJOBUSER</dt>
|
||
|
|
<dd> Runs a JVM (agent pool) with a different profile than the current profile
|
||
|
|
you are calling the command with:<ul class="simple"><li>PoolIdentifier</li>
|
||
|
|
<li>The pool that should run with a different profile.</li>
|
||
|
|
<li>User Profile</li>
|
||
|
|
<li>The profile you want to use to start the agent pool (PoolIdentifier).</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</li>
|
||
|
|
<li><span class="cmdname">End Agent Services (ENDAGTSRV)</span> command<p>Ends all of
|
||
|
|
the platform JVMs on this system that are specified as agent pools in the
|
||
|
|
file <span class="uicontrol">ableplatform.preferences</span>. This command starts
|
||
|
|
a QAHAPLTEND job that will find and end all agent pools. ENDAGTSRV has the
|
||
|
|
following keywords:</p>
|
||
|
|
<dl><dt class="dlterm">PREFDIR</dt>
|
||
|
|
<dd> Sets the location of the following files: able.preferences and ableplatform.preferences.
|
||
|
|
Leaving the PREFDIR parameter at the default value will start or end the platform
|
||
|
|
defined by the ableplatform.preferences and able.preferences file in the <span class="uicontrol">/QIBM/ProdData/OS400/able/</span> directory.
|
||
|
|
Multiple platforms could be started on the same system by using the PREFDIR
|
||
|
|
parameter to point to different directories. When doing this you must be careful
|
||
|
|
that two platforms do not overlap at all by using the same ports on a system.</dd>
|
||
|
|
</dl>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> If you have trouble starting or ending the agent platform, you
|
||
|
|
can turn on tracing for the startup programs by adding or setting the QAHA_TRACE
|
||
|
|
system environment variable to '1'. This will create log files in QUSRSYS/QAAHALOG.
|
||
|
|
Files named QSBR<job number>, QSBE<job number, and QEND<job number>
|
||
|
|
will be created for each QAHASBMTER, QAHASBMTEE, and QAHAPLTEND job that has
|
||
|
|
run.</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzahxagentsetup.htm" title="Before you can begin managing your agents with the Intelligent Agents console, you will need to configure your agents and agent services (the agent platform) to run on or across the systems in your environment. A secure environment requires Kerberos and additional platform configuration.">Set up your agent environment</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
|
|
<div><a href="rzahxagentconfigure.htm" title="Provides a brief overview of the agent platform, and then provides detailed configuration steps for modifying the platform preferences file. Before you begin using the Intelligent Agents console in iSeries Navigator, you first need to configure the agent platform.">Configure your agent platform</a></div>
|
||
|
|
<div><a href="rzahxagentsecurepref.htm" title="Before you begin, ensure that you have configured your Kerberos key distribution center (KDC).">Configure platform security</a></div>
|
||
|
|
<div><a href="rzahxagentsecure.htm" title="It is strongly recommended that you use Kerberos user and service principals to authenticate users, agent pools, and agent services to one another on or across a secure platform or distributed platform.">Secure your agent environment</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|