CodeMeter Runtime - Installation

© Copyright 2003-2023, WIBU-SYSTEMS AG,

Zimmerstrasse 5, D-76137 Karlsruhe, Germany

All rights reserved. No part of this documentation, the accompanying software, or other components of the described product
may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording,
for any purpose other than the personal use of the purchaser without the express written permission of Wibu-Systems.
While the data contained in this document has been written with all due care, Wibu-Systems does not warrant or assume
responsibility or represent that the data is free from errors or omissions.
Wibu-Systems expressly reserves the right to change programs or this documentation without prior notice.
Wibu-Systems®, CodeMeter®, SmartShelter®, SmartBind® and Blurry Box® are registered trademarks of Wibu-Systems. All other
brand names and product names used in this documentation are trade names, service marks, trademarks, or registered
trademarks of their respective owners.

Wibu-Systems is member of:

PCMCIA since1993

USB Implementers Forum since 1997

SD Card Association since 2007

Bitkom, German Association of Information Technology,
Telecommunications, and New Media since 2003
VDMA, German Engineering Federation since 2008
OPC Foundation since 2012
and also a member of the developers programs of Autodesk, Apple, HP, IBM, Intel and
Microsoft.

Microsoft Gold Certified Partner

Microsoft Embedded Partner

Strategic Software Partner Industrial and Medical

 How to use this help?

1 How to use this help?

Navigation
There are many ways to turn pages in a PDF. Many people use the buttons on the Page Navigation toolba', but you can also use
arrow keys, scroll bars, and other features to move forward and backward through a multipage PDF.
The Page Navigation toolbar opens by default. The default toolbar contains frequently used tools: the Show Next Page, Show
Previous Page, and Page Number. Like all toolbars, the Page Navigation toolbar can be hidden and reopened by choosing it in the
Toolbars menu under the View menu. You can display mo re tools o n the Page Navigation toolbar by right-clicking the toolbar and

choosing an individual tool, Show All Tools , or More Tools and then se le cting and de se le cting tools in the dialog box.
For more options see https:// he lpx.adobe .com/ acrobat/using/ navigating-pdf-page s.html

Wibu-Systems Copyright © 2/13/2023 3

CodeMeter Runtime - Installation

2 Installing CodeMeter Runtime

The following section contains installing and uninstalling information of the CodeMeter for different operating systems.
While installing it is not re quire d that a CmContainer is conne cte d to the computer.
· Windows 32-bit/64-bit 4
· macOS 8
· Linux 9

2.1 Installation on Windows

For Windows 32- and 64-bit a CodeMeter Runtime Kit installation program is available :
For installing the CodeMeter Runtime Kit start the re spe ctive installation program and follow the installation wiz ard.
The relevant pages cover:
· We lcome 4
· End-User License Agreement 4
· Installation Scope 5
· Custom Se tup 5
· Installing 7
W e lcome

You will be prompte d with the we lcome dialog of the wiz ard.

Confirm with "Next".

n
E d-U ser License Agreement
In the ne xt ste p, you must agree to the End User License Agreement. Please read it care fully and, if you acce pt the terms,
se le ct the "I accept the terms in the License A greement" che ckbox. Confirm this by clicking "Next".

4 Wibu-Systems Copyright © 2/13/2023

 Installing CodeMeter Runtime
Installation on Windows

Installation Scope
Se le cting the installation scope .

Confirm the se le ction by clicking on "Next".

Custom Setup
The next wizard page lists installable program functions.

Wibu-Systems Copyright © 2/13/2023 5

CodeMeter Runtime - Installation

Be side s the standard se le cte d functions you can select other functions for the installation.
Click on the icon in front of the re spe ctive entry. Then se le ct "Will be installed on local hard drive" from the menu that
displays.

For installe d functions, the re spe ctive re quire d hard disk space displays.
The following functions are offered for installation:
Function De scription
Ne twork Server CodeMeter licenses can be used from other computers. Port 22350 is used for TCP communication
(optional) and is entered in the Windows firewall.
During installation it can be de cide d whe ther CodeMeter License Server is se t up as a server in a
network environment and the associated TCP port 22350 is used. In the default case, CodeMeter
License Server is only available locally (local host).
This function can be selected in the installer and changed at any time by calling the installer again.
Alternative ly after the installation this is also possible via:
· CodeMeter WebAdmin
The "Settings | Server | Server Access" page allows for setting up CodeMeter in server environments
including ports.
· Profiling (re gistry-entry)
In the General se ction IsNetworkServer allows to se t whe ther CodeMeter License Server runs
as a network server in the network or not.
Please note , change s will only take e ffe ct when the CodeMeter License Server service is re starte d.
This can be done via the Windows Services Management or in CodeMeter Control Center via the
navigation entry "Action".
WibuShe llExtension This feature installs the WibuShellExtension DLL.
Library, which associate s certain file e xtensions with CodeMeter and adds conte xt menu commands
to Windows Explorer.

