Resolution:
Description:
============
Unable to change domain credentials using the domain utility tool.

Symptoms:
=========
Domain Utility throws blank/Unknown/Unspecified exception without any entry of the exception in the domain utility logs while changing domain credentials using domain utility GUI tool. On using the domain utility command line tool for changing domain credentials, an exception is printed in the domain utility logs as follows:

[Wed Nov 07 13:54:14 GMT 2012] -- Error -- java.lang.StringIndexOutOfBoundsException: String index out of range: -7
at java.lang.String.substring(String.java:1768)
at com.tibco.administrator.du.task.AbstractTask.authenticateSuperUser(AbstractTask.java:838)
at com.tibco.administrator.du.task.AbstractTask.authenticateSuperUser(AbstractTask.java:897)
at com.tibco.administrator.du.task.domaincredential.DomainCredentialScreen.validateCredential(DomainCredentialScreen.java:280)
at com.tibco.administrator.du.task.domaincredential.DomainCredentialsValidator.validate(DomainCredentialTask.java:206)
at com.tibco.administrator.du.cmdline.CmdLineHandler.execute(CmdLineHandler.java:195)
at com.tibco.administrator.du.DomainUtility.main(DomainUtility.java:419)

Environment:
===========
OS: All
TIBCO Administrator 5.x.x
TIBCO Runtime Agent 5.x.x

Cause:
=====
The issue is normally caused if a shortened EMS URL is used while creating a domain.
Normally, an EMS URL looks like "tcp://servername:port". However, a shortened EMS URL is accepted while creating a domain. A shortened EMS URL may contain only the server name or IP address, withouth protocol ("tcp://") and port number. For example:
       host1
Test Connection is also successful if the shortened EMS URL is used while creating the domain, as long as an EMS server uses the default port (7222). Due to the above reasons the EMS URL entry in the *.tra and *.properties files are as mentioned below :

EMS URL : &ltmachine-name> (, localhost or &ltIP-Address>) instead of tcp://&ltmachine-name>/localhost/&ltIP-Address>:7222.

Most of the functionality such as deployment, starting a service and other domain related functionality works as expected.

Resolution:
==========
Using Domain utility change the EMS URL, domain utility&gtServer Setting> Change Transport Parameters.

If the password has already been changed from the admin GUI, still use the old credentials while performing domain utility tasks.

Enter the URL as tcp://&ltmachine-name>/localhost/&ltIP-Address>:&ltport-number>/7222.
Click test connection to verify. Proceed to finish this task. Do not restart admin service even though domain utility would suggest to do so.

Check the AdministrationDomain.properties and AuthorizationDomain.properties to see if the notifier.ems.transport parameter has been updated with the new EMS URL value.
Without restarting admin or Hawk services, change the domain credentials using the Domain Utility, domain utility&gtServer Setting> Update Domain Credentials.


References:
==========
Changing EMS URL for a domain : &ltTibco_Home>\tra\&ltversion>\doc\pdf\tib_TRA_domain_utility_usr&gtChanging the Transport or Transport Parameters for a Domain

Changing domain credentials :  &ltTibco_Home>\tra\&ltversion>\doc\pdf\tib_TRA_domain_utility_usr&gtChanging Domain Credentials