Changing the WebSphere Application Server Liberty password

Procedure to modify the WebSphere Application Server Liberty password.

To modify the WebSphere Application Server Liberty password, update the wauser_variables.xml configuration file. This operation changes the password for the TWS user, which is stored in the configuration file. Ensure you also update the password in the useropts file, so that you can continue working with the command-line client. If you have several users using the command-line client, change the password of the TWS user in all useropts files (one for each user). For more information, see Change password used by command-line clients to access the master domain manager.
  1. The location of the file to be modified varies depending on whether you have already customized the template or not, as follows:
    If you have no previous customizations defined in the configuration file,
    edit the template located in the templates folder.
    Templates for the master domain manager are stored in the following paths:
    On UNIX operating systems
    TWA_home/usr/servers/engineServer/configDropins/templates
    On Windows operating systems
    TWA_home\usr\servers\engineServer\configDropins\templates
    Templates for the Dynamic Workload Console are stored in the following paths:
    On UNIX operating systems
    DWC_home/usr/servers/dwcServer/configDropins/templates
    On Windows operating systems
    DWC_home\usr\servers\dwcServer\configDropins\templates
    If you have previous customizations defined in the configuration file,
    edit the file located in the overrides folder, which is the file currently used by WebSphere Application Server Liberty.
    The wauser_variables.xml file is located in
    On UNIX operating systems
    TWA_DATA_DIR/usr/servers/engineServer/configDropins/overrides
    On Windows operating systems
    TWA_home\usr\servers\engineServer\configDropins\overrides
    On UNIX operating systems
    DWC_DATA_dir/usr/servers/dwcServer/configDropins/overrides
    On Windows operating systems
    DWC_home\usr\servers\dwcServer\configDropins\overrides
  2. Copy the wauser_variables.xml file to a temporary directory.
  3. Edit the file as necessary, specifying the new password.
    The contents of the wauser_variables.xml file is as follows: 
    <server description="wauser_var">
                <variable name="user.twsuser.id" value="$(wlpUser)"/>
                <variable name="user.twsuser.password" value="$(wlpPassword)"/>
                </server>

    where:

    user.twsuser.id
    Is the WebSphere Application Server Liberty user ID.
    user.twsuser.password
    Is the new WebSphere Application Server Liberty password.
  4. Optionally, create a backup copy of the configuration file in a different directory, if the file is already present.
  5. Copy the wauser_variables.xml file to the overrides folder. Changes are effective immediately.
  6. Update the PASSWORD in the useropts file on the following workstations:
    • on every command-line client that points to your workstation.
    • on every fault-tolerant agent in your environment that has an HTTP/HTTPS connection defined in localopts that points to your workstation. The HTTP/HTTPS connection is used to submit a predefined job or job stream.
    • in the engine connection parameters on every connected Dynamic Workload Console.
If you have more than one instance of IBM Workload Scheduler on a system, you might have implemented separate user options files to make separate connections. In this case, check the useropts key in the localopts file on each instance to determine the name of the specific useropts file for that instance.