8.4 KiB
Navodila za administratorje programskega paketa Amebis Besana
Namestitev
Namestitev programskega paketa
Namestitvene datoteke so objavljene na naslovu 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:
minisign -Vm "<ime datoteke>" -P RWRPrtnepBgoU86pKtSnHJXBtmtJjv6T5wN2Q+P7vPgHPdr3v8kGme13
Orodje Minisign lahko prenesete na 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):
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).
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.
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.
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 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
Samoposodabljanje lahko izklopimo na več načinov.
Da tega dela sploh ne namestimo (ukazna vrstica s skrbniškimi pravicami):
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):
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":
KodaLicence- preveri in namesti novo lokalno licenco z dano kodo licence (v nadaljevanju).- Obstoječa lokalna licenca - podaljša obstoječo licenco.
- Obstoječa omrežna licenca - podaljša obstoječo licenco pri istem Posredniku licenc.
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":
- Lokalna licenca
- 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):
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):
reg delete "HKLM\SOFTWARE\Amebis\Besana\Licenca" /f /reg:64
macOS
Lokalno licenco lahko spremenimo tako, da vpišemo novo kodo licence z ukazom:
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:
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):
reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Amebis\Besana" /v "Posrednik" /t REG_SZ /d "10.1.1.5" /f /reg:64
ali:
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):
reg delete "HKLM\SOFTWARE\Amebis\Besana\Posredno" /f /reg:64
macOS
Posrednik nastavimo z ukazom:
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:
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:
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):
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 (ukazna vrstica s skrbniškimi pravicami):
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:
sudo rm -rf /Library/Application\ Support/Amebis/Besana