StarTeam Web Server Known Issues

  • StarTeam Web Server must be connected to an actual IP Address or Host Name for search to work in StarTeam Web Client. Do not use localhost.
  • When administering the StarTeam Web Server for multiple combined StarTeam repositories that add up to more than 1000 projects, you must use Firefox 10.0.2 or greater. All other browsers fail or lock-up when trying to load the Web Server Administration user interface.
  • The first person to log into a project that contains over 100 views will experience a load delay that could last several minutes depending on the quantity of views. This is a one-time cost for the project. No other user will experience the delay unless the StarTeam Web Server is restarted.
  • On Windows Server 2008, sometimes the StarTeam Web Server installation will fail to copy the required libraries from the StarTeam install location to the StarTeam Web Server install location. If this occurs, the files must be manually copied from the SDK to the StarTeam Web Server. Copy the following files to YOUR_PATH\StarTeam <version> Web Server\apache-tomcat-[version]\shared\lib: 
    YOUR_PATH\StarTeam SDK <version>\lib\ss.jar
YOUR_PATH\StarTeam SDK <version>\lib\starteam130.jar
YOUR_PATH\StarTeam SDK <version>\lib\starteam130-resources.jar
YOUR_PATH\StarTeam SDK <version>\lib\StarTeam.Encryption.dll
YOUR_PATH\StarTeam SDK <version>\lib\StarTeam.Environment.dll
YOUR_PATH\StarTeam SDK <version>\lib\StarTeam.FileAccess.dll
YOUR_PATH\StarTeam SDK <version>\lib\StarTeam.Profile.dll
  • When the StarTeam Web Server is installed as a service, sometimes it may fail to stop. This can happen when the StarTeam Web Server is configured to support over 1000 projects. The process will exit, but Microsoft Windows will show a failed error message.
  • Default memory settings may be insufficient for very large data-sets (>1000 projects). There are two files that may need to be modified before the StarTeam Web Server can be started, depending on the action you perform:
    Running as a Service Edit either the file: YOUR_PATH\StarTeam <version> Web Server\StarTeamService32.bat or YOUR_PATH\StarTeam <version> Web Server\StarTeamService64.bat depending on your operating system. Change the value of JVM_MAX_MEMORY to a value of your choice (in megabytes). For 32-bit operating systems, a maximum of approximately 1.8 GB is generally the limit. The JAVA_HOME and PRODUCT_JVM variables should be validated for accuracy. They are set according to typical path locations.
    Running from the Start Menu Edit the file: YOUR_PATH\StarTeam <version> Web Server\ apache-tomcat-[version]\bin\setenv.bat. Change the value of -Xmx4096M to a value of your choice (in megabytes). For 32-bit operating systems, a maximum of approximately 1.8 GB is generally the limit. The JRE_HOME variable should be validated for accuracy. It is set according to typical path locations.
  • Properties whose values are Deleted Users will display as Deleted User in the StarTeam Web Client.

  • Star Team Web Server Administration Panel does not support SSO authentication. To add SSO enabled Star Team server to the web server you have to temporarily switch to Star Team authentication and re-enable SSO. You can do that from Star Team Server Administration -> Authentication tab or using app-control.xml.

  • Star Team Web Server Administration Panel does not support SSO authentication. To add SSO enabled Star Team server to the web server you have to temporary switch to Star Team authentication and when ready to re-enable SSO. You can do that from Star Team Server Administration -> Authentication tab or using app-control.xml.