modifyconfigdbpwd CLI command

Use this command to modify the default password for the Configuration Database.

When you install TrueSight IT Data Analytics, by default, the SA (super admin) user with corresponding default password is used for accessing the Configuration Database.

As a security precaution or as part of your normal maintenance, you might want to change the default password for accessing the Configuration Database. You might also need to change the password in a scenario where you forgot the previous password that was set. In these scenarios, as an administrator, you can use this command to change the default password (or the previous password) and protect against unauthorized access.

Related topics

Security considerations Open link

Security planning for IT Data Analytics Open link

Configuring a secured connection

Running this command results in a restart of the following services:

  • Console Server
  • Search (all instances)
  • Collection Station (all instances)


Before running the command, ensure that the following components are up and running:

  • Configuration Database
  • Console Server
  • Indexer (all instances)

Also, after running this command, ensure that all the product components are up and running. To understand the status of each of the components, navigate to the Administration > Components page. For more information, see Viewing component status and associated properties.

To understand the syntax and examples, see:



Before you run the command, note the following points:

modifyconfigdbpwd -d <hostname> -p <portNumber> -u <username> -w <password> -newpwd <newPassword> [-l <locale>] [-s]
  • Angle brackets (< >) indicate a variable value that needs to be user defined.
  • Square brackets ([ ]) indicate optional parameters.

The following table describes the parameters used in the syntax:

Host name of the Console Server.
Port number of the Console Server.
User name to use to connect with the Console Server.
Password corresponding to the user name to use to connect with the Console Server.

New password that you want to set for accessing the Configuration Database.

When you specify the new password, it appears in plain text. However, after you run the command, the password is encrypted and sent to the Console Server.

Note: The new password cannot be left blank.


(Optional) Indicates the locale in which you want to display messages when the command is run.

You can set one of the following locales:

  • English
  • Simplified Chinese
  • German
  • French

By default, the messages are displayed in the locale of the system on which the CLI is run.

The value can be set to one of the following depending on the locale you choose:

  • English: en
  • Simplified Chinese: chs
  • German: de
  • French: fr

Example: If you want to set the locale as Simplified Chinese, you need to specify, l=chs.

(Optional) Indicates an HTTPS connection.

Example inputs

The following example provides the input for viewing the modifying the password to "Adm1n@toR2016".

modifyconfigdbpwd -d localhost -p 9797 -u admin -w admin12345 -newpwd Adm1n@toR2016

Was this page helpful? Yes No Submitting... Thank you