IFIX Getting Started
IFIX Getting Started
GETTING STARTED
Trademark Notices
© 2014, General Electric Company. All rights reserved.
Proficy is a trademark of GE Intelligent Platforms, Inc., a wholly-owned subsidiary of General Electric Company.
* Indicates a trademark of General Electric Company and/or its subsidiaries.
All other trademarks are the property of their respective owners.
All other product names and marks identified throughout this book are trademarks or registered trademarks of their respective
companies. They are used throughout this book in editorial fashion only. No such use, or the use of any trade name, is intended to
convey endorsement or affiliation.
No part of this publication may be reproduced in any form, or stored in a database or retrieval system, or transmitted or distributed in
any form by any means, electronic, mechanical photocopying, recording or otherwise, without the prior written permission of GE
Intelligent Platforms. Information contained herein is subject to change without notice.
We want to hear from you. If you have any comments, questions, or suggestions about our documentation, send them to the following
email address:
[email protected]
Table of Contents
About This Guide .............................................................................................................................. 1
Using the Discover and Auto Configure Tool with Proficy Historian ......................................26
General Notes on Installing FIX and iFIX on the Same Computer .........................................27
Notes on Database Dynamos and Custom Programs that Run with iFIX Startup .................33
Toolbars ...................................................................................................................................... 37
VisiconX .................................................................................................................................. 40
Setting Up the Firewall for Use with Remote OPC Servers .......................................................49
Assistance .................................................................................................................................. 66
Index ............................................................................................................................................... 67
About This Guide
Welcome to iFIX®! Thank you for taking the time to install and use iFIX.
Before you begin installing our product, please take some time to review this Getting Started guide.
The guide includes information about the following:
• Installing iFIX
• Upgrading from earlier versions of iFIX
• Supported networking components
Reference Documents
For more information on the System Configuration Utility, troubleshooting your set-up, working with
the Proficy iFIX WorkSpace, or setting up a process database or SCADA system after you install iFIX,
please refer to the following electronic books:
1
Getting Started with iFIX
Set-up Overview
When you are ready to begin setting up your iFIX environment, use the following steps to set up your
nodes.
1. Set up each computer you require. Use the section Hardware Requirements as a guide and
refer to the user manual that accompanies each computer for detailed setup information.
2. Install and optimize Microsoft Windows on each computer as needed. Also make sure you
create a login account with administrator rights so you can install iFIX later. For instructions
on optimizing Windows, refer to the Optimizing Virtual Memory section.
3. Set up the network adapters and network software required for each computer. Refer to the
Networking iFIX Nodes and Advanced Topics chapters of the Setting Up the Environment
manual for more information.
4. Install iFIX and any other hardware you may have purchased. Refer to the Installing the iFIX
Software section for instructions. For information on installing other hardware, refer to that
product's documentation.
5. Configure iFIX on each computer. Make sure that the user installing iFIX is a member of the
Administrators Windows group. Refer to the Configuring iFIX Using the SCU chapter of the
Setting Up the Environment manual for more information on configuring iFIX.
Hardware Requirements
The minimum iFIX hardware requirements are:
2
Getting Started with iFIX
For Proficy HMI/SCADA - iFIX computers, the recommended minimum hardware requirements are:
• A 2.0 GHz Intel® Core™2 Duo Processor or better computer. For better performance, GE
Intelligent Platforms recommends a minimum 3 GHz computer with 4 GB memory or greater.
Be aware that the computer must be at least Dual-Core; a single core is not supported (with or
without hyper-threading). Hyper-threading is also not supported on multiple core computers.
• SpeedStep® technology is not supported and must not be enabled.
• For time synchronization, the Windows Net Time and W32tm commands are both supported.
However, if using the W32tm command, be sure to use the /nowait instruction when
resynchronizing the clock. For example: W32tm /resync /nowait. The /nowait parameter
instructs the operating system to make a stepping adjustment against the time server.
• The power save settings on your computer must be disabled. Do not use any power setting
features that affect CPU clock speed.
• A minimum of 2 GB RAM. For better performance, please consider using more.
NOTE: To use more than 4 GB of memory on a 32-bit platform you need to use Physical
Address Extension (PAE). For more information on PAE please reference
http://msdn.microsoft.com/en-us/library/windows/desktop/aa366796%28v=vs.85%29.aspx
• A minimum of 10 GB of free hard drive space for iFIX pictures, databases, alarm files, and
other data files. Even after allowing for an extra GB for iFIX, it is strongly recommended that
many GBs of additional free space exist on the hard drive to avoid performance issues.
• Be aware that iFIX alarm and historical data files grow dynamically. If you plan to perform
extensive alarm or data collection on a node, you may need more disk space on that particular
node.
• Other Proficy products, such as Proficy Plant Applications, Proficy Historian, and Proficy
Real-Time Information Portal, impose additional requirements. Refer to the Important
Product Information (IPI) topic in the product's electronic books for specific system
requirements. Click the System Req. tab in that product's IPI for details.
• A DVD drive.
• 100 MBit or faster Full Duplex TCP/IP-compatible network interface adapter for iFIX
network communication between SCADA and Client nodes.
NOTE: iFIX no longer supports NetBIOS.
NOTE: iFIX does not support IPv6.
• One free direct-connect USB port. Some touch screens, pointing devices, and I/O drivers
require a serial port. Additional ports for I/O hardware should be ordered with the computer.
• SVGA or better color monitor with a 24-bit (16,777,216 colors) graphics card capable of at
least 1024x768 resolution. For Windows 7, the graphics cards should be “Windows 7
(certified)”.
• Two-button mouse or compatible pointing device (such as a touch screen) that is capable of
opening a context menu.
For Proficy HMI/SCADA - iFIX computers with SCADA Enhanced Failover features enabled, the
recommended minimum hardware requirements are (for both primary and secondary computers):
3
Getting Started with iFIX
IMPORTANT: The minimum requirements below assume that you are running only a SCADA server
without additional applications, such as EDA applications. If you want to run more applications, you
will need to increase your hardware support for better performance.
• A 3.0 GHz Intel® Core™2 Duo Processor or better computer. For better performance, please
consider using higher. Be aware that the computer must be at least Dual-Core; a single core is
not supported (with or without hyper-threading). Hyper-threading is also not supported on
multiple core computers.
• SpeedStep® technology is not supported and must not be enabled.
• For time synchronization, the Windows Net Time and W32tm commands are both supported.
However, if using the W32tm command, be sure to use the /nowait instruction when
resynchronizing the clock. For example: W32tm /resync /nowait. The /nowait parameter
instructs the operating system to make a stepping adjustment against the time server.
• The power save settings on your computers and dedicated network card (NIC) must be
disabled. Do not use any power setting features that affect CPU clock speed.
• A minimum of 4 GB RAM. For better performance, please consider using more.
NOTE: To use more than 4 GB of memory on a 32-bit platform you need to use Physical
Address Extension (PAE). For more information on PAE please reference
http://msdn.microsoft.com/en-us/library/windows/desktop/aa366796%28v=vs.85%29.aspx
• One additional Gigabit-Ethernet card (or better) dedicated for SCADA-to-SCADA traffic (for
a total of at least 2 network cards). The dedicated SCADA-to-SCADA network card should be
excluded from the iFIX-to-iFIX network (not enabled for LAN redundancy), and used
exclusively for Enhanced Failover synchronization. Both network cards must be of the same
speed, and appear on the compatibility list for each card. It is strongly recommended that the
cards be of the same make and model number, and use the same drivers.
IMPORTANT: You must use a direct connection via a Cat6 crossover cable, without going
through any switches, hubs, or routers. Due to limited bandwidth and latency, wireless
networking technology should not be considered.
• The wake-up upon receiving a socket or/and request feature must be disabled on the dedicated
SCADA-to-SCADA network card.
• Jumbo Frames technology must be used on the dedicated network for Enhanced Failover.
Jumbo Frames technology allows for an Ethernet frame of 9000 MTU for the payload,
compared to a frame of 1500 bytes without the Jumbo Frames.
• A minimum of 10 GB of free hard drive space. Even after allowing for an extra GB for iFIX,
it is strongly recommended that many GBs of additional free space exist on the hard drive to
avoid performance issues.
Be aware that iFIX alarm and historical data files grow dynamically. If you plan to perform
extensive alarm or data collection on a node, you may need more disk space on that particular
node.
• Other Proficy products, such as Proficy Plant Applications, Proficy Historian, and Proficy
Real-Time Information Portal, impose additional requirements. Refer to the Important
Product Information (IPI) topic in the product's electronic books for specific system
requirements. Click the System Req. tab in that product's IPI for details.
• Primary and Secondary SCADA computers located physically next to each other, in the same
location/room.
• A DVD drive.
• 100 MBit or faster Full Duplex TCP/IP-compatible network interface adapter for iFIX
network communication between SCADA and Client nodes.
4
Getting Started with iFIX
For Proficy HMI/SCADA - iFIX computers with Proficy Historian for SCADA, the recommended
minimum hardware requirements are:
• A 3.0 GHz Intel® Core™2 Duo Processor or better computer. For better performance, please
consider using higher. Be aware that the computer must be at least Dual-Core; a single core is
not supported (with or without hyper-threading). Hyper-threading is also not supported on
multiple core computers.
• SpeedStep® technology is not supported and must not be enabled.
• For time synchronization, the Windows Net Time and W32tm commands are both supported.
However, if using the W32tm command, be sure to use the /nowait instruction when
resynchronizing the clock. For example: W32tm /resync /nowait. The /nowait parameter
instructs the operating system to make a stepping adjustment against the time server.
• The power save settings on your computer must be disabled. Do not use any power setting
features that affect CPU clock speed.
• A minimum of 4 GB RAM. For better performance, please consider using more.
NOTE: To use more than 4 GB of memory on a 32-bit platform you need to use Physical
Address Extension (PAE). For more information on PAE please reference
http://msdn.microsoft.com/en-us/library/windows/desktop/aa366796%28v=vs.85%29.aspx
• A minimum of 40 GB for free hard drive space. It is strongly recommended that many GBs of
additional free space exist on the hard drive for growing Archiver files and to avoid
performance issues.
Be aware that archiver data files grow dynamically. If you plan to perform extensive iFIX
data collection on a node, you may need more disk space on that particular node.
• Other Proficy products, such as Proficy Plant Applications, and Proficy Real-Time
Information Portal, impose additional requirements. Refer to the Important Product
Information (IPI) topic in the product's electronic books for specific system requirements.
Click the System Req. tab in that product's IPI for details.
• A DVD drive.
• 100 MBit or faster Full Duplex TCP/IP-compatible network interface adapter for iFIX
network communication between SCADA and Client nodes.
NOTE: iFIX does not support IPv6.
• One free direct-connect USB port. Some touch screens, pointing devices, and I/O drivers
require a serial port. Additional ports for I/O hardware should be ordered with the computer.
• SVGA or better color monitor with a 24-bit (16,777,216 colors) graphics card capable of at
least 1024x768 resolution. For Windows 7,the graphics cards should be "Windows 7
5
Getting Started with iFIX
(certified)".
• Two-button mouse or compatible pointing device (such as a touch screen) that is capable of
opening a context menu.
The hardware requirements for running iFIX on the Windows Embedded Standard 7 operating system
include:
RUN=%FIXTOHIST.EXE
• 100 MBit or faster Full Duplex TCP/IP-compatible network interface adapter for iFIX
network communication between SCADA and Client nodes. Since the server bandwidth
scales linearly with the number of clients connected, the speed of the network card on the
server should be able to accommodate these connections.
NOTE: iFIX no longer supports NetBIOS.
• One free, direct-connect USB port. Some touch screens, pointing devices, and I/O drivers
require a serial port. Additional ports for I/O hardware should be ordered with the computer.
• SVGA or better color monitor with a 24-bit (16,777,216 colors) graphics card capable of at
least 800x600 resolution.
• Two-button mouse or compatible pointing device (such as a touch screen) that is capable of
opening a context menu.
IMPORTANT: There are risks associated with using a Compact Flash or a similar device as
6
Getting Started with iFIX
a Primary drive in the Windows Embedded environment with the iFIX product and your
production data. These types of devices have a lifetime associated with them regarding the
number of writes the device is capable of over a lifetime. As such, storing production data on
such a device may result in lost data, over the long term. If the system has a physical drive,
and not a Compact Flash or a similar device, the production data is affected by this risk.
NOTE: Be aware that iFIX Enhanced Failover is not supported on Windows Embedded. For
a complete list of unsupported items on Windows Embedded, refer to the "Recommendations
and Unsupported Items" section on the Release Notes tab.
Due to the wide range of parameters associated with the hardware, configuration, memory settings,
third-party software installations, and the number of virtual machines running, GE Intelligent
Platforms recommends that you visit the VMware web site to help you determine the hardware
requirements for configuring your virtual environment. Start by looking at the VMware Compatibility
Guide, provided by this link on the VMware web site:
http://www.vmware.com/resources/compatibility/search.php
iFIX provides support for VMware ESXi Server version 5.0 and above. The virtualization capability
provided by VMware lets you run multiple virtual machines on a single physical machine, with each
virtual machine sharing the resources of that one physical computer. Please be aware that while we
have tested VMware ESXi 5.0 and above, issues with the VMware software or the virtualized
environment are outside the scope of GE Intelligent Platform's responsibility.
• The Enhanced Failover feature was tested with up to 10,000 tags on VMware.
• Per the system requirements for Enhanced Failover, Jumbo Frames technology must be used
on the dedicated network for Enhanced Failover. Jumbo Frames technology allows for an
Ethernet frame of 9000 MTU for the payload, compared to a frame of 1500 bytes without the
Jumbo Frames. This payload requirement does not change if you are using VMware with
Enhanced Failover. When using Enhanced Failover with VMware, be sure you are using the
9000 MTU setting (the default setting is 1500). On the ESXi Server, you can configure the
MTU settings by clicking the Configuration tab. Under the listed Hardware, select
Networking then chose the Properties option for the Virtual Switch that you want to
configure. On the Ports tab, select the Virtual Switch that is listed and then double-click it.
This action brings up the General tab. The MTU settings are located in the Advanced
Properties section of this tab.
• When setting up and creating virtual switches, and adding/or removing virtual NICs in the
Virtual Machine Settings, treat the virtual hardware as you would physical hardware. When
setting up the virtual machine, power down the machines before adding/removing NIC cards.
Validate all virtual MAC addresses and IP settings at the VMware HOST level, the virtual
machine level, and within the Guest operating system.
7
Getting Started with iFIX
ESXi servers have power meter functions and options as well as the ability to suspend images to
conserve power. We do not recommend or support these functions due to the potential effects on the
Guest operating system, specifically in regards to polling I/O and timely updates.
• There are a multitude of devices and methods of communications on the market. These
devices may be used if you can successfully connect them from the virtual machine through
the physical HOST, but we do not support the setup of that connection. Be aware that device
drivers used to write to proprietary cards for the ESXi HOSTS as part of virtual device setup
can cause issues.
The USB controller has these limitations when using iFIX and VMware:
USB devices have these limitations when using iFIX and VMware:
• A virtual machine may have up to 20 USB devices attached to it, however each unique USB
device can only be attached to one virtual machine at a time.
• Unsupported USB devices may not interact as expected with other ESXi features.
GE Intelligent Platforms cannot guarantee the performance of the iFIX software in a virtualized
environment due to the wide range of parameters associated with the hardware, configuration, memory
8
Getting Started with iFIX
settings, third-party software installations, and the number of virtual machines running – all of
which can affect performance. Therefore, GE Intelligent Platforms cannot provide support related to
the performance of the iFIX software running on a virtual machine if its determined that the issue is
related to the virtual environment. Also, GE Intelligent Platforms does NOT provide support or
troubleshoot a customer's virtual machine infrastructure.
It is the responsibility of you, the customer, to ensure that the performance of the iFIX software and
any third-party applications (especially those not recommended by GE Intelligent Platforms) are
adequate to meet the needs of your run mode environment. GE Intelligent Platforms does not support
issues related to functionality that is not available as a result of running in a virtual machine
infrastructure. Examples include the functionality of card level drivers such as those for the Genius®
family of drivers, the Allen-Bradley® DH/DH+ drivers, the Cyberlogic's MBX® Driver for the SA85
card, as well as functions requiring direct video access. Check with the vendor of your third-party
application for support statements regarding that third-party product's ability to run in a virtualized
environment.
For more detailed information regarding VMware specifications and requirements, please visit the
VMware web site:
http://www.vmware.com/resources/compatibility/search.php
An iFIX network that contains iFIX version 5.8 with Enhanced Failover SCADA nodes and also
contains older iFix client nodes may not be supported:
• An iFIX client node, installed with iFIX version is 5.5 or later, is fully compatible with iFIX
version 5.8 with Enhanced Failover SCADA nodes.
• An iFIX client node, installed with iFIX version is 5.1 and updated with the
iFix51_Pulse10_Workspace_019 SIM (Software Improvement Module), is fully compatible
with iFIX version 5.8 with Enhanced Failover SCADA nodes.
• An iFIX client node, installed with iFIX version is 5.1 and is not updated with the
iFix51_Pulse10_Workspace_019 SIM is not compatible with iFIX version 5.8 with Enhanced
Failover SCADA nodes.
• An iFIX client node, installed with iFIX version is 5.0 or earlier, is not compatible with iFIX
version 5.8 with Enhanced Failover SCADA nodes.
IMPORTANT: In an Enhanced Failover pair, both SCADA nodes must have the same iFIX version
installed with all SIMs.
Recommended Computers
iFIX has been tested by GE Intelligent Platforms on the following computers:
9
Getting Started with iFIX
While GE Intelligent Platforms cannot guarantee the integrity of any computer, our testing has shown a
higher potential for problems with the economy lines of computers on the market. Because of these
problems, it is not recommended that you use value or economy type computers with iFIX. Instead, it
is recommended that you invest in the higher end (premier) line of computers when purchasing
computer hardware.
Memory Requirements
iClients and SCADA nodes (without Enhanced Failover or Proficy Historian for SCADA) require at
least 2 GB RAM. For better performance, please consider using more.
If the size of your process database is over 1MB, add 1 megabyte of memory for each megabyte of
database size. For example, if your database is 2MB in size, your SCADA server requires 130MB
minimum (128+2=130).
If your picture cache size increases, your memory requirements should increase:
• 2 to 3 times the file size for each picture that does not include bitmaps and controls.
• 3 to 4 times the file size for each picture that includes bitmaps and controls.
For example, a 2 megabyte file that does not include bitmaps and controls requires a 4 to 6 megabyte
increase in memory. A 2 megabyte file that includes bitmaps and controls requires an increase in the
memory of 6 to 8 megabytes.
To help minimize this problem, the WorkSpace warns you if you have less than 10 MB of disk space
available. Although you can continue loading the software, we recommend that you stop iFIX, free
some disk space, then restart. Otherwise, the WorkSpace may become unstable.
The WorkSpace examines the iFIX Picture path and the Windows TEMP path when it starts. If you
change either path so that they reference different drives, for example, D:\Program
Files\Proficy\Proficy iFIX and C:\Temp, the WorkSpace requires 10 MB on each drive.
10
Getting Started with iFIX
You may find that 10MB is not enough space to protect against instability during file save operations.
You can increase this threshold by changing the FreeDiskSpace parameter in the
FixUserPreferences.ini file. This parameter sets the minimum amount of space that the WorkSpace
requires in bytes. By default, the parameter is set as follows:
[AppRunPreferences]
FreeDiskSpace=10000000
Software Requirements
The minimum iFIX software requirements are:One of the following operating systems:
11
Getting Started with iFIX
Edition. Since Windows Vista has continuous updates, you should run the Windows
update feature to get the latest software.
• Microsoft® Windows® Embedded Standard 7, Service Pack 1, with latest Microsoft
Windows updates.
NOTE: Only English Windows Embedded, with English regional settings, is
supported with English iFIX; other language operating systems or regional settings
for Windows Embedded are not supported
• Network interface software for TCP/IP network communication and certain I/O
drivers.
• If you are using third-party software along with iFIX, make sure that the third party
software is also supported for the operating system you are running iFIX on. For
instance, if you are running iFIX on Microsoft Windows Vista, your third party
software must also be supported on Microsoft Windows Vista.
• An I/O driver for SCADA servers. GE Intelligent Platforms supplies I/O drivers for
many programmable controllers or you may purchase a driver separately.
IMPORTANT: Be certain that the I/O driver you purchase is compatible with your
hardware and operating system. For example, if the driver is not supported on a
specific operating system, then you cannot use this driver with iFIX running on that
operating system. For more information drivers and supported operating systems,
check our support web site at: http://support.ge-ip.com.
• If using VisiconX and Proficy Historian, you must install the Historian OLE DB driver.
• If using the Plant Applications Dynamos in iFIX pictures, Microsoft Office 2003, 2007, or
2010(32-bit) is required.
• One of the following relational database applications, if relational database software is used
with iFIX:
• Microsoft® SQL Server 2008.
• Microsoft® SQL Server 2008 R2.
• Microsoft® SQL Server 2012.
• Oracle® 11g R2.
• Microsoft® Access 2000 (or higher). Microsoft Access is supported for local installs
only.
iFIX supports the following regional settings available in the Windows Control Panel:
12
Getting Started with iFIX
NOTE: The decimal symbol and the digit grouping symbol cannot be the same character. Also, the
time separator and the date separator cannot be the same character.
Avoid changing the time style or short date style in regional settings to values that are outside of the
standard styles provided. Changing these values to non-standard styles may result in improperly
formatting times and dates in some parts of iFIX.
iFIX supports the following short date formats, some of which may not be available in certain
language versions of Windows:
• dd/mm/yy, or dd/mm/yyyy
• dd/yy/mm, or dd/yyyy/mm
• mm/dd/yy, or mm/dd/yyyy
• mm/yy/dd, or mm/yyyy/dd
• yy/dd/mm, or yyyy/dd/mm
• yy/mm/dd, or yyyy/mm/dd
Avoid changing the language setting once a timer has been used in a schedule. If changed, the date
always reverts to 30/12/99, regardless of what you set the start time to be.
Language Support
The iFIX English product with English regional settings is supported on English, non-English single-
byte, double-byte, and Cyrillic Windows operating systems. However, be aware that double-byte
characters are not supported on single-byte operating systems (OSs). For example, you cannot display
Chinese or Japanese characters on an English OS with an English iFIX product installed. For a detailed
list of the iFIX supported operating systems, refer to the Software Requirements section in this chapter.
The iFIX product is also available in other languages. The following table outlines the currently
supported languages and operating systems. For more information on the available iFIX versions for
each language, contact your regional Sales Representative.
13
Getting Started with iFIX
IMPORTANT: English iFIX installed on Windows Embedded Standard 7 is only supported on the
English Windows Embedded Standard 7 operating system, with English regional settings. No other
languages are currently supported for Windows Embedded Standard 7.
English iFIX English OS, Chinese OS, Japanese OS, Polish OS, Russian OS,
French OS, and German OS – all only with English regional settings
Unsupported Items
• GE Intelligent Platforms does NOT support running the localized version of the product on an
English operating system.
• Multilingual User Interface versions of the Windows Operating Systems are not supported by
the iFIX product.
• iFIX client/server configurations with different OS languages are not supported. For instance,
connecting an English SCADA Server (on an English OS) with a German View node or
iClient (on a German OS) is not supported.
• Double-byte characters are not supported on single-byte operating systems.
Video Drivers
After much testing, GE Intelligent Platforms has found that some video drivers have unique problems
that are apparent only when using these drivers. Additionally, GE Intelligent Platforms has found that
many problems with video drivers occur in both iFIX applications and common applications, such as
Excel and Word.
If you are experiencing problems with your video driver, try using it in a different mode to find out if
the problem is unique to a specific configuration.
14
Getting Started with iFIX
may experience:
• Contact the manufacturer to ensure you have the latest version of the video driver. GE
Intelligent Platforms has found that the latest version of third-party video drivers can fix some
problems.
• If the latest version of the video driver does not fix the problem, notify the video driver
manufacturer to see if they are aware of the problem.
• If all else fails to resolve the problem, contact Technical Support.
6. Select Set.
7. Click OK to save the changes and exit the dialog box.
NOTE: If the paging file is set to grow dynamically, your system may experience severe
performance problems during runtime. To ensure optimal performance, be sure that the
Initial Size and Maximum Size of the paging file are the same so that the paging file does not
grow dynamically.
15
Getting Started with iFIX
Windows Services
In the Windows Services control panel, do not stop the iFIX service or make changes to the iFIX
configuration. This applies to iFIX running on any operating system.
In Windows 8 and 8.1, there is a functionality available in the Power Options called “Fast startup”
(Power Options are accessible from the Settings > Control Panel). When “Fast startup” is enabled as a
Power Option (the default) and you power down your computer or tablet, Windows will save the
current state of the system. The next time you restart Windows, your previous state is restored. This is
because, by default, Microsoft Windows 8 and 8.1 shuts down by logging off all users and then
hibernating. In this case, any service that was running will continue to run on the next startup.
When iFIX is running as a service, you may want to avoid this "Fast Startup" functionality. To revert
to the full shutdown on Windows 8 and 8.1, in the Power Options on the SCADA Server, select
"Choose what the power buttons do." Select the “Change settings that are currently unavailable” option
and then scroll down to the Shutdown Settings area, and clear the “Turn on Fast startup” option.
(The "Fast Startup" feature is not available on Microsoft Windows Server 2012.)
NOTE: The check boxes in the Service area of this dialog box are unavailable while iFIX is
running. You need to shut down iFIX, as you did in step 1, to update them.
6. Additionally, if you want to start iFIX whenever you start Windows, select the Start iFIX at
system boot check box.
16
Getting Started with iFIX
The Start iFIX at system boot option is available only when the Continue running after Logoff
option is selected.
7. Click OK.
8. Exit the SCU.
9. Restart iFIX.
iFIX Paths
Windows does not map network drives until a user logs in. Therefore, if you are running iFIX as a
service under Windows, all iFIX paths must be set to a local drive.
You must assign the Enable Ctrl+Alt+Del application feature to the user that is logged in when iFIX is
running as a service. Otherwise if a user logs out of the operating system while iFIX is running as a
service, no one will be able to log back in to the operating system.
You must configure the Default Service SCU in the Startup Profile Manager if you want to run iFIX as
a service on the Terminal Server. For more information, refer to the Configuring the Default Profile
section in the Using Terminal Server electronic book.
By default, iFIX uses the local System account when running as a service. However, you cannot use
the System account with certain applications, such as Proficy Historian for SCADA.
17
Getting Started with iFIX
Fast user switching is not supported with iFIX, even if you are running iFIX as a service.
If you want to run the OPC Client driver as a service, iFIX must also run as a service. Likewise, if you
want to run iFIX as a service, the OPC Client driver must run as a service. You cannot run one as a
service, without the other also running as a service.
If you plan to use environment protection when iFIX is running as a service, and you are running on an
operating system earlier than Microsoft Windows 8 or Windows Server 2012, be sure to add
TSFE.EXE to your Windows Startup program group. TSFE.exe is an iFIX application (located in your
iFIX install folder) that enables task switching and keyboard filtering when a new user logs into
Windows. By adding TFSE.exe to your startup group, you are ensuring that users can log into
Windows with environment protection enabled and then operate iFIX in an appropriate, secured
environment. Operating systems such as Microsoft Windows 8 or Windows Server 2012 do not
require TFSE.exe in your startup group, since they work differently.
For more detailed information about Environment Protection, refer to the Configuring Security
Features e-book. The Restricting Access in the Run-time Environment topic in the Defining and
Assigning Security Privileges chapter, in particular, has detailed information with links to more
information.
It is not recommended that you run Workspace.exe in the SCU task list when iFIX is running as a
service.
OPC Certification
Based on Microsoft's OLE (Object Linking and Embedding) technology, OPC (OLE for Process
Control) provides greater interoperability between control applications, field systems and devices, and
front office/backoffice applications. OPC servers, such as DCSs, PLCs, smart field devices, and
analyzers provide real-time information and can communicate directly with the Proficy HMI/SCADA -
iFIX product.
The iFIX product is an OPC 2.05a DA enabled client, which lets iFIX retrieve data from any OPC 1.x
or 2.x (up to version 2.05a) compliant data server. To access local or remote data from a third party
OPC Server, use the iFIX OPC Client version 7.4x, which is also in included with iFIX.
iFIX also has an iFIX OPC Server (OPC20iFIX.exe) that serves out data via OPC from the iFIX
Database.
18
Getting Started with iFIX
Both OPC Servers included with iFIX are in compliance with the OPC Foundation's "Self Tested"
specifications. GE Intelligent Platforms ran a series of OPC tests to verify compliance for the versions
listed above.
You can find more information about OPC on the Support web site at: http://www.ge-ip.com/support.
NOTES:
• The iFIX DVD no longer includes Proficy Historian for SCADA or Proficy WebSpace
(previously known as iFIX WebSpace). These products are now distributed on separate
DVDs. To upgrade these products, you must obtain the DVD for that product.
• FIX Desktop is no longer distributed on the iFIX DVD. During an upgrade scenario, the
existing programs will remain on the machine but this feature is no longer supported. For
new installations, these programs will not be deployed.
IMPORTANT: Installing or uninstalling iFIX via a remote desktop connection or through a terminal
server session is not supported.
For iFIX upgrade steps or for more general information on upgrading iFIX, refer to the Upgrading
from an Earlier Version of iFIX and Upgrading from FIX 7.x sections.
2. Insert the iFIX DVD into your DVD drive. The iFIX installation screen appears.
NOTE: If this screen does not automatically appear, double-click the InstallFrontEnd.exe file
on the DVD to display it. A message may appear with a security warning, click Run to
proceed.
3. Click the "Install iFIX" link. A message box appears asking you to confirm the install.
4. Click Yes to proceed. An informational message box appears.
5. Click Yes to proceed. The install program starts and the Welcome screen appears.
6. Click Next to continue. The license agreement screen appears.
7. Click "I accept the terms of the license agreement" if you want to continue, and then click
19
Getting Started with iFIX
Next.
IMPORTANT: If a previous version of iFIX is detected, you can choose to upgrade iFIX. For
iFIX versions before 4.0, you have the choice to upgrade or install iFIX to a completely new
folder, without upgrading. If you want to upgrade, it is suggested that you do so using the
install at this point in time.
• If you are upgrading from FIX32, make sure that you choose a location other than the
folder that contains your FIX32 software, if it is installed on the same computer. Do
not install over a current FIX32 installation.
• If you enter a custom install path, be aware that the path can be no greater than 100
characters long.
• If you want to use 6.x drivers, the iFIX compressed install path must be no greater
than 64 characters long. iFIX uses the Microsoft compression algorithm to try to fit
longer paths within this boundary. Some paths are not compressible to the 64
character maximum length. Please be aware of this. In addition, make sure that the
registry key,
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\FileSystem\NtfsDisabl
e8dot3NameCreation, is not enabled (is set to 0) when the install folder is created.
When set to 1, the compression algorithm is disabled. Refer to Microsoft help for more
information on the GetShortPathName() compression algorithm.
• After installing a 6x driver, the driver is listed in the SCU in the Drivers Available
dialog box (which can be accessed from the I/O Driver Name browse button in the
SCADA Configuration dialog box). You need to manually add the driver to the
Configured I/O Drivers list in the SCADA Configuration dialog box.
20
Getting Started with iFIX
For example, if you want to set up a SCADA server without any remote nodes, select SCADA
and Stand-alone. If you want a networked SCADA server, select SCADA and Networked. If
you want to configure a networked client, select View and Networked.
TIP: As a best practice, be sure to enter a new name in the Node Name field. Use a name
other than the default name of FIX for your node name. This distinction is important if you
have multiple SCADA nodes on the same network.
After you configure your settings and click OK, and if prompted to enter your remote nodes
(for a networked node), enter the name of your Remote SCADA node(s), click Add, and then
click OK. Otherwise, click Skip and you can configure this at a later time in the SCU (from
the Configure > Network menu option).
A message box requests that you enable Proficy HMI SCADA iFIX through the firewall, if
the Windows firewall is enabled.
13. Click Yes to continue (otherwise, you may need to do this later, if the firewall is enabled).
The install continues. For all operating systems except Microsoft Windows Embedded
Standard, a message box appears requesting you install KB 974945 for Microsoft® Visual
Basic for applications.
IMPORTANT: For the Microsoft Windows Embedded Standard operating system only, iFIX
does not prompt you to install KB 974945 for Microsoft® Visual Basic for applications.
Instead, it continues with the Proficy installation (Step 16). After the iFIX installation
completes, you must install KB 974945 for Microsoft® Visual Basic separately as described
in Step 21.
14. Click Yes to continue. Another message box appears with the Microsoft license agreement for
this update.
15. Click Yes to continue. A message box appears after the patch installs.
16. Click OK to continue. The Proficy install continues.
17. When a message box appears requesting that you view the release notes, click Yes. Close the
release notes after you finish reviewing them to resume the install. The Setup Complete
screen appears.
18. Select Yes to restart your computer, and then click Finish.
19. After you restart your computer and the install completes, install your product licensing. For
information on installing and configuring your license, refer to the GE Intelligent Platforms
Support site: http://support.ge-ip.com/licensing.
20. Restart the computer again. As the computer restarts, log in to Windows with the same user
name (with Administrator rights).
NOTE: If a previous version of iFIX already resides on your computer when you try to install
the latest version of iFIX, a message box appears during the installation suggesting that you
upgrade your existing iFIX install. It is recommended that you elect to upgrade iFIX when
this message appears. By following the upgrade process, iFIX installs to same folder where
your previous version existed. For example, if you have iFIX 3.5 installed to the C:\Dynamics
folder, when you upgrade, the newer version of iFIX installs to the C:\Dynamics folder. After
the iFIX upgrade completes and you restart iFIX, your SCU file is upgraded automatically,
and the original file is backed up with a .^CU extension. For more information on upgrading
SCU files, refer to the SCU Files and the Upgrade section.
21
Getting Started with iFIX
• A message box asks "Are you sure you want to install Microsoft Visual Basic for
Applications Update - KB974945?" Click Yes to continue.
• The Microsoft license agreement appears. Click Yes to accept the agreement and to
continue with the installation.
• A progress bar briefly appears, followed by a message box that informs you that
Microsoft Visual Basic for Applications Update is now installed
22. Check if there are any required Service Packs or SIMs to install for iFIX on the GE Intelligent
Platforms Support web site, and install them.
23. If you just installed a SCADA Server, change the default iFIX Administrator password in the
Security Configuration program. iFIX must be running to do this. For steps on how to change
the password and other user account settings, refer to the Modifying a User Account topic in
the Configuring Security Features e-book. Make sure you save this password.
24. If you are using iFIX on a Domain, in a client/server networking configuration, update the
HOSTS file with the name of the iFIX SCADA Server, to ensure the highest reliability for
connectivity. This update must be done on the server and all clients, as the contents of the
HOSTS file should be identical on each node (client and server) in your TCP/IP network. If
your iFIX SCADA Server node name is different from the computer name where iFIX is
installed, you also need to add this name to each HOSTS file.
TIPS:
• You can find the HOSTS file in the C:\WINDOWS\system32\drivers\etc folder.
• Use a text editor, such as Notepad to edit the HOSTS file, and do not add a file
extension to the file.
• An example entry in the HOSTS file is as follows: 198.212.170.4 SCADA01. If
SCADA1 was the iFIX SCADA Server node name, but the computer name where the
iFIX SCADA Server was installed was AREA1, you would need to add a second line to
the HOSTS file for AREA1: 198.212.170.4 AREA1.
• If you do not know the TCP/IP address of the SCADA computer, run the IPCONFIG
command on the SCADA Server.
• Be sure to update the HOSTS file on the SCADA Server and each iFIX Client that you
install.
• The same, identical entries should appear in the HOSTS file for the iFIX SCADA
Server and each iFIX View node (Client) on your network.
25. If you just installed an iFIX View (Client) node, and you want to be able to view pictures
from the SCADA Server from this node, you need to either: copy the pictures from the iFIX
SCADA to the iFIX client (no database or other files need to be copied), or map a drive on the
View node to the picture folder on your SCADA Server. You should then update the SCU
(with Configure > Paths menu option) on the View node to point to this mapped drive
location.
22
Getting Started with iFIX
• Set Proficy Historian tags for collection for the iFIX database.
• Insert a Historical Data Link into your picture in the iFIX WorkSpace.
• Use VisiconX data and grid objects to access Proficy Historian data from the iFIX
WorkSpace.
When making your decision on how you want to use Proficy Historian with iFIX, keep the following
considerations in mind.
Configuration Considerations
Although many of the features of Proficy Historian can be configured in iFIX, some cannot. They must
be configured directly in Historian. These features include:
• Security
• Alarms, if you are using them
• Collection on any field other than F_CV.
• Archive compression
• Archive back-up
• Other tag properties not configurable in iFIX
• Historian parameters for Database Dynamos, or loadable blocks
• Redundancy
Other Considerations
Multiple Databases
Only a single, local database is supported with Proficy Historian for SCADA. If you want to use
multiple databases, you may want to use Proficy Historian separately from iFIX. When used together,
Historian does not recognize tags from the iFIX database with the same name as different tags, even
though the source is different. So, tags that exist in your iFIX database are ignored. The data that is
populated comes from Historian, not from the iFIX database. To avoid this problem, verify that each
tag has a unique name.
When using multiple iFIX databases that have the same node name and the same tag name, Proficy
Historian will be unable to discriminate a tag coming one node with a tag coming from another node,
and these tags will be subsequently be ignored. It is best practice to not use the same iFIX node name
on multiple nodes.
For example, you have a tag called AI1 in both Process Database 1 (PDB1) and Process Database 2
(PDB2). Both tags are added to Historian as FIX.AI1.F_CV. If you reload PDB1 and then PDB2, the
AI1 tag is overwritten in Historian.
23
Getting Started with iFIX
Collection Delay
When iFIX and Proficy Historian for SCADA are used as an integrated application, rather than as
separate applications, it takes longer for tags to update if the Collector is running. Additions, deletions
and modifications of tags may take twice as long to display – approximately two minutes, instead of
one – than if each application was used separately.
Collectors
If you choose to use Historian, not all installed collectors will be available for selection as the default
Collector. Because this feature only supports collectors that read data from iFIX, the collectors
available for selection are limited to the following:
Electronic Signatures
If you use electronic signatures, then you should probably not use the integrated Historian feature. If a
tag requires an electronic signature in Historian and does not in iFIX, and a user makes a change in
iFIX, the user is not prompted for a password. Instead, the change is made, bypassing Historian's
electronic signature requirement.
Spare1 Fields
When used with iFIX, the Historian Spare1 fields are used to keep track of tags that were added or
modified by iFIX. When you enable Collection for a tag in the iFIX Database Manager (on the Proficy
Historian tab, in the Collection Options area), the Spare1 field is assigned to iFIX. iFIX controls the
creation or modification of this tag in Historian. In other words, iFIX becomes the owner of the Spare1
field. The Spare1 fields are written to when an iFIX tag is added for the first time from iFIX to the
Historian Server. The Spare1 field contains the iFIX database name.
If you want to use the Spare1 field in Proficy Historian to allow data to be written to Proficy Historian
from a third party application separate from iFIX, you need to Disable Collection on the tag from
within iFIX (which is the default setting for any new tags you add in iFIX Database Manager). When
disabled, Proficy Historian collection is not enabled for the tag and the tag is handled exclusively by
Proficy Historian. When the tag is being handled by Proficy Historian, it cannot be modified or deleted
from iFIX.
If you do not want to install integrated Historian, and continue using Historian as you did before, then
never do the following:
• Select the Automatically Configure Tags for Collection in Historian on the Proficy Historian
tab of the User Preferences dialog box.
• Use Proficy Historian fields in iFIX Database Manager to configure anything in Historian.
If you choose to install Historian, there are post-installation steps you will need to perform. For more
information, see Configuring iFIX to Use Proficy Historian and Configuring Security When Using
iFIX with Proficy Historian.
24
Getting Started with iFIX
For Historian domain security, see "User Privileges for Starting a Collector" in the Historian e-book.
For all other security considerations for Historian, see the chapter "Implementing Historian Security"
in the Historian e-book.
Stage Description
1 Install iFIX.
3 Install Proficy Historian for SCADA 5.5, which is available on a separate DVD.
Restart your computer.
5 In the iFIX WorkSpace (in Ribbon view, on the Administration tab, or in Classic
view on the Proficy Historian toolbar) verify that Historian Server is set to Proficy
Historian and not Classic Historian. Restart the iFIX WorkSpace.
6 In the iFIX WorkSpace, in the Configure the Proficy Historian Server(s) dialog box,
configure the Historian Server. Set a default collector, so that tags are automatically
added to Historian from iFIX using that collector.
7 Start the Database Manager application. In the iFIX Database Manager, add the
blocks that you want to start collecting on. Use the Proficy Historian tab to enter the
information from Historian. Save your database.
8 After approximately two minutes, in the Historian Administrator, check that your
tag was added. If your tag was not added or collected in Historian, check the log file
confighist.txt in the iFIX\LOCAL directory.
25
Getting Started with iFIX
Stage Description
9 Verify configuration. Add a Historical datalink to your picture, switch to run mode,
and view the last value collected in the datalink.
Stage Description
1 If upgrading from a previous release of iFIX and you have Historian installed on the
PC, shut down all Proficy services and licensing prior to installing iFIX and then
Historian.
2 Install iFIX.
3 Back up all the Historian archive data files (*.iha), configuration files (*.ihc), and
any other backup files you maintained. By default, you can find these files in the
c:\Proficy Historian Data\Archives folder. Make a copy of those backup files.
4 From the Add or Remove Programs feature in the Control Panel, manually uninstall
Proficy Historian. Do Not Delete Archives when prompted.
NOTE: Upgrade from full Historian to Proficy Historian for SCADA is not
supported.
7 After the install completes, restart your computer. It is very important not to forget
this step, and to restart your computer. Make sure the Proficy Historian Archiver is
running.
10 Configure iFIX and your Historian Server. For overview steps, refer to the
Configuring iFIX to Use Proficy Historian section.
Using the Discover and Auto Configure Tool with Proficy Historian
Not only can you can use the Discover and Auto Configure tool to automatically add tags to your iFIX
database, but you can also choose which tags get collected on in Proficy Historian as well.
26
Getting Started with iFIX
Additionally, you can configure the Proficy Historian description and the interval for the collection for
each tag through Discover and Auto Configure. For information about adding Proficy Historian fields
in Discover and Auto Configure, refer to the Adding Proficy Historian Fields as Columns topic.
Before you begin collection, however, you must have your Historian Server is configured, and your
iFIX Collector configured as your local, default collector.
Be aware of your license limits for Proficy Historian. For example, there are limits to the number of
iFIX tags you are permitted to add to the Proficy Historian Server for collection. Use care when you
select which tags that you want to collect on in Discover and Auto Configure. You do not want to
exceed your license limits.
For more information on this tool, refer to the Discover and Auto Configure e-book.
To avoid these errors, install iFIX without I/O drivers. This preserves your FIX 7.0 paths in the
registry.
Each product needs to have its own Services key. FIX 7.0 runs correctly if it is not run as a service.
The workaround for this problem is to edit the registry so that the Services key points to the service
executable in the correct path. The key is located in
27
Getting Started with iFIX
Use the following table as a guide for installing and removing either product.
Started the iFIX WorkSpace Use iFIX and Microsoft Uninstall iFIX, uninstall Microsoft
for the first time, and this Office harmoniously Office, re-install Microsoft Office,
message appears: and re-install iFIX.
Run time error "48": Error in
loading dll.
Backup Files
When you save one of the following files, iFIX creates a backup file:
28
Getting Started with iFIX
iFIX also creates these backup files after you start iFIX for the first time after an upgrade. These
backup files are helpful in disaster recovery of the individual files.
For new iFIX installs, be aware that you can also use the Factory Default Backup for disaster recovery
– performing a clean restore of your entire iFIX system. A clean restore includes the files listed above
along with other Factory Default files. For more information, refer to the Using and Creating Factory
Default Files section in the Understanding iFIX electronic book.
For upgrades, be aware that you can perform a Custom Backup to backup the files listed above before
the upgrade. After the upgrade, you can restore these files with the Backup and Restore wizard. Refer
to the Overview of the Backup Process section in the Understanding iFIX electronic book for more
information.
IMPORTANT: Do not use a Full Backup from a previous release of iFIX to update the files in the
currently installed iFIX folder. Issues can occur with upgrade paths, and possibly other files.
Optionally, after you upgrade your system with the Custom Backup, you can create a new Factory
Default Backup, that you can use for disaster recovery in replace of the original Factory Default
Backup file. This information is described in the Using and Creating Factory Default Files and Sample
BackupRestore.ini sections.
Additionally, you need to configure a few items on both iFIX and the Change Management Server, as
described in the Setting up iFIX for Use with Change Management topic in the Change Management
and iFIX e-book.
NOTE: If you want to run iFIX with other Proficy products, such as Proficy Change Management, you
will need to upgrade you key to at least an M4 key, or better.
If you are upgrading an iFIX computer with the Proficy Change Management, upgrade to Proficy
Change Management 5.8 or 5.9.
29
Getting Started with iFIX
You can currently extract information using the following Discovery Agents:
Not only can you automatically generate tags for OPC, Siemens S7, and Allen Bradley, but with the
Industrial Gateway Server (IGS), you have support for tag creation in over 90 protocols.
Within Discover and Auto Configure, you can also configure the iFIX tags that you want to collect on
in Proficy Historian (through the iFIX Collector). For information on using Discover and Auto
Configure with Proficy Historian, refer to the Using the Discover and Auto Configure Tool with
Proficy Historian section.
For more information on this tool, refer to the Discover and Auto Configure e-book.
Optional Hardware
iFIX supports the following optional hardware. You may want to purchase one or more of these items
to enhance your iFIX system.
Uninstalling iFIX
To uninstall iFIX, from the Control Panel, in the Add or Remove Programs dialog box, click the
Remove button next to the Proficy HMI SCADA - iFIX entry. This action launches the install program
allowing you to remove the iFIX product.
If you want to uninstall other items that install along with iFIX, such as the iFIX OPC Client, the
Proficy Change Management Client API, M4 Common Licensing, Proficy Discover and Auto
Configure application, you need to uninstall these items separately.
IMPORTANT: For the Proficy Discover and Auto Configure (DAC) application, it is recommended
that you uninstall it before you uninstall the iFIX product. If you wait until after you uninstall iFIX, the
DAC uninstall will display error messages.
30
Getting Started with iFIX
Also, when you upgrade your database, the high and low engineering units (EGU) fields are converted
from single precision to double precision floats. What that means, is that the degree of accuracy (the
Epsilon value) changes from +/_0.00000012 to +/_0.00000000000000022. If you are using extreme
ranges (very large or very low values) for your EGU limits, you may possibly experience issues after
an upgrade. To resolve these issues, open the Database Manager, export your database and then re-
import it. This procedure resets the block values.
• Shut down all Proficy applications. It is important that no Proficy products are running when
you run the iFIX installation program.
• Save copies of your existing .INI files with your application preferences and any custom files
you create. Customized files, such as *Res.dll files, and some *.INI files may be overwritten
during an upgrade. As such, you may need to integrate your custom changes into the newer
versions of these files after you upgrade.
• Back up your existing iFIX projects. This includes the files in your LOCAL, Config Files
Backup, PIC, and PDB folders.
• It is also recommended that you create a backup copy of your Alarm ODBC configuration
file(s).
• Export a report of your system configuration (SCU), for reference. (In the SCU, on the File
menu, click Report. Refer to the Generating a System Configuration Report section for
31
Getting Started with iFIX
detailed steps.)
• Export a report of your security configuration, for reference. (In the Security Configuration
application, on the File menu, click Export. Refer to the Exporting a Report of the Security
Configuration section for detailed steps.)
• If you have an application created by an Integration Toolkit, Database Dynamo Toolkit, or
System Extension Toolkit from iFIX 2.5 or earlier, and you want to use this application with
latest version of iFIX, do not uninstall iFIX. You must install the newer version of iFIX over
your existing iFIX configuration. Your toolkit application will not run if you uninstall your
previous version of iFIX.
• Be sure to obtain any toolkit updates that you need, prior to installing iFIX. For instance, if
you have previously installed the iFIX Productivity Pack for Allen Bradley, you must get the
updated version prior to upgrading iFIX.
• If you plan to use Enhanced Failover feature provided in iFIX, review the Enhanced Failover
and Upgrading section.
5. Click the "Install iFIX" link. A message box appears asking you to confirm the install.
6. Click Yes to continue. The install program starts and the Welcome screen appears.
7. Click Next to continue. The license agreement screen appears.
8. Click "I accept the terms of the license agreement" if you want to continue, and then click
Next.
A message box appears indicating that a previous version of iFIX has been detected.
9. Click Yes to upgrade.
CAUTION: If you select No to this message, you can no longer run the older version of iFIX.
By default, iFIX installs to the C:\Program Files\Proficy\Proficy iFIX folder instead. THIS IS
NO LONGER AN UPGRADE. Use caution in copying files from your previous iFIX release,
into your new iFIX install folder.
32
Getting Started with iFIX
few moments, a message box appears asking if you would like to review the release notes.
12. Click Yes to view the release notes. Close the release notes after you finish reviewing them to
resume the install. The Setup Complete dialog box appears.
13. Click Yes to restart your computer now, or No to do it later.
14. Click Finish.
NOTE: Be sure to restart your computer before starting iFIX. As the computer restarts, log in
to Windows with the same user name (with Administrator rights).
Notes on Database Dynamos and Custom Programs that Run with iFIX
Startup
When you install the newest release of iFIX, the product install program places a new version of the
startup control file, FIX.INI, into your iFIX Local directory. The previous version of this file is copied
to the iFIX Config Files Backup folder, along with the other configuration files.
If you configured Database Dynamos, also known as loadable blocks, or other custom programs to run
as part of iFIX startup, you should compare the new FIX.INI file in the Local folder against the
FIX.INI file stored in the Config Files Backup folder. If you find any changes between the two files,
add the necessary lines to the new FIX.INI stored in the Local path. Do not copy the old FIX.INI over
the new FIX.INI file.
NOTE: Paths with embedded path spaces in the FIX.ini require quotes. For example:
RUN="%E:\PROGRAM FILES\PROFICY\PROFICY IFIX\SysAlertQMgr.exe" /F /NSysAlertViewer
If you choose not to upgrade and install iFIX to another path, such as the default: C:\Program
Files\Proficy\Proficy iFIX, there are a few extra steps you need to perform before you can start the
older version SCU file in the latest version of iFIX. First, you must rename the older version SCU file,
so that the name is different than the default iFIX SCU file. For instance, if you try to start an iFIX 4.0
SCU file in the latest version of iFIX, when the names of both SCU files are the same, an error
message appears instead. So, be sure to rename your iFIX 4.0 SCU file to something other than the
startup default file name before opening it in the upgraded iFIX System Configuration Utility. After
33
Getting Started with iFIX
launching the SCU application, open the older SCU file. Now you can manually update the
information in it, as described in the steps below.
Be aware that if you have a Custom Backup available of your node with the previous version installed,
you also can use that file to upgrade your SCU. During the restore, make sure you select the Use SCU
File from Archive check box. If the SCU file name you are upgrading is the same as the iFIX default
SCU file name in the latest version, you need to change the path configuration at this point. Click on
the View Project Path Configuration button to check the current paths. In the Project Path edit box,
enter the iFIX install path. This upgrades your SCU file automatically, however you still have to
manually update other SCU information in the System Configuration Utility, as described in the steps
below. For more information on the restore process, refer to the Overview of the Restore Process
section.
IMPORTANT:
• You do not need to use a Full Backup from a previous release of iFIX if you are just
upgrading the SCU file. Instead, use a Custom Backup. Make sure that you back up the SCU
only in the .fbk file and restore it only in the latest version of iFIX. If you do a Custom
Backup, click “NO TO ALL” other files when restoring just the SCU file. Do not use a Full
Backup between iFIX versions. Issues can occur with upgrade paths, and possibly other files.
• During a restore, use caution in restoring other configuration files. For instance, if you
overwrite the .INI files in your iFIX Local folder, you lose all of iFIX .INI settings from the
latest version. After that is done, there may be issues that cause iFIX or certain features not to
work properly. For instance, if you overwrite the FIX.ini file with a 3.5 one, you need to
remove or comment out the RUN=REGISTERHELPFILES line in order to start the latest
version of iFIX with this file.
• Be sure check the default iFIX path configurations in the SCU in each of your iFIX projects
after you upgrade or restore a project. For example, if you installed the latest version of iFIX
to a 64-bit path (C:\Program Files (x86)\Proficy\Proficy iFIX), and your previous picture
files were installed to a 32-bit path (C:\Program Files\Proficy\Proficy iFIX), you will need to
make sure you update these paths to 64-bit.
NOTE: The following steps describe how to modify an SCU file with a path outside the install
path, so that you run it in iFIX.
34
Getting Started with iFIX
8. In the Network Configuration dialog box, confirm the information is correct and make
changes if necessary.
9. From the SCU Configure menu, click SQL, and then click Configure SQL Tasks.
10. In the SQL Task Configuration dialog box, make sure that the Primary and Backup paths are
correct, if used.
11. From the SCU Configure menu, click Local Startup Paths.
12. In the Local Startup Definition dialog box, change the path to the folder you copied the
project to with the get command.
13. From the SCU File menu, click Save. Save it as the default startup SCU file name or indicate
that this is the SCU you want to use on startup.
14. Restart iFIX.
• The Enhanced Failover feature is a keyed option. You must purchase the additional Enhanced
Failover option (SCADA Failover) if you plan to use SCADA Failover in iFIX. If you had
purchased the Ack Failover option in your previous version of iFIX, your key upgrade will
include the new SCADA Failover option.
• If you purchased the Failover feature when you bought a previous version of iFIX, then your
iFIX .plic license file update will enable the Enhanced Failover option automatically. Be
aware, when you use the Proficy License Viewer in iFIX, that the part description changed
from "ACK Failover" to "SCADA Failover."
• Before installing iFIX, it is recommended that you confirm that the SCADA Failover option is
enabled on your key. iFIX software checks the Enhanced Failover option at startup. Without
this option enabled, the Enhanced Failover functionality will not work. An error message
appears if you try to run iFIX with the SCADA Failover feature.
• If your SCADA key does not show the SCADA Failover functionality enabled, and you
purchased this additional option, please contact you sales representative before upgrading.
• When you upgrade your iFIX SCADA node to the latest version of iFIX, you will need to
make configuration changes on your iFIX SCADA nodes for the Enhanced Failover feature to
work properly. For example, the Data Sync Transport dialog box in the System Configuration
Utility (SCU) is new in iFIX 5.0 and greater. It requires that you enter the partner's IP address
on both the primary and secondary SCADA nodes.
• Be aware that in an Enhanced Failover pair, both server computers in the failover pair must be
at the same iFIX version. So, if you update one computer in the Enhanced Failover pair, you
must update the other. Both computers must be identical in configuration.
• An iFIX network that contains iFIX version 5.8 Enhanced Failover SCADA nodes and also
contains older iFIX client nodes may not be supported. Refer to the Enhanced Failover and
Legacy Clients section on the Release Notes tab of the Important Product Information (IPI)
topic for details.
• The Alarm Acknowledgement synchronization feature from previous iFIX versions is NOT
supported on upgraded SCADA nodes. The Alarm Acknowledgement functionality is
35
Getting Started with iFIX
To configure your iFIX SCADA nodes after an upgrade, if failover was used in a release
prior to iFIX 5.0:
1. On the primary SCADA node, on the Start menu, point to Programs, then Proficy
HMI/SCADA - iFIX, and then System Configuration. The System Configuration Utility
(SCU) appears.
2. On the Configure menu, click SCADA. The SCADA Configuration dialog box appears.
3. In the Failover area, select the Enable check box if it is not already selected.
4. In the Node area, verify or select the node type: Primary or Secondary.
5. In the SCADA Name field, verify or enter the name of your partner SCADA node.
6. Click the Data Sync Transport button. The Data Sync Transport dialog box appears.
7. From the Description list, select the LAN adapter(s) to use for data synchronization between
the SCADA pair, then select the Enable check box. Make sure that the LAN adapters you will
not be using for data synchronization are not enabled.
8. In the Partner's Address field, enter the IP address of the partner node.
9. Use the default settings for the rest of the fields.
NOTE: The Bandwidth Limit field in the Data Sync Transport dialog box allows you to enter
a value to throttle down or limit the synchronization rate or bandwidth used. It is
recommended when using a corporate, non-dedicated or shared network (10/100 or 1GB),
36
Getting Started with iFIX
that you "throttle" network traffic to limit bandwidth that the data synchronization process
will consume.
However, if you previously started the iFIX OPC A&E Server with this command:
iFixOPCAESrv.exe -service
The -service option is no longer needed to run the iFIX OPC A&E Server as a service. You should go
into the Task Configuration dialog box and remove the -service command from the startup task list.
Be aware that you can only run programs such as the iFIX OPC A&E Server as a service if iFIX is
configured to run as a service.
If you want to run the OPC Client driver as a service, iFIX must also run as a service. Likewise, if you
want to run iFIX as a service, the OPC Client driver must run as a service. You cannot run one as a
service, without the other also running as a service.
Toolbars
If your Proficy iFIX WorkSpace contains additional standard toolbars from other iFIX versions, such
as the Proficy Historian toolbar, these toolbars will appear in the iFIX WorkSpace system tree, in the
Project Toolbar Files > Toolbars folder. Double-click a toolbar to display it in the WorkSpace.
To resolve this issue, it is recommended that you change the Appearance Scheme in the Windows
Display Properties dialog box to Windows Classic.
37
Getting Started with iFIX
NOTE: The RealTimeSPCDataset still exists and has not been upgraded in iFIX 5.5.
When opening pictures from a previous version of iFIX (prior to iFIX 5.5), pictures that contain any
older dataset objects are upgraded to use the new GeneralDataSet object. An informational message
appears telling you that the file you are opening has been updated to the most recent format and that
the original can be found in the backup directory.
Any scripts with the logic to check against the dataset's class name in order to determine the data type
will now be replaced with the method IsHistoricalData. Each upgraded line in the script includes a
comment that starts with the words: '** Upgraded **'. This comment is provided so that you can
easily search and find any upgraded areas in your VBA scripts. For example, an updated line would
display like this:
An upgraded dataset still retains its object name in order to keep the scripts compatible in the latest
version of iFIX. For instance, a RealTimeDataSet named “XYZ” will still show up as “XYZ” in the
system tree in the iFIX WorkSpace, but the object itself will become a GeneralDataSet with the
additional properties. This name is still retained even if the data type is changed to a different type (for
38
Getting Started with iFIX
Be sure to review the functionality of any custom scripts if you previously used the classname property
of a HistoricalDataSet or RealTimeDataSet.
Starting in iFIX 5.5, Proficy Historian for SCADA is included on the iFIX installer. On new installs,
you can choose to install Proficy Historian for SCADA. If an existing Proficy Historian install is found
when you install iFIX, your install will exit after the iFIX install and Proficy Historian for SCADA
will not be installed. Should you want to install Proficy Historian for SCADA, refer to the Manually
Installing the Proficy Historian Software section for steps.
Upgrading Pictures
Coordinate Systems
Prior to iFIX 5.8, when you opened a picture from a previous version of iFIX in the newer version, and
saved it, your picture was automatically updated to the newest version of iFIX. Pictures created with
iFIX 5.5 (or earlier) were created with a Logical Coordinate System, which uses logical units for
screen measurements. The Logical Coordinate System allowed this automatic upgrading.
With iFIX 5.8 or greater, pictures are not automatically upgraded because the Enhanced Coordinate
System applies for screen measurements. An expert is provided to easily upgrade pictures you select
from the legacy Logical Coordinate System to the new Enhanced Coordinate System.
You can use both the Logical and Enhanced Coordinate Systems with iFIX 5.8 or greater. For
example, you can edit a legacy picture before you upgrade it. By default, the Enhanced Coordinate
System is enabled for new picture creation. For more information on this expert and on coordinate
systems, refer to the Creating Pictures e-book.
To assist you with upgrading command button captions (text) that may not scale properly, a Button
Caption Converter expert allows you to scale one or more button captions in an active picture that uses
the Enhanced Coordinate System. For more information on this expert, refer to the Creating Pictures e-
book
NOTE: Be aware that pictures with Enhanced Charts containing tag groups will display a message on
upgrade. However, pictures with Historical datalinks and Historical animations containing tag groups
39
Getting Started with iFIX
will not.
VisiconX
Due to the design of the VisiconX objects in iFIX 5.0 and greater, it is recommended that you
manually replace your older VisiconX objects with the newer versions (if you are upgrading from a
version of iFIX prior to iFIX 5.0).
To avoid color mapping problems, perform the following steps before saving and resolving any
pictures in the latest version of iFIX.
1. Copy and save the tables.lst file from the older version of iFIX.
40
Getting Started with iFIX
You can access the ActiveWindow object directly from the documents collection or by calling the
OpenPicture subroutine.
To correct the sizing and positioning, multiply the parameters in the 2.1 script by the number of
monitors.
For example:
In iFIX 2.1, you opened a picture on the second monitor of a dual monitor system by issuing the
following command:
openpicture "picture.grf",,0,50
In iFIX 2.6 and later, open a picture on the second monitor of a dual monitor system by issuing the
following command:
openpicture "picture.grf",,0,100
Historical Datalinks
Beginning with iFIX 5.1, the configuration requirements for historical datalinks changed. To upgrade
your existing historical datalinks, for each picture which contains them, open the picture and save it. If
you do not make any changes on the Historical Datalinks dialog box, the historical datalink, by default
will use CurrentValue for its Historical Mode.
Database Dynamos
Database Dynamos, also known as loadable blocks, will require updating to work with FIX. 5.8. If you
have old Database Dynamos on your system, the iFIX install program will detect them, and generate a
warning message. This includes any Database Dynamos that you downloaded from the Support web
site, or installed from the Allen-Bradley Productivity Pack CD before you installed iFIX 3.x.
The GE Intelligent Platforms web site contains updated versions of the Database Dynamos supplied by
41
Getting Started with iFIX
GE Intelligent Platforms. To obtain updated version of other Dynamos, contact the vendor of that
dynamo. To obtain the current version of the Database Dynamo Toolkit, contact your local iFIX sales
representative.
IMPORTANT: To upgrade your Database Dynamos from a previous version of iFIX, you must
recompile your blocks with the iFIX Database Dynamo Toolkit. After you recompile them, you can use
them in the newer version of iFIX. Follow the steps outlined in the iFIX Database Dynamo Toolkit and
the Database Converter will update your Database Dynamos. For information on the Database
Dynamo toolkit, contact GE Intelligent Platforms.
NOTE: When upgrading an iFIX SCADA node with loadable blocks, always make sure that the block
slot number prior to the upgrade matches the block slot number after the upgrade. Slots are saved
inside the FIX.INI (in the [Scada] section) . If the block slot numbers do not match after the upgrade,
iFIX will be unable to load these blocks, and eliminate them from the database. In addition, you may
receive a warning message stating that the there is a block configuration mismatch.
Be aware that when you upgrade iFIX, the Dynamos in pre-built Dynamo sets and the Dynamos
created before iFIX 4.5 are not considered Dynamo objects. This means you cannot use the Quick
Dynamo Updater, the Dynamo Updater Wizard, and the Cross Reference Tool (available in iFIX 4.5
and greater) to update instances of these Dynamos within existing pictures. Only Dynamo objects
created in the newer version of iFIX can be updated with these tools.
• Historical.fds
• Miscellaneous.fds
• Motors.fds
• Pipes.fds
• PipesAnim.fds
• Pumps.fds
• PumpsAnim.fds
• Tanks.fds
• TanksAnim1.fds
• TanksAnim2.fds
• Valves.fds
• ValvesAnim.fds
42
Getting Started with iFIX
If this happens, delete the contents of the Temp directory and run the installation again.
Next, using a text editor, you must provide translations for each of these new fields in the exported
language (.csv) file(s). This step is required because the iFIX language translation file originally did
not include the Alarm Summary object.
NOTES:
• iFIX 5.8 supports translation of the Alarm Summary object information through the picture
object, or through the Alarm Summary object. You may also want to create new pictures
which take advantage of the SwitchLanguage Method on the Alarm Summary object itself.
For more information on how to use this feature, refer to the SwitchLanguage Method
Example in the iFIX Automation Reference.
• In iFIX 5.8, you can also change the font of the Column Headers and the Status Bar in the
Alarm Summary object for translation display purposes. This Font changing feature can be
accessed from the General tab of the Alarm Summary object in configure mode. You may
want to update your pictures to use this feature, as well. For more information on how to use
this feature, refer to the Configuring Fonts for the Column Headings and Status Bar in the
Creating Pictures electronic book.
1. In the WorkSpace configuration mode, open the picture you want to export a language file
for.
2. In Classic view, on the WorkSpace menu, click User Preferences.
-Or-
In Ribbon view, on the Home tab, in the WorkSpace group, click Settings, and then click User
Preferences.
3. Click the Picture Preferences tab and make sure the Translate Picture On Open check box is
cleared. If it is selected, the LanguageDesired and TranslateOnOpen properties in the
Properties window cannot be changed.
4. Click OK to close the User Preferences dialog box.
5. Right-click in the picture and choose Property Window.
6. From the LanguageDesired list, select the appropriate language.
43
Getting Started with iFIX
1. In the iFIX WorkSpace, on the Translation toolbar, click the Export multiple language files
button. The Language File Exporter dialog box appears.
2. In the Select pictures list, select the check box for each picture you want to export a language
file for.
3. If applicable, select the Show Tag Status pictures check box to display and select tag status
pictures in the Select pictures list.
4. If applicable, select the Always overwrite existing export files check box. If you are exporting
a language file for a picture that already has a language file for the selected language, the
existing language file will be automatically overwritten. If you clear this check box, you will
be prompted to replace the existing language file. Click Yes to replace it and No to keep it.
5. From the Select language list, choose the language that you want to provide translations for.
6. Click Export. A separate language file is created for each picture you selected.
7. You can now open each language file in a text editor and translate the text strings for the
pictures.
44
Getting Started with iFIX
• For DCOM information, refer to the Setting Up DCOM for Use with Remote OPC Servers
section.
• For Firewall information, refer to the Setting Up the Firewall for Use with Remote OPC
Server section.
When OPC Servers register, they set up initial custom DCOM security settings to enable users on the
network to access and launch the Server. On large networks, it is recommended that you modify these
settings to avoid confusion and inadvertent changes to a running OPC Server.
If Firewall security is enabled on Windows, you must also modify or add items to the Exceptions list.
Refer to Setting Up the Firewall for Use with Remote OPC Servers section for more information.
IMPORTANT NOTES:
• It is recommended that all users that need to access remote OPC Servers be members of the
Administrators group. To facilitate this, it is recommended that you create a users group to
contain individual users that need to access remote OPC servers.
For example, for the Discover and Auto Configure application, create a group named “DAC”
and add those users who will log into the operating systems and access remote OPC servers.
Add the users Tom, Denise, and Harry into the DAC group. Each of these users will also be
added into the Administrators group. This DAC group should also contain the following built-
in security principals: INTERACTIVE; NETWORK; SYSTEM.
• To make any OPC Client / OPC Server application work via DCOM, changes need to be
made on both sides, especially if you intend to use Asynchronous I/O communications.
• OPCENUM must reside on the remote machine with the OPC server. While most OPC Server
applications install and register this file, some do not. You can download this file from
45
Getting Started with iFIX
• This section applies to OPC servers that need to use DCOM communications, regardless of
whether the OPC server uses Serial or Ethernet devices.
• If OPC communications is confined to a single machine (that is, using COM, but not DCOM),
it continues to work properly without making changes to DCOM settings.
• If you do not plan to use iFIX to connect remotely to OPC servers, then you may not need to
change your DCOM settings.
• If this is the first time you are connecting to (or allowing connections from) other machines
on the network, you must run the Windows Network Wizard (from Start > Control Panel) to
set up your computer to run on your network. This allows you to share resources on your
computer with other computers on your network. It is recommended that you run the Network
Setup Wizard before modifying the DCOM settings.
DCOM Settings
The following procedures provide general guidelines for configuring DCOM settings.
1. From the Start menu, select or type Run. The Run dialog box appears.
2. Type dcomcnfg and click OK. The Component Services dialog box appears.
IMPORTANT: Be careful when making any system-wide security changes. Any inadvertent changes
may affect the entire system and may cause some or all programs to stop working.
1. On the Component Services dialog box, expand Component Services, then expand the
Computers item.
2. Right-click My Computer and choose Properties. The My Computer Properties dialog box
appears.
3. Click the COM Security tab. There are four permissions on this dialog box.
You may need to make changes to the Edit Limits… for Access Permissions and Launch and
Activation Permissions.
Do not change the Edit Default… settings, since this will change the default settings for all
programs and applications running on the computer.
4. Click Access Permissions > Edit Limits… The Access Permission dialog box appears.
46
Getting Started with iFIX
a. Select the user labeled ANONYMOUS LOGON, and then select the Allow check box for
Remote Access.
NOTE: This setting is necessary for applications that use OPCenum.exe to function and
also for some OPC Servers and OPC Clients that set their DCOM 'Authentication Level'
to 'None' to allow anonymous connections. If you do not use such applications, you may
not need to enable remote access for anonymous logon users.
b. Select the user labeled Everyone, and then select the Allow check box for Remote
Access.
IMPORTANT: Since “Everyone” includes all authenticated users, it is recommended to
add these permissions to a smaller subset of users. One way of doing this is to create a
Group named “OPC” and add all user accounts to this Group that will access any OPC
server. Then substitute “OPC” everywhere that “Everyone” appears in the entire DCOM
configuration dialogs.
c. Click OK to close the Access Permissions dialog box and return to the My Computer
Properties dialog box.
5. Click Launch and Activation Permissions > Edit Limits… The Launch Permission dialog box
appears.
For each user or group (preferably add the “OPC” group) that needs to launch or activate the
OPC server, or participates in OPC / DCOM communications, make sure that the Local
Launch, Remote Launch, Local Activation, and Remote Activation check boxes are selected.
6. Click OK to save your changes, then click OK again to save and close the My Computer
Properties dialog box.
It is recommended that all users requiring access to remote OPC servers be members of the
Administrators group.
IMPORTANT: Since the “Everyone” group includes all authenticated users, it is recommended to
add these permissions to a smaller subset of users.
It is recommended that you create a group to contain individual users that need to access remote OPC
servers. It is also recommended that all users who require access to see OPC Servers be members of
the Administrators group.
For example, for Discovery and Auto-Assembly Component, create a group named “DAC” and add
those users who will log into the operating systems and access remote OPC servers. Add the users
Tom, Denise, and Harry into the DAC group. Each of these users will also be added into the
Administrators group. This DAC group should also contain the following built-in security principals:
INTERACTIVE; NETWORK; SYSTEM. Then substitute “DAC” everywhere that “Everyone” appears
in the entire DCOM configuration dialogs.
47
Getting Started with iFIX
1. Access the DCOM configurator (dcomcnfg.exe). The Component Services dialog box
appears.
2. Expand the Component Services item, then expand the Computers item, and then expand the
My Computer item.
3. Select the DCOM Config object. A list of applications displays.
4. Right-click the OPC server you want to modify and choose Properties. The <Selected OPC
Server> Properties dialog box appears.
5. Click the General tab. The Authentication Level should be set to “Default,” if it is not already.
This uses the default authentication rules that are set in the system-wide DCOM settings.
6. Click the Location tab and make sure that the "Run Application on this computer" check box
is selected.
7. Click the Security tab and select the Customize option for each of the permissions in this
dialog box and edit them as described in the following steps.
8. In the Launch and Activation Permissions area, click Edit. The Launch and Activation
Permission dialog box appears for Windows Vista and Windows 2008.
9. Click the Add button. The Select Users or Groups dialog box appears.
10. Click the Advanced Button. Another Select Users or Groups dialog box appears.
11. Click the Find Now button. In the search results, select the OPC group and click OK. The
Select Users or Groups dialog box displays the OPC group.
12. Click OK to return to the Launch Permission dialog box. The OPC group is displayed in the
Group or user names list.
13. Select the OPC group and then select the Allow check boxes for Local Launch, Remote
Launch, Local Activation, and Remote Activation permissions.
14. Click OK to return to the <Selected OPC Server> Properties dialog box.
15. In the Access Permissions area, click Edit. The Access Permission dialog box appears.
16. Click the Add button. The Select Users or Groups dialog box appears.
17. Click the Advanced Button. Another Select Users or Groups dialog box appears.
18. Click the Find Now button. In the search results, select the OPC group and click OK. The
Select Users or Groups dialog box displays the OPC group.
19. Click OK to return to the Access Permission dialog box. The OPC group is displayed in the
Group or user names list.
20. Select the OPC group and then select the Allow check boxes for Local Access and Remote
Access permissions.
21. Click OK to return to the <Selected OPC Server> Properties dialog box.
22. In the Configuration Permissions area, click Edit. The Change Configuration Permission
dialog box appears.
23. Click the Add button. The Select Users or Groups dialog box appears.
24. Click the Advanced Button. Another Select Users or Groups dialog box appears.
25. Click the Find Now button. In the search results, select the OPC group and click OK. The
Select Users or Groups dialog box displays the OPC group.
48
Getting Started with iFIX
26. Click OK to return to the Change Configuration Permission dialog box. The OPC group is
displayed in the Group or user names list.
27. Select the OPC group and then select the Allow check boxes for Full Control and Read
permissions.
28. Click OK to return to the <Selected OPC Server> Properties dialog box.
29. Click OK.
30. Repeat steps 2 through 29 for each OPC server you need to access remotely.
31. When you are done, close the Component Services dialog box.
It is recommended that you enter these settings on the local machine running iFIX, as well as on the
remote machine that has the OPC server you want to use.
49
Getting Started with iFIX
4. Click the Add Port button. The Add a Port dialog box appears. The following figure shows an
example of this dialog box in Microsoft Windows XP.
9. Select the Add Program button. The Add a Program dialog box appears. The following figure
shows an example of this dialog box in Microsoft Windows XP.
50
Getting Started with iFIX
11. Navigate to the System32 folder. This folder is found under the operating system folder
(usually Windows or WINNT).
12. In the System32 folder, select the OPCENUM.exe file, and then click the Open button.
In the Add a Program dialog box the path field displays the full path to, and including, the
OPCENUM.exe file.
51
Getting Started with iFIX
14. Complete steps 9-13 for each OPC server that you want to access.
NOTES:
52
Getting Started with iFIX
• If any OPC server that you want to use is a dll surrogate (an in-process dll and not an .exe),
you must add \system32\dllhost.exe into the Exceptions list.
• You must also add the GE Intelligent Platforms OPC Client driver by adding the file
OPCDrv.exe into the Exceptions list.
• OPCENUM must reside on the remote machine with the OPC server. While most OPC Server
applications install and register this file, some do not. You can download this file from
www.opcfoundation.org. Currently it is contained within the OPC Core Components 2.00
Redistributable 2.30.msi file. After you download OPCENUM, run the .msi file.
53
Windows Operating System
Considerations
When using iFIX in newer versions of Windows, be aware of the following limitations when working
with these products:
• GE Intelligent Platforms OPC Client Driver – If you want to run the OPC Client driver as
a service, iFIX must also run as a service. Likewise, if you want to run iFIX as a service, the
OPC Client driver must run as a service. You cannot run one as a service, without the other
also running as a service.
If you want to run the OPC Client driver, be sure to check with the vendor of your OPC
Server software to see if your OPC Server supports the operating system that you want to use.
• Third-Party OPC Servers – Be aware that at the time of the iFIX release there were a
limited number of OPC Servers supported on newer versions of Windows. iFIX was tested
with the OPC20iFIX.exe (Intellution.OPCiFIX) Server – an OPC 2.05a (out of process) Data
Server.
• Terminal Server – iFIX does not support running a Terminal Server on Windows 7 ,
Windows 8, or Windows Vista. However, these users can connect to a Terminal Server node
running Windows Server 2008 with RDP 6.0 AND 6.1.
• Drivers and DAC – If you want to run a driver on a newer operating system, be sure to check
with the vendor of your driver software to see if your driver supports the operating system.
Your driver must support your operating system to interface with the Discover and Auto
Configure (DAC) application.
• Biometric Toolkit – The iFIX Biometric Toolkit is supported only if you have a biometric
solution that is compatible with your operating system.
• VisiconX – Make sure that your data sources use UNC pathing, rather than mapped network
drives. For example, use a path like this: \\myserver\users\\mydb.mdb, instead of this:
d:\myserver\users\mydb.mdb for your data source. Otherwise, you may experience connection
errors.
• PMON – The GE Intelligent Platforms diagnostic utility PMON.exe does not work when
iFIX is running as a service in versions of Windows after XP.
• Proficy Portal Control – For best performance in Windows, it is recommended that when
you insert Proficy Portal control into your iFIX picture, that you do not insert any other
ActiveX controls into the same picture.
• Upgrading – If you are upgrading your iFIX install, be aware that Microsoft does not
recommend upgrading Windows XP or 2003 to the newer versions of the Windows operating
system.
Additionally, be aware of the following differences when working with iFIX in Microsoft Windows:
• Security – Microsoft Windows includes many new security enhancements in the newer
operating systems. Due to these enhancements, there may be changes you need to make for
the users who run iFIX. For more information, refer to the Windows and Security section.
54
Getting Started with iFIX
• Drive Mapping – Security and data protection enhancements may require you to use data
sources with UNC pathing, as opposed to mapped network drives. For more information, refer
to the Windows and Mapped Network Drives section.
• Sleep Mode – Be aware that an iFIX View node running on a version of Windows will lose
its connection to the iFIX network when going into "Sleep" mode.
As an Administrator, you have all of the rights you need to operate a SCADA node (start and stop
iFIX), as well as running iFIX as a service. However, if you want to allow a user not in the
Administrators group to operate an iFIX SCADA node or run iFIX as a service, you need to make
some adjustments to the user rights.
To allow a non-Administrator to operate an iFIX SCADA node, you need to add the individual user or
group to the "Create Global Objects" policy. If you want the user or group to run iFIX as a service,
then you need to run the GrantUserFixServiceRights command for the user or group.
1. Log in as an Administrator.
2. Click the Start button, and in the Search box, type secpol.msc and press Enter. The Local
Security Policy window appears.
3. In the tree, double-click Security Settings, and then Local Policies, to view the contents of the
Local Policies folder.
4. Click the User Rights Assignment item to view the policies.
5. Double-click the Create Global Objects policy. The Create Global Object Properties dialog
box appears.
6. Click Add User or Group. The Select Users or Groups dialog box appears.
7. Enter an individual user name, or group name, such as "iFIXUsers."
8. Click OK to add the user.
1. Click the Start button, and in the Search box, type Command Prompt and press Enter. If the
Command Prompt does not appear immediately, double-click the Command Prompt from the
list of results.
2. In the Command Prompt window, type:
GrantUserFixServiceRights GRANT FIX USERNAME
where FIX is the name of the service (iFIX) that you want to grant rights to, and USERNAME
is the name of the user or group that you want to grant rights to.
55
Getting Started with iFIX
If you want to allow all members of the group “iFIXUsers” to run iFIX as a service, type:
If you later need to revoke the right to run iFIX as a service, use the following command:
where FIX is the name of the service that you want to revoke rights from, and USERNAME is the name
of the user or group that you want to revoke rights from.
To resolve this issue, make sure that your system data sources use UNC pathing, rather than mapped
network drives. For example, use a path like this: \\myserver\users\\mydb.mdb, instead of this:
d:\myserver\users\mydb.mdb for your data source. Otherwise, you may experience connection errors.
Be sure to select the "Remember my password" check box in the Connection dialog box when setting
up your UNC pathing. By doing this, the next time you log in, your connection will succeed without
failing.
For example, you add a system data source (ODBC) with a mapped network drive for use with
VisiconX. When you configure a VisiconX data control and select a data source on the Database tab,
an error appears (error number -2147467259 indicates that you do have a valid path). To resolve this
issue, configure your data source with UNC pathing instead.
56
Getting Started with iFIX
The "Allocation of Shareable Memory Failed" message is one of the messages that can appear in this
scenario. To resolve these types of issues, elevate the application to the fullest privileges.
1. Create a text file named yourappname.exe.manifest, where yourappname is the name of the
application you want to elevate.
2. In a text editor such as Notepad, open yourappname.exe.manifest.
3. Paste the following lines of code into the text file:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assemblyIdentity version="1.0.0.0"
processorArchitecture="X86"
name="yourappname"
type="win32"/>
<trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
<security>
<requestedPrivileges>
<requestedExecutionLevel
level="highestAvailable"
uiAccess="false"/>
</requestedPrivileges>
</security>
</trustInfo>
</assembly>
4. Save the file in the same folder as the yourappname.exe, where yourappname is the name of
the application you want to elevate.
TIP: If yourappname.exe was built with an internal manifest, yourappname.exe will ignore
the external manifest created in the above manner. Instead, you need rebuild the application
57
Getting Started with iFIX
IMPORTANT: If you have run the executable before performing the above steps and it failed
to work, see this link for information on adding a manifest after the fact:
http://blogs.msdn.com/vistacompatteam/archive/2006/11/13/manifest-and-the-fusion-
cache.aspx.
• Build your application's executable (.exe) file with the elevation information built into it. Be
aware of issues with fusion cache when you use an external manifest file. For more
information, refer to the MSDN web site:
http://blogs.msdn.com/vistacompatteam/archive/2006/11/13/manifest-and-the-fusion-
cache.aspx.
For more information on User Account Control (UAC), refer to the Microsoft web site:
http://www.microsoft.com/downloads/details.aspx?familyid=ba73b169-a648-49af-bc5e-
a2eebb74c16b&displaylang=en.
To elevate a third party application that you do not own the source code for:
• Microsoft recommends writing a wrapper to invoke the application's executable (.exe) file in
an elevated manner. If this is not feasible, the following is suggested:
• Create a shortcut (.lnk) to the yourappname.exe, where yourappname is the name of the
application you want to elevate.
• Right-click the shortcut and select Properties. Configure the shortcut to run as an
Administrator.
58
Other iFIX Installation Considerations
This chapter provides information you need to consider when using databases or drivers and iFIX. This
information includes:
• Supported Drivers
• Special Keyboard Buttons
Supported Drivers
For information on iFIX supported drivers, refer to the GE Intelligent Platforms support web site at:
http://support.ge-ip.com/support/index?page=dwchannel&comp=ioall
&compSel=selioall &cat=&actl=All&lclicked=I/O Drivers
It is recommended that you reprogram or disable the software that operates such special buttons. Refer
to your computer's documentation for instructions on disabling these buttons.
59
Environment Protection and iFIX
Environment Protection is a feature within iFIX that allows you to restrict operator access in run mode.
This feature helps to provide a secure operating environment. For instance, while in run mode, you
may want to restrict an operator from:
For more detailed information about Environment Protection, refer to the Configuring Security
Features e-book. The Restricting Access in the Run-time Environment topic in the Defining and
Assigning Security Privileges chapter, in particular, has detailed information with links to more steps.
Important Information
Be aware that when using Environment Protection:
Be aware of the following when using task switching with Microsoft Windows 8 and Windows Server
2012:
• When you disable task switching on Windows 8 and Server 2012 systems, iFIX disables the
61
Getting Started with iFIX
Windows shell which includes the task bar, the start menu, the desktop, file and folder access,
the Charms bar, and hot corners that allow access to the Start screen.
• When security is enabled and iFIX is running, a user with task switching rights must be
logged in for the shell to run and the desktop to be accessible. (When security is enabled, the
rights of the logged in user will always take precedence over the environment protection
settings configured in the iFIX WorkSpace User Preferences.) If there is no user logged in,
task switching will be disabled, the shell will be disabled, and the system will become
inaccessible.
• The Windows shell may be disabled when switching from run to configure mode in iFIX. To
avoid this issue, make sure the logged-in user has both task switching rights and WorkSpace
configure access, so that the desktop is always available in configure mode. The task
switching right can be assigned by adding the Enable Task Switching application feature to
the user profile in the iFIX Security Configuration application. The WorkSpace configure
access can be assigned by adding the WorkSpace Configure application feature to the user
profile.
• If the iFIX WorkSpace is not configured as a startup task in the SCU, you must configure a
user to be logged in automatically who has task switching rights or the desktop will not be
available and the system will become inaccessible when iFIX starts up.
• All users who have iFIX WorkSpace runtime exit privileges must also be assigned task
switching rights or the iFIX WorkSpace runtime shutdown will be blocked.
• When iFIX is configured to run as a service and to start automatically, Fix.exe should always
be started before launching WorkSpace.exe to enable the on-screen keyboard functionality. If
WorkSpace.exe is launched without starting iFIX in the user session on a system without a
physical keyboard, the on-screen keyboard will not automatically display when the cursor is
in an edit control or in edit mode.
• For Microsoft Windows 8 and Windows Server 2012, the only supported on-screen keyboard
for use with iFIX and touch screens is the tabtip keyboard (tabtip.exe).
• To launch the keyboard automatically from iFIX on Windows Server 2012 systems, there is
additional configuration. In the Server Manager, you must install the Desktop Experience
feature included in the User Interface and Infrastructure features. (By default, this feature is
already enabled in Windows 8). After enabling the feature and restarting Windows, the on-
screen keyboard, tiptap.exe, will be available and will display automatically when focus is on
an edit field in iFIX.
62
• Networking
This chapter provides general information about the iFIX supported network protocol, supported
network software, supported file servers, and installing network cards with Windows. Refer to the
following sections for more information:
If you have difficulty networking your computer, refer to the Troubleshooting chapter of the Setting
Up the Environment manual to pinpoint and resolve your problems.
Refer to your file server documentation for installation and configuration instructions.
If a file server becomes unavailable and an iFIX node attempts to access a file, you may experience no
response, slow response, or time-outs. These conditions are a result of continuously polling all
available drives while it waits for a response from the file server. It is recommended that you store a
backup copy of the files you need on the local node. It is not recommended that you use the file server
for files if it is susceptible to failure.
IMPORTANT: You cannot run iFIX and FIX v7 at the same time on a single computer
63
Contact GE Intelligent Platforms
If you purchased this product through a GE Intelligent Platforms Authorized Channel Partner, please
contact them directly.
Technical Support
If you have technical problems that cannot be resolved with the information in this guide, please
contact us by telephone or email, or on the web at www.ge-ip.com/support.
Americas
65
Getting Started with iFIX
Asia Pacific
• Have your contract number ready. Your contract number is an eight-digit number that is a
combination of your company's six-digit identification number and a two-digit extension that
identifies the product you are using. It can be found on your invoice and in the body of your
original packing list from GE Intelligent Platforms. If you are a member of our Extended
Support Services program, your contract number is also on your customer support PhoneCard.
• Be next to your computer so that the engineer can step you through the proper procedure.
• Be familiar with your product's documentation so that the engineer can direct you to
information on related topics.
• Have the names and version numbers of the I/O drivers in use.
• Know the HMI Application you are using.
• Know the type of operating system you are using and the version number of your software.
Assistance
When you call for assistance with software that does not perform as you expect, the answer usually has
to do with your computer's setup. You should be able to answer the following questions when you call:
66
Index
A FIX 7.x..................................................................... 27
Advanced Historian, not supported with iFIX ......... 39 using with iFIX .................................................... 27
B FixUserPreferences.ini ............................................ 10
backup, file server files ............................................ 63 format, time and date ............................................... 12
C G
D GrantUserFixServiceRights ..................................... 55
F iFIX
67
Getting Started with iFIX
paths ..................................................................... 15 L
iFIX installation O
68
preserving settings when upgrading ........................ 33 toolbars .................................................................... 37
R U
running iFIX as a service ......................................... 15 user globals, iFIX upgrade considerations ............... 38
S third-party ............................................................ 14
starting up FIX 7.0 after iFIX install ....................... 27 Vista limitations ....................................................... 54
supported ................................................................. 63 W
69