Download 0514 Troubleshooting Connection Issues With Factelligence

8/22/13
Troubleshooting Connection Issues with Factelligence
Tech Note 514
Troubleshooting Factelligence Connection Issues
All Tech Notes and KBC D documents and software are provided "as is" without warranty of any kind. See the Terms of Use for more
information.
Topic#: 002245
C reated: January 2008
Introduction
This Tech Note provides general troubleshooting to take when you experience connection issues using Factelligence 3.1.
Connection issues are common to the following areas:
Installing the License Files
Customer License
SI License
Connecting to the Factelligence Database
First Time Connection
Re-creating the Database Connection
Note: The FactelligenceCFGEditor and the licensing must to be done on the Middleware server or the PC that is running
the Factelligence Component Application and not just the Component Application proxy. The Component Application proxy
normally runs on the client PC.
Installing License Files
When attempting to launch the Configurator you see the following message:
F IGURE 1: COM ERROR
This is because no license is installed.
You will need to install the Factelligence license file. License files are either end customer license and SI license. Below you
will find the steps for both:
Note: The message may vary depending upon which Factelligence module you open.
Installing the Customer License
1. From the Start menu select Programs/Wonderware/Factelligence/Activate.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
1/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 2: ACTIVATE LICENSE UTILITY
The License Activate Utility appears (Figure 3 below).
2. Type or copy your Activation Code and click Activate.
F IGURE 3: TYPE OR C OPY ACTIVATION C ODE
Note: If you have not received your activation code, contact Wonderware Technical Support.
Installing the SI License
Copy or extract the CIMNET.DATand CIMNET.RES files directly into the Middleware folder located at C:\Program
Files\Wonderware\Factelligence\Middleware. This location is where the Factelligence Component Application is
installed. Do this on the application server and not the proxy.
F IGURE 4: .DAT AND .RES F ILES
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
2/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 5: WONDERWARE\F ACTELLIGENCE\MIDDLEWARE LOCATION
Connecting to the Factelligence Database
After installing the license, make sure you have configured your connection to the Factelligence database. Failure to do this
generates the following message when you try to connect using the Configurator:
F IGURE 6: COM ERROR MESSAGE
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
3/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 7: COM ERROR FROM C ONFIGURATOR.CPP
Note: These error messages may take a few minutes to appear and may be different from the one shown in Figure 6,
depending on the Factelligence module that was executed.
First Time Connecting to Database
Use the following steps when connecting to the database for the first time.
To c onfigure a new database c onnec tion
1. Locate FactelligenceCfgEditor.exe at C:\Program Files\Wonderware\Factelligence\Middleware and doubleclick the file to open the configuator.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
4/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 8: F ACTELLIGENCEC FGEDITOR.EXE F ILE LOCATION
2. The Create Password dialog box appears (Figure 9 below). Enter a new password and confirm.
F IGURE 9: C REATE PASSWORD DIALOG BOX
Note: A different dialog box appears when you re-create the connection. See the Re-Creating the Database Connection
section below.
3. Click OK when you have created the new password.
The Factelligence.cfg Editor appears. Use the examples provided by the editor to create a connection string.
4. Select Examples from the main menu and click SQL Authentication.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
5/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 10: SQL AUTHENTICATION EXAMPLE SELECTION
The Connection Example Preview editor appears.
5. Click the Copy to Connection String button.
F IGURE 11: C OPY EXAMPLE TO C ONNECTION STRING
The string appears in the Editor (Figure 12 below).
6. Modify the string with the correct Server name, user name, password and Database name.
F IGURE 12: C ONNECTION STRING EDITOR
7. Click the Test button to test the connection. You will see Success in the Connection Test Results if you are
successful.
Note: The test button tests only the authentication of the Connection string and not the middleware connection to the
database.
8. Close the editor and save your changes when prompted.
F IGURE 13: SAVE Y OUR C HANGES
9. From the Start/Run menu, run the following command to open the DCOM Configuration Editor.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
6/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 14: START/RUN/DCOMCNFG.EXE
10. Under Services highlight the Factelligence Service.
F IGURE 15: F ACTELLIGENCE SERVICE
11. Stop the Factelligence Service.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
7/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 16: STOP
THE
F ACTELLIGENCE SERVICE
12. Under Component Services expand the following: Component Services/Computer/My Computer.
13. Click COM+ Applications. FACTELLIGENCE is listed in the left panel.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
8/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 17: F ACTELLIGENCE COM+ APPLICATION
14. Make sure that the ball inside the box icon is not spinning. If it is, right click on it and select Shut Down.
F IGURE 18: STOP
THE
FACTELLIGENCE COM+ APPLICATION
15. Select Services from the left panel, and start the Factelligence service.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
9/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 19: START THE F ACTELLIGENCE SERVICE
Re-Creating Connection to Database
Use the following section to re-create the database connection.
In the previous section, when you open the FactelligenceCfgEditor.exe if you saw a different dialog box asking for only a
password, you have previously configured a connection to database.
F IGURE 20: ENTER Y OUR PASSWORD TO RECONNECT
You can enter your password.
If you need to modify or change your connection string, see the following steps:
1. Complete steps 7-12 in the First Time Connection to Database section (above).
2. If you rember your password skip to step 5.
3. Find the Factelligence.cfg file located in the Middleware folder at C:\Program
Files\Wonderware\Factelligence\Middleware.
4. Right click the file and select Rename. Rename file to Factelligence.cfg1.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
10/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 21: RENAME THE F ACTELLIGENCE.CFG F ILE
5. Modify the connection string information by completing steps 3-6 in the First Time Connection to Database section
(above).
6. Restart the Factelligence service.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
11/12
8/22/13
Troubleshooting Connection Issues with Factelligence
F IGURE 22: RESTART THE F ACTELLIGENCE SERVICE
Click the following icon to view this file in .pdf format:
K. Porter
Tech Notes are published occasionally by Wonderware Technical Support. Publisher: Invensys Systems, Inc., 26561 Rancho Parkway South, Lake
Forest, C A 92630. There is also technical information on our software products at Wonderware Technical Support
For technical support questions, send an e-mail to [email protected].
Back to top
©2013 Invensys Systems, Inc. All rights reserved. No part of the material protected by this copyright may be reproduced or utilized in any form
or by any means, electronic or mechanical, including photocopying, recording, broadcasting, or by anyinformation storage and retrieval system,
without permission in writing from Invensys Systems, Inc. Terms of Use.
https://wdnresource.wonderware.com/support/kbcd/html/1/t002245.htm
12/12