The Cross Platform Client accepts the users credentials then displays the following error:





Clicking OK does not allow the user to log in.

The event occurs when the StarTeam MPX Cache Agent details have been entered manually with backslashes included in the address, for example, \\MyRemoteCA.

Star Team is unable to resolve the address when backslashes are included.  The host name or IP address are valid entries that should be used.

As the Cross Platform Client cannot be opened to resolve this issue (by modifying address field) it is necessary to use an alternative method. 

1.  Navigate to the ‘Application Data’ folder, for example:     C:\Documents and Settings\USERNAME\Application Data\Borland\StarTeam

2.  Make sure ‘show hidden files and folders’ is enabled

3.  Within the ‘Application Folder’ StarTeam directory find the file ‘CacheAgent.props’

4.  Open this file and the current entry will show ‘address=\\MyRemoteCA’

5.  Change this entry to ‘address=MyRemoteCA’ or alternatively the relevant IP Address

6.  Save the file

You will now be able to open the Cross Platform Client as Star Team can successfully resolve the host name.

For reference the full stack trace is:

Time of report generation: 2011-09-16 07:52:44Z
GUI Build: 10.4.7-70
SDK Build: 10.4.8.57
Exception Class: java.lang.IllegalArgumentException
================
Exception Message:
==================
protocol = socket host = null
Localized Exception Message:
==================
protocol = socket host = null

Stack Trace:
============
java.lang.IllegalArgumentException: protocol = socket host = null
 at sun.net.spi.DefaultProxySelector.select(Unknown Source)
 at java.net.SocksSocketImpl.connect(Unknown Source)
 at java.net.Socket.connect(Unknown Source)
 at java.net.Socket.connect(Unknown Source)
 at java.net.Socket.(Unknown Source)
 at java.net.Socket.(Unknown Source)
 at com.borland.starteam.impl._private_.HTTPClient.openConnection(Unknown Source)
 at com.borland.starteam.impl._private_.HTTPClient.sendRequest(Unknown Source)
 at com.borland.starteam.impl._private_.HTTPClient.pingCacheAgent(Unknown Source)
 .....
 .....

System Properties:
==================
java.runtime.name: Java(TM) SE Runtime Environment
sun.boot.library.path: C:\Program Files\Borland\Java\Sun1.6.0_02\bin
java.vm.version: 1.6.0_02-b06
java.vm.vendor: Sun Microsystems Inc.
java.vendor.url: http://java.sun.com/
path.separator: ;
.....
.....

CLASSPATH details:
==================
C:\Program Files\Borland\StarTeam Cross-Platform Client 2008 R2 : directory
C:\Program Files\Borland\StarTeam SDK 10.4\lib\starteam104.jar : size=2616946, time=[Fri Apr 16 18:31:34 BST 2010]
......
......