Installation
**************

To install TreeSize, execute the setup file and follow the instructions. TreeSize requires Windows 10 Version 1809, Server 2016 Version 1607, or upwards as well as .Net framework 4.8, which will be installed automatically when missing.

The setup program will copy the necessary files to your hard drive and will create a new program group in the Start menu/screen.

You will find the installation key for the registered version on the license document (PDF) sent to you after the purchase. During your maintenance period the key will be provided in the `customer area <https://customers.jam-software.de/?language=EN>`_.

TreeSize can be uninstalled using the Software applet in the Windows Control Panel. A portable installation on USB removable device can be created using the ribbon bar "Tools".

Unattended Installation
=========================

To perform a silent and automatic installation with the default settings, start the EXE-based installer with the command line parameters:

.. code-block::

    /SILENT /SUPPRESSMSGBOXES /PASSWORD=YourInstallKey
   
Please replace `YourInstallKey` with the installation key that you received after your registration.

Using `/VERYSILENT` instead of `/SILENT` will prevent any visual feedback.

The option `/DIR="x:\\dirname"` can be used to override the default install path.

Roll-out on various work stations
---------------------------------

If you want to roll-out TreeSize on multiple work stations (25 and more licenses), you can `download a 64Bit MSI installer <https://customers.jam-software.de/?language=EN>`_.

To perform a silent and unattended installation using the MSI-Installer, you need to use a command line like this for MsiExec:

.. code-block::

    msiexec /qn /i "TreeSize-x64-Full-EN.msi" INSTALLATION_KEY="XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX"

Please prefix the MSI file with the path of the network share, in which the MSI file is stored, and adjust the installation key.

You may also set the property `INSTALLATION_KEY` by modifying the MSI file using a `tool like Orca <https://learn.microsoft.com/de-de/windows/win32/msi/orca-exe?redirectedfrom=MSDN>`_.

Activation
----------

TreeSize needs to be activated for each user and device it is used on. This usually happens in the background automatically by calling our activation server at https://api.jam-software.de. In environments with no internet access, the activation can be achieved manually by uploading an activation request from another PC and transferring the activation response back to the system to activate.

Customers with 25 or more licenses can reuse their activation response on several systems to avoid having to perform all activation steps on every single system. To deploy the activation response along with the installation, please copy it to an accessible storage location (might be a network path or a fix path on the target device) and provide the path to the file to the installer. To perform the activation after the installation, you might also call the LicenseManager.exe directly:

* For the EXE-based installer, append the switch ``/ACTIVATIONRESPONSE <Path>``
* For the MSI installer, append the parameter ``ACTIVATIONRESPONSE="<Path>"``
* To perform the activation at any point after the installation, call the LicenseManager.exe located in the installation directory: ``LicenseManager.exe license activate --activationResponse <Path>``

Default Settings
==================

TreeSize stores its settings in the user profile by default. If there are no options stored yet, e.g. for the first start of the application, default settings will take effect.

You can adjust these default settings system-wide by creating entries in the Windows registry for each setting at `HKEY_LOCAL_MACHINE\\Software\\JAM Software\\TreeSize`.

To simplify this configuration, we provide `administrative templates for the Group Policy Editor <https://www.jam-software.com/redirects?ADMX>`_.