# Navodila za administratorje programskega paketa Amebis Besana ## 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 "" -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. Vendar programski paket ne bo pravilno deloval, 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 `INSTALLLEVEL=n` Izbere dele za namestitev do vključno neke stopnje: 1 (privzeto): aplikaciji Mini in Pregibnik, vtičnik za MS Office, lokalni API; 2: namesti še vtičnike LanguageTool za brskalnike Firefox, Edge in Chrome; 3: ni v uporabi; 4: dokumentacija lokalnega API-ja za razvijalce ```bat msiexec /i "\\distsrv\share\Besana.x64.msi" /qb INSTALLLEVEL=2 ``` Nadgradnje ignorirajo ta parameter in namestijo oz. posodobijo dele, ki so bili izbrani v programskem paketu, ki ga nadgrajujemo. ##### 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](#msi) trenutno ni podprto. #### macOS _V pripravi_ ## 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 Samodejno samoposodabljanje lahko izklopimo na več načinov. Da tega dela sploh ne namestimo: ```bat msiexec /i "\\distsrv\share\Besana.x64.msi" /qb REMOVE=featAUpdate ``` Da preklopimo kanal za posodobitve s `"stable"` (privzeto) na `""`: ```bat reg add "HKLM\SOFTWARE\Amebis\Besana\AUpdate" /v "Channel" /t REG_SZ /d "" /f /reg:64 ``` #### 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: ```bat reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana" /v "KodaLicence" /t REG_SZ /d "123-456-789-012-345" /f /reg:64 ``` Ker so kode licenc zaupne narave, opravilo, ki podaljšuje licence, po uporabi kodo v registru izbriše. Lokalna licenca je shranjena v registru `HKEY_LOCAL_MACHINE\\SOFTWARE\\Amebis\\Besana\\Licenca`. Odstranimo jo z ukazom: ```bat reg delete "HKLM\SYSTEM\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 ``` Ker so kode licenc zaupne narave, opravilo, ki podaljšuje licence, po uporabi kodo v datoteki `Besana.plist` izbriše. 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: ```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: ```bat reg delete "HKLM\SYSTEM\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 ``` ## 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 "per-machine" #### 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 (PowerShell s skrbniškimi pravicami): ```powershell Remove-Item -Path "HKLM:\SOFTWARE\Amebis\Besana" -Recurse -Force Remove-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\BesStr\Parametri" -Recurse -Force ``` ali (ukazna vrstica s skrbniškimi pravicami): ```bat reg delete "HKLM\SYSTEM\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 ```