Skip to main content

Installing the IF Data Reference

To install the IFDR:

  1. Log onto the machine running IF Server with administrative credentials.

  2. Run the Pimsoft Integration Framework Client setup.

  3. Run the IF Configurator and setup a valid connection with the IF Server.

  4. Test the connection and then close the IF Configurator.

  5. Go to Services and verify the following:

  6. The existence of Pimsoft.IFShadow.Service service.

    The user running the service has to be a local or domain user with administrative privileges over the machine running the IF Server and IF Shadow. In addition, the running user cannot be "Local System" or "Network Service."

  7. Start the Pimsoft.IFShadow.Service service.

  8. Install the IFDR Plug-In over the Sigmafine Server (for AF 2.9.5) by running the following command with administrative privileges.

    ClosedFor 32 bit machines

    \PIPC\AF\REGPLUGIN.EXE /PISYSTEM: \<YOURSERVER\> “Full Path of the Pimsoft.IF.Datareference.dll” /F

    ClosedFor 64 bit machines

    \PIPC\AF\REGPLUGIN64.EXE /PISYSTEM: \<YOURSERVER\> “Full Path of the Pimsoft.IF.Datareference.dll” /F

    Note: The “Full Path of the DLL” should be the installation folder. (e.g. C:\Program Files\IntegrationFramework\Configurator\DR_AF2x).

  9. Open PI System Explorer.

  10. Locate and select an Element and an Attribute.

  11. Change the Data Reference from "\<None>" to "Pimsoft IF DataReference" and begin configuring it.

    The first time you start the configuration, an Initialize IF connection... window opens. This happens because no initialization table has yet to be defined. Continue with the remaining steps to define the initialization table.Figure 1474: Initialize IF connection... window

  12. In the IF Server Name/IP box, type the name of the machine on which the IF Shadow Server is running.

    This machine must be the same one that is running the IF Server.

  13. In the IF Server Port box, leave the default Port address (8080).

    The IF Server Port can only be changed at the IF Shadow level.

  14. Click the Test button to test the connection and ensure that IF connects to the server successfully.

    If the connection is successful, an IF Shadow Configuration message window opens.Figure 1475: IF Shadow Configuration successful

    the installation is complete.

  15. Click OK to close the message window.

    You are returned to the Initialize IF connection... window.

  16. Click OK to save the configuration and close the Initialize IF connection... window.

    You can start using IFDR.

If you need to retrieve data from a particular Attribute of an element, the IFDR is the tool to use. For more details on this task, please see Configuring the IF Data Reference.

IMPORTANT: The creation of the initialization table should be done only once, as the table is then automatically stored in the system Database (called “CONFIGURATION”) as the "IFConfiguration" table. In the Case of a machine re-installation or another need that requires a re-install of IFDR, you can reset the connection settings by deleting the 'IFConfiguration' table. IFDR will discover that the table is missing and automatically ask you to provide the configuration parameters again.