Instalacja

1. Wymagania sprzętowe

1.1 System

- - Minimalne: Windows Server 2012 R2, Windows 7
  - Zalecane: Windows Server 2019 lub nowszy

1.2 Oprogramowanie

W zależności od trybu uruchomienia Wizlink License Broker - jako usługa Windows lub pod kontrolą IIS, wymagane są dodatkowe składniki oprogramowania.

- - .NET Runtime 8.x (lub nowszy) (dla Usługi Windows)
  - ASP.NET Core 8.x Hosting Bundle (dla IIS)

Oprogramowanie można pobrać ze strony https://dotnet.microsoft.com/en-us/download/dotnet/8.0

1.3 Przeglądarka internetowa

- - Google Chrome 80 lub nowsza
  - Firefox 72 lub nowsza
  - Opera 66 lub nowsza
  - Microsoft Edge 79 lub nowsza
  - Safari 13 lub nowsza
  - Internet Explorer – nieobsługiwana

Wymagana jest włączona obsługa JavaScript w przeglądarce.

Uwaga: Przeglądarka Firefox domyślnie nie pozwala na wyświetlanie zasobów z niezabezpieczonych źródeł. Aby korzystać z panelu WLB z użyciem tej przeglądarki wymagane będzie dodanie certyfikatu.

2. Wizlink License Broker

2.1 Wstępna konfiguracja i Szybki Start

W tej sekcji opisano jak zainstalować i próbnie uruchomić WLB z wiersza polecenia. Jest to przydatne na potrzeby konfiguracji i testów, ale w środowisku produkcyjnym zalecamy uruchomienie środowiska jako Usługę Windows, lub pod kontrolą IIS.

W tej sekcji opisano jak zainstalować i próbnie uruchomić WLB z wiersza polecenia

1. Wypakuj pliki oprogramowania Wizlink License Broker do wybranej lokalizacji na dysku twardym.

2. W edytorze tekstowym otwórz plik konfiguracji o nazwie appsettings.json

3. Uzupełnij sekcje:

a. AuthorizedGroups – pozwala użytkownikom windowsowym przynależącym do konkretnej grupy zalogować się do panelu licencji

"AuthorizedGroups": ["BUILTIN//Użytkownicy"]

Aby dodać więcej, niż jedną grupę

"AuthorizedGroups": ["Użytkownicy", "group1", "group2"]

Uwaga: "BUILTIN//Users" to domyślna lokalna grupa systemu Windows (oznaczona prefiksem BUILTIN). Nazwa grupy może się różnić w zależności od wersji językowej systemu Windows. Nazwę można zweryfikować na przykład poprzez sprawdzenie, do jakich grup należy aktualnie zalogowany użytkownik, używając polecenia

whoami /groups

w wierszu poleceń.

Uwaga: Od wersji 2.5.1.10 prefiks nie jest wymagany, nie jest także sprawdzana wielkość liter. Grupy mogą byś dodawane i usuwane z pola AuthorizedGroups bez konieczności ponownego uruchomienia aplikacji.

b. LicenseLocation - folder w którym przechowywane będą pliki licencji. Domyślnie licencje znajdą się w "%programdata%/WizlinkLicenseBroker/Licenses"

c. Url - adres IP pod jakim będzie widoczna usługa i który należy wprowadzić do Wizlink Designera i/lub Runtime, aby umożliwić oprogramowaniu połączenie się z serwerem licencji. Domyślnie jest to http://0.0.0.0:5274 (lub :5275, w zależności od wersji). W środowisku produkcyjnym radzimy wybrać port alternatywny i uruchomić serwis z adresem http://[TWOJE_IP]:[TWÓJ_PORT]

Uwaga: Ta sekcja odnosi się tylko do WLB, które domyślnie ma być uruchomione jako Usługa Windows lub lokalnie, w wierszu polecenia. IIS narzuci własne ustawienia.

Uwaga: Aby WLB działało prawidłowo konieczne może być wejście w ustawienia zapory Windows i otwarcie wybranego portu dla ruchu zarówno przychodzącego, jak i wychodzącego.

4. Zapisz zmiany w pliku appsettings.json

5. Uruchom Terminal, PowerShell lub wiersz poleceń (CMD) jako Administrator i ustaw bieżącą ścieżkę tak, aby wskazywała lokalizację plików WLB.

6. Uruchom serwer WLB poprzez uruchomienie pliku WizlinkLicenseBroker.exe

7. Zaloguj się do panelu zarządzania wpisując adres http://[TWOJE_IP]:[TWÓJ_PORT] w przeglądarce internetowej, a następnie wprowadzając dane logowania do konta Windows należącego do jednej z wcześniej autoryzowanych grup.

2.2. Usługa Windows (Windows Service)

