Installation, License and Help

Installation, activation with a license code, demo license, connection problems, license-dependent workspaces, updates, Linux desktop integration and help.

VICUS Districts Page 2 of 2 in this chapter

Overview

VICUS requires a license; which workspaces are usable depends on the license. This page describes the installation, activation via license code, requesting a demo license, the behaviour on connection problems, checking for updates, desktop integration on Linux, and the help and information functions.

Installation

On Windows, VICUS is set up with a digitally signed installer. To update an older version, simply install the new version on top of the old one; your settings and projects are kept. Before doing so, however, back up your own materials, climate data or examples, especially if you have changed them within the installation directory.

Workspaces and license

VICUS knows the two workspaces Building and Heat Network, which are switched on and off via the menu View › VICUS Workspaces (see User Interface and Navigation). Which of them are available is determined by the license:

  • A Districts license unlocks the Heat Network workspace, a Buildings license the Building workspace, and a Master license both.
  • If only one workspace is available, the respective other menu entry is disabled and cannot be switched on.
  • Depending on the District license tier, the maximum network size (number of consumers connected via transfer stations) and the dynamic network simulation are additionally unlocked.

Entering license information (activation)

The menu Help › Enter license information… opens the Software activation dialog. If no valid license is present at startup, this dialog appears automatically.

AreaContent
User/licenseMandatory fields Name (*) and E-mail (*) as well as – optionally – the name of the company. This information is required for the request and activation.
Request demo licenseTwo buttons request a time-limited but otherwise fully functional demo license – Request demo license for VICUS BUILDINGS or … for VICUS DISTRICTS.
Software activationPaste an already purchased license/activation code into the text field and click Activate software.

During activation and when requesting a demo license, VICUS briefly contacts the activation server. On success, the dialog reports The software was activated successfully.

Checking the connection to the activation server

If no connection to the activation server can be established during activation, the Checking for internet connectivity dialog opens. It checks, one after the other, the Connection to common webserver, the Connect to activation service step and the Encrypted handshake with activation service. Each step shows whether it succeeded; the diagnostic details name the server, the port and the certificate received. This makes it clear whether the internet connection is missing, a firewall blocks the port or a proxy intercepts the encrypted connection. Retry check runs the check again, e.g. after the firewall rules have been changed.

Invalid or expired activation

If the activation is invalid or has expired at program start and cannot be renewed automatically, the VICUS Software Activation dialog appears with the Error code and the following options:

ButtonEffect
Retry online activationRequests the activation from the server again.
Enter license/activation information…Opens the Software activation dialog, e.g. to paste a new activation code.
10 minute emergency sessionStarts VICUS for 10 minutes, for instance to save a project; the program is then closed.
Quit applicationCloses VICUS.

If your system is protected by a firewall, an outgoing TCP connection via port 5058 must be allowed so that VICUS can reach the activation server.

Checking for updates

The menu Help › Check for updates… checks on request whether a newer version is available – VICUS does not check automatically. If an update is available, a notice appears with a change list and download option; otherwise the message that no update is currently available for this software and this operating system. The same check is also accessible via the start screen.

Desktop integration (Linux)

The menu Help › Desktop integration (Linux)… sets up an application shortcut (.desktop file) on Linux and registers the file association for .vicus project files. Afterwards VICUS appears in the application menu and project files can be opened by double-clicking. The changes take effect after the next login.

Help and information

Menu entryFunction
Online manual…Opens this manual in the web browser
Keyboard and mouse control… (F1)Brief overview of the key and mouse assignments, see Keyboard and mouse
About VICUS…Version and build status, the license data (license type, validity, name, e-mail) as well as the licenses of the third-party components used
About Qt…Information on the underlying Qt library

The menu entries Send a feature request or bug report… and Visit website with discussion forum… are disabled in the current version.

Stay up to date

New features, tutorials and updates delivered to your inbox.