6 Wibu-Systems Copyright © 2/13/2023

 Installing CodeMeter Runtime
Installation on Windows

Function De scription
User He lp Code Me ter User He lp
The user help for the CodeMeter Runtime Kit is installed.
Automatic server search For re sponse s to a broadcast, port 22350 is use d on the ne twork client and server for UPD
communication and entere d in the Windows firewall.
In addition, an automatic search of ne twork servers is se t as standard during installation. This is
implemente d by a broadcast via UDP (User Datagram Protocol) (it is only 'listene d' during the server
search until the end of the UDP wait time is reache d) and the re lease of the associate d UDP port
22350 for communication in the Windows Firewall.
Remote acce ss to CodeMeter WebAdmin can optionally be set to allow remote access from other computers. Depending
We bAdmin on the se le cte d protocol, port 22352 or 22353 are use d for TCP communication. This make s
(optional) CodeMeter WebAdmin visible on the network and access can be allowed and set up.
In the de fault case , the port 22352 is use d for HTTP / TCP communication.
In the installer this function can be se le cte d and change d at any time by calling the installer again.
Alternative ly after the installation this is also possible via:
· CodeMeter WebAdmin
The page "Settings | Server | Server Access" allows for setting up CodeMeter in server environments
including ports.
The page "Settings | Basic | WebAdmin" allows settings that control local or remote access to
CodeMeter WebAdmin, select the desired protocol (HTTP or HTTPS), and specify any required
authentication data.
· Profiling (server.ini entry)
The CmWebAdmin service reads values from the CodeMeter service at startup. Among others also
the parame ter RemoteRead from the server.ini file . If you make change s, both service s must
be stoppe d be fore and re starte d after the change s.
Please procee d as follows:
1. Stop the service s:
CodeMeter service (service managent or via "CodeMeter Control Center | Action ").
CmWebAdmin service (service management).
2. Open the re gistry. Pre ss key combination [Windows] + [R] to open the dialog "Run ".
3. Type command regedit and confirm using [Enter].
4. Search for value [HKEY_LOCAL_MACHINE\SOFTWARE\WIBU-
SYSTEMS\CodeMeter\Server\CurrentVersion].
5. Se t parame ter in se ction [HTTP] RemoteRead to a value of 2 and save .
6. Re start the service s:
CodeMeter service (service managent or via "CodeMeter Control Center | Action ").
CmWebAdmin service (service management)
Installing
Confirm your se le ction by clicking "Next" and on the ne xt page click "Install".
Change s to the se se ttings can be made by calling up the installation package again. In the subse quent dialog, a change
installation is then possible via the "Change" button.
After confirming that you want to allow change s to your computer by the installation, the CodeMeter Runtime Kit will be installe d
and on the last page you confirm this by clicking on "Finish".
For quick acce ss to some basic actions please use the quicklinks.
2.1.1 Uninstalling on 32/64-bit Windows
1. Se le ct the "Software" option in the Windows System control start menu item.
2. Se le ct the "CodeMeter Runtime Kit" item and the "Remove" option
All CodeMeter file s as part of an installations package and re gistry entrie s are de le te d. Only the log and backup dire ctorie s
remain.

Wibu-Systems Copyright © 2/13/2023 7

CodeMeter Runtime - Installation

2.2 Installing on macOS

For macOS a CodeMeter Runtime Kit installation program is available :
File Desc ription

CmRuntimeUser.dmg holds all required CodeMeter runtime components

1. Open the CmRuntimeUser.dmg file .
In the window that opens you will see the icon of the program to be installe d CmInstall.pkg.
2. Double -click the program and follow the instructions of the installation wiz ard.

This installs CodeMeter Runtime with the default settings on your computer.
Optionally, additional options can be configure d:
Function De scription and Installation
Ne twork CodeMeter licenses can be used from other computers. Port 22350 is used for TCP communication.
Server It can be de cide d whe ther CodeMeter License Server is se t up as a server in a ne twork environment and the
associated TCP port 22350 is used. In the default case, CodeMeter License Server is only available locally (local
host).
After the installation this is possible via:
· CodeMeter WebAdmin
The "Settings | Server | Server Access" page allows for setting up CodeMeter in server environments including
ports.
· Profiling (server.ini-entry)
In the General se ction IsNetworkServer allows to se t whe ther CodeMeter License Server runs as a ne twork
server in the ne twork or not. This can be done in CodeMeter Control Center using the navigation entry "Action "
or via the commandline .
Please procee d as follows:
1. Stop deamon for CodeMeter:
o Open a terminal (Fin der | Applications | Utilities | Terminal).
o Type command cd /Library/LaunchDaemons/
o Type command sudo /bin/launchctl stop com.wibu.CodeMeter.Server
2. Open the file com.wibu.CodeMeter.Server.ini locate d at /Libray/Preferences in an e dito r.

