Besana-doc/admin/Install.md

6.8 KiB

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 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

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).

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

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):

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