Updating an environment by using an Ant task

You can update values of the attributes of an environment by using the HCL® Quality Server Ant task.

Here is an example syntax:
<taskdef name="updateEnvironment" classname="com.ghc.ghTester.ant.UpdateEnvironment" classpathref="tasklib" />

<updateEnvironment domain="<Domain name>" environment="<Environment name>" 
serverUrl="https://Hostname or IP address:5443/RTCP/" tagsPropertyFile="<Properties file name>" 
username="<user name>" securityToken="<Security token>" />
You can update the values of the following attributes of an environment:
  1. The URL of HCL® Quality Server.
  2. The domain name.
  3. The name of the environment.
  4. The tags to be updated in the environment.

The following table lists the attributes that you can use with the updateEnvironment Ant task for updating an environment.

Table 1. List of available attributes
Attribute Description Required
domain Domain name Yes
environment The name of the environment to be updated. Yes
securityToken The value of the security token to use for authentication with HCL® Quality Server when domain security is enabled. For more information, see Domain level security. No
serverUrl URL of the HCL® Quality Server Yes
tagsPropertyFile The path to a property file that specifies the environment tags to be set for the environment, which replace all the tags that are currently present for the environment. Yes
username The user name under which to perform the operation. No
Note: All environment events are recorded in the HCL® Quality Server Audit log. (For information about this log, refer to Administration of HCL Quality Server.)

Error codes

For details of any error codes, see Exit codes for Command-line client and Ant client.