AppServerAdmin command

If you change the default IBM® WebSphere® Application Server administration credentials or the repository credentials, use the AppServerAdmin command to update the new credentials across your configuration.

Location

Issue the command from the root_directory/InformationServer/ASBServer/bin directory.

The AppServerAdmin command has the following options:

-was option

If you change the default IBM WebSphere Application Server administrator user name and password, this command updates the user name and password throughout the WebSphere Application Server configuration.

You can change the WebSphere Application Server default administrator user name and password in the following cases:

If you change the WebSphere Application Server user registry configuration in the WebSphere Application Server Administrative Console and the server ID and password for the current user registry is changed or a new user registry is configured.
If the WebSphere Application Server default administrator is deleted from the configured user registry or if that user's password is changed or expired.

You must run the -was option each time the WebSphere Application Server default administrator credentials are changed.

-db option

The repository user credentials are used by WebSphere Application Server to connect to the IBM InfoSphere® Information Server metadata repository. The user account for the metadata repository is typically called "xmeta." If you change the repository user password, this command updates the password throughout WebSphere Application Server and the InfoSphere Information Server configuration.

You must run this command each time the repository user password is changed.

You cannot specify a new user name for the metadata repository with this command. The user name must match the schema of the database.

-dbs option

The staging repository user credentials are used by WebSphere Application Server to connect to the IBM InfoSphere Information Server metadata staging repository. The user account for the metadata staging repository is typically called "xmetasr." If you change the staging repository user password, this command updates the password throughout WebSphere Application Server and the InfoSphere Information Server configuration.

You must run this command each time the staging repository user password is changed.

You cannot specify a new user name for the staging repository with this command. The user name must match the schema of the database.

Password prompting

To avoid the display of passwords, you can either provide an encrypted password with the -password option, or you can run the command without the -password option. Without this option, you are prompted to provide a password (which is not displayed). You will be asked to provide the password again for verification. To provide an encrypted password, use the string generated from the encrypt command.

Syntax

The command syntax for the -was option:

AppServerAdmin.bat -was -user username [-password password]

AppServerAdmin.sh -was -user username [-password password]

The command syntax for the -db option:

AppServerAdmin.bat -db -user repository_userid [-password repository_password]

AppServerAdmin.sh -db -user repository_userid [-password repository_password]

The command syntax for the -dbs option:

AppServerAdmin.bat -dbs -user staging_repository_userid
[-password staging_repository_password]

AppServerAdmin.sh -dbs -user staging_repository_userid
[-password staging_repository_password]

Parameters

-was

Updates the new user credentials throughout the WebSphere Application Server configuration. WebSphere Application Server does not need to be up and running to run this command. If WebSphere Application Server is running, it must be restarted after this command is run.

-user: The new WebSphere Application Server user name.
-password: Optional. The new password of the WebSphere Application Server user. You can provide the password as plain text or as a string that has been encrypted with the encrypt command. You will be prompted for a password if one is not provided.

-db

Updates the new user password throughout the WebSphere Application Server configuration and the InfoSphere Information Server configuration. WebSphere Application Server does not need to be up and running to run this command. If WebSphere Application Server is running, it must be restarted after you run this command.

-user: The metadata repository user name, which matches the schema name. You cannot change the user name with this command.
-password: Optional. The new password of the repository user. You can provide the password as plain text or as a string that has been encrypted with the encrypt command. You will be prompted for a password if one is not provided.

-dbs

-user: The staging repository user name, which matches the schema name. You cannot change the user name with this command.
-password: Optional. The new password of the staging repository user. You can provide the password as plain text or as a string that has been encrypted with the encrypt command. You will be prompted for a password if one is not provided.