logo

Advanced documentation

Introduction

This document is intended primarily for the system administrator. It gives details about the installation, update and deinstallation procedures, with error codes.

Firewall

A firewall is a part of a computer system or network that is designed to block unauthorized access while permitting authorized communications. You may either completely open the firewall, i.e. remove the firewall, or only allow a specific signal to pass through the firewall, a firewall pinhole.

Remove the firewall under Windows XP:

  1. Open the Firewall control panel via › Start › Control Panel › Windows Firewall ›, or by typing “firewall.cpl” in the Run command on Start menu.
  2. Turn off the firewall.

Remove the firewall under newer Windows:

  1. Open the “Windows Firewall with Advanced Security” dialog via the ‹Windows logo› Control Panel › System and Security › Windows Firewall › Advanced settings › or by typing “wf.msc” in the Run command on Start menu.
  2. In the left pane, click “Windows Firewall with Advanced Security on Local computer”.
  3. In the “Action” pane on the right, click “Properties”.
  4. Turn off the firewall for the desired profile.

Firewall pinhole under Windows XP:

  1. Open the Firewall control panel via › Start › Control Panel › Windows Firewall ›, or by typing “firewall.cpl” in the Run command on Start menu.
  2. Define a port exception:
    • select the “Exceptions” tabsheet
    • click [Add a port]
    • type “Aladdin” for the name, type “3047” for the port select “UDP” for the protocol.

Firewall pinhole under newer Windows:

  1. Open the “Windows Firewall with Advanced Security” dialog via the ‹Windows logo› Control Panel › System and Security › Windows Firewall › Advanced settings › or by typing “wf.msc” in the Run command on Start menu.
  2. Define a new Inbound Rule:
    • in the left pane, click “Inbound Rules” ;
    • in the “Action” pane on the right, click “New Rule” ;
    • select “Port” for the type of rule, then click [Next]
    • select “UDP” for the protocol and “Specific local port”, type “3047”, then click [Next]
    • select “Allow” for the action mode, then click [Next]
    • check box of the profile you want to extend, then click [Next]
    • type “Aladdin” for the name, then click [Finish].

Note: by default, the Outbound connections are set to “Allow (default)” and the Inbound connections are set to “Block (default)” which means that, without a specific rule, a signal can not reach your computer, but your computer can always send any kind of signal to other computers.

 

“HL-Server” service & DEP (mainly with Windows 64)

Data Execution Prevention (DEP) is a security feature included in modern Microsoft Windows operating systems that is intended to prevent an application or service from executing code from a non-executable memory region.

By default, on Windows 64 systems, DEP will prevent the “HL-Server” service from starting. The solution is to define an exception for the “HL-Server” service in the Performance Options panel.

  1. Access the System Properties panel via › Start › Control Panel › System ›.
  2. Select the “Advanced” tabsheet.
  3. Open the Performance Options panel with a click onto the [Parameters] button under “Performances”.
  4. Select the “Data Execution Prevention” tabsheet.
  5. Click [Add…].
  6. Select the “hls32svc.exe” file under “%WINDIR%\SYSwow64”.
  7. Click [Apply] in the Performance Options panel.
  8. Open the Windows Services panel to start the “HL-Server” service.

Note: “%WINDIR%” is usually “C:\Windows”, and the file to select is then “C:\Windows\SYSwow64\hls32svc.exe”.

 

Setup Error codes

0: sucessfully completed, everything's fine.

3: can not define the uninstall record in the registry

12: can not overwrite a configuration file in the CubusShared folder; most probably, a CFG file is write protected, or you don't have the priviledges to modify this file

13: see 12

15: can not overwrite the main configuration file CUBUS.CFG in the CubusShared folder; most probably, this CFG file is write protected, or you don't have the priviledges to modify this file

16: see 12

20: can not create the start menu

30: a global path on the application server for a Cubus application is undefined or not valid

35: see 15

50: no licence preset on the application server

60: unknown entry in Admin.CFG for the line “PRESELECTEDLICENCES”

100: can not or no more read a ZIP file from the Cubus distribution medium

101: invalid CubusShared path; most probably, the main configuration file CUBUS.CFG is missing

102: the installation has first to be configured from the CubusNetworkManager on the application server

103: administrator privileges are necessary for the auto mode

104: the auto mode can only be started on a client, not on the application server

110: the ZIP file read is damaged and can not be properly expanded

