res-undeploy Task

ILOG JRules User Guide > Deploying Rules > Reference > RuleApp Management Using Ant > res-undeploy Task

res-undeploy Task

The res-undeploy task enables you to undeploy a RuleApp archive on a running Rule Execution Server. This task performs a HyperText Transfer Protocol (HTTP) or an HTTP Over SSL (HTTPS) remote call to remove the RuleApp from the model.

Table 10 res-undeploy Element Attributes

Element Attribute	Description	Required
`ruleapp`	The name of the RuleApp in the server.	Yes
`version`	The version of the RuleApp in the server.	No. Default value is1.0.
`portnumber`	The port number of the Rule Execution Server Console.	Yes
`hostname`	The host name of the server where the Rule Execution Server Console is installed.	Yes
`userid`	The user name to log into the Rule Execution Server Console.	No
`password`	The password linked to the user name to log into the Rule Execution Server Console.	No
`credentialsfile`	A file containing the `userid` and `password`, encrypted when the attribute is first used. If this attribute is present, you must not use the `userid` and `password` attributes.	No
`webapp`	The prefix of the Rule Execution Server Console.	No. Default value is bres
`failonerror`	The default is set to `true`. If it is set to `false`, a warning message is logged when an error occurs, but the build is not stopped.	No
`secured`	The default is set to `false`. If it is set to `true`, the task performs an HTTPS upload.	No

The following Ant task code provides an example of how to use the element attributes:

<res-undeploy hostname="localhost" portnumber="7001" userid="bres"
 password="mypassword" ruleapp="myruleapp" version="1.0"/>

Here is an encrypted example, using the credentialsfile attribute:

<res-undeploy hostname="localhost" portnumber="7001" 
 credentialsfile="mypasswordfile" ruleapp="myruleapp" version="1.0"/>

where the credentials file is a text file that contains:

username=bres

password=mypassword

The file must follow the Java property files format; see http://java.sun.com/j2se/1.4.2/docs/api/java/util/Properties.html#load(java.io.InputStream). After the first execution of the res-deploy ANT task, the contents are encrypted. For example:

username={DES}oLHZROlruWw\=

password={DES}als58ekruWw\=

With encryption, the userid and password never appear in plain text in traces during the RuleApp deployment operation.

res-undeploy Task

Related Concepts

Related Topics

Related Tasks

Related Samples and Tutorials

Related Reference