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 can be used to manage license containers and perform various license operations including creating containers, updating licenses, and handling offline license transfers. The tool supports both online operations with direct License Portal access and offline file-based operations.

Synopsis

WCCOAtoolCMactivation [options] [<license portal URL>]

The license portal URL parameter is mandatory for all operations except -container, -create, and -import.

Example: https://license-portal.example.com/12345/portal

Tool Location

You can find the tool under WinCCOA_path/bin/WCCOAtoolCMactivation[.exe]

Necessary Data

  • Firm Code for ETM (Vendor ID): 6000802 (default for ETM)
  • License Portal URL: e.g., https://license-portal.example.com/12345/portal
  • Container ID (e.g. 130-35951XXXXX)

Available Options

-container
Create new CmContainer. Optionally a server can be specified if the CmContainer is not connected locally. This operation requires -lif.
-create
Create context file for given CmContainer. Optionally a server can be specified if the CmContainer is not connected locally. This operation requires -serial, -firmcode and -context. Firmcode for ETM is always 6000802 which is the default when -firmcode is omitted.
-import
Import update file for given CmContainer. Optionally a server can be specified if the CmContainer is not connected locally. This operation requires -serial and -update.
-autoupdate
Update licenses for given CmContainer. This operation requires -serial. This is the default operation if no other option has been given.
-download
Download the most recent update file (WibuCmRaU) for the given container. Can only be used in combination with -update and -serial.
-confirm
Confirms open transfer operations in CodeMeter License Central. Can only be used in combination with -context and -serial.
-info
Retrieve information for given CmContainer, such as the IP address of the server the specified CmContainer is connected to. This operation will only work if the server search list of the local system is identical to the one where WinCC OA is operated. This operation requires -serial and -firmcode.
-comment <information>
Comment for the operation. This information will be shown in the license history of CodeMeter License Central. If this parameter is not given, an internally defined comment will be used.
-server <dns name or ip of license server>
Remote CodeMeter License Server to be used for the operation. If this parameter is not specified the local installation will be used. Can only be used in combination with -container, -create and -import.
-serial <container serial number>
Select an existing CmContainer by providing its serial number.
-firmcode <firm code>
Firm code to be used. A value is mandatory for operations -create and -info. If this parameter is not specified, the default firm code from ETM is used (6000802).
-context <filename>
Provides a file name of type WibuCmRaC to any file-based operation.
-update <filename>
Provides a file name of type WibuCmRaU to any file-based operation.
-lif <filename>
Provides a file name of type WibuCmLiF to any file-based operation.
-logfile <filename>
Name of log file where messages should be written to. If this parameter is not given, no further logging will be done.
-interactive <yes|no>
Definition whether interactive mode should be used. In regular mode all output is in JSON format, in interactive mode output is human readable. If this parameter is not given, non-interactive mode will be used.
-accept
Flag, whether the conditions of operation "restore" are accepted. If this parameter is not given, operation "restore" will fail with an error message.
-verbose
Flag, whether in non-interactive mode additional messages should be printed. If this parameter is not given, no additional messages are printed.
-help
Print help screen of the application.

Interactive or Non-Interactive Usage

All commands of the WCCOAtoolCMactivation tool can be used in interactive shells or in a non-interactive environment (e.g. script). If the commands are used together with the -interactive yes option, then the output is human readable. When an option is not specified, then -interactive no is the default. Non-interactive provides JSON formatted text on stdout for information and JSON formatted text on stderr for error messages.

Note:
The tool reports as briefly as possible. Turn on more output with the -verbose option.

Online and Offline Operations

The terms online and offline refer to the available or missing access to License Portal. Online means the license portal is reachable by WCCOAtoolCMactivation, while offline means the lack of access to License Portal.

A license server with the same subnet of a WinCC OA installation is referred to as remote license server or remote container.

Help

For a complete list of the command line tool options, use:

WCCOAtoolCMactivation -help