Terminaltjeneroppsett for Mikromarc 3-klienter

Fra Mikromarc Wiki
Hopp til navigeringHopp til søk

Mikromarc 3-klient på terminaltjenere/Citrix Xenapptjenere

Klientinstallasjon

Tilpasset klientinstallasjon med endring av verdier i mikromarc.exe.config under installasjon

Ved installasjon på terminaltjener anbefaler vi å be installasjonspakken om å sette visse konfigurasjonsinstillinger under installasjon:

  • msiexec /I Mikromarc3Client.msi MM3AUTOUPGRADE=false MM3SETTINGSPATH="%%UserProfile%%\mm3" MM3MACHINESETTINGSPATH="%%UserProfile%%\mm3"

Dette slår av automatisk klientoppgradering og setter "SettingsPath" og "MachineSettingsPath" til "%userprofile%\mm3" i konfigurasjonsfilen mikromarc.exe.config i Mikromarc 3-klientens programkatalog som finnes normalt her: C:\Program files\Mikromarc 3\Client\Bin\. Som et minimum må MM3AUTOUPGRADE og MM3MACHINESETTINGSPATH settes ved installasjon på terminaltjenere.

Variabler som %%appdata%% og %%username%% kan også brukes.

Foreløpig er følgende innstillinger mulig å sette under installasjon (obs! case-sensitive):

 MM3AUTOUPGRADE         tilsvarer AutoUpgrade i mikromarc.exe.config
 MM3SETTINGSPATH        tilsvarer SettingsPath i mikromarc.exe.config
 MM3MACHINESETTINGSPATH tilsvarer MachineSettingsPath i mikromarc.exe.config

Oppgradering av Mikromarc 3-klient på terminaltjenere

Ved oppgradering av Mikromarc 3 til nye versjoner må en ny klient installeres av IT-avdelingen enten ved å:

  • installere en ny klientversjon
  • endre verdien false til true i linjen: <add key="AutoUpgrade" value="false"/>. Deretter starter man Mikromarc 3 og oppgraderer klienten ved oppfordring på vanlig måte. Verdien endres manuelt tilbake til false etterpå.

Tilpasset klientinstallasjon med ferdige konfigurerte konfigurasjonsfiler

Det er mulig å installere Mikromarc 3-klienten med tilpassede konfigurasjonsfiler som er klargjort på forhånd i steden for å installere klienten først og endre konfigurasjonsfilene etterpå som beskrevet nedenfor. Følgende konfigurasjonsfiler kan distribureres sammen med Mikromarc 3-klienten: mikromarc.exe.config, connectionsettings.xml

  • Filen mikromarc.exe.config styrer:
    • standard applikasjons-url (innstilling "ApplicationURL")
    • standard database-guid (innstilling "ConnectionString")
    • om automatisk oppgradering skal være av eller på (innstilling "AutoUpgrade")
    • plassering av connectionsettings.xml (innstilling "SettingsPath" )
    • plassering av mikromarc.machine.config (innstilling "MachineSettingsPath")
  • Filen connectionsettings.xml styrer:
    • oppkoblingsprofiler dersom brukerne skal ha tilgang til flere forskjellige applikasjons-url og/eller database-guid, f.eks. når flere institusjoner deler samme driftsmiljø men har separate databaser.


Konfigurasjonsfilene må genereres på forhånd ved å gjøre en frittstående klientinstallasjon først. Deretter tilpasses konfigurasjonsfilene manuelt før de kopieres til installasjonsmappen. Eventuelt ta kontakt med Brukerstøtte for å få ferdige konfigurasjonsfiler.


En tilpasset installasjon krever at følgende filer befinner seg i samme installasjonsmappe:

  • Mikromarc 3-klienten: Mikromarc3Client.msi
  • Transformfil SwapMM3ConfigFile.mst for å kopiere filen mikromarc.exe.config
  • Transformfil MM3IncludeConnectionSettings.mst for å kopiere filen connectionsettings.xml
  • tilpasset mikromarc.exe.config dersom den skal kopieres
  • tilpasset connectionsettings.xml dersom den skal kopieres


Kommandoen for å installere Mikromarc 3-klient med tilpasset mikromarc.exe.config er:

  • msiexec /I Mikromarc3Client.msi TRANSFORMS=SwapMM3ConfigFile


Kommandoen for å installere Mikromarc 3-klient med tilpasset connectionsettings.xml er:

  • msiexec /I Mikromarc3Client.msi TRANSFORMS=MM3IncludeConnectionSettings