120: not enough memory to expand the ZIP files

130: internal error (error calling the ZIP files expanding routine)

140: internal error (no file parameter for the selected ZIP files routine)

150: hard disk is full, the selected ZIP file can not be properly expanded

160: the selected ZIP file is damaged (end of file reached unexpectedly)

180: the requested library XCDUNZ32.DLL (or XCDZIP32.DLL) is used by another process and is therefore not available; stop all running applications, a restart of your system may help

190: the current operation on a ZIP file has been interrupted by the user

201: the license presetting can not be saved

301: internal error (undefined Admin.CFG path)

240: the XCDZIP32.DLL and XCDUNZ32.DLL libraries, requested for the ZIP files expanding routines, are not available

250: internal error (ZIP file operation)

280: temporary folder error during ZIP files expanding

290: error reading the ZIP file

300: error writing ZIP file

302: can not save the Admin.CFG file; most probably, this CFG file is write protected, or you don't have the priviledges to modify this file

303: can not find a Cubus application CFG file

304: can not find the executable file

305: a global path on the application server for a Cubus application is undefined or not valid; check the path in the CubusNetworkManager on the application server

310:  Fehler beim Erzeugen der Dateien und Ordner zum Extrahieren von Dateien aus den ZIP-Dateien. Stellen Sie sicher, dass Sie alle nötigen Rechte haben um Dateien in die Programmordner (inkl. CubusShared-Ordner) zu schreiben und dort auch zusätzliche Unterordner zu erzeugen.

400: can not or no more fully read the selected ZIP file

401: no licence preset on the application server; can be recovered on the application server

501: can not determine the installed hardlock drivers version

510: can not create the requested folders to expand the ZIP files; check the access priviledges

1000-1999:  Windows Fehlermeldung (Offset 1000) beim Erzeugen eines Ordners zum Installieren der Programme. Prüfen Sie, ob Sie während der Installation alle nötigen Rechte haben um in den für die Installation gewählten Ordnern neue Unterordner erstellen zu können.

2000: (xsrFileNotFound) ZIP file corrupted; please contact the Cubus Hotline

2001: (xsrBadVersion) ZIP file corrupted; please contact the Cubus Hotline

2002: (xsrBadCrc) error reading the ZIP file from the Cubus distribution medium; please check the integrity of your Cubus distribution medium

2003: (xsrUpToDate ) ZIP file corrupted; please contact the Cubus Hotline

2004:  (xsrUnableToOpen): Die angegebene Datei konnte nicht extrahiert werden. Dies kann der Fall sein, wenn die Datei von einem laufenden Programm benutzt oder ausgeführt wird oder wenn ein Virenschutzprogramm gleichzeitig die Datei prüfen will. CubusSetup nochmals starten und prüfen ob die Meldung für dieselbe Datei wieder auftritt.

2006: (xsrBadData) error reading the ZIP file from the Cubus distribution medium; please check the integrity of your Cubus distribution medium

2007: (xsrOverwrite) ZIP file corrupted; please contact the Cubus Hotline

2005: (xsrBadPassword) ZIP file corrupted; please contact the Cubus Hotline

-100:  Der alte, ungenügende Hardlocktreiber kann nicht entfernt werden.

-101:  Es sind Administratorenrechte nötig um den Hardlocktreiber zu entfernen.

-102:  Es laufen auf der Maschine noch andere Prozesse welche den Hardlocktreiber verwenden. Dieser kann deshalb nicht automatisch entfernt werden.

-103:  Die zur Installation des Hardlocktreibers nötige DLL ist nicht auffindbar oder kann nicht geladen werden (CubusShared\Aladdin\HInstD.DLL).

-151:  Die Schreibrechte einiger Dateien welche der Hardlocktreiber verwendet und welche sich im System befinden (Windows\System32) können nicht geändert werden.

-152:  Einige temporäre Dateien welche der Hardlocktreiber verwendet und welche sich im System befinden (Windows\System32) können nicht gelöscht werden.

-153:  Einige Dateien welche der Hardlocktreiber verwendet und welche sich im System befinden (Windows\System32) können nicht gelöscht werden. A 9 Anhang

-154:  Einige Dateien welche der Hardlocktreiber verwendet und welche sich im System befinden (Windows\System32) können nicht umbenannt werden.

-200: can not install properly the new Hardlock drivers

  © 2026 Cubus AG, Zürich