Tworzenie usługi Windows Service

1. Skopiować pliki Wizlink License Broker do wybranej ścieżki (przykładowo C:\WLB)

2. Uruchomić PowerShell z uprawnieniami administratora. Wykonać komendę Power Shell – komenda utworzy Usługę Windows w systemie:

New-Service -Name WLB -BinaryPathName "C:\WLB\WizlinkLicenseBroker.exe" -StartupType Automatic -Description "Wizlink License Broker"

Dokumentacja komendy New-Service dla PowerShell 7.2: https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/new-service?view=powershell-7.2

Uruchomienie usługi

Wykonać komendę Power Shell – komenda uruchomi usługę Windows:

Start-Service WLB

Do panelu Wizlink License Broker można się teraz zalogować wpisując adres http://[TWOJE_IP]:[TWÓJ_PORT] w przeglądarce internetowej.

Usunięcie usługi

Aby usunąć stworzoną usługę należy najpierw zatrzymać ją za pomocą komendy Power Shell

Stop-Service -Name "WLB"

A następnie usunąć, za pomocą komendy

Remove-Service -Name "WLB"

2.3. Menedżer IIS (Internet Information Services)

Konfiguracja funkcji systemu Windows

Aby możliwe było korzystanie z menedżera IIS, należy najpierw aktywować tę usługę. W tym celu należy przejść do menu Panel Sterowania -> Programy -> Włącz lub wyłącz funkcje Systemu Windows i aktywować Konsolę zarządzania usługami IIS

- Internetowe usługi informacyjne -> Narzędzia zarządzania siecią Web -> Konsola Zarządzania usługami IIS

Aby Wizlink License Broker mógł korzystać z funkcji Uwierzytelniania Systemu Windows, konieczne jest też włączenie jej

- Internetowe usługi informacyjne -> Usługi WWW -> Zabezpieczenia -> Uwierzytelnianie Systemu Windows

Dla poprawnego działania Wizlink License Broker konieczna jest także włączenie Protokołu Websocket

- Internetowe usługi informacyjne -> Usługi WWW -> Funkcje Tworzenia aplikacji -> Protokół WebSocket

Konfiguracja dostępów puli użytkowników

Upewnić się, że pula użytkowników, która ma mieć dostęp do tworzonej witryny może zarządzać jej folderami źródłowymi.

1. Dla przykładowego folderu C:\WLB do którego wypakowane zostały pliki Wizlink License Broker i domyślnej puli IIS: DefaultAppPool wejść w jego Właściwości -> Zabezpieczenia, a następnie nacisnąć Edytuj

2. W następnym oknie nacisnąć Dodaj

3. W następnym oknie wprowadzić IIS AppPool\DefaultAppPool jako nazwę obiektu, nacisnąć Sprawdź nazwy i zatwierdzić zmiany

4. Dodanej grupie DefaultAppPool nadać pełną kontrolę nad folderem źródłowym i zatwierdzić zmiany

Tworzenie usługi IIS

1. Otworzyć Menedżera Internetowych Usług Informacyjnych (IIS)

2. W panelu po lewej (‘Połączenia’) kliknąć prawym przyciskiem myszy na serwer i wybrać z menu kontekstowego Dodaj Witrynę Sieci Web

3. Uzupełnić parametry tworzonej witryny

Przykładowo:

Nazwa Witryny: WLB_TEST
Pula aplikacji: Wybierz -> DefaultAppPools

Ścieżka do folderu z Wizlink License Broker: C:\WLB
Powiązanie: (http / wszystkie nieprzypisane / 90)

4. Upewnić się, że dla stworzonej witryny włączone jest Uwierzytelnianie systemu Windows.

W celu włączenia uwierzytelniania dla stworzonej witryny należy w menu po lewej kliknąć na nazwę witryny, w środkowym panelu z grupy IIS wybrać Uwierzytelnianie, a następnie upewnić się, że Uwierzytelnianie systemu Windows jest włączone.

5. Upewnić się, że dla puli aplikacji, do której przypisana jest usługa Wizlink License Broker włączone jest ładowanie profilu użytkownika.

W celu włączenia ładowania profilu użytkownika dla puli aplikacji należy w panelu po lewej kliknąć na Pule aplikacji, kliknąć ponownie na właściwą pulę aplikacji a następnie wybrać Ustawienia zaawansowane z prawego panelu. W grupie Model Procesów ustawić wartość True dla ustawienia Załaduj profil użytkownika.

Aby wprowadzić zmiany należy zatwierdzić przyciskiem OK i zrestartować pulę aplikacji.

6. Do panelu Wizlink License Broker można się teraz zalogować wpisując adres http://[TWOJE_IP]::[TWÓJ_PORT]/ w przeglądarce internetowej (w przykładzie użyto portu 90)