This release has the following requirements.
For the latest compatibility information, refer to the Product Compatibility and Download Center.
Hardware requirements
FactoryTalk Linx Gateway recommends the following hardware for applications with typical data acquisition needs:
Lower level x86-based CPUs will also work in standalone configurations with reduced data acquisition needs.
For small applications, the following configuration was also evaluated:
It is recommended to run a performance validation test on the planned computer hardware to ensure that the desired capacity and performance can be achieved.
|
|
Tip: When FactoryTalk Linx Gateway is operating on Windows® 10 IOT
Enterprise (for example, the Windows core of a CompactLogix™ 5480 controller),
it is limited to a FactoryTalk Directory and FactoryTalk Linx data server running in
the same environment (a remote directory and data server are not supported).
|
Operating systems
FactoryTalk Linx Gateway was tested on the following operating systems:
FactoryTalk Linx Gateway adopts .NET 4.8 which is only supported in Windows 10 v1803 and later.
If you use FactoryTalk Linx Gateway on Windows 11, you must update Windows 11 with patch KB5008215.
*For additional information about Windows 10 Support for the FactoryTalk Suite of Rockwell Software® products, refer to Knowledgebase Document ID: IN4493 - Windows 10 Support for the FactoryTalk Suite of Rockwell Software products.
Software compatibility
FactoryTalk Linx Gateway version 6.31.00 is compatible with these Rockwell Software products:
High Resolution Display Support
Windows 10 v1803 or later is the recommended operating system if running this software with a 2K or 4K High Resolution Display with scaling up to 125%.
Rockwell Automation Test Environment
Rockwell Automation tests software products under a standard configuration of operating systems and antivirus software. For additional information, see the Knowledgebase Document ID: PN24 - Rockwell Software Products and Antivirus Software.
Supported browsers
The following web browsers have been tested and are supported for use with this release:
Security requirements
To help meet secure system design requirements, review these publications:
To learn about implementing CIP Security, see CIP Security with Rockwell Automation Products Application Technique (publication SECURE-AT001).
This release includes the following system features.
FactoryTalk Linx Gateway version 6.31.00 has the following new features:
|
|
Note: FactoryTalk Linx and the FactoryTalk Linx OPC UA connector include new
capabilities that can be utilized by external clients connected to FactoryTalk Linx
Gateway. Review each product’s Release Notes and documentation to determine
the full set of capabilities.
|
This release has the following known anomalies.
To resolve this problem, use the UA or RTD/DDE custom namespace configuration editor to manually change the data type to BOOL.
Corrected in FactoryTalk Linx Gateway version 6.40.00.
To solve this problem, repair Remote Gateway or FactoryTalk Linx Gateway.
There is no workaround for this anomaly.
Corrected in FactoryTalk Linx Gateway version 6.50.00.
These anomalies are from previous releases but are still known in this release.
Corrected in FactoryTalk Linx Gateway version 6.50.00. Install patch 1150515 to resolve the problem in versions 6.31.00 and 6.40.00.
OPC UA clients cannot get data changes via FactoryTalk Linx Gateway when the OPC UA server or HMI server is configured with the local FactoryTalk Directory and the OPC UA Server is configured with Folders with scalar data or Tag list and structures/array access. First identified in FactoryTalk Linx Gateway version 6.30.00. [Jira 3677403]
To resolve this problem, do the following:
Perform the following modifications to DCOM
Migrate to using a Network Station application, which will eliminate the need to configure DCOM as listed above.
Corrected in FactoryTalk Linx Gateway version 6.50.00.
This release has the following functional changes from the previous release.
FactoryTalk Linx Gateway version 6.31.00 has no changes in functionality since the last release.
This release has the following application notes.
The following are the application notes for FactoryTalk Linx Gateway version 6.31.00.
Tag’s data type limitation in Custom Namespace
If you do not use the Tag Browser to add or edit a tag in the Custom UA Namespace or Custom RTD/DDE Namespace editor, you must ensure that the tag’s data type is the same as the data source, such as the Logix controller, or OPC UA server connected via the FactoryTalk Linx OPC UA Connector.
If you change a tag’s data type in a controller, you must ensure that the tag's data type in the Custom UA Namespace or Custom RTD/DDE Namespace editor is the same as that in the controller. Otherwise, an error message “BadTypeMisMatch” appears in the UA clients.
Remote Proxy service
The Remote Proxy service does not support FactoryTalk View ME Transfer Utility.
The Remote Proxy service supports Ethernet and Backplane drivers from the FactoryTalk Linx Network Browser.
CIS Benchmarks test results
Rockwell Automation conducts tests using domain-joined computers configured according to CIS Benchmarks to help assure that software products perform as expected on computers that are hardened to industry best practices.
For more information about the guidelines and which products were tested against which CIS Benchmarks, see the Knowledgebase Document ID: QA63609 - Recommended guidelines for hardening software, computer, device, and network systems and infrastructure (CIS Benchmarks).
|
|
Note: If a product compliance with the benchmark is less than 100%, a link to a
detailed spreadsheet is available. Download the spreadsheet to assist you in
determining whether additional compensating controls are necessary.
|
FactoryTalk Linx Gateway version 6.31.00 has been tested on CIS Microsoft Windows 10 Enterprise (Release 21H1) Benchmark v1.12.0, CIS Microsoft Windows 10 Enterprise (Release 21H2) Benchmark v1.12.0, CIS Microsoft Windows Server 2019 Domain Server Benchmark v1.3.0, and CIS Microsoft Windows Server 2019 Domain Controller Benchmark v1.3.0.
Exceptions settings for FactoryTalk Linx Gateway version 6.31.00 are listed.
CIS Microsoft Windows 10 Enterprise (Release 21H1) Benchmark v1.12.0 and CIS Microsoft Windows 10 Enterprise (Release 21H2) Benchmark v1.12.0
CIS Microsoft Windows Server 2019 Domain Server Benchmark v1.3.0
CIS Microsoft Windows Server 2019 Domain Controller Benchmark v1.3.0
Array Data Request
When an OPC UA Client makes a subsequent request to an array beyond the last element previously requested, FactoryTalk Linx Gateway’s OPC UA service will initially return a "BadIndexRangeNoData" error. If the array is defined to accommodate the requested elements, the initial error response is replaced with the appropriate array data.
Certificate
When a user regenerates a certificate in FactoryTalk Linx Gateway version 6.21.00 or later, and then uninstall it with "Keep configuration when uninstall" selected, FactoryTalk Linx Gateway installed on the same computer later may not work. To avoid this problem, delete all the files in folder <C:\ProgramData\Rockwell\FactoryTalk Linx Gateway\PKI\own>, restart FactoryTalk Linx Gateway, and then regenerate an outgoing certificate.
The following certificates are installed while installing Rockwell Automation software.
FactoryTalk Linx Gateway unsupported data types
FactoryTalk Linx Gateway natively supports most but not all data types defined in a Logix controller. FactoryTalk Linx Gateway does not support accessing these types through DA, UA, DDE or RTD services:
Tested FactoryTalk Linx Gateway OPC DA service update rates
CPU and memory requirements for the FactoryTalk Linx Gateway OPC DA server increase as tags are set to active (up to the activation tag capacity) or as more clients connect to the server (up to the 20 connected client capacity). Rockwell Automation tests with the following update rates for a number of active tags.
|
Processor
|
Number
of tags
|
Scan rate of all tags
|
Total CPU
utilization
|
|
Single
|
70,000
|
Controller data values changing at 250 msec
|
75%
|
|
Dual-core
|
70,000
|
Controller data values changing at 250 msec
|
50%
|
|
Dual-core
|
70,000
|
Controller data values changing at 1000 msec
|
20%
|
|
|
Note: Many of the FactoryTalk services use change of state processing. The high
data value change rate used in this test was selected to place a high processing load
on the system to evaluate the computer’s CPU impact. Because each system has
different operational requirements, testing should be performed to determine how a
proposed system will operate.
|
These values are tested on a computer with a dual-core Intel® Core™ i3-2120 processor, 3.3 GHz, with 4G of RAM. The single core test is run using only one of the cores to provide a basis for comparison. FactoryTalk Linx Gateway and FactoryTalk Linx are installed and configured on the same computer for the test.
The largest impact on CPU utilization is the rate that the data is changing even if the data server (in this case, FactoryTalk Linx) is local or remote to the FactoryTalk Linx Gateway.
The total amount of memory used for the runtime tests was approximately 700 MB. Additional memory would be used if browsing occurred.
Tested FactoryTalk Linx Gateway OPC UA update rates
Rockwell Automation tests with the following update rates for a number of active tags. This data is captured in FactoryTalk Linx Gateway version 6.31.00 with security disabled.
CPU and memory requirements for the FactoryTalk Linx Gateway OPC UA server increase as tags are set to active (up to the activation tag capacity) or as more clients connect to the server.
|
Number of Active Tags
|
Requested Rate (s)
|
Achieved Update Rate (s)
|
|
50,000
|
0.5
|
0.561
|
|
100,000
|
0.5
|
0.759
|
|
150,000 | 0.5 |
1.023
|
|
200,000
|
0.5
|
1.287
|
|
250,000
|
0.5
|
1.635
|
|
300,000
|
0.5
|
1.996
|
|
350,000
|
0.5
|
2.403
|
|
400,000
|
0.5
|
2.777
|
|
450,000
|
0.5
|
3.192
|
|
500,000
|
0.5
|
3.327
|
|
|
Note: This data was based on tests with the Folder with scalar data enabled in the
UA server. This data is provided as an example to show how tag quantity will
impact the speed that data can be delivered. The test did not verify all value changes
that were delivered. Because each system has different operational requirements,
testing should be performed to determine how a proposed system will operate.
|
|
Number of Active Tags
|
Requested Rate (s)
|
Achieved Update Rate (s)
|
|
10,000
|
0.5
|
0.5
|
|
50,000
|
0.5
|
0.5
|
|
100,000
|
0.5
|
0.5
|
|
150,000
|
0.5
|
1
|
|
200,000
|
0.5
|
2
|
|
250,000
|
0.5
|
2
|
|
300,000
|
0.5
|
2
|
|
350,000
|
0.5
|
2
|
|
400,000
|
0.5
|
2.5
|
|
450,000
|
0.5
|
3
|
|
500,000
|
0.5
|
4
|
|
|
Note: This data was based on tests with the UA tag list enabled. This data is
provided as an example to show how tag quantity will impact the speed that data
can be delivered. The test did not verify all value changes that were delivered.
Because each system has different operational requirements, testing should be
performed to determine how a proposed system will operate.
|
|
Number of Active Tags
|
Requested Rate (s)
|
Achieved Update Rate (s)
|
|
10,000
|
0.5
|
0.5
|
|
50,000
|
0.5
|
0.57
|
|
100,000
|
0.5
|
1.003
|
|
150,000
|
0.5
|
1.335
|
|
200,000
|
0.5
|
1.977
|
|
250,000
|
0.5
|
2.257
|
|
300,000
|
0.5
|
2.557
|
|
350,000
|
0.5
|
2.885
|
|
400,000
|
0.5
|
2.351
|
|
450,000
|
0.5
|
3.433
|
|
500,000
|
0.5
|
4.006
|
|
|
Note: This data was based on tests with the Custom namespace enabled. This data is
provided as an example to show how tag quantity will impact the speed that data
can be delivered. The test did not verify all value changes that were delivered.
Because each system has different operational requirements, testing should be
performed to determine how a proposed system will operate.
|
These values are tested on a computer with Win 10 enterprise 64 bit, 8G RAM, Intel® Xeon® CPU, E5-2699A v4 @ 2.40 GHz 2.39 GHz 4v CPU.
Requestor’s subscription rate recommendation
In a FactoryTalk system, data moves from a source like a controller connected to FactoryTalk Linx to a software client when a data item’s value has changed. Once, changes are detected, the data values are transferred between multiple components or services. The services use the subscription rate from the requestor to initiate a processing thread to transfer the data to its next destination in the system. Small processing delays by components, network delivery time, a high number of values changing at once, or a heavily loaded system can cause data to be processed and delivered slower than the requested rate. If the source data value changes faster than twice the subscription rate, a newer data value could likely overwrite a previous data value as it travels between the services.
In some cases, sampling at a rate faster than half of the speed of the value changes can help to ensure that data value changes are detected by the requester. Also balancing the data subscriptions across multiple computers and services can reduce processing and delivery delays.
FactoryTalk Linx Gateway Security Certificate
When an OPC UA client connects to FactoryTalk Linx Gateway, FactoryTalk Linx Gateway provides a self-signed security certificate to the client as identification. Depending on the OPC UA client used in the system, you may need to manually approve the FactoryTalk Linx Gateway security certificate in the client to complete the connection.
Read service
When an OPC UA client subscription is in the process of being updated and a read request for the same item interrupts the delivery, the subscription request could deliver an older value after the results of the read request are delivered. Subsequent subscription responses will deliver updated values.
Security considerations
Service log on option
To solve this problem, in Windows Services Manager, select FactoryTalk Linx Gateway OPC UA Server > Properties > Log on, change the log on option from Local Service to Local System account. Then restart the FactoryTalk Linx Gateway OPC UA Server service.
Unattended or silent install
Use command-line parameters to perform an unattended or silent installation of the software.
Installation Command-line parameters
The following table identifies the installation command-line parameters. Command-line parameters are case-insensitive. However, if a specified value includes a space, be sure to enclose the value in quotation marks (for example, "value with spaces").
|
Parameter
|
Description
|
|
/?
|
Displays the usage options for installation parameters.
|
|
/Q
|
Silent Install, install runs in a quiet mode without any user interface.
This parameter is recommended when deploying the software installation using an IT
tool or script, and don’t expect any error or restart messages. When using this
parameter, check the error codes, and respond as needed. For example, if the
installation returns error code 1641, then the IT tool or script should restart the
computer and relaunch the installation after restart.
This parameter is required if /QS is not specified.
|
|
/QS
|
Unattended Install, install runs in a quiet simple mode and shows progress through
the UI, it does not accept any input but still shows errors or restart messages.
When using this parameter, the installation will stop and display a prompt if there are
errors or restart messages. For example, if an immediate restart is required to
complete the install, a restart message will be displayed to confirm the restart.
Installation resumes automatically from the point of interruption after restart.
This parameter is required if /Q is not specified.
|
|
/IAcceptAllLicenseTerms
|
Acknowledges acceptance of the license terms.
This parameter is required for /Q or /QS parameters.
|
|
/AutoRestart
|
Automatically restarts the computer after the installation is complete. Used when a
restart is required to complete the installation.
This parameter is optional. If this parameter is not used silent install (/Q) will return
either error code 1641 or 3010 if a restart is required, and unattended install (/QS)
will result in a confirmation prompt that must be agreed to before the installation is
completed.
|
|
/Record
|
Records the installation options chosen to a recording file.
This parameter is optional.
|
|
/Playback
|
Plays back a recording file to specify the installation options.
This parameter is optional.
|
|
/SetupLanguage="value"
|
Specifies which language will be displayed during the install process.
The value must be one of the following:
This parameter is optional. If this parameter is not used, the default language is the
current user or operating system user interface language.
|
|
/IgnoreWarning
|
Specifies that the setup ignores warnings and continues.
This parameter is optional. If it is not specified, the setup exits when a warning
occurs.
|
|
/ftsp-s
|
Specifies the FactoryTalk directory scope for restore. Only "Global" and "Local"
scopes are supported.
This parameter is optional.
|
|
/ftsp-bak
|
Specifies the location where the restore file can be found.
This parameter is optional.
|
|
/ftsp-pp
|
Specifies the plain text used to decrypt the backup file.
This parameter is optional.
|
|
/ftsp-value=enable/disable
|
Specifies to enable or disable the option Require computer accounts for all client
machines in Security Policy. The option is used to determine whether or not a client
computer account must exist in the directory to log in.
This parameter is optional.
|
|
/FTSPWebAuth="value"
|
Specifies that the installation includes the FactoryTalk Web Authentication Server.
This parameter is optional.
The value must be one of the following:
If the value is Yes, the FactoryTalk Web Authentication Server will be installed. The
FactoryTalk Reverse Proxy will also be installed as it is required for operation of the
FactoryTalk Web Authentication Server.
If the value is No, the FactoryTalk Web Authentication Server will not be installed.
|
|
/ReverseProxy="value"
|
Specifies that the installation includes the FactoryTalk Reverse Proxy.
This parameter is optional.
The value must be one of the following:
If the value is Yes, the FactoryTalk Reverse Proxy will be installed.
If the value is No, the FactoryTalk Reverse Proxy will not be installed.
|
|
/FTSPWebEventServer="value"
|
Specifies that the installation includes the FactoryTalk Web Event Server.
This parameter is optional.
The value must be one of the following:
If the value is Yes, the FactoryTalk Web Event Server will be installed.
If the value is No, the FactoryTalk Web Event Server will not be installed.
|
|
/DirectoryServer
|
Specifies the directory server name.
This parameter is optional. If it is not specified, the setup turns on HTTPS for
communication, and a TLS certificate must be configured after installation.
|
|
/NoHTTPS
|
Specifies that the setup turns off HTTPS.
This parameter is optional. If it is not specified, the setup turns on HTTPS for
communication, and a TLS certificate must be configured after installation.
|
|
/Repair
|
Runs a repair operation on the installed products.
This parameter is optional.
|
|
/InstallDrive="value"
|
Specifies the install drive.
This parameter is optional. If this parameter is not used, the default install location is
"C:\Program Files (x86)\Rockwell Software".
Some software restricts the installer to only change the drive the software is installed
on. Use /? to determine which parameter is supported.
|
|
/Uninstall
|
Use to uninstall the product. This parameter is optional.
|
Examples
The following examples show how to use the installation commands.
Setup.exe /Q /IAcceptAllLicenseTerms
Setup.exe /QS /IAcceptAllLicenseTerms /AutoRestart /SetupLanguage=CHS
Setup.exe /Q /IAcceptAllLicenseTerms /ftsp-value=enable
Setup.exe /Q /IAcceptAllLicenseTerms /ftsp-bak="C:\aa.bak"
Setup.exe /Q /IAcceptAllLicenseTerms /DirectorySever=severname
Error codes
The following table identifies the error codes that can be returned by an installation.
|
Error Code
|
Value
|
Description
|
|
ERROR_SUCCESS
|
0
|
The installation completed successfully.
|
|
ERROR_INVALID_PARAMETER
|
87
|
One of the parameters was invalid.
|
|
ERROR_INSTALL_USEREXIT
|
1602
|
The installation was canceled by the user.
|
|
ERROR_INSTALL_FAILURE
|
1603
|
A fatal error occurred during installation.
|
|
ERROR_BAD_CONFIGURATION
|
1610
|
The configuration data for this product is corrupt. Contact your
support personnel.
|
|
ERROR_REBOOT_CONTINUE
|
1641
|
A restart is required to continue the installation.
|
|
ERROR_SUCCESS_REBOOT_REQUIRED
|
3010
|
A restart is required to complete the installation. After restarting, the
product is successfully installed.
|
|
ERROR_REBOOT_PENDING
|
3012
|
Restart is pending. Restart the computer to continue the installation.
|
|
ERROR_SUCCESS_NOT_APPLICABLE
|
3013
|
The installation cannot proceed because the products are already
installed.
|
|
ERROR_SUCCESS_WARNING_REBOOT
|
3014
|
The installation succeeded with warnings. Check the installation log
file for details. To complete the installation, restart the computer.
|
VeriSign Universal Root Certification Authority certificate
If the VeriSign Universal Root Certification Authority certificate does not exist on the local computer, the certificate is installed while installing Rockwell Automation software. Use Microsoft Management Console (MMC) to view the certificate in Console Root > Certificates (Local Computer) > Trusted Root Certification Authorities > Certificates.
Mitigation for Microsoft DCOM Hardening patch
In response to Microsoft Distributed Component Object Model (DCOM) Hardening patch (MS KB5004442), the minimum DCOM authentication level used by Rockwell Automation products was raised to Packet Integrity.
|
IMPORTANT
|
Installing this product’s latest version with earlier unpatched versions of
other FactoryTalk products or products using Classic OPC DA
connections may cause a loss of connectivity due to the difference in
DCOM authentication level used. For additional information, see the
Knowledgebase Document ID: IN39461 - Microsoft DCOM Hardening
Information TOC.
|
Microsoft releases the DCOM Hardening patch in response to CVE-2021-26414. This patch elevates the minimum DCOM authentication level that is required to establish a DCOM connection. DCOM is used by many Rockwell Automation products and may be affected by the change that is made by the Microsoft patch. For additional information about the affected Rockwell Automation products, see the Knowledgebase Document ID: PN1581 - Product Notification 2022-01-001 - Rockwell Automation products unable to establish proper DCOM connection after installing Microsoft DCOM Hardening patch (MS KB5004442).
"Meltdown" and "Spectre" Vulnerabilities
On January 3, 2018, a set of new hardware kernel-level vulnerabilities, named "Meltdown" and "Spectre", were announced by researchers. Both Spectre and Meltdown are vulnerabilities that affect modern microprocessors allowing malicious processes to access the contents of restricted memory and therefore affect multiple generations of Central Processing Units (CPUs).
For an up-to-date briefing on how Meltdown and Spectre affect Rockwell Automation products, see Rockwell Automation Knowledgebase Document ID: PN1011 - Rockwell Automation Briefing on "Meltdown" and "Spectre" vulnerabilities.