Home
Deployment
Topics you need to know before using WinCC OA.
WinCC OA Licensing
Overview of the licensing model used by WinCC OA
WCCOAtoolCMactivation
WCCOAtoolCMactivation is a command-line tool for managing CodeMeter license containers and performing license operations both online and offline with the WinCC OA License Portal.
WCCOAtoolCMactivation - Restore

Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics you need to know before using WinCC OA.
- Hardware and software requirements for WinCC OA
  This section contains the current hardware and software requirements for various WinCC OA application scenarios. Recommendations are given for practical deployment of WinCC OA depending on the specific application and scale of the project.
- WinCC OA Licensing
  Overview of the licensing model used by WinCC OA
  - Requirements and Installation
  - License Information Panel
  - Runtime Settings
  - WinCC OA License options (Features)
  - WinCC OA Licensing, Further Information
  - Fixed Licensing
  - WCCOAtoolCMactivation
    WCCOAtoolCMactivation is a command-line tool for managing CodeMeter license containers and performing license operations both online and offline with the WinCC OA License Portal.
    - WCCOAtoolCMactivation - Local PC Operations
      Local operations that can be performed on a WinCC OA installation without requiring access to the License Portal.
    - WCCOAtoolCMactivation - License Handling Online
      Online operations require access to the WinCC OA License Portal and are performed when the license portal is reachable by WCCOAtoolCMactivation.
    - WCCOAtoolCMactivation - License Handling Offline
      Offline operations are performed when there is no access to the License Portal. Container contents are always prepared in the License Portal by project workflow and transferred via file-based operations.
    - WCCOAtoolCMactivation - License request for an empty station
    - WCCOAtoolCMactivation - Restore
  - Licensing Errors
  - Licensing CTRL Functions
  - Subscription-based Licensing
    The subscription-based licensing model offers increased flexibility, scalability, and convenience compared to traditional approaches. Users receive access to software for a defined period, with the license automatically renewing upon timely payment. Key advantages include automated management through a secure portal, transparent license information, and proactive notifications. This model supports sustainable operational planning, optimizes resources, and ensures a seamless user experience through uninterrupted updates.
- WinCC OA License Portal
  The SIMATIC WinCC Open Architecture License Portal streamlines license management with a modern, user-friendly interface and advanced features, launching in October 2025. This documentation offers comprehensive guidance, support resources, and step-by-step instructions to help users and administrators efficiently manage licenses and access essential materials.
- Installation
  How to properly install WinCC OA.
- Docker Support
  An introduction on how to use WinCC OA within a Docker container, what specifics must be considered and where to find further information on the topic.
- Virtual Environment Support
  WinCC OA is used in very diverse computing environments, some of which are easier managed with the use of a enterprise virtualization software. Due to the good encapsulation and platform independence of WinCC OA, the use on a wide range of current versions of the most common virtualization products is possible. Our extensive, automated tests are provided via Proxmox and VMware(vSphere).
- WinCC OA Product Packaging
  Explains the file structure presented in the configuration bundles as well as some use cases with detailed descriptions
- WinCC OA for Industrial Edge
  With WinCC OA offered as an app for Industrial Edge, WinCC OA brings advanced data processing and integration capabilities directly to edge devices. This enables manufacturers to optimize industrial workflows and improve operational efficiency.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
Documentation
Basic information about terms and functions within the documentation.
Support & Services
An experienced team of support agents, consultants and trainers are ready to facilitate active partnerships with our customers, so they can profit from our comprehensive service.
Disclaimer
A brief clarification of liability exclusions or legal notices.

WCCOAtoolCMactivation - Restore

Note:

Create a new container before restoring a license.

Windows:

cmu32 -i -f c:\Siemens\Automation\WinCC_OA\<version>\data\license\ETM_pc_-_A_Siemens_Company.WibuCmLif

Linux:

cmu -i -f /opt/WinCC_OA/<version>/data/license/ETM_pc_-_A_Siemens_Company.WibuCmLif

Restore without "Accept":
Windows/Linux:
```
WCCOAtoolCMactivation -interactive yes -restore 211648,211668 -serial 130-111222333 https://license-portal.example.com/12345/gateways XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
```
Error code: 31
Error text: operation "restore" requires acceptance of the rules and regulations by using the additional option "-accept"

Restore with "Accept":

Windows/Linux:

WCCOAtoolCMactivation -accept -interactive yes -restore 211648,211668 -serial 130-111222333 https://license-portal.example.com/12345-dev/gateways XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Restore attempt with already used licence (restore is only possible once):
Windows/Linux:
```
WCCOAtoolCMactivation -accept -interactive yes -restore 211648,211668 -serial 130-444555666 https://license-portal.example.com/12345-dev/gateways XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
```
Error code: 12
Error text: at least one of the licenses "211648,211668" does not belong to the given container or is not restorable or is currently activated to the given cmcontainer