Release Notes
( 9358-Bx ) Provides efficient, predictable batch processing, consistency between batches, and generation of event info. FTB
Version 17.00.00 (released 1/2025)
Catalog Number FactoryTalk Batch
These release notes describe version information for FactoryTalk Batch, version 17.00.00 (released 1/2025).
Requirements
This release has the following requirements.
System requirements for FactoryTalk Batch v17.00.00
Review these minimum and recommended system requirements for installing, configuring, and running FactoryTalk Batch v17.00.00.
Unless noted, these requirements assume that no other applications are installed on the computer. Preferred operating systems and
software applications are prioritized for support, testing, and post- release patch qualifications.
Hardware requirements
- Server requirements
- 8 -GB of RAM memory
- 100-GB free hard disk space
- Intel® Core™ i5 standard power processor or greater
- Client requirements
- 4-GB of RAM memory
- 30 GB free hard disk space
- Intel Core i5 standard power processor or greater
Supported operating systems
- Windows Server®
- Windows Server 2022 Standard Edition (preferred)
- Windows Server 2019 Standard Edition (preferred)
- Windows Server 2022 Datacenter Edition
- Windows Server 2019 DataCenter Edition
- Windows®
- Windows 10 Enterprise 2019 LTSC 64-bit (v1809)
- Windows 10 Enterprise 2021 LTSC 64-bit (21H2)
- Windows 10 Professional 64-bit (preferred)
- Windows 11 Enterprise (64-bit)
- Windows 11 Professional (64-bit) (preferred)
Tip: The installer software inhibits installation of FactoryTalk software on all Windows 7 and 32-bit operating systems,
including Windows 10 (32 bit).
Supported database applications
(for storing recipes, materials, reports, and journal archives)
- SQL Server®
- SQL Server 2022 (English version only)
- SQL Server 2019 (English version only)
Web browsers
(for FactoryTalk Batch View only)
- Google® Chrome™ browser (preferred)
- Microsoft Edge™ based on Chromium version: 80.0.361.50 or higher
- Apple® Safari®
- Firefox®
Logix firmware requirements
(for FactoryTalk Batch only)
- Firmware revision 18 or later on ControlLogix 5570 and CompactLogix 5370 family of controllers – for integration of
PhaseManager with FactoryTalk Batch
- Firmware revision 32 or later on ControlLogix 5580 and CompactLogix 5380 family of controllers – for integration of
PhaseManager with FactoryTalk Batch
- Firmware revision 29 or later on ControlLogix 5570 and CompactLogix 5370 family of controllers - for integration of
SequenceManager with FactoryTalk Batch
- Firmware revision 35 or later on ControlLogix 5580P and CompactLogix 5380P family of controllers - for integration of
SequenceManager with FactoryTalk Batch
Logix Designer Application requirements
(for FactoryTalk Batch only)
- Studio 5000 Logix Designer v18.00 or later - for synchronization of PhaseManager with FactoryTalk Batch Equipment Editor
FactoryTalk View SE requirements
(for integration of FactoryTalk Batch View HMI Controls and legacy FactoryTalk Batch ActiveX controls only)
- FactoryTalk View SE v15.00.00
FactoryTalk Services requirements
- FactoryTalk Services Platform v6.50.00 (CPR9 SR 15) or later
- FactoryTalk Linx v6.50.00 (CPR9 SR 15) or later
- FactoryTalk Activation Manager v5.01.01
Rockwell Automation Test Environment
Warranty
The warranty does not cover systems that do not meet the minimum requirements for the version of software.
IMPORTANT: FactoryTalk Batch v17.00.00 supports only the
U.S. English versions of operating systems. For more
information about supported operating systems and other Rockwell Software product version support, refer to the
Product Compatibility and Download Center (PCDC).
- The FactoryTalk Batch Server computer cannot be configured as a:
- Domain controller
- DHCP server
- WINS server
- RAS server
- DNS server
- Master Browser
- The FactoryTalk Batch Server computer does not support replication.
- Install FactoryTalk Batch software on an NTFS formatted hard disk drive, as Windows security features are available
only for drives that are formatted to use NTFS.
- Warranty does not cover systems with modified DCOM configuration settings. Configuring settings using DCOMCNFG
may stop the FactoryTalk Batch Server and prevent the FactoryTalk Batch Service Manager from functioning correctly.
IMPORTANT: FactoryTalk Batch v17.00.00 components do not support touch screen technology.
Features
This release includes the following system features.
System features for FactoryTalk Batch v17.00.00
FactoryTalk Batch v17.00.00 has these new, enhanced, and deprecated features:
New features
- Support for FactoryTalk Link OPC UA Connector
FactoryTalk Batch v17.00.00 introduces enhanced connectivity with OPC UA data servers via the FactoryTalk Linx OPC UA
Connector. The updated workflow for browsing data server paths now includes FactoryTalk Linx OPC UA Connectors
defined within the FactoryTalk Directory. Additionally, the FactoryTalk Batch Server can read and write tags on an OPC UA
data server, providing seamless data integration and improved operational eiciency.
- Scripted Area Model import
FactoryTalk Batch v17.00.00 includes a new feature that allows users to script the import of an Area Model XML (AXML) file
into an Equipment Model configuration (CFG) file. This enhancement empowers engineers to develop area models using
their preferred tools and seamlessly integrate those area models within FactoryTalk Batch. The new application supports
importing either a complete area model into a new Equipment Model or a partial area model into an existing Equipment
Model configuration (CFG) file, offering greater flexibility and eiciency in managing equipment models. Additionally, this
feature can be utilized from a command line or within a script, providing even more versatility for automation and integration.
- Scripted Recipe import
FactoryTalk Batch v17.00.00 adds a new feature that allows users to import recipes using scripting. The new application
enables engineers to automate the import process, improving workflows and reducing manual effort. Whether working from
a command line or within a script, users can now eiciently manage and update recipes.
Enhanced features
- Material Server technology update
In FactoryTalk Batch v17.00.00, the Material Server has been migrated to a modern technology stack, helping to ensure
performance, security, and future enhancements for our FactoryTalk Batch software suite.
- Archive database improvements
FactoryTalk Batch v17.00.00 includes significant improvements in database performance and report generation speed. It also
introduces our new database migration utility, making it easier than ever to transition older database schemas to our
improved, optimized schema.
Deprecated features
Legacy Event Journal Format
The tab delimited event journal format (EVT) will not be updated or enhanced. It has been replaced by the enhanced JSON Lines
based format (EVTJ) and the option to use legacy EVT format will be removed in a future release. We recommend systems using
FactoryTalk Batch v16.00.00 or later move to the new EVTJ format.
Legacy client applications
The FactoryTalk eProcedure Client, legacy FactoryTalk Batch View Client, and the FactoryTalk Batch ActiveX Controls are not
included nor supported by FactoryTalk Batch v15.00.00 and later. If your production system has dependencies on these products,
transition to the modern FactoryTalk Batch View and FactoryTalk Batch View HMI Controls before upgrading to FactoryTalk Batch
v16.00.00.
NOTE: The FactoryTalk Batch Database Management Tool is being deprecated. The tool will only support database
schemas for older versions.
Corrected Anomalies in This Release
This release corrects the following anomalies.
Pop-up notifications are persistent (519919, 519912)
For example, a pop-up notification opens due to an invalid login. The notification is not cleared
even after a successful login.
To work around this issue, the user must close the notification.
Anomaly first identified in FactoryTalk Batch View version 2.00.00.
Port conflict when using HTTPS (1536376)
FactoryTalk View SE, FactoryTalk Services Platform, and FactoryTalk Batch View support secure communication using HTTPS
and use the default HTTPS port 443. There are two situations in which this port conflict could impact FactoryTalk Batch View.
FactoryTalk Batch View is installed before FactoryTalk View SE
The FactoryTalk View SE installation process does not check for port conflicts when installing with the option Secure
communication with TLS and does not provide the option to select a different port. If FactoryTalk Batch View is installed
first and assigns port 443 to its secure communication, and then FactoryTalk View SE is installed and the option Secure
communication with TLS is selected, the installation will fail with communications errors due to the port being
unavailable.
The FactoryTalk Batch View installation process does detect the port conflict and provides the option to select a
different secure communications port.
To work around this issue, install FactoryTalk Batch View after FactoryTalk
View SE.
Anomaly first identified in FactoryTalk Batch View version 2.01.00.
Installing new FactoryTalk-enabled software that uses HTTPS communication after installing FactoryTalk Batch View
Because the other FactoryTalk software does not check communication during install, a port conflict (port 443) will be created.
As a result, FactoryTalk Batch View client and HMI user controls cannot communicate with the FactoryTalk Batch View
server.
Anomaly first identified in FactoryTalk Services Platform
version 6.30.00.
Use one of these workarounds to resolve this issue:
Anomaly corrected in FactoryTalk Batch View version 3.00.00.
Creating a material-based batch fails when no binding units are satisfied (3153921)
Creating a batch from a material-based recipe that uses “By Configuration” binding and Material Class,
may fail to be created in the following scenario: The material that is selected during batch creation for
the Material Class was created in the material database after the batch server was started. In this
case, the batch server will not have the new material in the Materials enumeration.
To work around the issue, perform an online area model deploy using the same area model that the
server is currently using. This will cause the Batch Server to read in the new material from the Material
Database.
First identified in v16.00
FactoryTalk Event Archiver
Installing FactoryTalk Batch v14.00 updates FactoryTalk Services Platform to v6.20. There is a known
anomaly in FactoryTalk Services Platform 6.11 and 6.20 that impacts FactoryTalk Event Archiver
components. When FactoryTalk Diagnostics v6.11 or 6.20 and Microsoft SQL Server Reporting
Services 2017 or 2019 are installed on the same computer, Microsoft SQL Server Reporting Services
fails to work. This anomaly was first identified in FactoryTalk Services Platform v6.11.00. (#00369202)
To avoid this problem, change the default port used by Microsoft SQL Server Reporting Services from
8082 to another port.
For steps to address the issue after installation is complete, see Knowledgebase Document ID:
BF25929 - SQL Server Reporting Services stops working after installing FactoryTalk Diagnostics.
Existing recipe file can be overwritten if a new file with the same name is saved (3429831)
When using the Recipe Editor to save a new recipe in XML format, if a file with the same name as the recipe file to be created exists
in a directory on the current PATH environment variable, the “save” will overwrite the existing file in a directory on the PATH and the
file will not be created in the XML recipe directory configured in the batchsvr.ini.
Creating a material-based batch fails when no binding units are satisfied (3153921)
Creating a batch from a material-based recipe that uses “By Configuration” binding and Material Class, may fail to be created in the
following scenario: The material that is selected during batch creation for the Material Class was created in the material database
after the batch server was started. In this case, the batch server will not have the new material in the Materials enumeration.
To work around the issue, perform an online area model deploy using the same area model that the server is currently using. This
will cause the Batch Server to read in the new material from the Material Database.
First identified in v16.00.00
Incorrect material name is recorded if material is selected after the batch server is started (3273639)
When using a material class based recipe, if during batch creation a material is selected for the class that was created after the
batch server was started, the value of the MATERIAL parameter on the step will be “Null Material”, and not the name of the
selected material. This incorrect material name will be recorded in event journal records and can cause incorrect evaluation of
transition/parameter/report expressions that reference the MATERIAL step parameter.
First identified in v15.00.00
Known Anomalies in This Release
This release has the following known anomalies.
Loss of communication when multiple FactoryTalk Batch Servers running against one Material Server
(4083537)
Sharing a single Material Server across multiple FactoryTalk Batch Servers may lead to increased
timeouts when interfacing with the Material Server, potentially causing some batches to be held. To avoid
these timeouts, the recommended workaround was to only use one FactoryTalk Batch Server per Material
Server.
Stabilization efforts to the Material Server have resolved
this issue.
Anomaly first identified in FactoryTalk Batch
version 17.00.00.
Anomaly corrected in FactoryTalk Batch version 18.00.00.
Phases running "without the material server" before a Warm Restart should continue to run without
the material server, even if communication is re-established (3358860)
After a Warm Restart of the FactoryTalk Batch Server, a material enabled phase step that was executing
“without the material server”, may incorrectly resume material server communication for the rest of its
execution. The impact of this is there is no indication in the event journal that a depletion of material
occurred. There is no data to indicate that a manual update of the material database is required.
This anomaly was caused by software logic. Revisions to Warm Restart behavior in version 18.00.00 have
resolved this issue.
Anomaly first identified in FactoryTalk Batch version 17.00.00.
Anomaly corrected in FactoryTalk Batch
version 18.00.00.
FactoryTalk Batch Equipment Editor and Recipe Editor cannot make new folder under Batch
shared folder unless the upper level folder has permission (3996190)
When using a dialog with file or directory browsing capability within a FactoryTalk Batch Equipment Editor
or FactoryTalk Batch Recipe Editor, an attempt to create a sub-directory beneath the BATCHCTL share
fails with a permissions error. An attempt to create the same sub-directory using a physical path that does
not reference the BATCHCTL share works.
The issue was caused by the fact that permissions configured on a Windows share, such as BATCHCTL, can
differ from the configured permissions on the directory to which the share maps.
Starting in version 18.00.00, new functionality prevents this issue from occurring. Server options previously in
FactoryTalk Batch Equipment Editor are now managed in FactoryTalk® Directory and configured through the
FactoryTalk® Administration Console. A new network share, FTBATCH_PROJECTS, has replaced the BATCHCTL
share.
Anomaly first identified in FactoryTalk Batch
version 17.00.00.
Anomaly corrected in
FactoryTalk Batch version 18.00.00.
After a FactoryTalk Services Platform-only installation, FactoryTalk Network Directory is missing
Feature Security SAI for area models and recipes (3795405)
When the host computer for the FactoryTalk Network Directory has never had the FactoryTalk Batch Server
or Editors installed, the FactoryTalk Directory may lack support for FactoryTalk Batch configuration data such
as Feature Security SAI binding for area models and recipes.
The cause is these data structures are currently not included in the default FactoryTalk Services Platform
installation and are only created on install of the FactoryTalk Batch Server or Editors.
To work around this issue, install the FactoryTalk Batch Server or Editors on the FactoryTalk Network
Directory host computer. After install, the products may be uninstalled, if desired.
Anomaly first identified in FactoryTalk Batch version 17.00.00.
Material database user must reconfigure the security script to reuse the Custom Material Database
after update (3999682)
The Material Editor is unable to connect to the customized Material Database after upgrade of the Material
Manager Server from 16.00.00 to 17.00.00.
To work around this issue:
From the SQL Management Studio, delete and re-add the MTUsers group from the material database, as
detailed below:
- Open the SQL Management Studio.
- Select the database->Security->Users.
- Delete MTUsers.
- Select the material database and click Open File on the toolbar.
- Browse to the \\Batchctl\Scripts folder and open MaterialTrack_db_Security.sql.
- Execute the MaterialTrack_db_Security.sql script on the material database.
- Open the Material Editor.
Anomaly first identified in FactoryTalk Batch version 17.00.00.
Anomaly corrected in FactoryTalk Batch version 18.00.00.
Access sample material database failed after command line upgrade material manager (3999682)
The Material Editor is unable to connect to the Material Database after a command line upgrade of the
Material Manager Server from 16.00.00 to 17.00.00.
To work around this issue:
From the SQL Management Studio, delete and re-add the MTUsers group from the material database, as
detailed below:
- Open the SQL Management Studio.
- Select Security->Logins.
- Delete and recreate the group MTUsers.
- Select the database->Security->Users.
- Delete MTUsers.
- Select the material database and click Open File on the toolbar.
- Browse to the \\Batchctl\Scripts folder and open MaterialTrack_db_Security.sql.
- Execute the MaterialTrack_db_Security.sql script on the material database.
- Open the Material Editor.
Anomaly first identified in FactoryTalk Batch version 17.00.00.
Anomaly corrected in FactoryTalk Batch version 18.00.00.
Archiver Setup sometimes fails to launch and the Event journal records an abnormal termination
(3995412)
When running the FactoryTalk Batch Event Archiver in setup mode, which can be done using the “Archiver
Setup” startup menu item, the application sometimes fails to launch and an abnormal termination is recorded
in the Windows Application Event journal.
This occurred when the user launched the FactoryTalk Batch Event Archiver in setup mode, but had
insufficient privileges for access to the BATCHCTL share.
A new network share, FTBATCH_PROJECTS, has replaced the BATCHCTL share to allow off-node access
to project files.
Anomaly first identified in FactoryTalk Batch version 17.00.00.
Anomaly corrected in FactoryTalk Batch version 18.00.00.
Known Anomalies from Previous Releases
These anomalies are from previous releases but are still known in this release.
FactoryTalk Event Archiver
Installing FactoryTalk Batch version 14.00 and later updates FactoryTalk Services
Platform to version 6.20 [00369202]
There is a known anomaly in FactoryTalk Services Platform 6.11 and 6.20 that impacts
FactoryTalk Event Archiver components. When FactoryTalk Diagnostics version 6.11 or
6.20 and Microsoft SQL Server Reporting Services 2017 or 2019 are installed on the
same computer, Microsoft SQL Server Reporting Services fails to work. This anomaly
was first identified in FactoryTalk Services Platform version 6.11.00.
To avoid this problem, change the default port used by Microsoft SQL Server Reporting
Services from 8082 to another port.
For steps to address the issue after installation is complete, see Knowledgebase
Document ID: BF25929 - SQL Server Reporting Services stops working after installing
FactoryTalk Diagnostics.
FactoryTalk Batch Material Manager
Material Editor cannot access the material database after upgrading FactoryTalk
Batch [929120]
The MTUser account is not in the correct database. Anomaly first identified in
FactoryTalk Batch 14.00.
To work around this issue use these steps:
- Open the SQL Server Management Console.
- Navigate to the database Logins and delete the MachineName\MTUser login.
- Navigate to the material database and open the list of users: delete the user
account MTUser.
- Run the script MaterialTrack_DBSecurity.sql on the material database. This will
recreate the MTUser user account under the database.
The script is located in the C:\Program Files(x86)\Rockwell Software\Batch\Scripts folder.
Access to the material database should now be restored.
FactoryTalk eProcedure
Cannot create HMI Server on a computer with FactoryTalk eProcedure and
FactoryTalk View SE [00369237]
After adding eProcedure to a FactoryTalk Batch and FactoryTalk View SE install, an HMI
Server cannot be created.
To work around this issue, restart the computer after installing eProcedure, then create
the HMI Server.
FactoryTalk Batch View 2.00
Pop-up notifications are persistent [519919, 519912]
For example: When an invalid login is used, a pop-up notification is displayed, indicating
that the login is invalid. The notification is not cleared even after a successful login is
completed.
Anomaly first identified in FactoryTalk Batch View 2.00.
To work around this issue, the user must close the notification.
Unintended actions from Arbitration Summary page [98187]
On the Arbitration Summary page, when the More menu
is open and a user selects
Enter, the first item in the More menu is executed, resulting in possible unintended
actions.
Anomaly first identified in FactoryTalk Batch View 2.00.
To avoid this issue, in FactoryTalk Security, enable confirmation messages, which
prompt to confirm before actions are performed in FactoryTalk Batch View.
Spurious "No master recipes are released to production" message [263925]
When adding a batch to the batch list, the client may display a "No master recipes are
released to production" message while the system is gathering the control recipe data.
Anomaly first identified in FactoryTalk Batch View 2.00.
To work around this issue, wait for the recipes to load. The message disappears after the
recipes are loaded.
Spurious client reports of control recipe removal [471548]
During the runtime area model update, the control recipe may be inaccessible to the
client, causing the client to report that the control recipe has been removed.
Anomaly first identified in FactoryTalk Batch View 2.00.
The control recipe is not actually removed, so you can ignore this message
Filters not functioning on Arbitration Summary page [760902]
On the Arbitration Summary page, when performing a warm restart or applying a
run-time area model update, applied filters may not function as expected.
Anomaly first identified in FactoryTalk Batch View 2.00.
To work around this issue, reapply filters.
Filter values are not cleared automatically [98193]
When a user sets filter values on a phase while on the Equipment page and then restarts
the FactoryTalk Batch View Server, the filter values are not cleared automatically.
Anomaly first identified in FactoryTalk Batch View 2.00.
To work around this issue, after restarting the FactoryTalk Batch View Server, manually
clear the filter values.
FactoryTalk Batch View HMI Controls 1.00
FactoryTalk View SE Client process lock [360350]
When a Display Client is closed while running a FactoryTalk View SE display that
contains the FactoryTalk Batch HMI Controls, the Display Client process keeps running
as a background process. This may prevent the ability to launch subsequent instances of
the Display Client.
Anomaly first identified in FactoryTalk Batch View HMI Controls 1.00
To work around this issue, reboot the machine on which the FactoryTalk View SE
Display Client is executing.
FactoryTalk View Batch server authorization changes only reflected in FactoryTalk
View SE user interface only after login [362225]
If a change is made to the FactoryTalk Batch View authorization policies when a
FactoryTalk View SE display containing an HMI Control is in runtime, the change is not
reflected in the user interface.
The user is required to log out and then login with valid credentials for the new
authorization policy changes to be reflected in the user interface.
Removed BaseFilter batch remains on batch list [CLM 4578]
If a BaseFilter batch state is applied (such as State:Running) and the state changes for a
currently visible batch on the Batch List, the batch is visibly removed from the list and the
message: Control Recipe <name> has been removed appears.
Even though the applied BaseFilter removes visibility to the batch, the batch is actually
still on the batch list and can be viewed from other clients or HMI Controls that do not
filter based on the batch state.
Upgrade to FactoryTalk Batch v16.00 from v15.00 without uninstalling v15.00 caused failed
installation (2355688)
When upgrading to FactoryTalk Batch version 16.00 from version 15.00, the upgrade reports a failure when
all components are not upgraded at the same time or the service user name is changed.
This issue is resolved by re-running the installer, which ensures that all of the installed components for the
existing installation are selected and that the user name is the same as the one used for the existing
installation.
Anomaly first identified in FactoryTalk Batch
version 16.00.00.
Anomaly corrected in
FactoryTalk Batch version 18.00.00.
Problem installing FactoryTalk View Studio Enterprise with FactoryTalk Batch v16.00 already installed
(2313853)
Installing FactoryTalk Batch version 16.00 with FactoryTalk Batch View HMI Controls, restarting the
computer after the installation is complete, and customizing the installation of FactoryTalk View Studio
Enterprise version 13.00 by clearing the HTTPs option, generates the error Install could not locate the
FactoryTalk Directory to change the Network Distributed sample application HMI server computer names. Start FactoryTalk View Studio, open the Network Distributed sample applications and change all the HMI
server computer names to the correct computer names. To work around this issue, selecting OK on the
error dialog box allowed the installation to continue and all the components to install successfully.
This issue is resolved because FactoryTalk View no longer distributes the FactoryTalk
Batch View HMI Controls.
Anomaly first identified in FactoryTalk Batch version 16.00.00.
Anomaly corrected in FactoryTalk Batch version 18.00.00.
Material parameters cannot be deferred (3135145)
In FactoryTalk Batch version 16.00 and later only, the Material_Class
cannot be deferred.
Anomaly first identified in FactoryTalk Batch version
16.00.00.
Cross Invocation for User Controls (3106639)
Cross Invocation is not supported by the current view or
User Controls.
Anomaly first identified in FactoryTalk
Batch version 16.00.00.
FactoryTalk View Tag browser is inoperative (3146132)
When FactoryTalk Batch version 16.00 is installed after FactoryTalk View version 14.00, the tag browser in
FactoryTalk View is inoperative.
If you are installing multiple Rockwell Automation products in succession, such as both FactoryTalk View and
FactoryTalk Batch, Rockwell Automation recommends that you restart your computer after completing the
final installation to avoid this issue.
Anomaly first identified in FactoryTalk Batch
version 16.00.00.
Anomaly corrected in
FactoryTalk Batch version 18.00.00.
FactoryTalk eProcedureVideos are not displayed correctly in manual instruction content served from Batch View Server
(1503087)
In FactoryTalk Batch version 15.00, a new folder named customercontent was added to the FactoryTalk
Batch View Server. During installation, you can choose to have your custom images, videos, and scripts
migrated to this folder to support existing instructions. Absolute paths in the scripts files and manual
instructions to the customer content are updated correctly to point to the new content location. However, if
you are using relative paths, the content paths in the scripts files and manual instructions are not correctly
updated by the installation. Video and script files must include eProcedure/ at the beginning of the relative
path.
The src attributes for the instructions need to be updated as follows:
- The relative path for an image would be: <img src=”image01.jpg”>
- The relative path for a video would be: <video><source src=”eprocedure/video01.webm” /></video>
- The relative path for a script would be: <script src=”eprocedure/script01.js”></script>
After updating the attributes, the videos should display as
expected.
Anomaly first identified in FactoryTalk Batch
View version 2.01.00.
Functional Changes
This release has the following functional changes from the previous release.
Functional changes for FactoryTalk Batch v17.00.00
FactoryTalk Batch v17.00.00 has the following functional changes.
- Data Server type change
Data Servers with the type FTLinx are now identified as Live Data. This change is displayed in the Equipment Editor Edit
Data Server dialog. The change has no impact on functionality.
- Material Manager
The Material Manager Server technology has been updated to .Net in v17.00.00.
- The custom insertion point sample project, RAMSCustom.dll, is now a C# .Net component. Existing custom
RAMSCustom.dll may need to be migrated to the new technology. See the Material Manager Getting Results
guide.
- The change to .Net has forced changes in how the Material Object Model exposes enumeration data types. The
enumeration name is included in each enumeration item. This is a namespace issue that Microsoft fixed in .NET
Example in Batch v16.00.00 (VB6)
typedef [uuid (2BF6DB2B-F3FB-4EC5-95A8-E0ABC530ED2F), version (1.0) ]
enum {
GetAllMaterials = 0,
GroupName = 1,
ClassificationName = 2,
MaterialName = 3
} MaterialFilterEnum;
Example in Batch v17.00.00 (.NET)
typedef [uuid (2BF6DB2B-F3FB-4EC5-95A8-E0ABC530ED2F), version (1.0) ,
custom (0F21F359-AB84-41EB-9A78-36D110E6D2F9,
"RA.Batch.MaterialServer.MaterialFilterEnum")
]
enum {
MaterialFilterEnum_GetAllMaterials = 0,
MaterialFilterEnum_GroupName = 1,
MaterialFilterEnum_ClassificationName = 2,
MaterialFilterEnum_MaterialName = 3
} MaterialFilterEnum;
-
BatchHistoryEx database schema changeThe schema of the Batch History database, BatchHistoryEx, has been changed to improve performance. Existing
BatchHistoryEx databases can be migrated to the new schema by using the FactoryTalk Batch Database Migration
Utility. The utility is installed on the BatchHistoryEx machine and can be accessed from the Start menu. The
FactoryTalk Batch Database Migration Utility can migrate older BatchHistory and BatchHistoryEx databases to the
current schema. The migration to the current schema requires stopping all archiving to the database and can take hours
depending on the size of the database.
Application Notes
This release has the following application notes.
Application notes for FactoryTalk Batch v17.00.00
The FactoryTalk Batch v17.00.00 release has the following application notes.
Impact of Microsoft deprecating VBScript
Microsoft announced the phased deprecation of VBScript in 2024. VBScript is now an optional feature beginning in Windows 11 24H2 and Windows Server 2025. Many FactoryTalk software products released before September 1, 2026, use VBScript during installation.
FactoryTalk Batch versions 18.00.00 and earlier require VBScript for installation. Installation will fail if VBScript is not enabled.
To mitigate the problem, enable VBScript manually. For more information, see the Knowledgebase Document ID: IN41397 - Impact of Microsoft deprecating VBScript. FactoryTalk software products released after September 1, 2026, no longer rely on VBScript.
BATCHCTL Security Configuration
The Everyone group has been removed from the BATCHCTL security settings in Batch 17.00.00. The change further secures the
batch user files that are located under the BATCHCTL share (program files (x86)\Rockwell Software\Batch). This change requires
security configuration to be made on the directories under the BATCHCTL share after the install of Batch 17.00.00. See the Install
and Upgrade guide Post Install for instructions on how to secure the directories.
Preserve Basefilter property between releases
When upgrading the User Controls between releases, the controls are rewritten and must be deleted and reinstalled. After the
install, you must reconfigure the properties on the controls.
If the control is 2.x or later, FactoryTalk View SE applies the properties to the new control. You do not have
to reconfigure the properties. The COM ClassID verifies the new control is compatible. If it is not
compatible, the control must be deleted and reinstalled.
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.
Upgrade
NOTE: This version of FactoryTalk Batch View includes updated third-party libraries and enhanced security measures.
Rockwell Automation recommends testing all existing eProcedure instructions—especially those involving scripting or
connections to external data sources—on a non-production system, such as a development or test environment. Use
the latest version before upgrading your production system. Identifying and resolving any issues related to the
improved security stance or third-party libraries in advance will help prevent disruptions or issues in your production
environment.
Upgrade from FactoryTalk Batch v16.00.00 to FactoryTalk Batch v17.00.00 does NOT require an uninstall of FactoryTalk
Batch v16.00.00.
Before upgrading to FactoryTalk Batch v17.00.00 from FactoryTalk Batch v14.00.00, you must
uninstall the previous release and then delete the Batch View Server folder located at C:\Program Files
(x86)\Rockwell Software\Batch View Server. Failure to do so will result in the inability to start the FactoryTalk Batch
View Server.
Upgrading from RSLinx CIP communication to FactoryTalk Linx CIP communication is a manual operation. Use these steps:
- Open the FactoryTalk Administration Console and then navigate to FactoryTalk Linx.
- Create FactoryTalk Linx shortcuts to the controllers that have the Phase Manager phases or Sequence Manager
sequences.
- Open the area model in the Equipment Editor and navigate to the Data Servers.
- Edit each Data Server that is the type Logix5000 CIP, changing the FactoryTalk Linx Controller Shortcut to shortcuts
created in step 2.
FactoryTalk Batch
- Logix5000 CIP Data servers must use the first instance of a FactoryTalk Linx service.
FactoryTalk Linx v6.40 installs two instances of the FactoryTalk Linx data server. Only the first instance named FactoryTalk
Linx Instance01 Server supports the necessary communication interfaces to connect to PhaseManager and
SequenceManager on a Logix controller.
When configuring a Logix5000 CIP data server for communications with PhaseManager or SequenceManager, be sure to
select the data server that is using the first instance of the FactoryTalk Linx service.
Use these steps to identify which instance of FactoryTalk Linx is assigned to a data server:
- Start FactoryTalk Administration Console.
- In the Explorer pane, browse to the data server
- Right-click the data server name and select Properties.
- On the General tab, verify that the entry under Server Type is FactoryTalk Linx Instance01 Server.
Tip: For more information, see the FactoryTalk Linx Help topic What's FactoryTalk Linx instance02 service?
Service Manager does not use Single Sign-On credentials.
You must log in to FactoryTalk before using the FactoryTalk Batch Service Manager.
This is because performing a deployment to a runtime server is treated as an elevated privileges operation when launched
from the FactoryTalk Batch Service Manager. To run with elevated privilege the FactoryTalk Batch Service Manager must:
- Always prompt for a username and password.
- Not use the Single Sign-on User.
- Not set the Single Sign-on User.
Use command-line parameters to perform an unattended or silent installation of the software.
Installation command-line parameters
Use command Setup.exe /? to display the usage options for installation parameters. Command-line parameters are
case-insensitive. If a specified value includes a space, be sure to enclose the value in quotation marks (for example, "value with
spaces").
Examples
These examples show how to use the installation commands.
The command-line install of FactoryTalk Batch performs a full install of FactoryTalk Batch. To install FactoryTalk Batch,
FactoryTalk Event Archiver, FactoryTalk Batch Material Manager, or FactoryTalk Batch View HMI Controls separately
use the installation wizard instead of the command-line.
These options are specific to installing FactoryTalk Batch software:
|
Parameter
|
Description
|
|
BatchServerName
|
Required for Batch. Machine name where the Batch server is installed.
|
|
eProcedureServerName
|
Required for eProcedure. Machine name where the eProcedure Server
is installed.
|
|
MaterialManagerServerName
|
Required for Material Manager. Machine name where Material Manager
Server is installed.
|
|
FirstInSystem
|
Optional. Set to "No" to add a Batch or Material Manager install to an
existing system.
If omitted, the default is "Yes"
|
|
DomainWorkgroup
|
Optional. Set to "WORKGROUP" to indicate for a Batch, eProcedure, or
Material Manager install that the machine is not connected to a domain.
If omitted, the default is "DOMAIN"
|
|
BatchDomain
|
Required for Batch, eProcedure, and Material Manager.
Specifies the domain name of the machine where the product is being
installed. Value should be set to the local machine name when installing
in a workgroup.
|
|
BatchUserName
|
Required for Batch, eProcedure, and Material Manager.
|
|
BatchPassword
|
Required for Batch, eProcedure, and Material Manager.
|
|
RecipesInSQL
|
Optional. Set to "Yes" to indicate for a Batch or Material Manager install
that recipes should be stored in SQL.
If omitted, the default is "No"
|
|
FTDirectory
|
Optional. Set to "Local" to indicate for a Batch or eProcedure install that
FTSP should use the Local directory.
If omitted, the default is "Network"
|
|
MaterialJournaling
|
Optional. Set to "Yes" for a Material Manager install to record activity to
the MaterialBasedRecipe_MAJ database.
If omitted, the default is "No"
|
|
ArchiverSqlAuth
|
Optional. Set to "Yes" to indicate for an Event Archiver Database install
to use SQL authentication with the user and password values passed in
/ArchiverSqlUser and/ArchiverSqlPass.
If omitted, the default is "No"
|
|
ArchiverSqlUser
|
Optional for Event Archiver Database Feature.
|
|
ArchiverSqlPass
|
Optional for Event Archiver Database Feature.
|
|
ArchiverDbAction
|
Required for Event Archiver Database Feature.
"Migrate" updates pre-Batch 12 DB schema to
current format "Upgrade" updates only stored
procedures and reports "Create" generates a
new DB, overwriting an existing one
|
|
ArchiverServerName
|
Required for Event Archiver Database Feature.
|
|
ArchiverInstanceName
|
Optional for Event Archiver Database Feature.
|
|
ArchiverDataSourceName
|
Required for Event Archiver Database Feature.
|
|
ArchiverWithReports
|
Optional. For an Event Archiver Database install, set to:
"Yes" to use a BatchHistoryEx database
with reporting "No" to use a BatchHistory
database without reporting
If omitted, the default is "Yes"
|
|
HTTPS_PORT_USER
|
Optional for BatchView Server.
If omitted, the default value is 443.
To define a custom port, specify the value of the desired port (port value
must follow the validation rules for port number assignment).
|
|
CopyCustomerContentSelected
|
Optional for BatchView Server.
If omitted, the default is "No".
|
Example
The following example shows how to use the installation commands.
- To install the software with no user interface specifying a custom HTTPS port and copying custom content during the
installation process.
Setup.exe /Q /IAcceptAllLicenseTerms /DomainWorkgroup=Domain /BatchDomain=MyDomain /BatchUserName=User1 /BatchPassword=s3cretp@ssw0rd! /
Product=FTBatch /BatchServerName=BatchServer1 /HTTPS_PORT_USER=8443 /CopyCustomerContentSelected=Yes
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 cancelled 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_SUCCESS_REBOOT_INITIATED
|
1641
|
The installer has initiated a restart. After restart
installation
will continue.
|
|
ERROR_SUCCESS_REBOOT_REQUIRED
|
3010
|
A restart is required to complete the installation.
After restart
the product is successfully installed.
|
|
ERROR_SUCCESS_RELAUNCH_REQUIRED
|
3011
|
Restart of setup needed before installation can
continue.
|
FactoryTalk Batch Material Manager
- Material Editor is a COM+ application. If another service starts or logs in using the same identity before the Material Server
is started, stopping that service logs off the user account. If the Material Editor is connected before the other service is
stopped, it will still have access to the Material Server, but if it disconnects from the Material Server it will not be able to
reconnect until the server is rebooted or the previous service is restarted. For more information and potential
workarounds, see the information about COM+ applications on the Microsoft web site.
FactoryTalk Batch Enterprise Integration Server
- Install the FactoryTalk Batch Enterprise Integration Server after completing the FactoryTalk Batch installation to add
support for developing enterprise integration features using the provided API.
The FactoryTalk Batch EI Server.msi file is in the EIServer folder of your FactoryTalk Batch v17.00.00 installation media.
CIS Benchmarks test results recommendations
The following CIS Benchmarks recommendations for Windows 11 with FactoryTalk Batch and eProcedure are exceptions that are
set contrary to the recommendation:
2.2.3 (L1) Ensure 'Act as part of the operating system' is set to 'No One'
2.2.4 (L1) Ensure 'Adjust memory quotas for a process' is set to 'Administrators,
LOCAL SERVICE, NETWORK SERVICE'
2.2.11 (L1) Ensure 'Create a token object' is set to 'No One'
2.2.13 (L1) Ensure 'Create permanent shared objects' is set to 'No One'
2.2.25 (L1) Ensure 'Increase scheduling priority' is set to 'Administrators,
Window Manager\Window Manager Group'
2.2.36 (L1) Ensure 'Replace a process level token' is set to 'LOCAL SERVICE, NETWORK SERVICE'
2.3.10.8 (L1) Ensure 'Network access: Remotely accessible registry paths and sub-paths' is configured
- (L1) Ensure 'User Account Control: Admin Approval
Mode for the Built-in Administrator account' is set to 'Enabled'
- (L1) Ensure 'User Account Control: Behavior of the
elevation prompt for administrators in Admin Approval Mode' is set to
'Prompt for consent on the secure desktop' or higher Fail
- (L1) Ensure 'User Account Control: Behavior of the elevation
prompt for standard users' is set to 'Automatically deny elevation requests'
2.3.17.6 (L1) Ensure 'User Account Control: Run all administrators in Admin
Approval Mode' is set to 'Enabled'
The following CIS Benchmark Recommendations for Server2022 with all FactoryTalk
Batch components installed are exceptions which are set contrary to the
recommendation:
2.2.4 (L1) Ensure 'Act as part of the operating system' is set to 'No One'
2.2.6 (L1) Ensure 'Adjust memory quotas for a process' is set to 'Administrators,
LOCAL SERVICE, NETWORK SERVICE'
2.2.14 (L1) Ensure 'Create a token object' is set to 'No One'
2.2.16 (L1) Ensure 'Create permanent shared objects' is set to 'No One'
2.2.33 (L1) Ensure 'Increase scheduling priority' is set to 'Administrators,
Window Manager\Window Manager Group'
2.2.44 (L1) Ensure 'Replace a process level token' is set to 'LOCAL SERVICE, NETWORK SERVICE'
2.3.10.9 (L1) Configure 'Network access: Remotely accessible registry paths and sub-paths' is configured
CIS Benchmarks test results recommendations
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.
FactoryTalk Batch version 17.00.00 has been tested on CIS Benchmark v2.0.0 for Microsoft Windows 10 Enterprise, Microsoft
Windows Server 2019 Standard, Microsoft Windows 11 Enterprise, and Microsoft Windows Server 2022 Standard.
Exceptions settings for FactoryTalk Batch version 17.00.00 are listed.
CIS Microsoft Windows 10 Enterprise Benchmark v2.0.0
- 2.2 User rights assignment
- 2.2.4 (L1) Ensure 'Act as part of the operating system' is set to 'No One'
- 2.2.6 (L1) Ensure 'Adjust memory quotas for a process' is set to 'Administrators, LOCAL SERVICE, NETWORK SERVICE'
- 2.2.14 (L1) Ensure 'Create a token object' is set to 'No One'
- 2.2.16 (L1) Ensure 'Create permanent shared objects' is set to 'No One'
- 2.2.33 (L1) Ensure 'Increase scheduling priority' is set to 'Administrators, Window Manager\Window Manager Group'
- 2.2.44 (L1) Ensure 'Replace a process level token' is set to 'LOCAL SERVICE, NETWORK SERVICE'.
CIS Microsoft Windows Server 2019 Standard Benchmark v2.0.0
- 2.2 User rights assignment
- 2.2.4 (L1) Ensure 'Act as part of the operating system' is set to 'No One'
- 2.2.6 (L1) Ensure 'Adjust memory quotas for a process' is set to 'Administrators, LOCAL SERVICE, NETWORK SERVICE'
- 2.2.14 (L1) Ensure 'Create a token object' is set to 'No One'
- 2.2.16 (L1) Ensure 'Create permanent shared objects' is set to 'No One'
- 2.2.33 (L1) Ensure 'Increase scheduling priority' is set to 'Administrators, Window Manager\Window Manager Group'
- 2.2.44 (L1) Ensure 'Replace a process level token' is set to 'LOCAL SERVICE, NETWORK SERVICE'.
- 2.3.10 Network access
- 2.3.10.6 (L1) Configure 'Network access: Named Pipes that can be accessed anonymously' (DC only)
CIS Microsoft Windows 11 Enterprise Benchmark v2.0.0
- 2.2 User Rights Assignment
- 2.2.3 (L1) Ensure 'Act as part of the operating system' is set to 'No One'.
- 2.2.4 (L1) Ensure 'Adjust memory quotas for a process' is set to 'Administrators, LOCAL SERVICE, NETWORK
SERVICE'.
- 2.2.11 (L1) Ensure 'Create a token object' is set to 'No One'Fail
- 2.2.13 (L1) Ensure 'Create permanent shared objects' is set to 'No One'.
- 2.2.25 (L1) Ensure 'Increase scheduling priority' is set to 'Administrators, Window Manager\Window Manager Group'.
- 2.2.36 (L1) Ensure 'Replace a process level token' is set to 'LOCAL SERVICE, NETWORK SERVICE'.
- 2.3.10 Network access
- 2.3.10.8 (L1) Ensure 'Network access: Remotely accessible registry paths and sub-paths' is configured.
CIS Microsoft Windows Server 2022 Standard Benchmark v2.0.0
- 2.2 User Rights Assignment
- 2.2.4 (L1) Ensure 'Act as part of the operating system' is set to 'No One'
- 2.2.6 (L1) Ensure 'Adjust memory quotas for a process' is set to 'Administrators, LOCAL SERVICE, NETWORK SERVICE'
- 2.2.14 (L1) Ensure 'Create a token object' is set to 'No One'
- 2.2.16 (L1) Ensure 'Create permanent shared objects' is set to 'No One'
- 2.2.33 (L1) Ensure 'Increase scheduling priority' is set to 'Administrators, Window Manager\Window Manager Group'
- 2.2.44 (L1) Ensure 'Replace a process level token' is set to 'LOCAL SERVICE, NETWORK SERVICE'
- 2.3.10 Network access
- 2.3.10.9 (L1) Configure 'Network access: Remotely accessible registry paths and sub-paths' is configured
Rockwell Automation recognizes that some of the terms that are currently used in our industry and in this publication are not in alignment with the movement toward inclusive language in technology. We are proactively collaborating with industry peers to find alternatives to such terms and making changes to our products and content. Please excuse the use of such terms in our content while we implement these changes.
Copyright © 2026 Rockwell Automation, Inc. All rights reserved.
Rockwell Automation, Allen-Bradley, and FactoryTalk are trademarks of Rockwell Automation, Inc.
To view a complete list of Rockwell Automation trademarks please
click here.Trademarks not belonging to Rockwell Automation are property of their respective companies.