Release Notes

Connected Components Workbench (CCW) Developer Edition single software to program, simulate, configure, and visualize.
Version 21.00.00 (released 11/2022)

Catalog Number Connected Components Workbench - Dev Ed 

These release notes describe version information for Connected Components Workbench - Dev Ed, version 21.00.00 (released 11/2022).

Requirements

This release has the following requirements.

The following are the system requirements for Connected Components Workbench version 21.00.

Connected Components Workbench 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

Connected Components Workbench requires the following hardware:

Software requirements

Connected Components Workbench has been tested on the following operating systems:

IMPORTANT
Installation failure will occur on systems running on Windows 10 1507 and Windows 10 1511 due to Microsoft® .Net Framework 4.8 requirements.

Connected Components Workbench automatically installs the following required software on the computer, if necessary:

IMPORTANT
Installation failure will occur on systems running on Windows 10 1507 and Windows 10 1511 due to Microsoft .Net Framework 4.8 requirements. Uninstalling Connected Components Workbench would not remove all these components. It is recommended to verify the respective component dependencies before uninstalling them.

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).

Features

This release includes the following system features.

Connected Components Workbench version 21.00 has the following new and enhanced features:

New features

Enhanced features

PanelView™ 800 DesignStation has no new release. The product version is still 12.02. For more information, see Connected Components Workbench version 20.01 Release Notes.

Corrected Anomalies in This Release

This release corrects the following anomalies.

Connected Components Workbench version 21.00 has no corrected anomalies.

Known Anomalies from Previous Releases

These anomalies are from previous releases but are still known in this release.

Functional Changes

This release has the following functional changes from the previous release.

Connected Components Workbench version 21.00 has no changes in functionality since the last release.

Application Notes

This release has the following application notes.

The following are the application notes for Connected Components Workbench version 21.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 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).

graphic
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.

Restarts during installation of Connected Components Workbench

Some Microsoft components may require a restart before the full Connected Components Workbench installation is complete. If the Connected Components Workbench does not install completely, restart the computer, and the Connected Components Workbench automatically continues installing.

Install Connected Components Workbench version 21.00

If you have a previous version of Connected Components Workbench installed, it is recommended to:

To install the Connected Components Workbench

graphic
Note: To use Software Center Configuration Manager (SCCM), install it with a user account or manually install Visual Studio shell 2013 before installing Connected Components Workbench.
  1. Download the current version of Connected Components Workbench (Standard or Developer Edition).
  2. Launch Setup.exe.
  3. You must manually install .NET Framework 3.5 SP1 if you are using Windows 10, Windows 11, or Windows Server 2019.
  4. In the Connected Components Workbench Setup dialog, select the products which you want to install, or specify a different drive where you want to install the software, and then click Next. By default, all products are selected and installed with the Connected Components Workbench. To remove a product or language from the current installation, clear the checkbox.
  5. (optional) If installing the Developer Edition, enter the product serial number when prompted, and click Install.
  6. In the End-User License Agreements dialog, read the agreements, click Accept all to continue the installation, or click Decline to return to the previous page.
  7. (optional) If there are multiple Ethernet adapters in the computer, select one as the default from the popup window. Silent install mode will not provide the selection during installing. Configure it in RSLinx Classic after installation completes.
  8. When prompted to restart your computer during the installation, click Restart now to restart your computer and continue the installation, or Restart later to suspend and exit the installation.
  9. In the That's it! dialog, click Close to exit the installation. Meanwhile, you can also:
    • Click Installation Summary to see the installation details.
    • Click Register for updates to learn how to receive email updates about product patches.
    • Click Download it free to install Adobe Acrobat Reader.
  10. The Connected Components Workbench installation is complete.

To upgrade an existing installation

  1. Stop your current version of Connected Components Workbench.
  2. Perform the installation steps in the order presented on the screen.
  3. Modify the products you want to install or uninstall.
    • Clear the product you want to uninstall. By default, the products are selected if they have been installed.
    • Select the product you want to install.
  4. Click Install.
  5. Restart your computer to complete the update.

FactoryTalk Updater

The FactoryTalk Updater utility is installed with Rockwell Automation software products. It assists the management of installed Rockwell Automation software by announcing new versions and patch roll-ups. Registering for updates is not required to receive announcements from the FactoryTalk Updater.

System logs and some application data are stored in this folder:

