Initial version

README.md

@@ -0,0 +1,10 @@
+# Dokumentacija programskega paketa Amebis Besana
+
+## Vsebina tega repozitorija
+
+- Navodila za administratorje:
+    - [Namestitev](admin/Install.md)
+    - [Samoposodabljanje](admin/Update.md)
+    - [Odstranitev](admin/Uninstall.md)
+- [Changelog](Changelog.md) - Spisek sprememb
+- [Splošni pogoji](Splosni%20pogoji.rtf) - Splošni pogoji med uporabnikom programskega paketa in izdelovalcem, pogoj za uporabo programskega paketa

admin/Install.md

@@ -0,0 +1,158 @@
+# Namestitev
+
+## Namestitev programskega paketa
+
+Namestitvene datoteke so objavljene na naslovu [https://prenos.amebis.si/Besana](https://prenos.amebis.si/Besana).
+
+Integriteto prenesenih datotek preverite tako, da poleg prenesene datoteke prenesete še istoimensko datoteko s končnico `.minisig` in v ukazni vrstici uporabite naslednji ukaz:
+
+```bat
+minisign -Vm "<ime datoteke>" -P RWRPrtnepBgoU86pKtSnHJXBtmtJjv6T5wN2Q+P7vPgHPdr3v8kGme13
+```
+
+Orodje Minisign lahko prenesete na [https://jedisct1.github.io/minisign/](https://jedisct1.github.io/minisign/).
+
+### Windows, MSI
+
+Za namestitev programskega paketa uporabljamo datoteke MSI. Priporočamo prenos datotek MSI na svoj LAN. Programski paket namestimo (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+msiexec /i "\\distsrv\share\Besana.x64.msi" /l* "%TEMP%Besana.x64.log" /qb /norestart
+```
+
+`/l* "%TEMP%Besana.x64.log"` v začasno mapo uporabnika, ki izvaja zgornji ukaz, zapiše dnevnik namestitve.
+`/qb` pomeni minimalen uporabniški vmesnik, ki ničesar ne sprašuje. Ukazna vrstica počaka na dokončanje namestitve, preden nadaljuje. Ukazu lahko po želji sledi `if errorlevel ...`.
+`/norestart` preprečuje samodejni ponovni zagon. Če je potreben ponovni zagon, msiexec konča s kodo 3010. Vendar programski paket ne bo deloval v celoti, dokler uporabnik ponovno ne zažene svojega računalnika.
+
+Z dodatnimi parametri - javnimi spremenljivkami MSI, ki jih dodajamo vedno na konec ukazne vrstice `msiexec` lahko natančneje upravljamo postopek namestitve oz. nadgradnje.
+
+#### Parameter `POSREDNIK=hostname[:port]`
+
+Nastavimo omrežno preverjanje licenc z Amebisovim posrednikom licenc. Kot ime računalnika, na katerega smo namestili Posrednik licenc, lahko navedemo ime računalnika, FQDN, IPv4, [IPv6] (v oglatih oklepajih). Privzeta vrata so 321 (vedno TCP).
+
+```bat
+msiexec /i "\\distsrv\share\Besana.x64.msi" /qb POSREDNIK=10.1.1.5
+```
+
+#### Parameter `KODALICENCE=nnn-nnn-nnn-nnn-nnn`
+
+Nastavimo lokalno licenco. Kodo licence smo dobili ob nakupu.
+
+```bat
+msiexec /i "\\distsrv\share\Besana.x64.msi" /qb KODALICENCE=123-456-789-012-345
+```
+
+#### Parametra `PROXYUP=username` in `PROXYGE=password`
+
+Nastavimo uporabniško ime in geslo, če za dostop do spleta HTTP uporabljamo proksi, ki potrebuje avtentikacijo.
+
+```bat
+msiexec /i "\\distsrv\share\Besana.x64.msi" /qb PROXYUP=janez PROXYGE="moje geslo 123"
+```
+
+Uporabo odsvetujemo! Uporabniško ime in geslo se shranita v register v nekodirani obliki.
+
+### Windows, EXE
+
+Uporabniki, ki ne vedo vnaprej, katere arhitekture je računalnik, lahko uporabijo tudi priloženo datoteko EXE. V datoteki EXE je preprost programček, ki ugotovi arhitekturo. Če je datoteka MSI ustrezne arhitekture na istem imeniku kot datoteka EXE, jo zažene. Sicer pa jo prenese s spleta, preveri digitalni podpis in jo zažene. Nastavljanje parametrov, kot pri ukazu `msiexec` v poglavju [MSI](#windows-msi) trenutno ni podprto.
+
+### macOS
+
+_V pripravi_
+
+## Nastavitev licenciranja
+
+Licenca je vezana na posamezni računalnik.
+
+Programski paket namesti opravilo, ki enkrat na uro poskusi podaljšati licenco za naslednjih (tipično) 30 dni. Zato spremembe v nastavitvah licenc lahko začnejo veljati šele sčasoma.
+
+Programski paket podaljša licenco v naslednjem vrstnem redu po načelu "kar uspe prej":
+
+1. `KodaLicence` - preveri in namesti novo lokalno licenco z dano kodo licence (v nadaljevanju).
+2. Obstoječa lokalna licenca - podaljša obstoječo licenco.
+3. Obstoječa omrežna licenca - podaljša obstoječo licenco pri istem Posredniku licenc.
+4. `Posrednik` - preveri in namesti novo omrežno licenco od danega Posrednika licenc (v nadaljevanju).
+
+Programski paket uporablja licenco v naslednjem vrstnem redu po načelu "katero najde prej in je še veljavna":
+
+1. Lokalna licenca
+2. Omrežna licenca
+
+## Lokalna licenca
+
+Lokalno licenco programski paket pridobi od https://licence.amebis.si.
+
+### Windows
+
+Lokalno licenco lahko spremenimo tako, da vpišemo novo kodo licence z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana" /v "KodaLicence" /t REG_SZ /d "123-456-789-012-345" /f /reg:64
+```
+
+Lokalna licenca je shranjena v registru `HKEY_LOCAL_MACHINE\\SOFTWARE\\Amebis\\Besana\\Licenca`. Odstranimo jo z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg delete "HKLM\SOFTWARE\Amebis\Besana\Licenca" /f /reg:64
+```
+
+### macOS
+
+Lokalno licenco lahko spremenimo tako, da vpišemo novo kodo licence z ukazom:
+
+```sh
+sudo defaults write /Library/Application\ Support/Amebis/Besana.plist KodaLicence -string 123-456-789-012-345
+sudo chmod a+r /Library/Application\ Support/Amebis/Besana.plist
+```
+
+Lokalna licenca je shranjena v `/Library/Application\ Support/Amebis/Besana/Licenca.plist`. Odstranimo jo z ukazom:
+
+```sh
+sudo rm /Library/Application\ Support/Amebis/Besana/Licenca.plist
+```
+
+## Omrežna licenca
+
+Omrežno licenco programski paket pridobi od Amebisovega posrednika licenc. Računalnik, na katerem imamo nameščen Posrednik licenc, nastavimo ob namestitvi ali v registru. Osveževalnik bo vedno najprej poskušal podaljšati licenco pri istem posredniku, kot jo je dobil uvodoma.
+
+### Windows
+
+Posrednik nastavimo z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana" /v "Posrednik" /t REG_SZ /d "10.1.1.5" /f /reg:64
+```
+
+ali:
+
+```bat
+reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana" /v "Posrednik" /t REG_MULTI_SZ /d "alicpos.lj.org.home\0alicpos.mb.org.home" /f /reg:64
+```
+
+Omrežna licenca je shranjena v registru `HKEY_LOCAL_MACHINE\\SOFTWARE\\Amebis\\Besana\\Posredno`. Odstranimo jo z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg delete "HKLM\SOFTWARE\Amebis\Besana\Posredno" /f /reg:64
+```
+
+### macOS
+
+Posrednik nastavimo z ukazom:
+
+```sh
+sudo defaults write /Library/Application\ Support/Amebis/Besana.plist Posrednik -array -string 10.1.1.5
+sudo chmod a+r /Library/Application\ Support/Amebis/Besana.plist
+```
+
+ali:
+
+```sh
+sudo defaults write /Library/Application\ Support/Amebis/Besana.plist Posrednik -array -string alicpos.lj.org.home -string alicpos.mb.org.home
+sudo chmod a+r /Library/Application\ Support/Amebis/Besana.plist
+```
+
+Omrežna licenca je shranjena v `/Library/Application\ Support/Amebis/Besana/Posredno.plist`. Odstranimo jo z ukazom:
+
+```sh
+sudo rm /Library/Application\ Support/Amebis/Besana/Posredno.plist
+```

admin/Uninstall.md

@@ -0,0 +1,38 @@
+# Odstranitev
+
+## Odstranitev programskega paketa
+
+### Windows
+
+Odstranitev je izziv, ker `msiexec /x` zahteva, bodisi točen GUID verzije, ki je nameščena, bodisi originalno datoteko MSI paketa, ki je nameščen. Glede na to, da gre za čiščenje in načeloma ne vemo, katera verzija je nameščena, če sploh, predlagamo spodnji ukaz (PowerShell s skrbniškimi pravicami):
+
+```powershell
+Get-WmiObject -Class Win32_Product -Filter "Name LIKE '%Besana%' AND Vendor LIKE '%Amebis%'" | ForEach-Object {$_.Uninstall()}
+```
+
+To odstrani vse pakete, ki imajo v imenu "Besana" in imenu avtorja "Amebis".
+
+Licenca, nastavitev Amebisovega posrednika licenc in uporabniške nastavitve ostanejo prisotne v registru tudi po odstranitvi.
+
+### macOS
+
+_V pripravi_
+
+## Odstranitev licence in drugih nastavitev vezanih na računalnik
+
+### Windows
+
+Programski paket vse svoje nastavitve, ki veljajo za posamezen računalnik, hrani v registru `HKEY_LOCAL_MACHINE\\SOFTWARE\\Amebis\\Besana` in `HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\BesStr\\Parametri`. Odstranimo jih lahko z ukazom (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg delete "HKLM\SOFTWARE\Amebis\Besana" /f /reg:64
+reg delete "HKLM\SYSTEM\CurrentControlSet\Services\BesStr\Parametri" /f /reg:64
+```
+
+### macOS
+
+Programski paket vse svoje nastavitve, ki veljajo za posamezen računalnik, hrani v `/Library/Application Support/Amebis/Besana`. Odstranimo jih lahko z ukazom:
+
+```sh
+sudo rm -rf /Library/Application\ Support/Amebis/Besana
+```

admin/Update.md

@@ -0,0 +1,23 @@
+# Samoposodabljanje
+
+Privzeto programski paket namesti opravilo, ki enkrat na uro preveri, ali je na voljo novejša verzija programskega paketa in jo namesti v ozadju.
+
+### Windows
+
+Samoposodabljanje lahko izklopimo na več načinov.
+
+Da tega dela sploh ne namestimo (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+msiexec /i "\\distsrv\share\Besana.x64.msi" /qb REMOVE=featAUpdate
+```
+
+Da preklopimo kanal za posodobitve s `"stable"` (privzeto) na `""` (ukazna vrstica s skrbniškimi pravicami):
+
+```bat
+reg add "HKLM\SOFTWARE\Amebis\Besana\AUpdate" /v "Channel" /t REG_SZ /d "" /f /reg:64
+```
+
+### macOS
+
+_V pripravi_