3. Modify entry [General] IsNetworkServer=1 and save .

4. Start the deamo n fo r CodeMeter:

o Type command sudo /bin/launchctl start com.wibu.CodeMeter.Server

Remote CodeMeter WebAdmin can optionally be set to allow remote access from other computers. Depending on the
access se le cte d protocol, port 22352 or 22353 are use d for TCP communication. This make s CodeMeter WebAdmin
visible on the ne twork and acce ss can be allowe d and se t up.

8 Wibu-Systems Copyright © 2/13/2023

 Installing CodeMeter Runtime
Installing on macOS

Function De scription and Installation

CodeMeter In the de fault case , the port 22352 is use d for HTTP / TCP communication.
WebAdmin Alternative ly after the installation this is also possible via:
· CodeMeter WebAdmin
The page "Settings | Server | Server Access" allows for setting up CodeMeter in server environments including
ports.
The page "Settings | Basic | WebAdmin" allows settings that control local or remote access to CodeMeter
WebAdmin, select the desired protocol (HTTP or HTTPS), and specify any required authentication data.
· Profiling (server.ini entry)
The CmWebAdmin deamon reads values from the CodeMeter deamon at startup. Among others also the
parame ter RemoteRead from the server.ini file . If you make change s, both service s must be stoppe d
be fore and re starte d after the change s.
Please procee d as follows:
1. Stop the deamo ns fo r CodeMeter and CodeMeter WebAdmin :

o Open a terminal (Fin der | Applications | Utilities | Terminal).

o Enter command cd /Library/LaunchDaemons/
o Enter command sudo /bin/launchctl stop com.wibu.CodeMeter.Server
o Enter command sudo /bin/launchctl stop com.wibu.CodeMeter.WebAdmin
2. Open the file com.wibu.CodeMeter.Server.ini locate d at /Libray/Preferences in an e dito r.

3. Modify the entry [HTTP] RemoteRead=2 and save .

4. Start the deamo ns fo r CodeMeter and CodeMeter WebAdmin :

o Enter command cd /Library/LaunchDaemons/

o Enter command sudo /bin/launchctl start com.wibu.CodeMeter.Server
o Enter command sudo /bin/launchctl start com.wibu.CodeMeter.WebAdmin
For quick acce ss to some basic actions please use the quicklinks.
2.2.1 Uninstalling on macOS
To uninstall the CodeMeter Runtime Kit, proceed as follows:
1. R e -open the file CmRuntimeUser.dmg.

2. Double -click the program CmUninstall.mpkg and follo w the instructio ns of the wiz ard.

Alternative ly, in the command line enter the following command: $ sudo installer -
pkg /Volumes/CmRuntimeUser/CmUninstall.mpkg -target. Please note that path specification may vary.

2.3 Installing on Linux

For Linux operating systems different installation package s are available in common formats:
R PM (RedHat Package Format) DEB (Debian Package Format ) Packages e . g ., for Debian, Ubuntu.

Packages, e.g., for SuSe, Red Hat.

Package 32 bit 64 bit AMD64 32 bit 64 bit AMD64 32 bit ARMHF 64 bit ARMHF

Basis Basis

GLIBC and GLIBC 2.17 or GLIBC 2.17 or GLIBC 2.17 or GLIBC 2.17 or GLIBC 2.13 or GLIBC 2.17 or

Kerne l higher and Kernel higher and higher and higher and higher and higher and
3. x or higher Kerne l 3. x or Kerne l 3. x or Kerne l 3. x or Kerne l 4.9 or Kerne l 4.15 or

higher higher higher higher higher

CodeMeter CodeMeter- CodeMeter- codemeter_[Cod codemeter_[Cod CodeMeter Lite - CodeMeter Lite -
Runtime [CodeMeter- [CodeMeter- eMeter- eMeter- driver installer driver installer
contains all Version]. Version]. Version]. Version]. o n ly fo r s y stems only for systems
necessary [package [package [package [package without GUI without GUI
number].i386.r number].x86_64 number] number]
file s for the codemeter- codemeter-
pm .rpm _i386.deb _amd64.deb
end-user lite_[CodeMete lite_[CodeMete
alternatively: alternatively: alternatively: alternatively: r-Version]. r-Version].
CodeMeter Lite - CodeMeter Lite - CodeMeter Lite - CodeMeter Lite - [package [package
driver installer driver installer driver installer driver installer number] number]
_armhf.deb _arm64.deb

Wibu-Systems Copyright © 2/13/2023 9

