Comm error: -306 from client on the broker machine

Products

CA Harvest Software Change Manager CA Harvest Software Change Manager - OpenMake Meister

Issue/Introduction

After upgrading to SCM v14.5.01, when testing the SCM Workbench and Administrator Tool applications installed on the broker machine, we were unable to connect to the broker.

Environment

Harvest Software Change Manager all versions

Resolution

Here are the initial things to check:

Did the person installing the SCM Client have "Local Administrator" permissions on the computer?
Did they execute the installation program in "Run as Administrator" mode?
Did they execute the "setup.exe" and not the msi installer file?
Did they reboot after installation completed?
When executing the Administrator Tool for the first time, did you select "Run as Administrator" mode?

Your system environment variables should include these settings:

CA_SCM_HOME=C:\Program Files\CA\SCM 
CA_SCM_LOCALHOME=C:\Program Files\CA\SCM
HARVESTHOME=C:\Program Files\CA\SCM
LOCALHARVESTHOME=C:\Program Files\CA\SCM 
RTARCH=i86_w64 
RTHOME=C:\Program Files (x86)\CA\SharedComponents\PEC

Your system path should include these folders:

C:\Program Files (x86)\CA\SharedComponents\PEC\bin;
C:\Program Files\CA\SCM\x86;
C:\Program Files\CA\SCM;
C:\Windows\system32;
C:\Windows;
C:\Windows\System32\Wbem;
C:\Windows\System32\WindowsPowerShell\v1.0\;

If your environment variables look OK, the next thing you can do is try to execute the Administrator Tool from a command prompt window to see if any additional error messages are shown. To do this open a command prompt window "Running as Administrator" and execute:
```
cd %CA_SCM_HOME%
workbench.exe -data "@user.home/.cascm/workspaceAdmin" -perspective "com.ca.harvest.ui.harvestAdminPerspective" -vmargs -Dorg.eclipse.equinox.p2.reconciler.dropins.directory="%CA_SCM_HOME%\adminDropins"
```
If your environment variables look OK, the next thing you can do is try to execute the Administrator Tool from a command prompt window to see if any additional error messages are shown. To do this open a command prompt window "Running as Administrator" and execute:
```
cd %CA_SCM_HOME%
workbench.exe
```
If all these fail, the next thing to do is uninstall all SCM components on the computer, reboot, and then reinstall the SCM client from the command line so that we can collect a log file of the installation:
From Control Panel -> Programs, uninstall SCM Client
Reboot the computer
Open a command prompt window (running as administrator) and navigate to the folder containing the SCM Client's "setup.exe" installation program

Execute the following:

setup.exe /qf /v"/l \"C:\Temp\client_install.log\"

Make sure the C:\Temp folder already exists before running the command. The result should be a client_install.log file containing more information about any problems encountered during installation.

Additional Information

It is very important that all installation activity for the Harvest product be done on the Windows operating system with a userid that is a member of the local Administrator group, and that all Harvest-related processes, including the "rtserver.exe" process be shut down before installing and uninstalling.