QuoteWerks Knowledgebase Topic (Article ID 6200)

ACT! - Advanced Troubleshooting and Debugging

This information applies to :

Article ID

March 7, 2012


Are you using the most current release of QuoteWerks?
Version 5.5 Build 1
6/25/2009 Update: In the upcoming build 49 there will be a QuoteWerks ACT! Integration Medic utility. It will be located in the "C:\Program Files\Common Files\QuoteWerks" folder and is accessible directly, or through the QuoteWerks Medic Utility under the Utilities|QuoteWerks ACT! Medic Utility menu. This is very useful in debugging complicated ACT! integration issues, including detecting and repairing ACT! framework registration issues due to failed ACT! updates, and blocked (by anti-virus or firewall) tcp ports which interfere with .NET component communication.

Running this utility first can save time by helping to pinpoint exactly where the integration is breaking.

Until build 49 or higher is available, this utility can be obtained free of charge by contacting support at: 407-248-1481 or support@quotewerks.com.

NOTE: Many of the steps mentioned in this article can be accomplished more efficiently by making use of the buttons available within the 'Advanced Debugging Options' of the QuoteWerks ACT! Integration Medic utility.

Errors occur when installing the QWActIntSetup.msi file (either when it runs during Node Installation (Nsetup.EXE) or when running the file by itself). Typically the error is simply that ACT! is not running when launching QuoteWerks, even though ACT! is indeed up and running.

All other troubleshooting steps have failed and now advanced troubleshooting is required.


Before trying these procedures, please see knowledgebase article 6017 - ACT! 2005 - Errors when starting QuoteWerks

There are multiple options for advanced debugging. All these steps require both ACT! and QuoteWerks to be closed:

1) Run the MachineConfigUpdater.EXE located in the Act For Windows Folder (typically located in C:\Program Files\ACT\Act for Windows). This file may only be available in ACT! 10.0.3 and higher.

2) Uninstall the "QuoteWerks 4.0 ACT! Link" through Add/Remove Programs, close out, and then rerun the QWACTIntSetup.msi file located in the main QuoteWerks folder (which would be located on the server if on a network, in a local hard drive if running a remote or stand alone). Once it finishes reinstalling, test the integration; if this did not resolve the error, move on to the next step.

3) Browse to the ACT! Plugins folder, typically located in the" C:\Program Files\ACT\Act for Windows" folder. Look for the files QWACTInt.Client.DLL, QWACTInt.Server.DLL, and QWACTInt.Common.DLL; if they are not present, the ACT! link did not install - anti-virus or permissions may have blocked it; review those settings and try the install of the QwACTIntSetup.msi file again once full access is granted. If they are present, leave this window open and move to the next step.

4a) If on Vista, click on Start then type CMD in the Search box at the bottom. An icon will display in the space above; right click on it and choose "Run as Administrator".

4b) If on XP, click on Start, click Run and type CMD into the Open field, then click Ok.

5) In the command prompt, type "cd C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727" (without the quotes) and hit enter on the keyboard.

6) Next, type "regasm /unregister " (without the quotes, but make sure to include the space between regasm and /unregister and the space after /unregister), then click and drag the QWACTInt.Common.DLL file from the Plugins folder into the Command window. It should populate with the path to the file. Hit enter, and it should say the file was unregistered successfully.

7) Repeat the same exact steps, except do so with the QWACTInt.Client.DLL file. It should also unregister successfully.

8) Now type in "regasm " (without the quotes, but with the space at the end) and drag QWACTInt.Common.DLL into the command window and hit enter. It should say it registered successfully.

9) Follow the same steps with QWACTInt.Client.DLL; this one may report it registered successfully or state the Act.Framework cannot be found.

10a) If it reports success, close out of the Command window and browse to the "C:\Documents and Settings\\Application Data\ACT\ACT for Windows ‘version number here’" (where the correspond to the logged in user's name and 'version number here' refers to the act version, such as "ACT for Windows 9"). Look for the DependantDlls.xml file; right click on it and rename it to DependantDlls.old. Open ACT!, then open QuoteWerks - the integration should work without issue now.

10b) If the command window reports that the Act.Framework file cannot be found, close the command window and browse to "C:\Program Files\ACT\ACT for Windows". Look for two files, gacutilitout.bat and gacutilit.bat. Double click on gacutilitout.bat first; this will uninstall all assemblies. Once it completes, run gacutilit.bat. This will reinstall those assemblies.

11) Repeat steps 4 through 9; this time, both of the dll files should report successful unregistration and reregistration. If they do, follow step 10a and the integration should work from this point.

New Search