Setup av Mikromarc 3-Server

Fra Mikromarc Wiki
Hopp til navigeringHopp til søk

OPPDATERES I UKE 16-17

Sjekk at du har fulgt anvisningene i artikkelen Forberedelser til MM3-overgang.
Legg spesielt merke til systemkrav for server og anbefaling om å installere .Net 3.5 på forhånd på både server og klienter.

Installasjon av Mikromarc 3-server

Last ned installasjonsfilene som beskrevet i mottatt e-post. Kjør Setup.exe. For å vise installasjonsinstruksjoner, kreves en Portable Document Format (PDF) -leser. F.eks. Adobe Acrobat Reader.

Komponenter som blir installert

Installasjonsveiviseren for Mikromarc 3-serveren installerer følgende:

  • .NET 3.5 (Bør fortrinnsvis være installert på forhånd)
  • Sybase SQL Anywhere 10.0.1 (hvis nødvendig)
  • Mikromarc 3-database
  • Mikromarc 3-databaseserver
  • Mikromarc 3 ODBC-datakilde
  • Mikromarc 3-serverfiler
  • Snarveier til Mikromarc 3-serveren på programmenyen
  • Virtuell mappe for Mikromarc 3-serveren i IIS
  • Mikromarc 3 som en ASP.NET 3.5-applikasjon og nedlastbar installasjonsveiviser for Mikromarc 3-klienten
  • Hvis valgt, installeres også Mikromarc 3 Websøk. Dette inkluderer nødvendige ASP.NET-filer og virtuell mappe for websøket

Hvis IIS ikke er installert

Hvis Microsoft Internet Information Server (IIS) ikke er installert, må denne installeres først for at installasjonsveiviseren til Mikromarc 3-serveren skal kjøre. Se i Windows-manualen for hvordan IIS installeres.

Hvis ADSI-tillegget for IIS ikke er installert

Hvis Active Directory Service Interface (ADSI)-tillegget for IIS ikke er installert, må denne installeres først for at installasjonsveiviseren til Mikromarc 3-serveren skal kjøre. ADSI-tillegget brukes for å lage og slette virtuelle mapper i IIS fra installasjonsveiviseren. Se i Windowsmanualen for hvordan ADSI for IIS installeres og/eller aktiveres. På Windows 2000 og på Windows Vista/Windows 2008 Server er ofte ikke ADSI-tillegget for IIS installert og aktivert.

Hvis IIS er installert etter .NET

Hvis IIS installeres etter .NET, må ASP.NET re-registreres med aspnet_regiis-verktøyet som følger med .NET. Eller enklest med ”Reparer” .NET fra 'Legg til/fjern programmer' i 'Kontrollpanelet'.

Hvis klientene får '(405) Method not found' ved pålogging

Hvis Mikromarc 3-klienten(e) får en '(405) Method not found' ved pålogging, kan dette skyldes at IIS ble installert etter .NET på Mikromarc 3-serveren. Se da Hvis IIS er installert etter .NET for en mulig løsning.

Hvordan skru på kjøring av ASP.NET-applikasjoner i IIS for Windows 2003 Server?

I IIS på Windows 2003 Server må kjøring av ASP.NET-applikasjoner være skrudd på ('Tillatt') for at Mikromarc 3-klienter på andre maskiner skal kunne kommunisere med Mikromarc 3-serveren. Se i IIS-hjelpen til Windows 2003 Server for hvordan ASP.NET settes opp/konfigureres.

Hvor har det blitt av snarveiene til Sybase SQL Anywhere på programmenyen?

Sybase SQL Anywhere 10.0.1-versjonen som installeres av installasjonsveiviseren for Mikromarc 3-serveren er en 'mini'-versjon, dvs. kun med nødvendige filer for å administere og få Mikromarc 3-serveren til å virke. Snarveier til Sybase Central, Interactive SQL og Sybase-hjelpen finnes under Mikromarc 3 > Server på programmenyen til Windows.

