Compare commits

...

No commits in common. "2ee5cb251fbabce5b15a1b9ce33f819092a2e56a" and "8238bcad42535412f5536826c043830c0c144c26" have entirely different histories.

4 changed files with 86 additions and 102 deletions

View File

@ -2,6 +2,9 @@
## Vsebina tega repozitorija
- [Admin](Admin.md) - Navodila za administratorje
- 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

View File

@ -1,8 +1,4 @@
# Navodila za administratorje programskega paketa Amebis Besana
## Namestitev
### Namestitev programskega paketa
# Namestitev programskega paketa
Namestitvene datoteke so objavljene na naslovu [https://prenos.amebis.si/Besana](https://prenos.amebis.si/Besana).
@ -14,7 +10,7 @@ minisign -Vm "<ime datoteke>" -P RWRPrtnepBgoU86pKtSnHJXBtmtJjv6T5wN2Q+P7vPgHPdr
Orodje Minisign lahko prenesete na [https://jedisct1.github.io/minisign/](https://jedisct1.github.io/minisign/).
#### Windows, MSI
### 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):
@ -24,11 +20,11 @@ msiexec /i "\\distsrv\share\Besana.x64.msi" /l* "%TEMP%Besana.x64.log" /qb /nore
`/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.
`/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`
#### Parameter `INSTALLLEVEL=n`
Izbere dele za namestitev do vključno neke stopnje:
@ -43,7 +39,7 @@ 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]`
#### 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).
@ -51,7 +47,7 @@ Nastavimo omrežno preverjanje licenc z Amebisovim posrednikom licenc. Kot ime r
msiexec /i "\\distsrv\share\Besana.x64.msi" /qb POSREDNIK=10.1.1.5
```
##### Parameter `KODALICENCE=nnn-nnn-nnn-nnn-nnn`
#### Parameter `KODALICENCE=nnn-nnn-nnn-nnn-nnn`
Nastavimo lokalno licenco. Kodo licence smo dobili ob nakupu.
@ -59,7 +55,7 @@ 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`
#### Parametra `PROXYUP=username` in `PROXYGE=password`
Nastavimo uporabniško ime in geslo, če za dostop do spleta HTTP uporabljamo proksi, ki potrebuje avtentikacijo.
@ -69,39 +65,15 @@ msiexec /i "\\distsrv\share\Besana.x64.msi" /qb PROXYUP=janez PROXYGE="moje gesl
Uporabo odsvetujemo! Uporabniško ime in geslo se shranita v register v nekodirani obliki.
#### Windows, EXE
### 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.
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
### 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
# Nastavitev licenciranja
Licenca je vezana na posamezni računalnik.
@ -119,27 +91,25 @@ Programski paket uporablja licenco v naslednjem vrstnem redu po načelu "katero
1. Lokalna licenca
2. Omrežna licenca
### Lokalna licenca
## Lokalna licenca
Lokalno licenco programski paket pridobi od https://licence.amebis.si.
#### Windows
### Windows
Lokalno licenco lahko spremenimo tako, da vpišemo novo kodo licence z ukazom:
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
```
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:
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\SYSTEM\SOFTWARE\Amebis\Besana\Licenca" /f /reg:64
reg delete "HKLM\SOFTWARE\Amebis\Besana\Licenca" /f /reg:64
```
#### macOS
### macOS
Lokalno licenco lahko spremenimo tako, da vpišemo novo kodo licence z ukazom:
@ -148,21 +118,19 @@ sudo defaults write /Library/Application\ Support/Amebis/Besana.plist KodaLicenc
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ž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
### Windows
Posrednik nastavimo z ukazom:
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
@ -174,13 +142,13 @@ 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:
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\SYSTEM\SOFTWARE\Amebis\Besana\Posredno" /f /reg:64
reg delete "HKLM\SOFTWARE\Amebis\Besana\Posredno" /f /reg:64
```
#### macOS
### macOS
Posrednik nastavimo z ukazom:
@ -201,49 +169,3 @@ Omrežna licenca je shranjena v `/Library/Application\ Support/Amebis/Besana/Pos
```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
```

36
admin/Uninstall.md Normal file
View File

@ -0,0 +1,36 @@
# 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
```

23
admin/Update.md Normal file
View File

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