C:\Users\Public\Documents\Rockwell\Updater\Data

The logs and application data can be helpful when contacting Rockwell Automation Technical Support. System logs are automatically deleted after 90 days.

graphic
Tip: To receive notifications of new versions and patch roll-ups, the FactoryTalk Updater utility requires access to the Download Center web service. Verify that the firewall does not block access to this URL:
https://api.rockwellautomation.com/es-be-pcdc-vpcprod/

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 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.
/Repair
Runs a repair operation on the installed products.
This parameter is optional.
/Uninstall
Uninstalls the product.
This parameter is optional.
/SetupLanguage="value"
Specifies which language will be displayed during install process.
The value must be one of the following:
  • ENU
  • CHS
  • DEU
  • ESP
  • FRA
  • ITA
  • JPN
  • KOR
  • PTB
This parameter is optional. If this parameter is not used, the default language is the current user or operating system user interface language.
/Product="value"
Specifies which sub-products will be installed.
Only required if sub-products are included with the install package.
If the software does not include sub-products this parameter is not available.
/ProductLanguage="value"
Specifies the language version of the software being installed.
The value must be one of the following:
  • ENU
  • CHS
  • DEU
  • ESP
  • FRA
  • ITA
  • PTB
This parameter is optional. If this parameter is not used, the default language is the same as the setup language.
If the software does not support multiple languages this parameter is not available.
/InstallLocation="value"
Or
/InstallDrive="value"
Specifies the install location or install drive respectively.
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.
/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.
/SerialNumber="value"
Specifies the serial number of the software being installed. This is used to activate the software during installation.
This parameter is optional. If it is not specified the software must be activated manually after installation if activation is required.
Some software does not require activation. If activation is not required this parameter is not available.
/ProductKey="value"
Specifies the product key used to get activation keys during installation.
This parameter is optional. If it is not specified the software must be activated manually after installation if activation is required.
Some software does not require activation. If activation is not required this parameter is not available.
/Version="value"
Specifies the version of the software to activate which corresponds to the product version associated with the SerialNumber and ProductKey.
This parameter is optional. If it is not specified the installer will use the most recent product version available.
Some software does not require activation. If activation is not required this parameter is not available.

Examples

The following examples show how to use the installation commands.

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 reboot is required to continue to installation.
ERROR_SUCCESS_REBOOT_REQUIRED
3010
A restart is required to complete the installation. After restart, the product is successfully installed.
ERROR_REBOOT_PENDING
3012
A restart is pending and is required before the installation can continue.
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.

Convert an existing project to the current release

To use the most current features on projects created in previous versions of Connected Components Workbench, convert the project to the current release by opening the project in the latest Connected Components Workbench. This will automatically convert the project’s databases to the current release.

An existing project that is converted to the current release, opened and saved in the current release, or downloaded to a Micro800 controller cannot be opened in a previous release. If a project is shared, all users must upgrade to the current release of the Connected Components Workbench to continue using the project.

When you open a project created in a previous release of the Connected Components Workbench, the project database automatically updates to the current release, which allows access to the latest Connected Components Workbench features. However, to use new device-specific features in the current release, you may also need to use the device's upgrade feature to upgrade the device. For example, Micro800 controllers use the Change Controller feature to update the controller firmware revision to the latest revision to make use of newly added instructions.

User account types for Connected Components Workbench

When you create new projects or open existing projects, we recommend that you do not use the default Guest user account and that you use the same type of account you used when you installed Connected Components Workbench. That is, if you were signed in under an administrator account when you installed Connected Components Workbench, you should sign in with an account that has administrator privileges when you use the Connected Components Workbench.

To change to an administrator account

  1. Navigate to: \Program Files > Rockwell Automation > Connected Components Workbench.
  2. Right-click CCW.Shell.exe, select Run as, and then select Administrator user.
  3. Click OK.

File Extensions and locations

Connected Components Workbench creates and uses the file extension .ccwsln for user-created projects.

By default, the product-managed files are saved to:

C:\Users\<user>\Documents\CCW\<Project#>\<project#>.ccswln

Connecting to a Micro800 controller on a virtual machine

If you install RSLinx Classic on a virtual machine (for example, VMware®), make sure to disable RSLinx Classic on the host computer before you plug the USB cable that is attached to your Micro800 controller into the host computer. If you ignore this step, the host computer will obtain the driver for the Micro800 controller, and the virtual machine may not be able to detect the Micro800 controller.