Hvis databaseservertjenesten ikke kjører på Windows Vista

På Windows Vista vil ikke databaseservertjenesten opprettes riktig. NT-servicen må opprettes manuelt etter at Mikromarc 3-serveren er installert. Dette kan gjøres fra Sybase Central. Se Sybase-hjelpen for hvordan.

Når default.aspx må skrives inn som en del av URL-en til Websøk

For at Websøk-brukere skal slippe å skrive inn ASP.NET-oppstartsdokumentet (default.aspx) etter Websøk-URL-en, er det mulig i IIS å legge til denne filen i listen over kjente oppstartsdokumenter. Dette kan gjøres i egenskapsdialogen for den virtuelle (Web) Websøk-mappen. Gå til flippen 'Documents', klikk 'Add' og skriv inn Default.aspx.

Hvis kommunikasjonen mellom klient og server virker ustabil

Kjøres Mikromarc 3 via remoting – som er standard oppsett – kan det være lurt å velge bort ”HTTP Keep-Alives Enabled”-innstillingen på ”Site”-nivå f.eks. i egenskapsdialogen for ”Default Web Site” i IIS. Da virker kommunikasjonen mellom Mikromarc 3-klienten og -serveren mer stabil. Det samme kan gjelde for ”Enable Logging”-innstillingen: Med ”Enable logging” skrudd på kan ytelsen reduseres drastisk, så det kan være lurt å skru av denne innstillingen også.

Bedre server-feilmeldinger på klienten

For å få rapportert bedre (mer lesbare) feilmeldinger til Mikromarc 3-klienten ved serverfeil, bør 'Custom errors' skrus av. Dette kan gjøre fra IIS og i egenskapsdialogen til den virtuelle mappen for Mikromarc 3. Gå til flippen ASP.NET, klikk ”Edit configuration”, gå så til flippen 'Custom errors' og velg 'Off' fra nedtrekkslisten for 'Custom errors mode'.

Oppgradering av Mikromarc 3-Server

Se Installasjon av Mikromarc 3-server. Velg 'Kjør installasjonsveiviseren' fra websiden. Svar 'Ja' på å oppgradere i oppgraderingsveiviseren.

Hva oppgraderes?

Oppgraderingsveiviseren oppgraderer Mikromarc 3-serverfiler inklusive Websøk-filer og databasen. Før oppgraderingsveiviseren kjøres, må det lages en sikkerhetskopi av databasen. Dette kan f.eks. gjøres fra utforskeren i Windows. Databasen ligger f.eks. i C:\Program Files\Mikromarc 3\Database. Kopier filene Mikromarc.db og Mikromarc.log herfra til et annet sted enn C:\Program Files\Mikromarc 3.

Hvis databaseoppgraderingen feiler

Hvis databaseoppgraderingen i oppgraderingsveiviseren skulle feile, så må databasen oppgraderes manuelt i etterkant.

  • Stop evt. databaseserveren
  • Kopier tilbake kopien av databasefilene Mikromarc.db og Mikromarc.log til f.eks. C:\Program Files\Mikromarc 3\Database
  • Start ISQL (Sybase Interactive SQL) fra Start-menyen og skriv inn brukernavn og passord for administrator
  • På fanekortet Database velger du Databasefil (nede i vinduet). Klikk OK
  • Kjør databaseoppgradering med kommandoen CALL shdbupgrade(’<VERSJONSNUMMER>’);
  • Hvis alt går bra, lukk ISQL og start databaseserveren manuelt igjen fra Sybase Central.

<VERSJONSNUMMER> kan f.eks. være 3.3.0.1. Kontakt Mikromarc Brukerstøtte ved usikkerhet om hva versjonsnummeret skal være.

Avinstallering av Mikromarc 3-Server

For å avinnstallere, gå til ”Kontrollpanelet”, velg ”Legg/til fjern programmer”, bla fram til ”Mikromarc 3-serveren” i listen, trykk ”Endre/fjern” og velg ”Fjerne” fra installasjonsveiviseren.

