wydanie portable

Instalacja Portable

Rozpakuj paczkę, uruchom program i otwórz pierwszą konfigurację. Wszystkie składniki potrzebne do pracy są w zestawie. Dane są zapisywane oddzielnie od programu, w profilu użytkownika.

1. Pobranie i weryfikacja

Link do paczki przychodzi mailem razem z kluczem. Wybierz plik dla swojego systemu:

Oblicz sumę kontrolną pobranego pliku i porównaj ją z wartością w SHA256SUMS. W przykładzie zastąp nazwę paczki nazwą pobranego pliku:

# Windows (PowerShell)
Get-FileHash .\viewer-pro-portable-1.4.2-win-x64.zip -Algorithm SHA256

# Linux / macOS
shasum -a 256 viewer-pro-portable-1.4.2-linux-x64.zip

2. Rozpakowanie i uruchomienie

Rozpakuj paczkę do katalogu, w którym masz prawo zapisu. Nie potrzebujesz uprawnień administratora. Następnie uruchom skrypt dla swojego systemu:

# Windows
C:\Narzedzia\viewer-pro\viewer-pro.cmd

# Linux / macOS (za pierwszym razem nadaj prawo wykonania)
chmod +x ./viewer-pro.sh
./viewer-pro.sh

Skrypt uruchamia program pod adresem 127.0.0.1 na wolnym porcie i otwiera domyślną przeglądarkę. Dostęp jest możliwy tylko z tego komputera. Zamknięcie terminala zatrzymuje program; baza PGlite zapisuje dane na bieżąco.

Windows SmartScreen może zapytać o nieznanego wydawcę przy pierwszym uruchomieniu node.exe z paczki. Node w środku jest pobrany z nodejs.org i zweryfikowany sumą SHA przy budowie paczki; suma jest w manifest.json.

macOS Gatekeeper: jeśli system odmówi uruchomienia, zdejmij atrybut kwarantanny: xattr -dr com.apple.quarantine ./viewer-pro.

3. Klucz licencji

Najprościej wkleić klucz w ustawieniach programu. Możesz też przekazać go przez zmienną środowiskową lub plik. Zmienna ma pierwszeństwo przed kluczem zapisanym w ustawieniach.

  1. Ustawienia → Licencja → wklej WCR1.… → „Aktywuj”. Program łączy się z serwerem licencji i zapisuje potwierdzenie ważne przez 30 dni, nazywane dzierżawą.
  2. Zmienna WEBCON_LICENSE ustawiona przed startem skryptu.
  3. Zmienna WEBCON_LICENSE_FILE ze ścieżką do pliku zawierającego sam klucz.
# Windows - na stale dla uzytkownika
setx WEBCON_LICENSE "WCR1...."

# Linux / macOS - w ~/.profile
export WEBCON_LICENSE="WCR1...."

Płatny klucz jest przypisany do wydania Portable lub Server. Licencja Portable obejmuje dwie aktywacje, np. na laptopie i komputerze zapasowym tej samej osoby. Instalację identyfikują komputer i konto użytkownika. Przed przeniesieniem programu lub zmianą nazwy komputera zwolnij aktywację: Ustawienia → Licencja → „Dezaktywuj”. W sieci bez internetu skorzystaj z aktywacji offline.

Standardowy plan Portable obejmuje jedną osobę, jedną przestrzeń roboczą i cztery środowiska. Do limitu wlicza się środowisko z co najmniej jedną migawką. Po wykorzystaniu limitu program zablokuje dodanie kolejnego środowiska, zachowując dostęp do historii. Odłączenie środowiska zwalnia miejsce i pozostawia jego dane do odczytu. W okresie próbnym limity przestrzeni i środowisk nie obowiązują. Jeśli potrzebujesz większego zakresu po testach, zapytaj o wydanie Server.

4. Katalog danych i kopie zapasowe

systemkatalog danych (domyślny)
Windows%LOCALAPPDATA%\ViewerPro
Linux~/.local/share/viewer-pro
macOS~/.local/share/viewer-pro

Program przechowuje dane w lokalnej bazie PGlite. Aby wskazać inny katalog, np. na szyfrowanym dysku lub w projekcie klienta, ustaw WEBCON_DB przed uruchomieniem:

set WEBCON_DB=D:\Projekty\klient-A\viewer-pro
viewer-pro.cmd

Możesz używać kilku niezależnych katalogów danych na tym samym komputerze i koncie użytkownika. Nadal zajmują jedną aktywację. Kopię zapasową wykonuj przy wyłączonym programie, kopiując cały katalog danych. Hasła źródeł SQL i klucze AI są przechowywane osobno w magazynie systemowym (DPAPI / Keychain / libsecret). Kopia katalogu danych ich nie zawiera.

5. Wczytaj pierwszą konfigurację

Paczki .bpe

Wyeksportuj aplikacje z Designer Studio — każdą do osobnej paczki. Komplet paczek z jednego środowiska tworzy migawkę, czyli zapis konfiguracji z danego momentu. W Spectrum otwórz Workspace, nazwij przestrzeń roboczą i wybierz „Nowe środowisko”. Podaj jego nazwę (np. DEV, TEST lub PROD), rodzaj i host. Następnie przejdź do Importu i wskaż pliki.

Większą liczbę paczek możesz zaimportować jednym poleceniem:

viewer-pro.cmd ingest import "C:\eksport\DEV\*.bpe" --workspace "Klient A" --env DEV

Bezpośredni odczyt z bazy WEBCON

Otwórz Źródła SQL → „Nowe źródło”. Podaj serwer, nazwę bazy (np. BPS_Content) i sposób logowania. Wybierz „Testuj połączenie”, aby sprawdzić dostęp i zgodność schematu. Następnie użyj „Wczytaj konfigurację”, aby zapisać migawkę. W Portable pobieranie uruchamiasz ręcznie; harmonogram jest dostępny w Server.

Windows Authentication wymaga sterownika ODBC i systemu Windows. Logowanie SQL, NTLM z hasłem i Microsoft Entra ID są dostępne na wszystkich obsługiwanych systemach.

6. Aktualizacja

  1. Zamknij program i wykonaj kopię katalogu danych.
  2. Rozpakuj nową wersję do osobnego katalogu. Dane pozostają w dotychczasowej lokalizacji.
  3. Uruchom nową wersję. Program automatycznie zaktualizuje strukturę bazy, zachowując migawki. Jeśli potrzebne będzie ponowne przeliczenie danych pochodnych, wyświetli propozycję uruchomienia ingest refresh.

Nowa wersja musi mieścić się w opłaconym okresie aktualizacji. Jeśli jest późniejsza, program wyświetli komunikat o licencji. Możesz odnowić okres aktualizacji i wsparcia lub korzystać z uprawnionej wersji. Po migracji bazy powrót do starszego programu wymaga przywrócenia kopii danych sprzed aktualizacji.

Gdy coś nie działa