Chapter 12: Using jagtool and jagant

install

Installs an entity into another entity (for example, installing a package into a server).

Local mode support: Yes.

Command line:

install [ connect-args | local-args ] source target

Ant build file:

<jag_install source=”source” target=”target” />

Option	Description	Required
connect-args \| local-args	Arguments to specify a connection to the server or to run in local mode. See “Local versus connected mode”.	Yes
source	The entity identifier for the entity being installed.	Yes
target	The entity identifier in which the source entity is being installed.	Yes

Return value	Indicates
0	The command ran successfully; the result is true/success.
1	The command ran successfully; the result is false/failure.
2	The command did not run successfully; an exception was thrown.

This example installs the package SoapDemo in the server.

Command line:

jagtool install Package:SoapDemo Server:Jaguar

Ant build file:

<jag_install source="Package:SoapDemo" target="Server:Jaguar" />

This example installs the application MyPortfolio in the server.

Command line:

jagtool install Application:MyPortfolio Server:Jaguar

Ant build file:

<jag_install source="Application:MyPortfolio" target="Server:Jaguar" />

This example installs MyListener into the Jaguar server:

Command line:

jagtool install Listener:Jaguar/MyListener Server:Jaguar

Ant build file:

<jag_install source="Listener:Jaguar/MyListener" target=”Server:Jaguar” />

This example installs the service component MyPack/MyComp into the Jaguar server:

Command line:

jagtool install Service:MyPack/MyComp Server:Jaguar

Ant build file:

<jag_install source="Service:MyPack/MyComp" target=”Server:Jaguar” />