Hva avinstalleres?

Avinstallasjonsveiviseren fjerner alle Mikromarc 3-serverfilene inklusive databasen, databaseserveren, ODBC-datakilde, virtuell mappe for serveren i IIS og snarveiene på programmenyen. Hvis Mikromarc 3 Websøk er installert, avinstalleres også websøk-filene inklusive virtuell mappe for Websøk i IIS. .NET 3.5 og Sybase SQL Anywhere 10.0.0 fjernes ikke da disse 3. parts-komponentene kan være i bruk av andre applikasjoner.

Hvorfor må IIS stanses ved avinstallasjon?

Avinstallasjonsveiviseren stanser IIS før selve avinstallasjonen påbegynner! Dette gjøres for å avslutte en eventuelt ”hengende” ”ASP.NET worker process” (aspnet_wp.exe) etter kjøring av Mikromarc 3 Websøk. Deretter avinstalleres Mikromarc 3. Tilslutt startes IIS opp igjen. Utsett derfor avinstallasjonen av Mikromarc 3-serveren til kveldstid/rolig periode hvis IIS ikke kan restartes i et produksjonsmiljø!


Sette opp en tjeneste for sending/mottak av e-post og SMS

Mikromarc 3 Server Messages Program (Messages.exe) er programmet som sender og mottar e-post og SMS, dvs. sender og mottar e-post med SMTP og POP3 og sender ut SMS via eksterne tilbydere. I Norge benyttes Findexa og i Sverige benyttes 21st Centry Mobile for sending av SMS. Flere SMS-tilbydere kan komme til etter hvert. Messages.exe er i utgangspunktet et konsollprogram, men kan også kjøre som en NT-service. Hvordan er beskrevet under. Merk: Beskrivelsen under tar ikke for seg oppsett av e-post- og SMS-kontoer. Dette gjøres fra klienten i Rutiner og Meldinger. Se klienthjelpen for hvordan.

Forberedelser

  • Åpne konfigurasjonsfila. F.eks. C:\Program Files\Mikromarc 3\Server\bin\Messages.exe.config.
  • Sjekk at verdiene for ApplicationURL og ConnectionString peker på riktig server og riktig database. Merk at ConnectionString kan settes til å kjøre mot flere databaser samtidig.

F.eks. <add key="ConnectionString" value="DSN=bib-1|DSN=bib-2|...|DSN=bib-N"/>

  • Sett deretter opp LogFile. F.eks. <add key="LogFile" value=" C:\Program Files\Mikromarc 3\Server\bin\Messages.log" />
  • Endre eventuelt parametrene:

<add key="LogClear" value="true" /> der true betyr å tømme logfilen ved hver oppstart.

<add key="LogLevel" value="all" /> der verdiene kan være none, fatal eller all

<add key="MessagesPoll" value = "60" /> der verdien er antall sekunder mellom hver send og motta.

Installere tjeneste

  • Kjør skriptfila for å installere tjenester

f.eks. C:\Program Files\Mikromarc 3\Server\bin\ installServices.bat. Dette skriptet setter bla. opp Messages.exe som en automatisk tjeneste som starter med maskinen. Avsnittet under om å 'Kjøre tjeneste' er ikke nødvendig hvis maskinen restartes.

Kjøre tjeneste

  • Kjør skriptfila for å starte tjenester

f.eks. C:\Program Files\Mikromarc 3\Server\bin\startServices.bat. Dette skriptet kjører (starter) bla. tjenesten for Messages.exe.

Stoppe tjeneste

  • Kjør skriptfila for å stoppe tjenester

f.eks. C:\Program Files\Mikromarc 3\Server\bin\stopServices.bat. Dette skriptet stopper bla. tjenesten for Messages.exe.

Fjerne tjeneste

  • Kjør skriptfila for å fjerne tjenester

f.eks. C:\Program Files\Mikromarc 3\Server\bin\removeServices.bat. Dette skriptet fjerner bla. tjenesten for Messages.exe.