Chapter 12: Using jagtool and jagant

setjagadminpasswd

Description

Changes the jagadmin password for a server.

Syntax

Local mode support: No.

Command line:

setjagadminpasswd connect-args [-server ServerName] oldpassword newpassword

Ant build file:

<jag_setjagadminpasswd [serverName=”ServerName”] oldpassword=”oldpassword “ newpassword=“newpassword” />

Option	Description	Default	Required
connect-args	Arguments to specify a connection to the server. See “Using connected mode”.	-	Yes
server	Indicates the server for which to set the jagadmin password. The specified server must be defined in the repository used by the server to which you are connected.	Jaguar	No
oldpassword	The current password for the server.	-	Yes
newpassword	The new password for the server.	-	Yes

Returns

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.

Examples

Example 1

This example changes the jagadmin password on MyServer from “secret” to “newsecret”. The server MyServer must be in the same repository as the server to which jagtool connects.

Command line:

jagtool setjagadminpasswd -server MyServer secret newsecret

Ant build file:

<jag_setjagadminpasswd serverName="MyServer"
oldpassword="secret" newpassword="newsecret"/>

Usage

The server must be restarted before clients (including jagtool) can connect with the new password.