Connecting to a Device using Ethernet

Use the default EtherNet/IP driver to connect to a device.

If you use Ethernet instead of a USB to connect to the controller, the Ethernet/IP driver is installed by default in RSLinx and you can connect to devices which are on the same subnet as the PC. If a DHCP server is available, in most cases, your computer and the device (such as the Micro850 controller, which defaults to DHCP) will be assigned IP addresses that will allow them to communicate using this Ethernet/IP driver. The Ethernet/IP driver will browse all devices on the subnet.

In cases where the device is not on the same subnet as the PC or you do not wish to view all devices on the subnet, it is recommended to install the Ethernet Devices driver, which requires manually entering the IP address of the device.

To add the Ethernet Devices driver to connect to a device

Note: Be sure to select the correct port (it may not be the Windows default).

  1. Click Communications > Configure to open the Configure Drivers dialog.
  2. In Available Driver Types, select Ethernet Devices.
  3. Click Add New and type a name for the driver or accept the default name.
  4. If prompted, enter the Ethernet adapter selection. Be sure to select the correct port (it may not be the Windows default).
  5. For each device, enter the IP address (or Host Name if DNS is supported) under Host Name. It is recommended to append ":EIP" to the IP address for better performance by avoiding the older CSPv4 port 2222. Click Add New as necessary. Click OK, then Close when finished.
  6. For the device, click Connect to open the Connection Browser.
  7. Expand the Ethernet Devices driver you previously added.
  8. Select the controller that you want to connect to from your project and then click OK.

Security considerations

Connected Components Workbench and its included software components require running system services and network access to communicate with controllers, drives, graphic terminals, and other devices. You may need to enable system services or configure firewall rules for Connected Components Workbench to function properly. However, Connected Components Workbench does not require endpoint firewall rules because it is not a server product that allows remote clients.

For a list of services that require network access, as well as detailed information on security concerns, see Knowledgebase Document ID: PN826 - Security considerations when using Rockwell Automation Software Products.

For a list of TCP/UDP ports used by Rockwell Automation products, see Knowledgebase Document ID: BF7490 - TCP/UDP Ports Used by Rockwell Automation Products.

View Trend and UDC Help with Help Viewer 2.1

The Help Viewer 2.1 Filter is designed to keep the search list compact and manageable. Titles appear in the filtered table of contents (TOC) list only if they contain the root of the term used in the filter and the empty TOC levels are collapsed with an ellipsis (…).

For example, if you specify "troubleshooting" as a filter, only titles that contain "troubleshoot" or "troubleshooting" appear. Nodes whose titles do not contain the term are collapsed to a single node with an ellipsis (...).

In the filtered TOC, you can do the following:

Internet Explorer security settings

Internet Explorer® high security settings can prevent some help features from working as expected.

VMware compatibility

Compatibility with VMware has not been formally tested, but it has been used extensively with Connected Components Workbench.

Manually connecting a virtual machine to a USB device

Downloading available firmware

The only firmware files installed with Connected Components Workbench 10.0 and later are the two most recent firmware versions for the Micro800 controllers. Additional firmware files (.dmk) are available for download on Rockwell Automation Compatibility and Downloads.

Downloading sample code and Device Manuals

If upgrading Connected Components Workbench from an earlier version to 11.00 or later, the Sample Code and Device Manuals of the earlier version should be downloaded manually. The latest Sample Code and Device Manuals are available for download on Rockwell Automation Compatibility and Downloads. We recommended you install the same version of Device Manuals as Connected Components Workbench.

Activation and grace period

If the Connected Components Workbench Developer Edition is unable to connect to the FactoryTalk Activation server, it enters a seven-day grace period. Once the grace period expires, Connected Components Workbench will run as Standard Edition.

Installing language package

If a German or Italian Connected Components Workbench version is installed on Windows 10 or Windows Server 2012 and later with a different language version, install the German or Italian Language Pack on your operating system.

Spectrum Controls module configuration tool

For the Spectrum Controls module configuration tool, it is installed to C:\Program Files (x86)\Rockwell Automation\CCW\SpectrumTool\ModuleConfigConverter.exe. This launch path can be configured as part of the module’s profile.

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 © 2024 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.