CodeMeter Runtime - Installation

RPM (RedHat Package Format) DEB (Debian Package Format ) Packages e . g ., for Debian, Ubuntu.

Packages, e.g., for SuSe, Red Hat.

only for systems only for systems only for systems only for systems
without GUI without GUI without GUI without GUI
CodeMeter- CodeMeter- codemeter- codemeter-
lite- lite- lite_[CodeMete lite_[CodeMete
[CodeMeter- [CodeMeter- r-Version]. r-Version].
Version]. Version]. [package [package
[package [package number] number]
number].i386.r number].x86_64 _i386.deb _amd64.deb
pm .rpm
To install CodeMeter License Server, please proceed as follows:
1. Se le ct the de sire d installatio n package , and

2. Install the package as usual, e .g. she ll co mmand o r re spe ctive he lp programs.

rpm packages: [rpm -ivh CodeMeter-[CodeMeter-Version].[Package Number].i386.rpm]

deb packages: [dpkg -i CodeMeter-[CodeMeter-Version].[Package Number]_i386.deb]

This installs CodeMeter Runtime with the default settings on your computer.
Optionally, additional se ttings can be configure d:
Function De scription and Installation
Ne twork server CodeMeter license s can be use d from other computers. Port 22350 is use d for TCP communication.
It can be de cide d whe ther CodeMeter License Server is se t up as a server in a ne twork environment and the
associated TCP port 22350 is used. In the default case, CodeMeter License Server is only available locally (local
host).
After the installation this is possible via:
· CodeMeter WebAdmin
The "Settings | Server | Server Access" page allows for setting up CodeMeter in server environments
including ports.
· Profiling (server.ini-entry)
In the General se ction IsNetworkServer allows to se t whe ther CodeMeter License Server runs as a
network server in the network or not. This can be done in CodeMeter Control Center using the navigation
entry "Action" or via the commandline.
Please procee d as follows:
1. Stop deamon for CodeMeter:
o Open a terminal.
o Type command /etc/init.d/codemeter stop
2. Open the file com.wibu.CodeMeter.Server.ini locate d at /etc/wibu/CodeMeter/Server.ini in

an editor.
3. Modify entry [General] IsNetworkServer=1 and save .

4. Start the deamo n fo r CodeMeter:

o Type command /etc/init.d/codemeter start

Remote acce ss CodeMeter WebAdmin can optionally be set to allow remote access from other computers. Depending on the
to CodeMeter se le cte d protocol, port 22352 or 22353 are use d for TCP communication. This make s CodeMeter WebAdmin
WebAdmin visible on the ne twork and acce ss can be allowe d and se t up.
In the de fault case , the port 22352 is use d for HTTP / TCP communication.
Alternative ly after the installation this is also possible via:
· CodeMeter WebAdmin
The page "Settings | Server | Server Access" allows for setting up CodeMeter in server environments
including ports.
The page "Settings | Basic | WebAdmin" allows settings that control local or remote access to CodeMeter
WebAdmin, select the desired protocol (HTTP or HTTPS), and specify any required authentication data.
· Profiling (server.ini entry)

10 Wibu-Systems Copyright © 2/13/2023

 Installing CodeMeter Runtime
Installing on Linux

Function De scription and Installation

The CmWebAdmin deamon reads values from the CodeMeter deamon at startup. Among others also the
parame ter RemoteRead from the server.ini file . If you make change s, both service s must be stoppe d
be fore and re starte d after the change s.
Please procee d as follows:
1. Stop the deamo ns fo r CodeMeter and CodeMeter WebAdmin :

o Open a terminal (Fin der | Applications | Utilities | Terminal).

o Enter command cd /Library/LaunchDaemons/
o Enter command sudo /bin/launchctl stop com.wibu.CodeMeter.Server
o Enter command sudo /bin/launchctl stop com.wibu.CodeMeter.WebAdmin
2. Open the file com.wibu.CodeMeter.Server.ini locate d at /etc/wibu/CodeMeter/ in an e dito r.

3. Modify the entry [HTTP] RemoteRead=2 and save .

4. Start the deamo ns fo r CodeMeter and CodeMeter WebAdmin :

o Enter command cd /Library/LaunchDaemons/

o Enter command /etc/init.d/codemeter start
o Enter command /etc/init.d/codemeter-webadmin start
For quick acce ss to some basic actions please use the quicklinks.
2.3.1 Uninstalling on Linux
Exe cute the re spe ctive she ll command for uninstalling of the CodeMeter Runtime Kit:
· for RPM base d distributions, such as, Suse /R e dHat/Fe dora [rpm -e CodeMeter]
· for DEB base d distributions, such as, De bian/Ubuntu [dpkg -r CodeMeter]

Wibu-Systems Copyright © 2/13/2023 11