In the following scenarios, a Syniti Data Workbench Client installation may point to the wrong Data Workbench Server to retrieve licensing and user information:
- Installing the Standalone version of Syniti Data Workbench by mistake
- Specifying the incorrect server when installing the Enterprise Version of Syniti Data Workbench
This can be corrected by editing the Syniti Data Workbench configuration files.
IMPORTANT: Syniti does not recommend editing configuration files except under extraordinary circumstances because mistakes when editing the file can cause the application not to work.
The configuration files, named DataWorkbenchMain.exe.Config and DiagnosticUtility.exe.Config , are located by default in:
- Version 9 releases: \Program Files (x86)\Quadrate\DataWorkbench\
- Version 10 releases: \Program Files (x86)\Syniti\Data Workbench\DataWorkbench
These files (not to be confused with the DataWorkbenchMain.exe and DiagnosticUtility.exe executable files) contain various configuration options that should normally be changed from the Data Workbench GUI.
More importantly, they also contains the URL reference to the Quadrate Authentication Server, located on the system where the Syniti Data Workbench Enterprise Server installation resides.
To point a Client Installation to the correct server, for both the DataWorkbenchMain.exe.Config and the DiagnosticUtility.exe.Config files:
- Make a backup version of the .Config file with a .backup extension.
- Open the .Config file in any text editor.
- Locate the snippet below:
<wellknown type="Quadrate.Common.Security.IQASProxy, Quadrate.Common.Security" url="tcp://localhost:3333/QASServiceProxy" />
<channel ref="tcp" port="0" />
<customErrors mode="Off" />
- Replace the highlighted text with the hostname, IP address, or fully qualified domain name of the computer that hosts the Server installation, without removing anything else.
- Save the file
- Be sure to complete this process for both files.
- Open Syniti Data Workbench.
The application should now connect to the Server installation’s QAS service, which will access the application database to retrieve all the license and user information.
- If you should encounter problems running Syniti Data Workbench, contact technical support and explain that you have edited the DataWorkbenchMain.exe.Config and DiagnosticUtility.exe.Config files.