Important Product Information For iFIX 2022
Important Product Information For iFIX 2022
iFIX 2022
Important Product Information
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 General Electric
Company. Information contained herein is subject to change without notice.
Trademark Notices
GE, the GE Monogram, and Predix are either registered trademarks or trademarks of General Electric Company.
Microsoft® is a registered trademark of Microsoft Corporation, in the United States and/or other countries.
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
Install Changes 1
Proficy Authentication 2
Updates to FIXVBA 3
Installation 5
Installing as an Administrator 5
Installing iFIX 5
Upgrade Notes 6
Upgrade Steps 7
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . i
DDA Drivers and the Upgrade 8
Alarm Viewer 11
FIX Desktop 11
Classic Historian 12
Migration Tools 12
Speedstep Technology 12
IPv6 12
ii © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Backwards Portability of Process Databases 13
WorkSpace Startup 15
Close All Dialog Boxes in the WorkSpace Before Running the Report Wizard 16
Code Example: Checking for a Null Value with the iFIX RealTime ODBC Driver 20
Software Requirements 38
Index 43
iv © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Important Product Information for iFIX 2022
Welcome to the newest version of iFIX! The features of iFIX 2022 include:
l Install Changes
l Configuration Hub 2022
l Support for Up to 65,534 Tags per Block Type
l Proficy Authentication
l Upgraded Windows Support
l Updates to the Alarm Summary
l New Command Expert
l New Model Tab in Expression Builder
l A Second New Sample System
l Support for Nested Domain Groups in the Security Synchronizer
l Updates to FIXVBA
l Update Support for Third-party Applications
l Support for Recently Updated GE Products
Install Changes
There are two installers for iFIX 2022: the integrated installer or the individual installer. Both are down-
loadable.
The new integrated Proficy installer helps you install iFIX, Historian, IGS, Configuration Hub, Licensing, and
other Proficy related applications in a fast and efficient way. The integrated product installer streamlines
the deployment experience for iFIX, along with the other products it often is used with. The integrated
installer is the preferred way to install iFIX.
You can still, however, install iFIX with the individual installer. The individual iFIX installer does not include
Configuration Hub. If you want to install Configuration Hub, you would use the new integrated product
installer.
Also, a change in the iFIX installer, is that access controls (previously referred to as secure mode) are not
enabled by default.
IMPORTANT: If enabling access controls when installing iFIX, do not to delete the user group that was created/used by
the iFIX installer (to apply ACLs) before you uninstall the iFIX product. Instead, uninstall iFIX first, and then you can
optionally remove this Windows group. If you accidentally delete this group, run the ConfigureWizard.exe tool which is
found in the iFIX install folder (by default: C:\Program Files (x86)\GE\iFIX). Restart the machine and then restart iFIX.
Confirm that you can open the iFIX WorkSpace and the Database Manager. After that, you will be able to uninstall iFIX
if want to.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 1
For the full install steps, refer to the "Installing the iFIX Software" topic in the Getting Started guide.
There are also model enhancements that are provided both in Configuration Hub and iFIX. You can
browse substitutions, and build expressions for type variable property values.
For more information, click the Help button from the Configuration Hub application. Or, open the Con-
figuration Hub content from the GE Documentation web page.
Proficy Authentication
iFIX can use Proficy Authentication (UAA) for its security authentication and authorization, in addition to
the currently supported mechanisms of iFIX security. Integration with Proficy Authentication provides
advantages such as centralized management of users and groups, a common security model across
Proficy products such as Historian and Operations Hub, and enables support for multi-factor authen-
tication.
For more information on Proficy Authentication in the ebooks, see the Configuration Security Features >
Using iFIX with Proficy Authentication.
For a complete list of all supported operating systems, refer to the System Requirements tab.
2 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
New Command Expert
The Set Symbol from Model Browse Expert was added in iFIX 2022. This expert allows you to set a sym-
bol’s value by browsing and selecting a model object instance at run time.
Search the ebooks for "Set Symbol from Model Browse Expert" to learn more.
For more information, search for "Browsing the Model in the Expression Builder" in the ebooks.
To support this functionality a new /N command line is available. For example: SecuritySynchronizer.exe
/D"domain1" /N
For more information on this command line and others supported by the Security Synchronizer, search
for "using the command line" in the ebooks.
Updates to FIXVBA
The iFIX Automation References includes the following new properties:
l SmoothShapeOption Property: Describes how Line object is rendered in a picture where the
SmoothShapes property is set to True. The SmoothShapeOption property is not effective when
the pictures's SmoothShape property is set to False.
l StorageMode Property: Describes how data is stored in a Bitmap object. This property is
applied to the Bitmap object when picture it is saved (or switches between configuration and run
mode). IMPORTANT: JPEG storage mode uses the lossy image compression algorithm that results
in a little degradation of the image data. After JPEG storage mode is applied to a Bitmap control
and picture is saved and closed, the original bitmap data cannot be reverted back.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 3
l iFIX Productivity Tools from Catapult (included on the iFIX install media). Includes updates to sup-
port the latest version of iFIX. The Productivity Tools are supported in English only.
l Dream Report 2020 for Proficy.
l Win911 version 4.20.10.
For a complete list of products and versions tested to work with the iFIX 2022 product, go to the System
Requirements tab and scroll to the Compatibility with Other GE Products section.
If this is your first time using the iFIX product, try launching the Sample System from your desktop icon of
the same name. There is a specific chapter in the help documentation, under the heading Sample Sys-
tem, which will instruct you on how to interact with the Sample System in run mode. When configuring a
new iFIX system with Configuration Hub, and you want to use the Sample System, make sure you start
iFIX first before starting the Sample System.
You can also run iFIX in Demo mode. In Demo mode, you can run iFIX applications for 2 hours. To start in
Demo mode, start iFIX from command line using the parameter, like this:
Launch.exe /t
4 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
NOTE: You can run Sample System with an iFIX license by removing the /D switch from the Sample System shortcut.
However, be aware that you need to have an appropriate license installed for the Sample System to be fully functional.
For a general overview of iFIX and the WorkSpace, refer to the Understanding iFIX electronic book.
For an overview of how to configure your iFIX system, refer to the Setting up the Environment electronic
book.
Installation
Installing as an Administrator
You must install iFIX with a local Windows user account with administrator rights. See your Windows
manuals or online Help for information on creating this account.
Installing iFIX
Without an iFIX license, you can run iFIX applications for 2 hours in Demo mode.
NOTE: When configured for WebSpace, none of the iFIX SCUs on WebSpace Server should be configured to start iFIX as
service, as this is a unsupported configuration.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 5
IMPORTANT: Be aware that if you do not already have .NET 4.6.1 installed and you choose to install iFIX, the .NET 4.6.1
install will run first. After it installs, you will be prompted to restart your computer. After the restart, the iFIX install con-
tinues. The install media must be available or connected to the target machine the entire time for the install to finish.
Upgrade Notes
Before you upgrade the iFIX product installed on your computer, make sure you shut down all GE applic-
ations. It is important that no GE products are running when you run the iFIX installation program.
IMPORTANT: Direct upgrades from iFIX 3.5 to the latest version of iFIX are not supported. To upgrade iFIX in this case,
upgrade to 5.8 first and then upgrade to the latest version of iFIX.
NOTE: iFIX WebSpace must be uninstalled before/after the upgrade to iFIX 2022. Instead of iFIX WebSpace, WebSpace
5.0 needs to be installed and configured to work with iFIX.
IMPORTANT: If you are upgrading from a previous version of iFIX with failover enabled, and you want to use the
Enhanced Failover feature in iFIX 5.0 or greater, there are a number of issues that you must be aware of. For detailed
information and steps describing how to upgrade your failover system, see the Enhanced Failover and Upgrading" sec-
tion on the New Features tab.
Save copies of your existing .INI files with your application preferences and any custom files you create;
customized 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.)
Export a report of your security configuration, for reference. (In the Security Configuration application, on
the File menu, click Export.)
If you have an application created by an Integration Toolkit, Database Dynamo Toolkit, or System Exten-
sion Toolkit from iFIX 2.5 or earlier, and you want to use this application with iFIX 2022, do not uninstall
iFIX. You must install iFIX 2022 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.
CAUTION: If you choose to integrate Historian with iFIX, make sure that your database tags have unique names. If
both your iFIX and Historian databases have the same tag name, when you import an iFIX tag into the Historian data-
6 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
base, the Historian tag will be overwritten with the tag of the same name from the iFIX database. For more inform-
ation, see Using iFIX with Historian and Troubleshooting Historian and iFIX.
If you plan to use Configuration Hub with iFIX, before you upgrade iFIX, delete the old OPC UA Con-
figuration certificate (iFIX_OpcuaConfigRoot.crt) from the Program Files (x86)\GE\iFIX\LOCAL\iFIX_
OpcuaConfigService\pki folder, and then upgrade to the latest version of iFIX.
IMPORTANT: If you forget to delete the OPC UA certificate before upgrading, you will need to follow the steps in this
topic in order to trust the certificate again after the upgrade.
After upgrading iFIX and Configuration Hub, you will need to add the APPLICATION_DESIGNER group in
iFIX Security Configuration, and then export it to Proficy Authentication. The group name from iFIX 6.5
contained a space character, which is not supported in the current version of Configuration Hub and is
why the group name is not migrated. Before you export the group, be sure that the APPLICATION_
DESIGNER group contain the following iFIX application features: Database Block Add-Delete, Database
Manager, Database Reload, Database Save, Enable Task Switching, OPC UA Confiugration Tool, Runtime
Visual Basic Editor Access, WorkSpace Configure, WorkSpace Runtime, and WorkSpace Runtime Exit.
After upgrading iFIX and Configuration Hub, you will need to manually add two missing privileges to the
ch_admin user. In the Navigation panel from Configuration Hub, select Proficy Authentication. From the
Users list, select the ch_admin user and add the following items to its group membership: scada.fix_
shared.IFIX_PROFICY_AUTH_ADMIN and scada.fix.shared_APPLICATION_DESIGNER.
Upgrade Steps
To upgrade to the latest version of iFIX, perform the following steps:
1. Confirm that you backed up all the applicable files. Refer to the Before You Upgrade or Reinstall...
section above for more details.
2. Shut down any GE applications or Proficy services that are running. For instance, if you have His-
torian Collectors configured to start when you start Windows, use the Services window to shut
them down.
3. Run the iFIX product install. A message box appears asking you if you want to upgrade your sys-
tem.
4. Click Yes to continue.
5. Follow the instructions on your screen.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 7
With iFIX 2022, pictures are not automatically upgraded because this version uses the Enhanced Coordin-
ate System 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. For example, you can edit a leg-
acy 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
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 with tag groups will not.
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).
When you upgrade your database, the high and low engineering units (EGU) fields are converted from
single precision to double precision floats. This means 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.
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 FIX.INI stored in the Local path.
Additionally, you should restore other .INI files as necessary, using the same process.
8 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Upgrading Database Dynamos
Database Dynamos, also known as loadable blocks, will require updates to work with iFIX 2022. If you
have old Database Dynamos on your system, the iFIX install program will detect them, and generate a
warning message.
The GE Digital web site contains updated versions of the Database Dynamos supplied by GE Digital. To
obtain updated version of other dynamos, contact the vendor of that dynamo. To obtain the current ver-
sion of the Database Dynamo Toolkit, contact your local iFIX sales representative.
If a picture created with an earlier version of iFIX contains a VisiconX Data Control, and also contains
VBA 5.5 scripts added for the VisiconX Data Control's ErrorOccurred event or ExecuteComplete event,
when the picture is opened in iFIX 2022, it will generate a compiler error indicating an invalid character '_
'.
This occurs because the ErrObject in VBA 5.5 is declared as type "VBA._ErrObject", and in VBA 6.5, it is
declared simply as "ErrObject".
To correct the compiler problem and make the scripts function correctly, make the following changes to
the event declarations:
End Sub
End Sub
End Sub
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 9
End Sub
NOTE: This problem may occur with other ActiveX controls and data types that GE has not directly encountered. If you
see problems, you should insert the control into a new picture, go to the VBA Editor, and examine the syntax used to
declare events for the control in the new picture. Use the information provided in this section to edit the event declar-
ations in the existing picture.
For example, when you have the WorkSpace in Ribbon view (the default), the caption bar with the Min-
imize icon is displayed off screen. It's there, but you cannot view it. >My-T-Soft allows you to customize
where the Minimize button positions itself through the MYTSOFT.ini file located in the iFIX install folder.
By changing the ButtonOffsetY=0 setting to a positive number, you can move the button down a specified
number of pixels, allowing the Minimize button and caption bar to show in full screen, when in ribbon
view. After this value is configured, the My-T-Soft keyboard will always display in that specified offset pos-
ition.
1. Open Windows Explorer by clicking the Start button, and pointing to Programs, Accessories, and
then Windows Explorer.
2. Locate the folder to which you installed iFIX. (For example: C:\Program Files (x86)\Proficy\Proficy
iFIX.
3. Right-click the iFIX folder and select Properties from the right-click menu. The Properties dialog
box appears.
4. Click the Security tab.
5. Select the Users group in the top half of the dialog box.
6. Select the Allow check box for the Modify, Read & Execute, List Folder Contents, Read, and Write
permissions in the bottom half of the dialog box.
7. Click OK.
10 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Unsupported Items and Recommendations
If you want to archive these Microsoft applications along with your project with Backup and Restore or
Change Management, the Excel and Word documents must be saved to "App" sub-folder in the
WorkSpace system tree.
Alarm Viewer
The Alarm Viewer is no longer installed as part of iFIX. If you are upgrading from a previous version of iFIX,
your pictures with Alarm Viewer objects will continue to work. At the time of this release, however, the
Alarm Viewer is not supported on a Windows 64-bit enabled operating system.
FIX Desktop
iFIX no longer supports FIX Desktop.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 11
Classic Historian
As of 6.1, iFIX no longer supports Classic Historian and it has been removed from the program. Updating
to iFIX 2022 (or later) from a previous version will remove the Classic Historian binaries. Before updating,
make sure you have a plan to migrate your historical data to Historian Essentials, or some other per-
manent storage.
Migration Tools
iFIX 2022 does not support the FIX32 migration tools. If an .ODF files exists, that you want to convert, you
must use an older version of iFIX to upgrade screens first before opening the picture in iFIX 2022.
Speedstep Technology
SpeedStep® technology is not supported and must not be enabled.
IPv6
FIX does not make use of any IPv6 functionality.
If you disable IPv6 to use WebSpace, make sure that your local HOSTS file does not contain any IPv6 ref-
erences. For example, remove the "::1 localhost" lines from the HOSTS file, and replace them a line that
references the IP address and the local host name (if necessary).
12 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Drivers and Operating System Compatibility
Be sure to check with the vendor of your driver software to confirm that your driver supports the oper-
ating system you want to run it on.
If you want to run the OPC Client driver on a specified operating system, be sure to check with the vendor
of your OPC Server software to confirm that your OPC Server supports the operating system you want to
run it on.
It is recommended that you install the latest OPC Core Components from the Downloads section of the
OPC Foundation web site: http://www.opcfoundation.org. The latest OPC Core components are designed
for use on a 64-bit OS.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 13
OPC Servers that Require an Access Path
The iFIX WorkSpace does not support OPC servers that require an Access Path, such as RSLinx. To use an
OPC Server like RSLinx with iFIX, configure the server so that it does not require a value for the access
path. In order to do this with RSLinx, use the following syntax: [topic]item.
Instead of modifying the file, you can copy any of the experts from this file and incorporate them into your
own custom toolbar.
14 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Find and Replace Object Outside of the WorkSpace
The Find and Replace object is not accessible from clients that reside in a process outside the
WorkSpace. Any programs you create using Visual Basic will not support the Find and Replace feature.
To fix this issue, display hidden files in Explorer, delete the icon cache file, and restart Windows. This
action restores the icon cache.
WorkSpace Startup
After starting the operating system, the first time the WorkSpace is started, you may notice that it takes
longer for the WorkSpace to start up. Subsequent WorkSpace startups will not experience the delay. The
delay is related to the number of pictures in the picture folder, so smaller projects may not experience
the delay.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 15
Clicking the Calendar Control Shuts Down the WorkSpace
If you double-click a calendar control in the iFIX WorkSpace configure mode, or if you single-click it in
WorkSpace run mode, it may shut down the WorkSpace. The Microsoft Calendar control causes similar
issues in other Microsoft Office products. This is a known Microsoft issue.
The report generation remains halted until you click on the Cross Reference Tool. This causes the fol-
lowing message to appear: "An action cannot be completed because a component (iFIX WorkSpace (Con-
figure) is not responding. Choose "Switch To" to activate the component and correct the problem."
Use the Switch To button and acknowledge the several dialog boxes that appear. To avoid this problem
altogether, check for missing references before running the report wizard.
Close All Dialog Boxes in the WorkSpace Before Running the Report Wizard
If you try use the Cross Reference Tool Report Wizard when certain dialog boxes are open in the
WorkSpace, such as the User Preferences or the Find and Replace dialog boxes, an error may occur.
For instance, the following message may display: "The Cross Reference application could not export VBA
script files. Your ExpertGlobal may be corrupted. Cross Reference is exiting."
Click OK to acknowledge this message and allow the Cross Reference application to exit. To prevent this
message from occurring in the first place, close all dialog boxes in the WorkSpace before you run the
Report Wizard in the Cross Reference Tool.
16 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Avoid Running the Report Wizard with Read-Only Files
When you use the Cross Reference Tool Report Wizard to generate a report, the following message
appears if one or more of the files is read-only: "An action cannot be completed because a component
(iFIX WorkSpace (Configure)) is not responding. Choose "Switch To" to activate the component and cor-
rect the problem."
When you switch to the WorkSpace, this error appears: "Error number -2147211306. The file you are
attempting to open has been renamed outside the WorkSpace. Please make sure you have write access
to the file and try again."
Once you clear these messages, run the report again. Additionally, you can also use either of these tech-
niques to resolve this issue:
Remove the read-only attribute – Identify all files being searched for that have a read-only attribute.
Remove the read-only attribute.
Upgrade the file – Upgrade the file if you choose to leave the read-only attribute. To upgrade the file,
remove the read-only attribute on the file, open the file in the WorkSpace configuration mode, and close
the file. The file is automatically upgraded. You then have to add the read-only attribute to the file.
If security is enabled for Historian, and you do not have the necessary security group memberships, you
will not be able to use Mission Control to start or stop Historian collectors. To give the iFIX WorkSpace
and Mission Control access to the Historian collectors, configure a user name and password in one of the
following Historian dialog boxes:
l Configure the Historian Server(s) Access this dialog box by clicking Configure Historian Server on
the Historian toolbar.
l Historian Administrator Login Access this dialog box by opening the Historian Administrator and
clicking Main.
Be sure to read the Historian IPI (Important Product Information) document for tips about using the
product in general.
Please refer to the following KB article, article ID:15129, for authentication information for WebSpace
and Historian: http://support.ge-ip.com/support/index?page=kbchannel&id=S:KB15129&actp=search
The iFIX Scheduler and charts can use Historian data that supports Daylight Savings Time. However,
before allowing automatic Daylight Saving Time to be used in a production environment, you should test
your application under each of the following scenarios for proper behavior:
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 17
Working with iFIX Drivers
Use the Advanced tab of the PowerTool dialog box to set the Auto Start for each driver. If you do not use
the /A parameter and:
l the Auto Start setting in the PowerTool is set to On, 7.x driver starts automatically.
l the Auto Start setting in the PowerTool is set to Off, 7.x driver does not start automatically.
l ABR
l GE9
l M32
l MBE
l OPC
l SI5
l SL4
l SI7
Refer to the GlobalCare web site for software downloads for I/O driver updates:
https://digitalsupport.ge.com
18 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
3. Delete the MSFlexGrid control from the old picture.
4. Save the old picture.
5. Drag and drop the MSFlexGrid control back into the old picture and re-save it.
6. Delete the new picture.
For more information, refer to the Microsoft Knowledge Base article 318597.
To eliminate this error, you need to make the following registry change for the OPC data source.
For example, if your third-party OPC server is installed as SOMEOPCSERVER, then you would add the
string value "ValidateItemsNotSupported" to \HKEY_CLASSES_
ROOT\FIX32\DataSources\SOMEOPCSERVER key, setting the string value to "true." This change verifies
that data items on OPC Servers not implementing the ValidateItems call can be read.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 19
Visual Basic Editor from iFIX:
l Refrain from using punctuation marks, pound sign (#), and VBA reserved words within VBA file
names.
l Avoid generating a script within a script, that is currently executing. This causes unpredictable res-
ults.
l Do not use the WM_CLOSE SendMessage to close a user form; the object does not get destroyed
properly. If you must close a form with a script, use the WM_DESTROY SendMessage.
l Avoid referencing the Intellution iFIX Find and Replace Mechanism v1.0 Type Library in your pro-
ject. It causes an error when you compile your script.
l Be aware that a script based on an object's event should not call the DestroyObject method on
the parent of the same object. Doing so causes unpredictable results.
l If you are using any of the iFIX subroutines to write data back to the database, use the F_CV field
as the data link. Using the A_CV field may cause unpredictable results.
l Do not use the DblClick event when you configure a Data link for "In-Place" data entry. If you do,
the DblClick event does not execute.
l Do not access class modules that are declared as PRIVATE in an out of process environment, such
as user.fxg, expert globals, or any Global pages. This is not allowed.
l Be aware that when you change a source tag in iFIX, an automation error displays if you do not
allow iFIX enough time to establish the new connection before you read the InputValue property.
The wait time depends on the scan time of the event object source tag.
l If you set a tag with a static value as the source tag twice in a row, you will cause an automation
error.
For more information on using VBA in your iFIX projects, look up "summaries" or "scripting, in iFIX" in the
online help Index.
Code Example: Checking for a Null Value with the iFIX RealTime ODBC Driver
The iFIX RealTime ODBC driver was built to allow NULL values to be returned. For example, when check-
ing iFIX real time data for a tag that does not exist, a value of NULL is returned when the tag is not found.
In some instances, it may be helpful to check for the NULL value so that it is not counted as one string
returned. The following is an example of code that will allow you to check for the NULL value:
If Record.ID "" Then
MSG = "A valid record exists"
Else
MSG = "A null situation exists"
End If
MsgBox MSG
To avoid this problem, replace the second line in the above sample script with the following line:
20 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Dim iApp As Object
For example, say UserA installs iFIX to C:\LocationA, and then both UserA and UserB make use of iFIX. If
UserA uninstalls iFIX and then reinstalls iFIX to another location, say D:\LocationB, without deleting
C:\LocationA, UserB may experience issues. Although UserA will be able to use iFIX in its new location
without any problems, UserB will see several error messages if he tries to launch iFIX or the SCU, since
his registry paths still point to C:\LocationA.
As a workaround, open the Windows Registry and delete the HKEY_USERS\<USER'S ID>\Soft-
ware\Proficy\iFIX\ProjectPaths key which contains the old paths. For example, deleting the HKEY_
USERS\S-1-5-21-3882306234-4042192530-3641380709-1028\Software\Proficy\Proficy iFIX\Pro-
jectPaths key would alleviate this issue for a user with an ID of S-1-5-21-3882306234-4042192530-
3641380709-1028. After updating the Registry, be sure to restart iFIX.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 21
Case # Area Description
22 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Case # Area Description
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 23
Case # Area Description
24 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Case # Area Description
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 25
Case # Area Description
If you have iFIX with Productivity Tools installed and you upgrade from to
DE124575 Upgrade iFIX 2022, manually update the FIX.INI to include this entry at the end of the
[SCADA] section: RUN=%IFIX_CONFIG_SERVICE.EXE run -config ifix_config_
service.json. Restart iFIX after you save your changes.
26 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Issue Area Description
When running iFIX with its OPC UA Server enabled on a computer that has
VMWare installed, you may find that you cannot discover the OPC UA Server
from clients on the local machine. In this case, you may repeatedly see the
following error in the iFixUaServer.log file: Error: "Registration with Dis-
covery Server failed." This occurs because the VMWare virtual network
adapter fails to respond during Discovery Server registration, which causes
DE118716 OPC UA
the entire registration operation to time out.
In order to work around this, you can disable the VMWare network adapter
(if it is not used) in Control Panel. Otherwise, you will need to manually
enter the endpoint URL of the OPC UA Server into client applications, since
they cannot find the server by discovery. Note that this issue only affects
discovery of the iFIX OPC UA Server and has no impact on further con-
nectivity or functionality of the iFIX OPC UA Server.
OPC Core Components subinstall displays a request to install a VC 2013
Redistributable (version 12.0.30501)
DE122938 Install This error occurs only on a fresh install. It occurs because the target system
already has the Microsoft VC++ 2013 Redistributable Update 5 (12.0.40660)
installed. Acknowledge the message and continue. The install will run prop-
erly despite the message.
Cannot open OPC UA Client Driver Configuration Tool When the Windows
Firewall is Enabled
OPC UA Client
DE120941 Add port 9444 to the Windows firewall exception list, along with any other
Driver
port associated with this driver that you want to include, such as ports
4855, 4856, and 4857.
iFIX UA client will not fully work with OPC UA Aggregators that change server
iFIX OPC UA Cli- namespaces dynamically
TA626596
ent
This is not supported in iFIX 2022.
Discover and Discover and Auto Configure Does not Support Long Tags Names or OPC UA
TA592883
Auto Configure These items are not supported in iFIX 2022.
Size of HPLinearGauges Dynamo Not Maintained After Upgrade
This is a known issue in iFIX 2022. When the HPLinearGauge Dynamo in pic-
DE114780 WorkSpace ture is upgraded with the iFIX 2022 Master Dynamo, then the updated
Dynamo will be reduced in length. There is no workaround for this issue
except to manually resize the upgraded Dynamo.
iFIX Collector Fails When Browsing iFIX Tags in the Historian Administrator
If you try to browse tags, for instance from the Add Multiple Tags from Col-
Historian Integ- lector dialog box in the Historian Administrator, the iFIX Collector will fail.
DE92547
ration Be aware that you can still add tags, up to 199 characters long, for collection
using FixToHist.exe.
This is a known issue with the Historian Collector in Historian 7.0 and has
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 27
Issue Area Description
If you have iFIX with Productivity Tools installed and you upgrade to iFIX
DE90938 Upgrade 2022, then the FIX.INI file does not contain an entry for the iFIX OPC UA
Server. As a workaround, manually update the FIX.INI to include this entry at
the end of the [SCADA] section: RUN=%IFIXUASERVER.EXE. Restart iFIX
after you save your changes.
HTC Tab is not Working With Historian Installed
DE90685 Mission Control In iFIX 2022, Historical Collector actions are no longer supported from the
iFIX Mission control application, mission.exe. Please use the Historian Admin-
istrator UI instead.
Alarm Shelving Related Fields Are Not Shown in the Text Compare Report
Change Man-
DE89991 Alarm Shelving related fields are not shown in the Text Compare Report in
agement
the Change Management History window.
Alarm Shelving Status Incorrect When Alarms Are Sent Over AAM
DE84751 Alarm Shelving When using the Auto Alarm Manager (AAM) with Alarm Shelving, be aware
that the Alarm Shelving Status is incorrect when alarms are sent via AAM.
Altered Table Failing for Microsoft Access Database Due to Long Tag Names
and Descriptions
After upgrading to iFIX 2022, when using Microsoft Access to log Alarms
using ODBC, an error occurs. To use iFIX after an upgrade with Microsoft
Access requires a manual update to the Registry and an update of the
Microsoft Access database in Design View. The ALM_TAGNAME and ALM_
TAGDESC (if it exists) rows needs to be formatted as a LONGTEXT (MEMO)
field.
28 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Issue Area Description
When using VisiconX, be aware that you must configure your environment
variables correctly for Oracle. If you select the Microsoft OLE DB Provider for
ODBC Drivers as your data source, when you try to select an Oracle table,
you will experience an error. On the Oracle Client machine where iFIX is
installed, set the ORACLE_HOME environment variable to point to the
Oracle Admin Client installation directory.
For example:
For the CTR, GAB, ITM, PAR, and P12 blocks, an upgrade to iFIX 2022 does
Database Man- not fix issues with the Alarm Area 2 and Alarm Area 3 ordering. As a work-
DE85273 around, you need to export the database to a .CSV file, edit the Alarm Area
ager
2 and Alarm Area 3 values, and then reimport the database back into iFIX
2022 to fix the designated Alarm Areas. If the blocks are created using iFIX
2022, there is no issue with alarm areas.
Tags Created After Connection Established to the SOA Server Appear Miss-
iFIX-SOA Ser- ing When Browsing Tag Properties on SOA Node
DE86292
vice Provider The workaround is to restart iFIX each time you add a new block type to the
existing iFIX database.
DE71528 WorkSpace Identifier Too Long Error for Long Tag Name on Script Behind Event
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 29
Issue Area Description
DE82077 WorkSpace There are limitations on screen that will not allow the full tag name to be
displayed in Tag Status pictures. Even with the use of tooltips, you are
restricted to 160 characters.
New Document Option Is Disabled in the System tree for Microsoft Word
and Excel Files
As a workaround, you can create the registry keys as described in the fol-
lowing articles. Restart the iFIX WorkSpace after doing making your
DE69641 WorkSpace changes.
https://answers.microsoft.com/en-us/msoffice/forum/msoffice_o365ad-
min/why-docobject-registry-keys-with-a- value-of-16-are/24cd9c98-46a9-
4c10-8ca1-cb3933bd7817
https://community.qlik.com/docs/DOC-14030
Tag Lookup Takes Longer Than Expected
DE80338 WorkSpace When browsing tags in the Expression Editor on a view node (iClient), it may
take 50% longer to perform the initial tag lookup.
Long Tag Name Not Readable or Shrinks in Enhanced Charts
Enhanced
DE66431 After inserting a Line Chart or XY Chart, a long tag name is not readable or
Charts
shrinks on the chart display.
iFIX Charts (with Historian data) Not Working on a System with Historian
Historian Integ- 7.0 Mirroring when Primary Historian Server is Unavailable
N/A
ration
iFIX 2022 currently does not support Historian 7.0 mirrored systems.
DE17435 Dynamos Sometimes the Values Displayed on the HPTanksAnim and HPLinearGauges
30 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Issue Area Description
Try saving the picture before switching to run mode or run the WorkSpace in
Full Screen mode. Disabling Zoom to Fit may also display the values cor-
rectly.
When Shape objects are aligned to each other with the Edge Width property
set to 0, the objects display a white line within GE Web HMI browser client.
When a picture is created in iFIX with Shape objects that are aligned to each
other and the Edge Width property is set to 0, the objects in the exported
Web HMI picture display a white line when viewed within GE Web HMI.
DE14743
Export
Workaround: If the Edge Width property is 0, set the Edge Style property to
“EdgeStyleNone” in the object’s property window, or set Edge Style to “No
Edge” via the object’s Right Mouse Menu option. Confirm that the objects
look correct in iFIX Configure mode. Then, save and export the picture for
Web HMI.
Some Anti-Aliased Lines that are Near Horizontal Appear Fuzzy
DE29895 WorkSpace With SmoothShapes (anti-aliasing) enabled, edge lines of some objects can
appear fuzzy when they are at certain angles... such as with line objects
when they are in a near-to-horizontal position.
Some Text Objects Draw Lighter than Normal
Text objects with a font size of 13 or smaller will draw without anti-aliasing
regardless of the SmoothShapes setting in the picture. Size 13 fonts with
the bold property set will draw with anti-aliasing.
Changing the font style from Regular to Bold, or increasing the font size
improves the readability of the text.
Dynamo sets with text objects that use small fonts may need to be edited in
pictures where SmoothShapes is enabled. Changing the font style from reg-
ular to bold or increasing the font size improves the appearance of the text
within the Dynamo.
Anti-aliased Objects with Edge Style = 6 (inside frame) will See Color Out-
side the Object Frame
DE25183 WorkSpace Anti-aliased objects with edge style = 6 (inside frame) will see pixels for the
background color or fill color outside the object's frame. There is currently
no workaround.
LineChartPopUpHist.grf and LineChartPopUpReal.grf Pictures Display an
Error when Switching from Configure to Run Mode
DE29588 WorkSpace
These popup pictures are meant for the associated Dynamo objects (Chart_
LineHist and Chart_LineRealTime). When the Chart_LineHist or Chart_
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 31
Issue Area Description
If you see a "server not licensed" error message from IMG, start the service
DE28601 My-T-Soft manually. From Start menu, select My-T-Soft > License Information to open
the IMG application, and click the Start Service button. You can also use the
command line to start the service: Manage.exe START. After the service
starts, try to run My-T-Soft again.
VisconX dialog boxes display a few headings with clipped text (in Configure
mode only)
DE113972 VisconX When using the VisiconX controls, be aware that the Database and Record
Source tabs may contain some subheadings with clipped text. This is a
known issue due to a Microsoft coding limitation on text allowed on frames
used within frames. There is no known workaround at this time.
Unable to Configure Historian Server in the iFIX WorkSpace after installing
Historian 8.1 or 9.0 Client Tools one time
DE151572 Historian
When this issue is encountered, install the Historian 8.1 or 9.0 Client Tools a
second time on the iFIX system, restart, and then try again to configure.
The OPC UA Server cannot monitor more than 32,000 tag fields at a time
DE139692 OPC UA Server There is currently no support for more than 30,000 tags in the OPC UA
Server.
Model tags not initially shown in Expression Builder after Model Import
Configuration The workaround is wait a few minutes and do a refresh, or close the
DE150686
Hub WorkSpace and then restart after a few minutes. The indirect tags should
now be listed.
Deleted Shelve Policy Still Appears in Configuration Hub UI
Configuration If you delete a shelve policy in the Database Manager, it will still appear
DE145434 assigned to tags in the Configuration Hub UI. No error appears when you
Hub
open the tag in Configuration Hub. As a workaround, you need to manually
update the tag with a new policy.
Browse dialog opens slowly with IGS and IDS when connected to a large con-
figuration
Database Man-
DE137521 The browse button may take over a minute or more to open when with a
ager
large database. As a workaround, wait a few minutes for the database to
open.
WorkSpace will not start when the domain user is added to the secure
iFIX group after the install
DE137082
WorkSpace After adding a user to the iFIX secure users group on a Domain, you may not
have immediate access to iFIX resources (cannot run iFIX). Wait for a few
32 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Issue Area Description
Unsupported model names can be imported into Configuration Hub, but you
Configuration will not be able to edit or do further operation on them. For instance, using
DE156901
Hub API calls you can create a type or instance name which has more than 256
bytes. You can also perform an import or export. More than 256 bytes is cur-
rently not supported.
Database File Encoding in Configuration Hub and the iFIX Database is Dif-
Configuration ferent
DE166777
Hub Be aware that Configuration Hub supports only UTF-8 encoded files. The
iFIX Database Manager uses ANSI encoding.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 33
Issue Area Description
If you export a .CSV database file from Configuration Hub, you need to
change the format from UTF-8 to ANSI before importing it into the iFIX Data-
base Manager. Open the .CSV file in Notepad, save the file with ANSI encod-
ing, and then import it into the Database Manager.
Likewise, to import a .CSV database file from the Database Manager into
Configuration Hub, the file format must be in UTF-8 format. If you exported
your .CSV file from the iFIX Database Manager, you must change the format
to UTF-8 before importing it into Configuration Hub.
The iFIX installation fails if the host name or computer name is greater than
15 characters This limitation is because the network NetBIOS name can be
only 15 characters.
DE166800 Installation
With greater than 15 characters, you cannot set the iFIX Secure Mode- Ser-
vice user. Also, the Configuration Hub certificate will not be created prop-
erly, making it so that you cannot log in to Configuration Hub.
When running the Plant Applications Report Server as a service (for the
Microsoft Excel Addin), you may experience issues if you do not have the
security settings correct for ActiveX controls.
If you see this message and ignore it or disable the control, you will also
experience issues: "Microsoft Forms: This application is about to initialize
ActiveX controls that might be unsafe. If you trust the source of this file,
ActiveX Con-
DE146496 select OK and the controls will be initialized using your current workspace
trols
settings."
1. Log into the Plant Applications Report Server with the account the
report server services are configured to run as. (On a client system,
skip this step.)
2. Open Microsoft Excel and select File and then Options.
3. Click Trust Center, and then Trust Center Settings.
34 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Issue Area Description
DE163450 WorkSpace The workaround is to use the T_DATA field. T_DATA2 is not supported in
older versions of iFIX. The T_DATA field is used for getting an array of data
from the TR or ETR block (to plot the pen in the chart). T_DATA is array of
16-bit integers. While T_DATA2 is array of 32-bit integers.
Model Search and Filter Issues
Configuration If you try to filter the model view while the nodes are expanded, the filter
DE173820
Hub will not work. As a workaround, collapse the node view to apply the filter.
For the model, you can only apply the Search or the Filter at a time.
After Upgrading from iFIX 6.5 to 2022, iFIX Fails to Start
If upgrading from iFIX 6.5 to iFIX 2022 using the Integrated Installer, and iFIX
Integrated 6.5 used Secure Mode and was running iFIX as a service, then iFIX will fail to
DE174216
Install start after the upgrade. After upgrading, run the "Setup Access Control" util-
ity from the Start Menu and set the service account and password. Other-
wise, iFIX will fail to start.
iFIX Installer Can Not Create IFIXUSERS Group when Machine Name Con-
tains non-English Characters
DE173848 Installation
Running iFIX on a computer with a machine name that contain non-English
characters such as æ, ø, å in the name is not supported.
OPC UA Client Working Prior to Upgrade, but Now Registration Shows Cer-
tificate Not Trusted
DE173697 Upgrade
Before upgrading iFIX, delete the old OPC UA Configuration certificate (iFIX_
OpcuaConfigRoot.crt) from the Program Files (x86)\GE\iFIX\LOCAL\iFIX_
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 35
Issue Area Description
If you forget to delete the certificate before upgrading iFIX, you will need to
follow the steps in this topic in order to trust the certificate again after the
upgrade: https://www.ge.-
com/digital/documentation/confighub/version2022/g_ifix_confighub_server_
name_changes_ifix.html#g_ifix_confighub_server_name_changes__ifix_
certs1.
APPLICATION DESIGNER Group Does Not Migrate on Upgrade or Export to
Proficy Authentication After Upgrade
This issue occurs because Proficy Authentication does not support spaces in
group names. To resolve this issue after upgrading, create the group again in
iFIX and then export it to Proficy Authentication.
After you upgrade iFIX and Configuration Hub, log in to Configuration Hub.
From the Navigation Pane, under Proficy Authentication, select Security. On
the Security panel, click the Users link. Double-click the ch_admin user. In
DE174060 Upgrade the Details pane, in the Group Membership area, click Edit to open the
Group Membership dialog box. Select the check box for the following groups:
scada.fix_shared.IFIX_PROFICY_AUTH_ADMIN, and scada.fix.shared_
APPLICATION_DESIGNER, and then click Apply. Save your changes. The
APPLICATION _DESIGNER will give you access to iFIX in Configuration Hub,
while IFIX_PROFICY_AUTH_ADMIN will allow you to use Proficy Authentic-
ation.
When an Operations Hub Model File is Imported, Instances Are Not seen in
Configuration Model List
DE174332
Hub Spaces are not supported in model or tag names in Configuration Hub. So
for instance, if your Operation Hub model is imported into Configuration Hub
36 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Issue Area Description
and the model names have spaces, the model instances will not be seen the
model list. As a workaround, update the model file to remove the unsup-
ported space characters before importing.
Getting "Failed to load plugin Application: Undefined" while Loading the
Configuration Remote iFIX Plugin
DE174443
Hub The Configuration Hub node and the iFIX node need to be in the same
domain or same workgroup.
Error Displays that iFIX is Not Active or Unable to Retrieve Local Information
When iFIX and Configuration Hub are on different computers and an error
Configuration displays that the iFIX SCADA is not active or unable to retrieve locale inform-
DE169376 ation, ensure that iFIX is started and that SCADA is enabled. (If iFIX has Fail-
Hub
over enabled, then only the Primary Node in Maintenance Mode can connect
to Configuration Hub.) Also, make sure that both systems have same date
and time.
Issues registering upgraded iFIX Server with remote Configuration Hub
When iFIX 2022 is upgraded from a previous version of iFIX, sometimes the
iFIX Register to Configuration link shows as non-trusted. You will need to
recreate the iFIX_OpcuaConfigService certificate. The steps to do that are:
NOTE: If you experience any certificate issues when you open up Con-
figuration Hub, you can use these same steps to remove the certificates and
then re-add them.
Configuration
DE174910 1. rom the iFIX install folder, open the iFIX Configuration Service Cer-
Hub
tificate Tool (iFixConfigServiceCertTool.exe) tool as an Administrator.
By default, this tool is found in the C:\Program Files (x86)\GE\iFIX\
folder.
2. Click Delete Certificates, and then click Delete Certificate Binding.
3. Create the new certificates by clicking the Create Certificates but-
ton.
4. Copy the iFIX_OpcuaConfigServer.crt and iFIX_OpcuaCon-
figServer.key files from the C:\Program Files (x86)\GE\iFIX\CFG\iFIX_
OpcuaConfigService\pki folder into the C:\Program Files
(x86)\GE\iFIX\web\conf directory.
5. Restart the computer.
6. Restart iFIX. When iFIX starts, and you open the Configuration Hub
Server Registration page to register Configuration Hub from the iFIX
WorkSpace, the trust should now appear on this page.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 37
l Software Requirements
l Hardware Requirements - iFIX SCADA Server
l Hardware Requirements - iFIX iClient/View
l Wireless Devices and iFIX
l Virtual Machine Support
l Remote Desktop (Terminal Server) Support
l Compatibility with other GE products
Software Requirements
GE recommends using the latest service packs for Windows operating systems. The minimum iFIX soft-
ware requirements include:
38 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
l Microsoft® SQL Server 2017
l Microsoft® SQL Server 2019
l Oracle® 19c
l Microsoft® Access 2000 (or higher). Microsoft Access is supported for local installs only
l A 3.0 GHz Intel® Core™ i5 Processor or equivalent with 8GB of memory. For better performance,
please consider using a faster processor and more memory. When running Proficy Authentication
or Historian on the same server at the iFIX SCADA Server, we recommend at least 16 GB of
memory.
l SpeedStep® technology is not supported and must not be enabled.
l 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 resyn-
chronizing the clock. For example: W32tm /resync /nowait. The /nowait parameter instructs the
operating system to make a stepping adjustment against the time server.
NOTE: With virtual machines, the host and guest operating system need to synchronize against an external
physical Network Time Protocol (NTP) Server.
l The power save settings on your computer must be disabled. Do not use any power setting fea-
tures that affect CPU clock speed. For Enhanced Failover, the power save settings on both com-
puters and dedicated network card (NIC) must be disabled.
l For Enhanced Failover, you need one additional Gigabit-Ethernet card (or better) dedicated for
SCADA-to-SCADA traffic (for a total of at least 2 network cards), or the VMXNET 3 network
adapter NIC. 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 syn-
chronization. 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.
l For Enhanced Failover, 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.
l For Enhanced Failover, the Primary and Secondary SCADA computers must be located physically
next to each other, in the same location/room.
l For Enhanced Failover, Jumbo Frames technology must be used on the dedicated network. 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.
l A minimum of 40 GB of free hard drive space for iFIX pictures, databases, alarm files, and other
data files, in addition to the free disk space required by the operating system for Windows
Updates. It is strongly recommended that many GBs of additional free space exist on the hard
drive to avoid performance issues.
l Be aware that iFIX alarm and historical data files grow dynamically. If you plan to perform extens-
ive alarm or data collection on a node, you may need more disk space on that particular node.
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 39
l Other GE products, such as Proficy Plant Applications and Proficy Historian, impose additional
requirements. Refer to the System Requirements in the associated product's electronic books for
that product's specific system requirements.
l 100 MBit or faster Full Duplex TCP/IP-compatible network interface adapter for iFIX network com-
munication between SCADA and Client nodes.
NOTE: iFIX does not support NetBIOS or IPv6.
l 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.
l For Enhanced Failover, ensure that the following ports are open on your firewall: UDP port 53014
needs to open for the Sync Card and TCP 2010 needs to open for the SCADA NIC.
l SVGA or better color monitor with a 24-bit (16,777,216 colors) graphics card capable of at least
1024x768 resolution.
l Two-button mouse or compatible pointing device (such as a touch screen) that can open a context
menu.
l A 3.0 GHz Intel® Core™ i3 Processor or equivalent with 4GB of memory. For better performance,
please consider using a faster processor and more memory.
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/lib-
rary/windows/desktop/aa366796%28v=vs.85%29.aspx.
l SpeedStep® technology is not supported and must not be enabled.
l 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 resyn-
chronizing the clock. For example: W32tm /resync /nowait. The /nowait parameter instructs the
operating system to make a stepping adjustment against the time server.
NOTE: With virtual machines, the host and guest operating system need to synchronize against an external
physical Network Time Protocol (NTP) Server.
l The power save settings on your computer must be disabled. Do not use any power setting fea-
tures that affect CPU clock speed.
l A minimum of 20 GB of free hard drive space for iFIX pictures, databases, alarm files, and other
data files, in addition to the free disk space required by the operating system for Windows
Updates. It is strongly recommended that many GBs of additional free space exist on the hard
drive to avoid performance issues.
l Be aware that iFIX alarm and historical data files grow dynamically. If you plan to perform extens-
ive alarm or data collection on a node, you may need more disk space on that particular node.
l Other GE products, such as Proficy Plant Applications and Proficy Historian, impose additional
requirements. Refer to the System Requirements in the associated product's electronic books for
that product's specific system requirements.
l 100 MBit or faster Full Duplex TCP/IP-compatible network interface adapter for iFIX network com-
munication between SCADA and Client nodes.
NOTE: iFIX does not support NetBIOS or IPv6.
l 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.
l SVGA or better color monitor with a 24-bit (16,777,216 colors) graphics card capable of at least
1024x768 resolution.
40 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
l Two-button mouse or compatible pointing device (such as a touch screen) that can open a context
menu.
GE Digital will support the functional operation of the product that is running on a supported Operating
System in a virtualized environment and will address any functional issues related to the software.
GE Digital cannot guarantee performance of the software in the virtualized environment due to the wide
range of parameters associated to the hardware, configuration, memory settings, 3rd party software,
and the number of virtual sessions running on the same hardware, all of which can affect performance.
It is the responsibility of you, the customer, to ensure that the performance of the GE HMI/SCADA soft-
ware and application are adequate to meet the needs of their runtime environment. GE does not support
issues related to functionality that is not available as a result of running in a virtual machine. Examples
include the functionality of card level drivers such as Genius, RMX, SA85 and functions requiring direct
video access, or functionality of other software running in the same environment. It is your responsibility
to check with the vendor of those applications for their ability to run in a virtualized environment.
Each virtual machine instance that is using our software is required to have a valid license. The licensing
in a virtualized environment will depend on the access to a hardware key or a license server depending
on the selected license type.
l Microsoft Windows 10: Remote Desktop Connection Version 10.0.19041 – Remote Desktop Pro-
tocol 10.8
l Microsoft Windows 11: Remote Desktop Connection Version 10.0.22000 – Remote Desktop Pro-
tocol 10.10
l Microsoft Windows Server 2016: Remote Desktop Connection Version 10.0.14393 – Remote
Desktop Protocol 10.2
l Microsoft Windows Server 2019: Remote Desktop Connection Version 10.0.17763 – Remote
Desktop Protocol 10.6
l Microsoft Windows Server 2022: Remote Desktop Connection Version 10.0.20348 – Remote
Desktop Protocol 10.9
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 41
Compatibility with other GE Products
Several GE products work with iFIX. The following is a general set of versions tested to work with the iFIX
2022 product:
NOTE: For information on product compatibility with critical Microsoft security patches, go to the GE
Digital support web site:
https://digitalsupport.ge.com/communities/en_US/Article/Information-on-Product-Compatibility-with-
Critical-Microsoft-Security-Patches
42 © 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d .
Index
© 2 0 2 2 G e n e ra l E le c tric C o m p a n y . A ll rig h ts re s e rv e d . 43