This release has the following requirements.
FactoryTalk Linx Gateway version 6.50.00 (CPR 9 SR 15) works within the system requirements of all Rockwell Automation® software products.
For the latest compatibility information, refer to the Product Compatibility and Download Center.
Hardware requirements
We recommend 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:
We recommend that you 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
The following operating systems are supported and recommended*:
*The recommended operating systems have priority for Microsoft Patch Qualifications with Rockwell Automation software.
Rockwell Automation's software installation policy is based on the lifecycle information of Microsoft operating systems. If an operating system's lifecycle state is approaching the end, you may encounter a warning message when trying to install Rockwell Automation software on it.
|
Microsoft
lifecycle
policy
|
Rockwell Automation installation warning policy
|
Rockwell Automation installation
prevention policy
|
|
Fixed
|
Present a warning message during installation on
Microsoft operating systems that are six months past
Microsoft's mainstream date.
|
Prevent installation on Microsoft operating
systems that are six months past
Microsoft's extended end date.
|
|
Modern
|
Present a warning message during installation on
Microsoft operating systems that are 18 months
ahead of Microsoft's retirement date.
|
Prevent installation on Microsoft operating
systems that are six months past
Microsoft's retirement date.
|
Rockwell Automation will provide a notice about the lifecycle information of the following operating systems.
|
Operating system
|
Microsoft
lifecycle
policy
|
Start date
|
Mainstream
date
|
Extended
end date
|
Retirement
date
|
Installation
warning
|
Installation
prevented
|
|
Windows Server 2019
Standard and
Datacenter editions
|
Fixed
|
November
13, 2018
|
January 9,
2024
|
January 9,
2029
|
None
|
August 1,
2024
|
August 1,
2029
|
|
Windows Server 2016
Standard and
Datacenter editions
|
Fixed
|
October
15, 2016
|
January 11,
2022
|
January
12, 2027
|
None
|
August 1,
2022
|
August 1,
2027
|
|
Windows 10
Enterprise and
Professional editions
|
Modern
|
July 29,
2015
|
None
|
None
|
October 14,
2025
|
May 1, 2024
|
May 1, 2026
|
For the latest compatibility information, refer to the Microsoft Lifecycle Policy and Product Compatibility and Download Center.
Software compatibility
FactoryTalk Linx Gateway version 6.50.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 learn about designing a secure networking environment, review this publication:
To learn about implementing application-level security using FactoryTalk Security, review this publication:
To learn about designing and implementing an architecture with device-level security using CIP Security, review these publications:
This release includes the following system features.
FactoryTalk Linx Gateway version 6.50.00 has the following new and enhanced features:
New features
Enhanced features
This release corrects the following anomalies.
Corrected in FactoryTalk Linx Gateway version 6.50.00.
Corrected in FactoryTalk Linx Gateway version 6.50.00.
Corrected in FactoryTalk Linx Gateway version 6.50.00.
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.
This release has the following known anomalies.
FTLinxGatewayConfigUIService.exe will stop responding when turning off the computer after an upgrade of FactoryTalk Linx Gateway from version 6.40.00 to 6.50.00. First identified in FactoryTalk Linx Gateway version 6.50.00. [Jira 3835577]
FactoryTalk Linx Gateway will work after restarting the computer.
When adding a parent folder and its child folder to the same tag group in the FactoryTalk Linx Gateway tag list, the OPC UA client cannot browse the child folder tags under the parent folder. First identified in FactoryTalk Linx Gateway version 6.50.00. [Jira 3852386]
To resolve this problem, remove the independent child folder from the namespace and access the child folder through the parent folder.
The FactoryTalk Linx Gateway standalone OPC DA server doesn’t support the flat namespace. First identified in FactoryTalk Linx Gateway version 6.50.00. [Jira 3854490]
To resolve this problem, the client should use the hierarchical namespace.
If FactoryTalk Linx Gateway Configuration UI is open for several days, selecting multiple tags in a namespace will experience a delayed response. First identified in FactoryTalk Linx Gateway version 6.50.00. [Jira 3881123]
To resolve this problem, close FactoryTalk Linx Gateway Configuration UI and reopen it.
When multiple OPC UA clients, MQTT brokers, RTD clients, and DDE clients are connected to FactoryTalk Linx Gateway, the data updates in the MQTT brokers, RTD clients, and DDE clients become slow due to excessive tags, for example, 400,000 tags for the OPC UA clients and 40,000 tags for the MQTT brokers. First identified in FactoryTalk Linx Gateway version 6.50.00. [Jira 3941273]
To resolve this problem, reduce the OPC UA client connections.
FactoryTalk Linx Gateway’s OPC UA service, DDE service, and RTD service configured to use Custom namespace or Tag list and structures/array access and FactoryTalk Linx Gateway’s MQTT dataset will not support item IDs (tag names) with wide characters, such as Chinese and Japanese. First identified in FactoryTalk Linx Gateway version 6.50.00. [Jira 3855499]
Corrected in FactoryTalk Linx Gateway version 6.60.00.
The MQTT interface shows the running state when the enabled MQTT has no client configurations. First identified in FactoryTalk Linx Gateway version 6.50.00. [Jira 3999627]
Corrected in FactoryTalk Linx Gateway version 6.60.00.
An error message "The actual activation 'activation name' does not support the selected scope because it contains servers on multiple computers. Please select a project or area that only contains servers for this computer." is displayed when using the Standard activation and Local FactoryTalk Policy Directory scope, which does not influence saving the configuration and runtime operation. First identified in FactoryTalk Linx Gateway version 6.50.00. [Jira 4799711]
Corrected in FactoryTalk Linx Gateway version 6.60.00.
These anomalies are from previous releases but are still known in this release.
To solve this problem, repair Remote Gateway or FactoryTalk Linx Gateway.
There is no workaround for this anomaly.
To resolve this problem, use the UA or RTD/DDE custom namespace configuration editor to manually change the data type to BOOL.
To determine how much time is required to generate the namespace, utilize an OPC UA Client to attempt a connection periodically. To permit the UA Service to start quicker, use the Advanced Setting “Cache UA Namespace” to retain a copy of the generated namespace.
To avoid this problem, close the FactoryTalk Linx Network Browser when you don’t use it.
To access multiple array elements, use multiple array single item references to access each desired array element, like u8[#], s32[#], f32[#], etc.
When using the standalone data service to configure a shortcut to a Logix controller with firmware version 17 or earlier, no tags can be browsed via the OPC DA client. First identified in FactoryTalk Linx Gateway version 6.40.00. [Jira 3608015]
To avoid this problem, update the Logix controller firmware to version 18 or later.
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.
This release has the following functional changes from the previous release.
FactoryTalk Linx Gateway version 6.50.00 has the 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.50.00.
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, see the Knowledgebase Document ID: QA63609 - Recommended guidelines for hardening software, computer, device, and network systems and infrastructure (CIS Benchmarks).
FactoryTalk Linx Gateway version 6.50.00 has been tested on the following CIS Benchmarks:
Exceptions settings for FactoryTalk Linx Gateway version 6.50.00 are listed.
CIS Microsoft Windows 10 Enterprise (Release 22H2) Benchmark v3.0.0:
CIS Microsoft Windows 11 Enterprise (Release 23H2) Benchmark v3.0.0:
CIS Microsoft Windows Server 2019 Domain Controller Benchmark v3.0.1
CIS Microsoft Windows Server 2022 Domain Server Benchmark v3.0.0
Tested FactoryTalk Linx Gateway update rates configured using a FactoryTalk Application
Rockwell Automation tests with the following update rates for a number of active tags. This data is captured in FactoryTalk Linx Gateway version 6.50.00 with security disabled.
CPU and memory requirements for the FactoryTalk Linx Gateway server increase as tags are set to active (up to the activation tag capacity) or as more clients connect to the server.
Example test environment and results for OPC UA using folders with scalar data
|
Items
|
Details
|
|
OS
|
Windows 11 Professional
|
|
Processor
|
12th Gen Intel(R) Core(TM)
i7-12700k 3.6GHZ
12-core
|
|
RAM
|
32 GB
|
|
Number of
Active Tags
|
Requested
Rate (s)
|
Achieved Update
Rate (s)
|
|
50,000
|
0.5
|
0.5
|
|
100,000
|
0.5
|
1
|
|
150,000
|
0.5
|
1.8
|
|
200,000
|
0.5
|
2
|
|
250,000
|
0.5
|
2.5
|
|
300,000
|
0.5
|
3
|
|
350,000
|
0.5
|
3.5
|
|
400,000
|
0.5
|
4
|
|
450,000
|
0.5
|
4.5
|
|
500,000
|
0.5
|
5
|
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.
Example test for OPC UA using tag list
|
Items
|
Details
|
|
OS
|
Windows 11 Professional
|
|
Processor
|
12th Gen Intel(R) Core(TM)
i7-12700k 3.6GHZ
12-core
|
|
RAM
|
32 GB
|
|
Number of
Active Tags
|
Requested
Rate (s)
|
Achieved Update
Rate (s)
|
|
1,000
|
0.5
|
0.5
|
|
2,000
|
0.5
|
0.5
|
|
5,000
|
0.5
|
0.5
|
|
10,000
|
0.5
|
0.5
|
|
50,000
|
0.5
|
0.6
|
|
100,000
|
0.5
|
1
|
|
150,000
|
0.5
|
1.5
|
|
200,000
|
0.5
|
2
|
|
250,000
|
0.5
|
2.5
|
|
300,000
|
0.5
|
3
|
|
350,000
|
0.5
|
3.5
|
|
400,000
|
0.5
|
4.1
|
|
450,000
|
0.5
|
4.5
|
|
500,000
|
0.5
|
5.2
|
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.
Example test for OPC UA using custom namespace
|
Items
|
Details
|
|
OS
|
Windows 11 Professional
|
|
Processor
|
12th Gen Intel(R) Core(TM)
i7-12700k 3.6GHZ
12-core
|
|
RAM
|
32 GB
|
|
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
|
1
|
|
150,000
|
0.5
|
1.9
|
|
200,000
|
0.5
|
2
|
|
250,000
|
0.5
|
2
|
|
300,000
|
0.5
|
3
|
|
350,000
|
0.5
|
3
|
|
400,000
|
0.5
|
3
|
|
450,000
|
0.5
|
4
|
|
500,000
|
0.5
|
4
|
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.
Example test for MQTT
|
Items
|
Details
|
|
OS
|
Windows 10 Enterprise 64-bit
|
|
Processor
|
Intel® Xeon® CPU E5-2699A
v4@2.39GHz
4-core
|
|
RAM
|
8 GB
|
|
Number of
Active Tags
|
Number of MQTT
clients
|
Data Sampling
Mode
|
Data Sampling
Period (s)
|
|
40,000
|
1
|
Periodic
|
1
|
|
40,000
|
1
|
Change in value
|
1
|
|
40,000
|
1
|
Periodic
|
2
|
|
40,000
|
1
|
Change in value
|
1
|
|
40,000
|
20
|
Periodic
|
2
|
|
40,000
|
20
|
Change in value
|
1
|
Note:
This data was based on tests for the MQTT. 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.
Example test for RTD using folders with scalar data
|
Items
|
Details
|
|
OS
|
Windows 10 Professional 64-bit
|
|
Processor
|
Intel(R) Xeon(R) CPU E5-2697A v4 @
2.60GHz, ~2.59GHz
8-core
|
|
RAM
|
8 GB
|
|
Number of
Active Tags
|
Requested
Rate (s)
|
Achieved Update
Rate (s)
|
|
5,000
|
0.5
|
1.9
|
|
10,000
|
0.5
|
1.9
|
|
15,000
|
0.5
|
1.9
|
|
20,000
|
0.5
|
1.9
|
|
25,000
|
0.5
|
2
|
|
30,000
|
0.5
|
2
|
|
35,000
|
0.5
|
2
|
|
40,000
|
0.5
|
2
|
Note:
This data was based on tests with the Folder with scalar data enabled for the RTD. 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.
Example test for RTD using custom namespace
|
Items
|
Details
|
|
OS
|
Windows 10 Professional 64-bit
|
|
Processor
|
Intel(R) Xeon(R) CPU E5-2697A v4 @
2.60GHz, ~2.59GHz
8-core
|
|
RAM
|
8 GB
|
|
Number of
Active Tags
|
Requested
Rate (s)
|
Achieved Update
Rate (s)
|
|
5,000
|
0.5
|
1.9
|
|
10,000
|
0.5
|
1.9
|
|
15,000
|
0.5
|
1.9
|
|
20,000
|
0.5
|
2
|
|
20,000
|
0.5
|
2
|
|
30,000
|
0.5
|
2
|
|
35,000
|
0.5
|
2
|
|
40,000
|
0.5
|
2.1
|
Note:
This data was based on tests with the Custom namespace enabled for the RTD. 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.
Example test for DDE using folders with scalar data
|
Items
|
Details
|
|
OS
|
Windows 10 Professional 64-bit
|
|
Processor
|
Intel(R) Xeon(R) CPU E5-2697A v4 @
2.60GHz, ~2.59GHz
8-core
|
|
RAM
|
8 GB
|
|
Number of
Active Tags
|
Requested
Rate (s)
|
Achieved Update
Rate (s)
|
|
500
|
0.5
|
0.8
|
|
1,000
|
0.5
|
0.8
|
|
1,500
|
0.5
|
0.8
|
|
2,000
|
0.5
|
0.9
|
|
2,500
|
0.5
|
1.0
|
|
3,000
|
0.5
|
1.2
|
|
3,500
|
0.5
|
1.4
|
|
4,000
|
0.5
|
1.8
|
Note:
This data was based on tests with the Folder with scalar data enabled for the DDE. 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.
Example test for DDE using custom namespace
|
Items
|
Details
|
|
OS
|
Windows 10 Professional 64-bit
|
|
Processor
|
Intel(R) Xeon(R) CPU E5-2697A v4 @
2.60GHz, ~2.59GHz
8-core
|
|
RAM
|
8 GB
|
|
Number of
Active Tags
|
Requested
Rate (s)
|
Achieved Update
Rate (s)
|
|
500
|
0.5
|
1.8
|
|
1,000
|
0.5
|
1.9
|
|
1,500
|
0.5
|
1.9
|
|
2,000
|
0.5
|
1.9
|
|
2,500
|
0.5
|
1.9
|
|
3,000
|
0.5
|
1.9
|
|
3,500
|
0.5
|
1.9
|
|
4,000
|
0.5
|
2.1
|
Note:
This data was based on tests with the Custom namespace enabled for the DDE. 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.
Tested FactoryTalk Linx Gateway update rates configured using a standalone data source
Rockwell Automation tests with the following update rates for a number of active tags using a standalone data source.
Example test for OPC DA service
|
Items
|
Details
|
|
OS
|
Windows 10 Professional 64-bit
|
|
Processor
|
Intel(R) Xeon(R) CPU E5-2697A v4 @
2.60GHz, ~2.59GHz
8-core
|
|
RAM
|
8 GB
|
|
Number of
Active Tags
|
Requested
Rate (s)
|
Achieved Update
Rate (s)
|
|
1,000
|
1
|
1
|
|
3,000
|
1
|
1
|
|
5,000
|
1
|
1
|
|
10,000
|
1
|
1
|
|
20,000
|
1
|
1
|
|
50,000
|
1
|
1
|
|
100,000
|
1
|
1
|
|
120,000
|
1
|
1
|
|
150,000
|
1
|
1
|
|
200,000
|
1
|
2
|
Note:
This data was based on tests with the OPC DA enabled for the standalone data source. 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.
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.
Installation limitation
When FactoryTalk Linx Gateway is installed on a computer that also has the "Remote Gateway (DA Client remote configuration)" installed, these two options must have the same version.
If using the unattended install to upgrade from a prior version of FactoryTalk Linx Gateway, ensure that Remote FactoryTalk Linx Gateway is uninstalled prior to performing the unattended install, otherwise it will fail.
To work around this, do one of the following:
Important: In this example, {32D45A1C-DCEF-45DB-8EEC-18D5A1C51B21} is the product code of version
6.40.00. For more information, see Unattended or silent install. To view the installation progress, use qb
to replace q.
Service log on option
In FactoryTalk Linx Gateway, if the FactoryTalk Directory Scope path is set to an application containing an OPC DA server, the OPC UA clients connecting to FactoryTalk Linx Gateway can browse the tags defined in the OPC DA server but cannot communicate to tags (read or write).
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.
Service log on option change
Starting from FactoryTalk Linx Gateway version 6.30.00, OPC UA service account is downgraded to Local Service.
To solve this problem:
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.
OPC UA tag access
The Logix controller’s OPC UA tag access setting is used for its embedded OPC UA server and does not apply to tags delivered by FactoryTalk Linx Gateway. Use the FactoryTalk Linx Gateway OPC UA Tag list or Custom data-model options to limit which tags OPC UA clients can access.
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.
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 Namespace of OPC UA Server, RTD Server, or DDE Server, 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 Namespace of OPC UA Server, RTD Server, or DDE Server 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.
The FactoryTalk Linx Gateway Standalone data service is not able to communicate through the Remote Proxy service.
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 OPC UA, MQTT, OPC DA, RTD, or DDE:
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.
|
|
/IISCommPort
|
Specifies the IIS server communication port for HTTPS. The default port for HTTPS is
443.
If the HTTPS port was previously configured using FactoryTalk Services Platform, like
port 4356, then the existing HTTPS port setting is retained.
This parameter is optional.
|
|
/ftsp-s
|
Specifies the FactoryTalk Directory scope for restore. Only "Global" and "Local" scopes
are supported.
The SECURE.BAK backup file provided by Rockwell Automation is only supported for
the “Global” scope.
This parameter is optional.
|
|
/ftsp-bak
|
Restores the backup file and specifies where the restore file can be found.
Rockwell Automation provides a SECURE.BAK backup file containing pre-configured
access control lists which limit user access. The pre-configured access control lists
follow Rockwell Automation recommended best practice.
The SECURE.BAK backup file is located in the FactoryTalk Services Platform
installation package, Redist\FTSPSecureBak.
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 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.
Setup.exe /Q /Uninstall /Product="Gateway"
|
Examples
The following examples show how to use the installation commands.
To install the software with no user interface using the default settings during the installation process. (Silent install)
Setup.exe /Q /IAcceptAllLicenseTerms
To install the software with Chinese displayed during the install process and restart the computer if necessary. (Unattended install)
Setup.exe /QS /IAcceptAllLicenseTerms /AutoRestart /SetupLanguage=CHS To install the software with FactoryTalk security policy value specified.
Setup.exe /Q /IAcceptAllLicenseTerms /ftsp-value=enable To perform a restore during the install process.
Setup.exe /Q /IAcceptAllLicenseTerms /ftsp-bak="C:\aa.bak" To specify the FactoryTalk Directory machine.
Setup.exe /Q /IAcceptAllLicenseTerms /DirectorySever=severname Important:
Uninstall Remote FactoryTalk Linx Gateway using the following command line:
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.
|
Security considerations
For information on the security considerations when using Rockwell Automation products, including
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).
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 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.
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.
"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.