Windows

SMARTUNIFIER be delivered in two formats: as an executable (.exe) or as a ZIP archive.

Install SMARTUNIFIER Manager (Archived Package)

Follow the steps below to install SMARTUNIFIER Manager:

  • Move the SMARTUNIFIER installation package to a suitable location. Make sure the path to the directory does not include any white spaces!

  • Extract the .zip-archive.

  • Execute the UnifierManager.bat script. Afterwards the SMARTUNIFIER Manager Console appears on the screen.

  • Enter your master password. When starting SMARTUNIFIER for the first time go to chapter: Master Password and Administrator Account.

After successfully starting up the SMARTUNIFIER Manager, it can be accessed by opening an Internet Browser (e.g., Chrome or Firefox) and navigating to http://localhost:9000. Use the administrator credentials to login.

Note

The console is for information purposes only. It can be moved to any suitable location on your screen or it can be hidden. Nevertheless, do not close it, because the related processes will also be terminated.

Install SMARTUNIFIER Manager as a Service

Apache Procrun

SMARTUNIFIER includes Apache Procrun, a Windows tool that facilitates the installation and execution of Java applications as services. It simplifies the process by integrating the application with the Windows Service Control Manager.

Follow the steps below to install and operate SMARTUNIFIER Manager as a Service under Windows:

  • Move the SMARTUNIFIER installation package to a suitable location

  • Ensure that the directory path does not contain any white spaces

  • Extract the .zip-archive

  • Open a terminal window with Administrator privileges within the installation package

  • Execute the following commands in the terminal window to:

Install
UnifierManagerService.bat install
Start
UnifierManagerService.bat start
Stop
UnifierManagerService.bat stop
Uninstall
UnifierManagerService.bat uninstall

NSSM

Hint

SMARTUNIFIER does not offer official support for NSSM, unlike Apache Procrun. If you choose to use NSSM, you will need to download the NSSM binary separately.

Follow the steps below to install and operate SMARTUNIFIER Manager as a Service under Windows using NSSM:

  • Move the SMARTUNIFIER installation package to a suitable location

  • Ensure that the directory path does not contain any white spaces

  • Download the latest version of NSSM to a suitable location (Last tested with version 2.24)

  • Go to win64 and copy the nssm.exe in the installation package

  • Create the UnifierManagerService.bat file in the installation package

UnifierManagerService.bat
@echo off
cd %~dp0
set JAVA_HOME=%~dp0\jre
set JAVA=%JAVA_HOME%\bin\java.exe
set MANAGER=%~dp0\bin\adaptermanagerweb.bat
set JAVA_OPTS=-Dunifier.administrator.credentials.file="%~dp0/conf/credentials.properties"

del RUNNING_PID
"%MANAGER%"

  • Open a terminal window with Administrator privileges within the installation package

  • Execute the following commands in the terminal window to:

Install
nssm install SmartUnifierManager "UnifierManagerService.bat"
Start
nssm start SmartUnifierManager
Stop
nssm stop SmartUnifierManager
Uninstall
nssm remove SmartUnifierManager

Optional

Set SERVICE_AUTO_START
nssm set SmartUnifierManager Start SERVICE_AUTO_START