Setup av Mikromarc 3-Server: Forskjell mellom sideversjoner

Fra Mikromarc Wiki
Hopp til navigeringHopp til søk
Ingen redigeringsforklaring
 
(24 mellomliggende versjoner av 2 brukere er ikke vist)
Linje 1: Linje 1:
=OPPDATERES I UKE 16-17=
__NOTOC__
Sjekk at du har fulgt anvisningene i artikkelen [[Forberedelser til MM3-overgang]].<br>
Legg spesielt merke til [[Systemkrav_og_-anbefalinger_for_Mikromarc_3#Server| systemkrav for server]] og anbefaling om å installere .Net 3.5 på forhånd på både server og klienter.
==Installasjon av Mikromarc 3-server==
==Installasjon av Mikromarc 3-server==




Sett inn installasjons-CD-en for Mikromarc 3-serveren i CD-ROM-spilleren. Fra websiden som
Last ned installasjonsfilene som beskrevet i mottatt e-post. Kjør Setup.exe.
deretter vises, klikk på knappen 'Kjør installasjonsveiseren'.
<!-- Fra websiden som deretter vises, klikk på knappen 'Kjør installasjonsveiseren'.
For å kjøre installasjonsveiviseren fra websiden, kreves Microsoft Internet Explorer. I tillegg må
For å kjøre installasjonsveiviseren fra websiden, kreves Microsoft Internet Explorer. I tillegg må
støtte for både Javascript og Java være skrudd på. Se nettleserhjelpen for hvordan. Alternativt kjør
støtte for både Javascript og Java være skrudd på. Se nettleserhjelpen for hvordan. Alternativt kjør -->
setup.exe manuelt fra rotkatalogen på CD-en. For å vise installasjonsinstruksjoner, kreves en
For å vise installasjonsinstruksjoner, kreves en
Portable Document Format (PDF) -leser. F.eks. Adobe Acrobat Reader.
Portable Document Format (PDF) -leser. F.eks. Adobe Acrobat Reader.


===Komponenter som blir installert===
===Komponenter som blir installert===
Installasjonsveiviseren for Mikromarc 3-serveren installerer følgende:
Installasjonsveiviseren for Mikromarc 3-serveren installerer følgende:
* .NET 2.0 (hvis nødvendig)
* .NET 3.5 (Bør fortrinnsvis være installert på forhånd)
* Sybase SQL Anywhere 10.0.1 (hvis nødvendig)
* Sybase SQL Anywhere 10.0.1 (hvis nødvendig)
* Mikromarc 3-database
* Mikromarc 3-database
Linje 19: Linje 25:
* Snarveier til Mikromarc 3-serveren på programmenyen
* Snarveier til Mikromarc 3-serveren på programmenyen
* Virtuell mappe for Mikromarc 3-serveren i IIS
* Virtuell mappe for Mikromarc 3-serveren i IIS
* Mikromarc 3 som en ASP.NET 2.0-applikasjon og nedlastbar installasjonsveiviser for Mikromarc 3-klienten
* 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 valgt, installeres også Mikromarc 3 Websøk. Dette inkluderer nødvendige ASP.NET-filer og virtuell mappe for websøket


Linje 64: Linje 70:
'Documents', klikk 'Add' og skriv inn Default.aspx.
'Documents', klikk 'Add' og skriv inn Default.aspx.


===Hvis kommunikasjonen mellom klient og server er ustabil og treg===
===Hvis kommunikasjonen mellom klient og server virker ustabil===
Kjøres Mikromarc 3 via remoting, som er standard oppsett, kan det være lurt å fravelge 'HTTP
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å.
Keep-Alives Enabled'-innstillingen på ”Site” nivå f.eks. i egemskapsdialogen 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å.


===Forbedring av lesbarheten på server-feilmeldinger på klienten===
===Bedre server-feilmeldinger på klienten===
For å få rapportert bedre (mer lesbare) feilmeldinger til Mikromarc 3-klienten ved serverfeil, bør
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
'Custom errors' skrus av. Dette kan gjøre fra IIS og i egenskapsdialogen til den virtuelle mappen
Linje 79: Linje 81:
==Oppgradering av Mikromarc 3-Server==
==Oppgradering av Mikromarc 3-Server==


Se [[Setup_av_Mikromarc_3-Server#Installasjon_av_Mikromarc_3-server| Hvordan installere]]. Velg 'Kjør installasjonsveiviseren' fra websiden. Svar 'Ja' på å oppgradere i oppgraderingsveiviseren.
Se [[Setup_av_Mikromarc_3-Server#Installasjon_av_Mikromarc_3-server|Installasjon av Mikromarc 3-server]]. Velg 'Kjør installasjonsveiviseren' fra websiden. Svar 'Ja' på å oppgradere i oppgraderingsveiviseren.


====Hva oppgraderes?====
====Hva oppgraderes?====
Oppgraderingsveiviseren oppgraderer Mikromarc 3-serverfiler inklusive Websøk-filer og
Oppgraderingsveiviseren oppgraderer Mikromarc 3-serverfiler inklusive Websøk-filer og databasen.
databasen.
Før oppgraderingsveiviseren kjøres, 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.
Før oppgraderingsveiviseren kjøres, bør (MÅ) det lages en kopi 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 feiler====
Hvis databaseoppgraderingen i oppgraderingsveiviseren skulle feile, så må databasen
Hvis databaseoppgraderingen i oppgraderingsveiviseren skulle feile, så må databasen oppgraderes manuelt i etterkant.
oppgraderes manuelt i etterkant. Kopier tilbake kopien av databasefilene Mikromarc.db og
*Stop evt. databaseserveren
Mikromarc.log til f.eks. C:\Program Files\Mikromarc 3\Database. Start deretter opp
*Kopier tilbake kopien av databasefilene Mikromarc.db og Mikromarc.log til f.eks. C:\Program Files\Mikromarc 3\Database
databaseserveren og kjør følgende kommando <code>CALL shdbupgrade(’<VERSJONSNUMMER>’);</code>
*Start ISQL (Sybase Interactive SQL) fra Start-menyen og skriv inn brukernavn og passord for administrator
(hvor <VERSJONSNUMMER> f.eks. er 3.0.3.0) fra Sybase Interactive SQL (en lenke til ISQL
*På fanekortet Database velger du Databasefil (nede i vinduet). Klikk OK
finnes på programmenyen til Mikromarc 3 i Server-mappen). Kontakt Mikromarc 3-brukerstøtte
*Kjør databaseoppgradering med kommandoen <code>CALL shdbupgrade(’<VERSJONSNUMMER>’);</code>
ved usikkerhet om hva <VERSJONSNUMMER>-et skal være.
*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==
==Avinstallering av Mikromarc 3-Server==
Linje 109: Linje 108:
Hvis Mikromarc 3 Websøk er installert, avinstalleres også websøk-filene inklusive virtuell mappe
Hvis Mikromarc 3 Websøk er installert, avinstalleres også websøk-filene inklusive virtuell mappe
for Websøk i IIS.
for Websøk i IIS.
.NET 2.0 og Sybase SQL Anywhere 10.0.0 fjernes ikke da disse 3. parts komponentene kan være
.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.
i bruk av andre applikasjoner.


Linje 121: Linje 120:




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


Mikromarc 3 Server Messages Program (Messages.exe) er programmet som fysisk sender og
Mikromarc 3 Server Messages Program (Messages.exe) er programmet som sender og
leser e-post og SMS. Dvs. sender og mottar e-post med SMTP og POP3 og sender ut SMS via
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
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.
av SMS. Flere SMS-tilbydere kan komme til etter hvert.
Linje 143: Linje 142:
<code> <add key="LogLevel" value="all" />  </code>der verdiene kan være none, fatal eller all
<code> <add key="LogLevel" value="all" />  </code>der verdiene kan være none, fatal eller all


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


===Installere tjeneste===
===Installere tjeneste===
Linje 166: Linje 165:
Dette skriptet fjerner bla. tjenesten for Messages.exe.
Dette skriptet fjerner bla. tjenesten for Messages.exe.


<!--


[[Category:Mikromarc 3 installasjon/oppgradering]]
[[Category:Mikromarc 3 installasjon/oppgradering]]
-->

Siste sideversjon per 17. apr. 2010 kl. 03:58

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.