[Collapse]Collaborator 10
 [Expand]General Information/viewarticle/80040/
 [Expand]Getting Started/viewarticle/80359/
 [Expand]Collaborator Server/viewarticle/80060/
 [Expand]Web Client/viewarticle/80107/
 [Collapse]Desktop Clients/viewarticle/80151/
   Desktop Clients - Overview/viewarticle/80113/
   Client Installation/viewarticle/80127/
  [Expand]Configuration/viewarticle/80308/
  [Expand]GUI Client/viewarticle/80074/
  [Expand]Command-Line Client/viewarticle/80089/
  [Expand]IDE Clients/viewarticle/80162/
   Tray Notifier/viewarticle/80088/
   External Diff Viewer launcher/viewarticle/80179/
 [Expand]Version Control Integration/viewarticle/80048/
 [Expand]External Integrations/viewarticle/80340/
 [Expand]Techniques & Best Practices/viewarticle/80403/
 [Expand]Appendices/viewarticle/80117/
Updated: 12/23/2016 Applies To: Collaborator 10 Rating: No votes Click to rate: PoorNot badAverageGoodExcellent

Desktop Clients

Top |Previous |Next

Client Installation

The Client Installer includes the following components:

Version Control System triggers

The client installer is cross-platform and can be run in an interactive GUI mode or silently from the command-line.

Getting the Installer

Go to our website to get the latest installer for your platform:

http://downloads.smartbear.com

Installers are provided for Windows, Linux/Solaris and Mac OS X. We also supply the raw files without a managing installer in the form of a compressed tar archive.

Notes:

In order to install client, you may need to install Java Runtime Environment (JRE). Collaborator client for Windows and Mac OS are distributed along with JRE. Therefore, it is not necessary to install Java separately on these platforms, since Collaborator may use the bundled version of Java. See Java Compatibility Matrix for more details.
If you have previously installed the client with the 32 bit installer and are now wanting to run the 64 bit installer, you must first uninstall the 32 bit client. This will not remove any existing configuration data, like preferences, SCM configurations, default browsers and so on.
In order to enable integration with ClearCase Remote Client, you should launch client installer with administrator permissions on Windows. Otherwise, you can launch the installer as a regular user.
Graphical Installation

This is the recommended way to install the client software because you get a chance to see all the configuration options and allow the installer to validate your configuration.

cl_install_welcome

After the welcome screen, you are prompted with the EULA (End User License Agreement):

cl_install_license

The next screen lets you select where to lay down the files for the installation:

cl_install_directory

The next screen lets you configure how and if your Start Menu (Windows only) is modified. This does not affect the behavior of the command-line client itself:

cl_install_startmenu

Next, you configure your connection to the Collaborator server:

cl_install_servinfo

When you configure the URL, be sure to remember to specify the protocol (for example, http:// or https://) and port number, and path. Leaving out one of those things is the most common mistake.

Your username and password must already exist on the server. Log into the server first from a web browser to test your account information.

If you use a proxy, supply your proxy information as well.

If the connection to the server cannot be established, you will get an error dialog and an explanation of the problem:

cl_install_error

If you select "Retry", you can supply different configuration information and try again. Otherwise, if you select "Continue", the installation will continue but you will still need to set up your configuration.

After this step, you will be prompted for additional tasks.

On Windows you will have the option to configure the Collaborator Tray Notifier to run on Startup. On all platforms, there will be options to configure the integrations with ClearCase Remote Client and Perforce Visual Tools.

In order to enable integration with ClearCase Remote Client, you should launch client installer with administrator permissions on Windows. You need to specify the location of the Rational CM API jar files on your system. See details in Support for ClearCase Remote Client.

The "Configure Addons To Perforce Visual Tools" option is shown only if Perforce Visual Tools is installed. If this option is selected, the installer will attempt to configure the P4V and P4Win integrations for the current user. Other users will still need to configure the integrations manually.

cl_install_traycheck

Once you click "Next," the installer will complete:

cl_intall_done

Unattended Installation

To run the installer without a GUI, run it from the command-line using the -q switch. In this case, you can also use the -dir [directory] switch to specify the target install directory. The -q switch gives you a silent install and will not prompt you for any installation instructions. If you would like to be prompted for installation instructions without using the graphical installer, you can run the installer from the console using the -c command.

This installation technique can also be used to install clients remotely on many workstations.

Warning: When run in unattended mode, the installer cannot verify the client's connection with the Collaborator server. You might have to manually configure the connection with the server.

Installing on a system with multiple JRE installations

See Known Issues with the Collaborator for instructions on selecting a specific JRE to be used by Collaborator.




© 2019 SmartBear Software. All rights reserved.
Email Send feedback on this document