Kommandoen for å installere Mikromarc 3-klient med både tilpasset mikromarc.exe.config og connectionsettings.xml er:

  • msiexec /I Mikromarc3Client.msi TRANSFORMS=SwapMM3ConfigFile;MM3IncludeConnectionSettings


Kommandoen for å avinstallere Mikromarc 3-klienten er:

  • msiexec /X Mikromarc3Client.msi

Konfigurasjonsfiler å ta hensyn til

Oppkoblingsprofilen

Mikromarc 3 brukere sine oppkoblingsprofil lagres i filen ConnectionSettings.xml her:

  • Windows Server 2008: C:\Users\<brukernavn>\AppData\Local\Bibliotekenes IT-senter AS\Mikromarc®
  • Windows Server 2003: C:\Documents and Settings\<brukernavn>\Local Settings\Application Data\Bibliotekenes IT-senter AS\Mikromarc® For at nye brukere på terminaltjenere skal få riktig oppkoblingsprofil som standard ved første pålogging skal filen ConnectionSettings.xml kopieres til Mikromarc 3-klientens programkatalog som finnes normalt her: C:\Programfiler\Mikromarc 3\Client\Bin\. Denne filen blir kopiert til brukerprofilen ved første pålogging.

Mandatory brukerprofiler

Ved bruk av mandatory brukerprofiler må det tas høyde for ConnectionSettings.xml i brukerprofilene. Vi anbefaler at utloggingsskriptet til brukerne eksporterer katalogen C:\Users\<brukernavn>\AppData\Local\Bibliotekenes IT-senter AS\Mikromarc® til et sentralt lagringsområde. Tilsvarende anbefaler vi at påloggingsskriptet til brukerne importerer den samme katalogen til brukerprofilen dersom den eksisterer på det sentrale lagringsområdet.

Skriveroppsett, fra og med versjon 3.4.0.2

For å definere at visse utskriftstyper skal skrives ut til f.eks. en kvitteringsskriver som ikke er satt som standardskriver lagres en konfigurasjonsfil mikromarc.machine.config under %programdata%. For at terminaltjenerbrukere skal beholde individuelle skriverinnstillinger må plasseringen av mikromarc.machine.config endres i filen mikromarc.exe.config.

Endre stier til oppkoblingsprofiler og skriveroppett

Konfigurasjonsfilen mikromarc.exe.config i Mikromarc 3-klientens programkatalog som finnes normalt her:C:\Program files\Mikromarc 3\Client\Bin\ kan brukes for å endre standardplassering av filene connectionsettings.xml og mikromarc.machine.config.

For connectionsettings.xml, endre følgende linje i avsnittet <appSettings> og skriv inn stien til ønsket plassering mellom "". <add key="SettingsPath" value="" />

For mikromarc.machine.config, endre følgende linje i avsnittet <appSettings> og skriv inn stien til ønsket plassering mellom "". <add key="MachineSettingsPath" value="" />


Ved oppgradering av Mikromarc 3 til nye versjoner må en ny klient installeres av IT-avdelingen.

Oppkoblingsprofilen

Mikromarc 3 brukere sine oppkoblingsprofil lagres i filen ConnectionSettings.xml her:

  • Windows Server 2008: C:\Users\<brukernavn>\AppData\Local\Bibliotekenes IT-senter AS\Mikromarc®
  • Windows Server 2003: C:\Documents and Settings\<brukernavn>\Local Settings\Application Data\Bibliotekenes IT-senter AS\Mikromarc®

For at nye brukere på terminaltjenere skal få riktig oppkoblingsprofil som standard ved første pålogging skal filen ConnectionSettings.xml kopieres til Mikromarc 3-klientens programkatalog som finnes normalt her: C:\Programfiler\Mikromarc 3\Client\Bin\. Denne filen blir kopiert til brukerprofilen ved første pålogging.

Mandatory brukerprofiler

Ved bruk av mandatory brukerprofiler må det tas høyde for ConnectionSettings.xml i brukerprofilene. Vi anbefaler at utloggingsskriptet til brukerne eksporterer katalogen C:\Users\<brukernavn>\AppData\Local\Bibliotekenes IT-senter AS\Mikromarc® til et sentralt lagringsområde. Tilsvarende anbefaler vi at påloggingsskriptet til brukerne importerer den samme katalogen til brukerprofilen dersom den eksisterer på det sentrale lagringsområdet.

Skriveroppsett i versjon 3.4.0.2

For å definere at visse utskriftstyper skal skrives ut til f.eks. en kvitteringsskriver som ikke er satt som standardskriver lagres en konfigurasjonsfil mikromarc.machine.config under %programdata%.

-->