Maintenance and troubleshooting

General maintenance

In order to maintain a high software quality CAMAG will provide updates and patches. You should always install the latest software version available.

Service Tool

On the server, a visionCATSServiceTool.exe will be installed. It should only be used to get log files when no visionCATS client is working.

Known Issues and Workarounds

The “Export entier log” functionality is not available anymore in method, analysis and comparison’s log tab.

Reason: In visionCATS 2.5, the export of the HPTLC log has been integrated into the reports. As a result, visionCATS methods don’t have the functionality anymore because no report is generated for methods.

For analysis and comparisons, go to the report tab, use a report template where the loading of the log data is enabled, and check the log option.

After reinstalling with different server and instrument service ports, no instrument service are available.

Restart the service visionCATS Server.

The camera is not recognized anymore after the PC was in sleep or hibernate mode.

Some USB3 controllers have some issues with the camera, like the Intel® USB 3.0 eXtensible Host Controller. Restart the machine to resolve the problem, and disable sleep mode to prevent the problem from occurring again.

Blue screen when capture image with TLC Visualizer on a Windows 10

Go to Power Options/Choose what the power button does/Change settings that are currently available/Shutdown settings and disable the option “Turn on fast startup”

A click on the OK button of the message box appearing when an error occurs during a step execution, while the instrument is already executing a step of another analysis, causes an error to occurr in the step currently in progress.

When the error message appears, click on the OK button before starting the execution of the other step.

The import of winCATS methods won’t import steps of instruments not supported in visionCATS, and some winCATS specific parameters will be ignored

Reason: winCATS and visionCATS don’t exactly support the same set of instruments, and for each instrument, the exact same set of parameters

After having imported some winCATS methods, visionCATS will inform the user when some steps are ignored. In all cases, please review the imported methods.

After changing of the TLC Visualizer/TLC Visualizer 2, a TLC Visualizer/TLC Visualizer 2 cannot be executed in an analysis already having images

Reason: Only one TLC Visualizer/TLC Visualizer 2 can be used in an analysis

Redo the analysis

After changing of the camera for a TLC Visualizer/TLC Visualizer 2, an already opened analysis with a TLC Visualizer/TLC Visualizer 2 step waiting for execution, or TLC Visualizer/TLC Visualizer 2 Manual control or OQ may behave strangely (using the old camera, bad image corrections…)

Before changing of a camera, close all analyses with the next step as TLC Visualizer/TLC Visualizer 2 and Visualizer views

After changing of the camera for a TLC Visualizer/TLC Visualizer 2, the Visualizer icon in the toolbox isn’t marked as having a bad Diagnostic

Restart the client

While using two TLC Visualizer/TLC Visualizer 2 on a single PC, one or both cameras aren’t detected, or the camera of one TLC Visualizer/TLC Visualizer 2 seems to be connected to the other.

We strongly suggest to use only one TLC Visualizer/TLC Visualizer 2 per InstrumentService (PC)

No image appears in Data or in Comparison after the initial installation of visionCATS on the PC

Restart Windows

Track Assignment doesn’t allow to drag & drop a multi-selection

Before clicking for drag and during the drag, hold SHIFT key for dragging a multi-selection

Application crashes after clicking on an image or opening a comparison

Update your graphic driver to the latest version

After installation, no visionCATS is installed. Also, the SQLServer service may not want to start.

Change the name of the user which installs the application, so that the username is different from PC and domain name

Instruments aren’t responding correctly

Check if you have an Intel(R) Active Management Technology - SOL COM port on your machine, and disable the corresponding COM port in visionCATS/General Settings

When using offline help, the display of some pages is very slow

Reason: the page requests an online resource that is not accessible, causing the slow down

Use the online help when possible. If not possible, try using Chrome or Firefox (instead of Internet Explorer), where the slow down occurs less often.

visionCATS fails in Scanner/Scanner 3 Diagnostics if the Positioning-Test is started in the same session.

Reason: Scanner data of the new test can not be stored for later processing. This does not invalidate the test results of the previous run.

Close the current Scanner Instrument Tab and reopen it. Attention: just switching between the Tabs inside the Instrument Tab will not prevent the failure. You need to close the Instrument Tab.

When installing visionCATS’s client on machines with Windows of different language (different code page), or restoring a backup on a machine with Windows of another language (code page), all passwords are corrupeted.

Reason: Passwords are encrypted using the code page of the local machine (client).

All visionCATS machines of a system (clients and server) should have the same Windows code page.

When installing visionCATS’s server on a machine with name including diacritic (like è or ó), the ports will always be marked as used, blocking the installation.

Reason: Depending on the query, Windows will use the host name with or without diacritic, creating mistmatch which result in errors.

Don’t use diacritic in host name (other international characters should work)

When installing visionCATS’s server on a machine with Region settings “Beta: Use Unicode UTF-8 for worldwide language support” enabled, SQL Server will fail to install .

Reason: Microsoft SQL Server don’t support codepage 65001 (UTF-8).

Uncheck “Beta: Use Unicode UTF-8 for worldwide language support”.