Renishaw - Setup the UCCserver Client Tool Environment

Renishaw - Setup the UCCserver Client Tool Environment

Warning
You must be running UCC Suite 4.7 or above.
  1. UCC T3 (Fusion) and UCC Lite-2 controllers must use UCC suites between 4.7 and 4.8.  UCC Suite 4.8 is recommended.
  2. UCC2-2 and newer controllers should use UCC suites 5.1 and above.  (Due to a Renishaw bug, UCC Suite 5.7 and 5.7.1 are not supported)
If you are running a UCC Suite version older than 4.7, or if you are unsure what version you are running,
STOP
Do not continue without first contacting  QxSoft  for further instructions.

For legacy UCC Direct users upgrading to UCC Direct 2.0

Make a note the current Machine Configuration File

  1. Launch CMM-Manager and go the System Tab > Machine Setup (Password = service) and write down the Machine Configuration Filename for later use.


For all users installing or upgrading to UCC Direct 2.0

Alert
UCC Server must be launched using the -advanced parameter in order to make the following changes:
  1. Right click on the UCC Server shortcut icon on Windows Desktop and select "Properties" from the popup menu
  2. Under Shortcut tab on the Properties dialog, append -advanced to the Target executable path, e.g.
    1. "C:\Program Files (x86)\Renishaw\UCC\UCCSERVER\UCCSERVER_55000\UCCSERVER.exe" -advanced
  3. Click OK to accept the change.

Set the ClientToolEnvironment Active

Warning
WARNING : If the ClientToolEnvironment does not exist,
STOP
See the instructions at the end of this page
  1. Click the Advanced Tab
  2. Click the Environments Tab
  3. Use the mouse to position the cursor on the ClientToolEnvironment icon and right click
  4. Select Set Active from the pop up menu
  5. Reboot UCC Server


Verify the ClientToolEnvironment Configuration

  1. Click the Advanced Tab
  2. Click the Machine Tab


  1. Verify the contents of the ClientToolEnvironement
  2. There should not be any missing items
  3. There should not be any extra items


  1. This environment must remain unmodified by the user
    1. Do Not: Add any items here
    2. Do Not: Delete any items here
    3. Do Not: Edit or otherwise modify any items here
    4. Do Not: Create a Ref_Tool and cal sphere and calibrate
    5. Do Not: Create or configure a rack here


Configure the ClientToolEnvironment

  1. Click the Advanced Tab
  2. Expand the Machine tree and right click on the ClientToolEnvironment Machine
  3. Click Edit


  1. Browse to, and select the machine .ini file (Micro4S3 in this example


  1. Select the proper probe type
5a. For a PHC10 embedded in the controller, or an external PHC10-2/3 connected to the controller, select the actual head type.


5b. For an external PCH10-2/3 connected to the PC, or a manual head, select Other.

Notes
If you are getting an error about probe type not matching what is on the machine when trying to connect to UCC after migrating from the UCC legacy driver, check the ProbeHeadType setting in the UCC machine .ini file to make sure it is set correctly.
  1. It should be set to 2 if the PH10 or PHC10-2/3 is connected to the UCC controller
  2. It should be set to 0 if the PH10 or PHC10-2/3 is connected to the PC or it is a manual probe head.


Refer to this KB article for detailed description: Renishaw - UCC Direct 2.0 (DCC) - Hardware Diagrams.
  1. Click the green checkmark to accept your configuration

Verify parameters (Only required when upgrading from Legacy Direct Connect)

When upgrading from a legacy version of Direct Connect to Direct Connect 2.0, it is recommended you  review and update the acceleration parameters in UCC Server.

Complete the Setup

Continue with 'Setup/Upgrade CMM-Manager'  Here

Restoring/Repairing the ClientToolEnvironment

Notes
If further assistance is required beyond what is shown here, please contact QxSoft at support@qxcmm.com  or call 740-777-9609

Restoring the ClientToolEnvironment

If the ClientToolEnvironment is missing, there are a few option available to restore the missing environment:
  1. Exit UCC Server, then run the UCC Suite Install Manager.  It should detect a 'broken' installation.  Tell the UCC Install Manager to 'repair' the installation.  Run UCC Server and verify that the environment has been restored.
  2. Export a known clean ClientToolEnvironment from another system.  Import that ClientToolEnvironment into the system where this environment is missing.
  3. Contact QxSoft for instructions for where to obtain a clean ClientToolEnvironment.mzp file.  This file can then be imported into the system where this environment is missing.

Importing a clean set of tools into ClientToolEnvironment

Download the ClientToolEnvironment_TransferEquipment_ClientTool.tzp file in the attachments section below.  Import this file into the Environments section of UCC Server.


    • Related Articles

    • Renishaw - UCC Direct 2.0 (DCC) - Setup/Upgrade CMM-Manager

      If you have not done so, please set up the UCCserver client environment first. Instructions may be found here. For I++ users upgrading to UCC DIrect 2.0 Ensure that the existing installed version of CMM-Manager is fully synced with UCCserver. This ...

    • Renishaw - UCC Direct 2.0 (DCC)

      UCC Direct 2.0 supports a wide variety of configurations running on a Renishaw UCC controller with tactile probing. UCC Direct 2.0 uses a sub-set of I++ commands via UCCserver and the ClientTool environment. However, all user interaction is in ...

    • Renishaw - UCC T3 Plus (+) / S3 / T5 / I++ (DCC)

      DCC Models: UCClite, UCClite2, UCC1, UCC2, Fusion, T3, T3+, T5, S3, S3+ UCC Suite From Renishaw here. Due to a change in how UCC Server deals with "blocks" of commands, CMM-Manager (and some other brands of inspection software) will not run properly ...

    • Renishaw - UCC Direct 2.0 (DCC) - Controller / UCC Suite versions

      The following table lists the supported controllers and the versions of the UCC Suite required for each. The following UCC Suite versions are not supported: 5.6.x 5.7.0, 5.7.1 5.9.x 5.10.0 Information is current as of Dec 2024 Controller UCC Suite ...

    • Renishaw - UCC Direct 2.0 (DCC) - Hardware Diagrams

      Supported and tested configurations: Manual Probe Head PH10 direct to UCC T3 PLUS (No external PHC10) PH10 to PHC10 - PHC10 controlled via RS232 to the Host PC PH10 to PHC10 - PHC10 controlled via RS232 to controller