Svenska kohanätverkets wiki - Användarbidrag [sv]

Dokumentation

2018-05-15T07:29:08Z

Tobias.carlsson:

Här samlar vi dokumentation som rör Koha, mestadels på svenska. Det finns rapporter, arbetsdokument, tips och förslag. Engelskspråkig dokumentation som manual, wiki m.m. nås på https://koha-community.org/documentation/.

== Rapporter ==

'''2017'''

Swärd Bergström, A., Lundmark, L., Svanborg, P. (2017) '''Nytt bibliotekssystem på Umeå universitetsbibliotek: slutrapport'''
[[Media:UMU Rapport2.docx]]

'''2016'''

Andersson, Ola (2016) '''Införandet av Koha vid LTU.''' [https://mypages.lib.ltu.se/KohaRapport.pdf] [2017-01-19]

Hedström Mace, Andreas och Ingemarsson, Katarina (2016) '''Koha på SUB! Implementering av Koha på Stockholms universitetsbibliotek.'''
[[Media:ProjektrapportKohaPaSUB.pdf]]

'''2015'''

Andréason, Krister och Hellström, Örjan (2015) '''Från Libra till Koha. Migrering och test''' [https://bibliotek.molndal.se/documents/10844/210604/Koha+migreringsprojekt/1d8563d9-0b51-48e0-84aa-0680e5ac10c8?version=1.0] [2017-01-19]

Andréason, Krister (2015) '''Koha i Mölndal?''' [https://www.regionhalland.se/PageFiles/110476/KristerAndreason-Molndal-Koha2015.pdf] [2017-01-19]

Carlsson, Tobias (2015) '''Koha - ett biblioteksdatasystem för Jönköpings län? Förstudie''' [https://www.bitlabbet.se/wp-content/uploads/2017/08/Koha_forstudierapport.pdf] [2017-01-19]

Egevad, P., Ekvall, A., Ericson Lagerås, K., Hertzberg, C., Johansson, T., Karlsson, L., Lundgren, I., Trygg, L. (2015) '''Ny bibliotekssystemmiljö. Slutrapport.''' [https://www.mah.se/upload/BIT/Dokument/Publik%20slutrapport%20Ny%20bibliotekssystemmiljö.pdf] [2017-01-19] - Berör i första hand systemmiljön i stort men innehåller överväganden om Koha.

Hammarbäck, L., Kull, M., Tengström, M., Berndtsson, S., Fröberg, U., Gustafsson, R., Andréasson, B. (2015) '''NYS 2017 fas 1. Underlag för val av nya bibliotekssystem på GUB''' [http://libguides.lub.lu.se/ld.php?content_id=25841064] [2017-01-19]

Hammarböck. L., Tengström, M., Berndtsson, S., Fröberg, U., Gustafsson, R., Andréasson, B., Alfredsson, C., Gustafsson, E., Gravås, H. (2015 rev. 2016) '''NYS 2017 fas 2. Underlag för val av Koha som ILS på GUB''' [http://libguides.lub.lu.se/ld.php?content_id=27054752] [2017-01-19]

Hedström Mace, Andreas (2015) '''Koha som lokalt cirkulationssystem?''' [[Media:Koha-projektrapport-final.pdf]]

Hedström Mace, Andreas (2015) '''Koha + Libris. Öppen källkod (open source) - oberoende och större kontroll'''
[[Media:Koha_Libris_öppen_källkod_och_större_kontroll_dec_2015.pdf]]

Ratcovich, Anna-Karin (2015) '''Jobbskuggning i Conneticut'''. [https://bibliotek.molndal.se/documents/10844/210604/Jobbskuggning+Connecticut/2cadfd41-9a82-4e29-8100-c064a5846d0f] [Trasig länk 2017-01-19]

Sarge, Viktor (2015) "Blev Koha bättre, billigare och en fri infrastruktur för svenska bibliotek?" [http://www.kb.se/dokument/Samverkan/Avslutade%20projekt/Blev%20Koha%20b%C3%A4ttre,%20billigare%20och%20en%20fri%20infrastruktur%20f%C3%B6r%20svenska%20bibliotek_dec2015.pdf]

Syddansk Universitetsbibliotek, DTU Bibliotek (2015) '''Undersögelse af mulighederna for anvendelse af open source integrated library systems (ILS) i universitetsbiblioteket''' [http://projekter.kulturstyrelsen.dk/projekt/undersogelse-af-mulighederne-anvendelse-af-open-source-integrated-library-systems-ils-i-univ] [2017-01-19]

'''Äldre rapporter'''

Universitetsbiblioteket (2013) '''Front 2014 - en projektrapport''' [https://kib.ki.se/sites/default/files/bildarkiv/Dokument/front_2014_projektrapport.pdf] [2017-01-19] - Denna rapport från KIB behandlar systemlandskapet i stort men har passager som överväganden om kring Koha.

Hannfors, Henrik (2012) '''Rapport från studieresa till Biblioteka e Universitetit te Arteve''' [http://www.biblioteksforeningen.org/wp-content/uploads/2012/11/henrik_hannfors1.pdf] [2017-01-19]

Gornitzki, Carl (2011) '''KIB och framtidens bibliotekssystem - en projektrapport.''' [https://kib.ki.se/sites/default/files/bildarkiv/Dokument/slutrapport_koha.pdf] [2017-01-19]

Sarge, Viktor (2009) '''Duger? Det är ett jättebra system! Initialtest av Koha - ett fritt alternativ för biblioteken.''' [https://www.regionhalland.se/PageFiles/23092/Koha-projektrapport.pdf] [2017-01-19]

== Teknisk dokumentation & instruktioner ==

* Selin, Erik. '''[[Media:KohaInstallationochKonfiguration.pdf|Installation och konfiguration av Koha i Linux och stödtjänster i Windows Server]]''' (PDF). ''AD-integration med LDAPS och hur man sätter upp HTTPS för OPAC. Skriven för Koha 3.14.''
* [[Anonymisera lånehistorik]]: se till att information om låntagares tillbakalämnade böcker inte sparas

== Lokala manualer ==

* Bibliotek Mellansjö
** '''[[Media:Mellansjo-fjarrlan-2017-12-12.pdf|Fjärrlån]]''' (PDF)
** '''[[Media:Mellansjo-guide-for-flytt-av-exemplar-2018-03-08.pdf|Guide för flytt av exemplar]]''' (PDF)
** '''[[Media:Mellansjo-guide-for-sammanslagning-av-poster-2018-03-12.pdf|Guide för sammanslagning av poster]]''' (PDF)
** '''[[Media:Mellansjo-katalogen-att-andra-status-pa-en-bok-till-forsvunnen.pdf|Katalogen - att ändra status på en bok till försvunnen]]''' (PDF)
** '''[[Media:Mellansjo-katalogen-importera-post-fran-libris-2017-12-14.pdf|Katalogen - Importera post från Libris]]''' (PDF)
** '''[[Media:Mellansjo-katalogen-lagg-in-bestallt-exemplar-2017-12-14.pdf|Katalogen - Lägg in beställt exemplar]]''' (PDF)
** '''[[Media:Mellansjo-katalogen-skapa-ny-post-i-koha-2017-12-14.pdf|Katalogen - Skapa ny post i Koha]]''' (PDF)
** '''[[Media:Mellansjo-librisimport-och-matchning-2017-03-20.pdf|Librisimport och matchning]]''' (PDF)
** '''[[Media:Mellansjo-periodika-2018-02-26.pdf|Periodika]]''' (PDF)

* Göteborgs universitetsbibliotek (använder Elastic search och funktionstangenter, finns listade i manualen Sökning)
** '''[[Media:Gub-koha-forvarv.pdf|Förvärv]]''' (PDF)
** '''[[Media:Gub-koha-forvarv-inkopsforslag.pdf|Förvärv inköpsförslag]]''' (PDF)
** '''[[Media:Gub-koha-forvarv-monografi-amnesbevakning.pdf|Förvärv monografi ämnesbevakning]]''' (PDF)
** '''[[Media:Gub-koha-forvarv-ta-emot-leverans.pdf|Förvärv ta emot leverans]]''' (PDF)
** '''[[Media:Gub-koha-forvarv-kursbocker.pdf|Förvärv kursböcker]]''' (PDF)
** '''[[Media:Gub-koha-katalog.pdf|Katalog]]''' (PDF)
** '''[[Media:Gub-koha-periodika-redigera-och-skapa-nya-prenumerationer.pdf|Periodika redigera och skapa nya prenumerationer]]''' (PDF)
** '''[[Media:Gub-koha-periodika-registrera-nya-tidskriftsnummer.pdf|Periodika registrera nya tidskriftsnummer]]''' (PDF)
** '''[[Media:Gub-koha-sokning.pdf|Sökning]]''' (PDF)
** '''[[Media:Gub-cirkulation-i-koha-superkorta.pdf|Cirkulation Superkorta manualen]]''' (PDF)
** '''[[Media:Gub-koha-stora-cirkulationsmanualen.pdf|Stora cirkulationsmanualen]]''' (PDF)

* Katrineholms bibliotek
** '''[[Media:Katrineholm-ankomstregistrering-i-koha.pdf|Ankomstregistrering i Koha]]''' (PDF)
** '''[[Media:Katrineholm-att-kolla-bocker-som-ar-pa-vag-till-ditt-bibliotek.pdf|Att kolla böcker som är på väg till ditt bibliotek]]''' (PDF)
** '''[[Media:Katrineholm-gallra-exemplar.pdf|Gallra exemplar]]''' (PDF)
** '''[[Media:Katrineholm-import-av-poster-fran-libris.pdf|Import av poster från Libris]]''' (PDF)
** '''[[Media:Katrineholm-lokalisering-knyt-exemplar-till-post.pdf|Lokalisering - Knyt exemplar till post]]''' (PDF)
** '''[[Media:Katrineholm-lagga-in-nya-nummer-av-tidskrifter-i-koha.pdf|Lägga in nya nummer av tidskrifter i Koha]]''' (PDF)
** '''[[Media:Katrineholm-lagga-in-tillfalliga-exemplar.pdf|Lägga in tillfälliga exemplar]]''' (PDF)
** '''[[Media:Katrineholm-mangd-reservationer.pdf|Mängd reservationer]]''' (PDF)
** '''[[Media:Katrineholm-postkollen.pdf|Postkollen]]''' (PDF)
** '''[[Media:Katrineholm-skapa-lantagare.pdf|Skapa låntagare]]''' (PDF)

* Luleå tekniska universitet
** '''[[Media:Ltu-fjarrlanemanual-ebba.pdf|Fjärrlånemanual EBBA]]''' (PDF)
** '''[[Media:Ltu-manual-cirkulation.pdf|Manual cirkulation]]''' (PDF)
** '''[[Media:Ltu-manual-gallring-i-koha.pdf|Manual gallring i Koha]]''' (PDF)
** '''[[Media:Ltu-manual-inkop.pdf|Manual inköp]]''' (PDF)
** '''[[Media:Ltu-manual-snabbkatalogisering-i-koha.pdf|Manual Snabbkatalogisering i Koha]]''' (PDF)
** '''[[Media:Ltu-snabbmanual-for-att-titta-efter-en-fjarrlanebestallning.pdf|Snabbmanual för att titta efter en fjärrlånebeställning]]''' (PDF)
** '''[[Media:Ltu-snabbmanual-hur-ser-man-att-en-bok-ar-bestalld.pdf|Snabbmanual hur ser man att en bok ar beställd]]''' (PDF)

* Stockholms universitetsbibliotek
** '''[[Media:Sub-koha-fel-avhamtingsstalle.pdf|Koha fel avhämtningsställe]]''' (PDF)
** '''[[Media:Sub-koha-lathund-bestandsregistreringens-alla-moment.pdf|Koha lathund - beståndsregistreringens alla moment]]''' (PDF)
** '''[[Media:Sub-koa-i-koha.pdf|Köa i Koha]]''' (PDF)
** '''[[Media:Sub-lagga-in-ny-lantagare.pdf|Lägga in ny låntagare]]''' (PDF)
** '''[[Media:Sub-radera-en-bestallning-i-koha.pdf|Radera en beställning i Koha]]''' (PDF)
** '''[[Media:Sub-registrera-ny-lantagare-i-koha.pdf|Registrera ny låntagare i Koha]]''' (PDF)
** '''[[Media:Sub-aterlamna-bok-som-ska-till-annan-enhet.pdf|Återlämna bok som ska till annan enhet]]''' (PDF)
** '''[[Media:Sub-aterlamna-bok.pdf|Återlämna bok]]''' (PDF)
** '''[[Media:Sub-aterlamnakobok.pdf|Återlämna köbok]]''' (PDF)

* Vaggeryds bibliotek
** '''[[Media:Vaggeryd-manual-koha.pdf|Manual Koha]]''' (PDF)

Installationsguide

2017-03-30T21:02:59Z

Tobias.carlsson: /* Konfigurera Koha och dess webbplatser */

== Installation av Koha 16.11 + plack på Debian Jessie 8.6 ==

Syftet med denna installation är att testa och utvärdera det fria biblioteksdatasystemet Koha.

=== Du behöver ===

* Debian 8.6 Jessie installationsmedia: Hämta CD/DVD-avbild [https://www.debian.org/distrib/ här].

* En server/dator eller ett virtualiseringsverktyg som t.ex. VirtualBox. Debian fungerar på i princip alla moderna datorer och även på lite äldre maskiner. Jag rekommenderar minst en dator med Athlon II X2 eller Core2Duo med minimum 2 GB RAM-minne. För virtualisering krävs en processor med stöd för det.

Dokument för att komma igång med Debian Linux

* [https://www.debian.org/releases/stable/amd64/install.pdf.sv Debian’s officiella installationsguide på svenska].
* Information om hur du använder Debian finner du i [https://debian-handbook.info/browse/stable/ The Debian Administrator’s Handbook].

Debian är ett icke-kommersiellt och helt fritt operativsystem, det är känt för sin stabilitet och pålitlighet.

==== Debian 8.6 (Jessie) innehåller följande versioner av programvara som fungerar med Koha och plack ====

* MySQL Server 5.5.53-0+deb8u1
* Apache 2.4.10

==== Några ord om att redigera filer i denna guide ====

För att redigera en systemfil i Debian används en editor, t.ex. Nano. Kommandot för att redigera en fil kan då se ut så här:

<code> $ sudo nano /etc/koha/sites/instansnamn/koha-conf.xml</code>

=== Installation av Koha 16.11 ===

==== Ställ in paketförråd ====

Lägg till nyckeln till Kohas paketförråd genom att köra följande kommando:

<code>$ wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -</code>

Lägg till Koha (stable) i ditt paketförråd:

<code>$ echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list</code>

==== Installation av paket ====

Kör följande kommandon:

<code>$ sudo apt-get update</code>
<code>$ sudo apt-get install koha-common</code>

Detta kan ta lite tid beroende på din maskinvara och din uppkoppling.

=== Installera databashanterare ===

Installera MySQL-server. Det vill du antagligen göra på samma maskin om ditt syfte är att testa Koha. Om du vill använda en databas på en annan server hänvisar jag till information på installationsguiden på Kohas wiki (under ”Create a Koha instance”).

<code>$ sudo apt-get install mysql-server</code>

=== Konfigurera Koha och dess webbplatser ===

Koha-sites.conf är en fil som hjälper till att ställa in de två virtuella sajterna i Apache. Sökvägen till filen är:

<code>/etc/koha/koha-sites.conf</code>

Denna fil ska ställas in, men det är inga problem att ändra URL:erna i efterhand. Det gör man så här:

<code>$ sudo nano /etc/apaches2/sites-available/instansnamn.conf</code>

Efteråt måste man starta om Apache:

<code>$ sudo service apache2 restart</code>

Det är inte nödvändigt att ange domain, intraprefix, intrasuffix, opacprefix, opacsuffix, men för att få till t.ex. koha.bitlabbet.se för personaldelen och opac.bitlabbet.se för OPAC gör jag enligt följande:

<pre>DOMAIN="bitlabbet.se" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
INTRAPORT="80" # Port för den administrativa sidan.
INTRAPREFIX="koha" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
INTRASUFFIX=""
OPACPORT="8080" # Jag ställer in port 8080 för OPAC:en, men det är inte nödvändigt om man använder domäner/subdomäner
OPACPREFIX="opac" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
OPACSUFFIX=""</pre>

Utelämna alltså ovanstående information efter ”domain”, intraprefix” och ”opacprefix” om du bara är ute efter en testinstallation utan att använda domäner. Det krävs att du utelämnar domäner m.m. om du inte ska komma åt webbplatsen via domänerna utan endast med intern IP-adress.

Glöm ej att ställa in att Apache2 ska lyssna på port 8080 om du behöver den. Det gör du genom att lägga till ”Listen 8080” i filen:

<code>/etc/apache2/ports.conf</code>

Ställ in Apache:

<pre>$ sudo a2enmod rewrite cgi
$ sudo a2dissite 000-default.conf
$ sudo service apache2 restart</pre>

=== Skapa en Koha-instans och stöd för svenska ===

Installera stöd för svenska:

<code>$ sudo koha-translate --install sv-SE</code>

Skapa en ny instans av Koha (Koha instance)

<code>$ sudo koha-create --create-db instansnamn</code>

Instansnamn kan t.ex. vara bibliotekets namn. Jag väljer ordet ”test” som instansnamn i denna installation.

Nu ska det gå att besöka Koha’s administrationssida genom att ange serverns lokala IP-adress i en webbläsare, t.ex. 192.168.1.55.

På denna sida ska du logga in med ett inloggningsnamn som står i filen:

<code>/etc/koha/sites/instansnamn/koha-conf.xml</code>

Informationen står nästan längst ner i filen och användarnamnet är uppbyggt så här: koha_instansnamn (t.ex. bibliotekets namn). Exempel:

<code><user>koha_test</user>
<pass>d7yrN6G8hXyVmPjn</pass></code>

När man loggat in fortsätter installationen och man får då välja diverse inställningar och principer. Sedan är installationen helt klar och man kan logga in och börja administrera systemet.

OPAC besöker du sedan genom att skriva in serverns lokala IP-adress i en webbläsare med ändelsen :8080, t.ex. 192.168.1.55:8080.

=== Aktivera plack ===

Med plack förbättras prestandan avsevärt i Kohas personalgränssnitt. Test är instansnamnet, byt ut mot det du valt.

Installera de nödvändiga Apache2-modulerna

<code>$ sudo a2enmod headers proxy_http</code>

Starta om Apache2

<code>$ sudo service apache2 restart</code>

Aktivera plack

<code>$ sudo koha-plack --enable test</code>

Starta plack

<code>$ sudo koha-plack --start test</code>

Starta om Apache2 igen

<code>$ sudo service apache2 restart</code>

=== Länkar ===

* Denna guide bygger på [https://wiki.koha-community.org/wiki/Debian en officiell guide i Koha’s wiki].
* [https://koha-community.org/documentation/ Koha dokumentatio]n – här kan du läsa mer om Koha och hur du konfigurerar det.
* [https://wiki.koha-community.org/wiki/Newbie_guide Newbie guide] – Guide för den som är ny på Koha och biblioteksdatasystem.

Installationsguide

2017-03-30T21:01:50Z

Tobias.carlsson: /* Konfigurera Koha och dess webbplatser */

== Installation av Koha 16.11 + plack på Debian Jessie 8.6 ==

Syftet med denna installation är att testa och utvärdera det fria biblioteksdatasystemet Koha.

=== Du behöver ===

* Debian 8.6 Jessie installationsmedia: Hämta CD/DVD-avbild [https://www.debian.org/distrib/ här].

* En server/dator eller ett virtualiseringsverktyg som t.ex. VirtualBox. Debian fungerar på i princip alla moderna datorer och även på lite äldre maskiner. Jag rekommenderar minst en dator med Athlon II X2 eller Core2Duo med minimum 2 GB RAM-minne. För virtualisering krävs en processor med stöd för det.

Dokument för att komma igång med Debian Linux

* [https://www.debian.org/releases/stable/amd64/install.pdf.sv Debian’s officiella installationsguide på svenska].
* Information om hur du använder Debian finner du i [https://debian-handbook.info/browse/stable/ The Debian Administrator’s Handbook].

Debian är ett icke-kommersiellt och helt fritt operativsystem, det är känt för sin stabilitet och pålitlighet.

==== Debian 8.6 (Jessie) innehåller följande versioner av programvara som fungerar med Koha och plack ====

* MySQL Server 5.5.53-0+deb8u1
* Apache 2.4.10

==== Några ord om att redigera filer i denna guide ====

För att redigera en systemfil i Debian används en editor, t.ex. Nano. Kommandot för att redigera en fil kan då se ut så här:

<code> $ sudo nano /etc/koha/sites/instansnamn/koha-conf.xml</code>

=== Installation av Koha 16.11 ===

==== Ställ in paketförråd ====

Lägg till nyckeln till Kohas paketförråd genom att köra följande kommando:

<code>$ wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -</code>

Lägg till Koha (stable) i ditt paketförråd:

<code>$ echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list</code>

==== Installation av paket ====

Kör följande kommandon:

<code>$ sudo apt-get update</code>
<code>$ sudo apt-get install koha-common</code>

Detta kan ta lite tid beroende på din maskinvara och din uppkoppling.

=== Installera databashanterare ===

Installera MySQL-server. Det vill du antagligen göra på samma maskin om ditt syfte är att testa Koha. Om du vill använda en databas på en annan server hänvisar jag till information på installationsguiden på Kohas wiki (under ”Create a Koha instance”).

<code>$ sudo apt-get install mysql-server</code>

=== Konfigurera Koha och dess webbplatser ===

Koha-sites.conf är en fil som hjälper till att ställa in de två virtuella sajterna i Apache. Sökvägen till filen är:

<code>/etc/koha/koha-sites.conf</code>

Denna fil ska ställas in, men det är inga problem att ändra URL:erna i efterhand. Det gör man så här:

<code>sudo nano /etc/apaches2/sites-available/instansnamn.conf</code>

Efteråt måste man starta om Apache:

<code>$ sudo service apache2 restart</code>

Det är inte nödvändigt att ange domain, intraprefix, intrasuffix, opacprefix, opacsuffix, men för att få till t.ex. koha.bitlabbet.se för personaldelen och opac.bitlabbet.se för OPAC gör jag enligt följande:

<pre>DOMAIN="bitlabbet.se" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
INTRAPORT="80" # Port för den administrativa sidan.
INTRAPREFIX="koha" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
INTRASUFFIX=""
OPACPORT="8080" # Jag ställer in port 8080 för OPAC:en, men det är inte nödvändigt om man använder domäner/subdomäner
OPACPREFIX="opac" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
OPACSUFFIX=""</pre>

Utelämna alltså ovanstående information efter ”domain”, intraprefix” och ”opacprefix” om du bara är ute efter en testinstallation utan att använda domäner. Det krävs att du utelämnar domäner m.m. om du inte ska komma åt webbplatsen via domänerna utan endast med intern IP-adress.

Glöm ej att ställa in att Apache2 ska lyssna på port 8080 om du behöver den. Det gör du genom att lägga till ”Listen 8080” i filen:

<code>/etc/apache2/ports.conf</code>

Ställ in Apache:

<pre>$ sudo a2enmod rewrite cgi
$ sudo a2dissite 000-default.conf
$ sudo service apache2 restart</pre>

=== Skapa en Koha-instans och stöd för svenska ===

Installera stöd för svenska:

<code>$ sudo koha-translate --install sv-SE</code>

Skapa en ny instans av Koha (Koha instance)

<code>$ sudo koha-create --create-db instansnamn</code>

Instansnamn kan t.ex. vara bibliotekets namn. Jag väljer ordet ”test” som instansnamn i denna installation.

Nu ska det gå att besöka Koha’s administrationssida genom att ange serverns lokala IP-adress i en webbläsare, t.ex. 192.168.1.55.

På denna sida ska du logga in med ett inloggningsnamn som står i filen:

<code>/etc/koha/sites/instansnamn/koha-conf.xml</code>

Informationen står nästan längst ner i filen och användarnamnet är uppbyggt så här: koha_instansnamn (t.ex. bibliotekets namn). Exempel:

<code><user>koha_test</user>
<pass>d7yrN6G8hXyVmPjn</pass></code>

När man loggat in fortsätter installationen och man får då välja diverse inställningar och principer. Sedan är installationen helt klar och man kan logga in och börja administrera systemet.

OPAC besöker du sedan genom att skriva in serverns lokala IP-adress i en webbläsare med ändelsen :8080, t.ex. 192.168.1.55:8080.

=== Aktivera plack ===

Med plack förbättras prestandan avsevärt i Kohas personalgränssnitt. Test är instansnamnet, byt ut mot det du valt.

Installera de nödvändiga Apache2-modulerna

<code>$ sudo a2enmod headers proxy_http</code>

Starta om Apache2

<code>$ sudo service apache2 restart</code>

Aktivera plack

<code>$ sudo koha-plack --enable test</code>

Starta plack

<code>$ sudo koha-plack --start test</code>

Starta om Apache2 igen

<code>$ sudo service apache2 restart</code>

=== Länkar ===

* Denna guide bygger på [https://wiki.koha-community.org/wiki/Debian en officiell guide i Koha’s wiki].
* [https://koha-community.org/documentation/ Koha dokumentatio]n – här kan du läsa mer om Koha och hur du konfigurerar det.
* [https://wiki.koha-community.org/wiki/Newbie_guide Newbie guide] – Guide för den som är ny på Koha och biblioteksdatasystem.

Installationsguide

2017-03-28T22:59:59Z

Tobias.carlsson: /* Konfigurera Koha och dess webbplatser */

== Installation av Koha 16.11 + plack på Debian Jessie 8.6 ==

Syftet med denna installation är att testa och utvärdera det fria biblioteksdatasystemet Koha.

=== Du behöver ===

* Debian 8.6 Jessie installationsmedia: Hämta CD/DVD-avbild [https://www.debian.org/distrib/ här].

* En server/dator eller ett virtualiseringsverktyg som t.ex. VirtualBox. Debian fungerar på i princip alla moderna datorer och även på lite äldre maskiner. Jag rekommenderar minst en dator med Athlon II X2 eller Core2Duo med minimum 2 GB RAM-minne. För virtualisering krävs en processor med stöd för det.

Dokument för att komma igång med Debian Linux

* [https://www.debian.org/releases/stable/amd64/install.pdf.sv Debian’s officiella installationsguide på svenska].
* Information om hur du använder Debian finner du i [https://debian-handbook.info/browse/stable/ The Debian Administrator’s Handbook].

Debian är ett icke-kommersiellt och helt fritt operativsystem, det är känt för sin stabilitet och pålitlighet.

==== Debian 8.6 (Jessie) innehåller följande versioner av programvara som fungerar med Koha och plack ====

* MySQL Server 5.5.53-0+deb8u1
* Apache 2.4.10

==== Några ord om att redigera filer i denna guide ====

För att redigera en systemfil i Debian används en editor, t.ex. Nano. Kommandot för att redigera en fil kan då se ut så här:

<code> $ sudo nano /etc/koha/sites/instansnamn/koha-conf.xml</code>

=== Installation av Koha 16.11 ===

==== Ställ in paketförråd ====

Lägg till nyckeln till Kohas paketförråd genom att köra följande kommando:

<code>$ wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -</code>

Lägg till Koha (stable) i ditt paketförråd:

<code>$ echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list</code>

==== Installation av paket ====

Kör följande kommandon:

<code>$ sudo apt-get update</code>
<code>$ sudo apt-get install koha-common</code>

Detta kan ta lite tid beroende på din maskinvara och din uppkoppling.

=== Installera databashanterare ===

Installera MySQL-server. Det vill du antagligen göra på samma maskin om ditt syfte är att testa Koha. Om du vill använda en databas på en annan server hänvisar jag till information på installationsguiden på Kohas wiki (under ”Create a Koha instance”).

<code>$ sudo apt-get install mysql-server</code>

=== Konfigurera Koha och dess webbplatser ===

Koha-sites.conf är en fil som hjälper till att ställa in de två virtuella sajterna i Apache. Sökvägen till filen är:

<code>/etc/koha/koha-sites.conf</code>

Denna fil ska ställas in, men det är inga problem att ändra URL:erna i efterhand. Det gör man så här:

<code>sudo nano /etc/apaches2/sites-available/instansnamn.conf</code>

Efteråt måste man starta om Apache:

<code>$ sudo service apache2 restart</code>

Det är inte nödvändigt att ange domain, intraprefix, intrasuffix, opacprefix, opacsuffix, men för att få till t.ex. koha.bitlabbet.se för personaldelen och opac.bitlabbet.se för OPAC gör jag enligt följande:

DOMAIN="bitlabbet.se" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.

INTRAPORT="80" # Port för den administrativa sidan.

INTRAPREFIX="koha" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.

INTRASUFFIX=""

OPACPORT="8080" # Jag ställer in port 8080 för OPAC:en, men det är inte nödvändigt om man använder domäner/subdomäner

OPACPREFIX="opac" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.

OPACSUFFIX=""

Utelämna alltså ovanstående information efter ”domain”, intraprefix” och ”opacprefix” om du bara är ute efter en testinstallation utan att använda domäner. Det krävs att du utelämnar domäner m.m. om du inte ska komma åt webbplatsen via domänerna utan endast med intern IP-adress.

Glöm ej att ställa in att Apache2 ska lyssna på port 8080 om du behöver den. Det gör du genom att lägga till ”Listen 8080” i filen:

<code>/etc/apache2/ports.conf</code>

Ställ in Apache:

<code>$ sudo a2enmod rewrite cgi</code>
<code>$ sudo a2dissite 000-default.conf</code>
<code>$ sudo service apache2 restart</code>

=== Skapa en Koha-instans och stöd för svenska ===

Installera stöd för svenska:

<code>$ sudo koha-translate --install sv-SE</code>

Skapa en ny instans av Koha (Koha instance)

<code>$ sudo koha-create --create-db instansnamn</code>

Instansnamn kan t.ex. vara bibliotekets namn. Jag väljer ordet ”test” som instansnamn i denna installation.

Nu ska det gå att besöka Koha’s administrationssida genom att ange serverns lokala IP-adress i en webbläsare, t.ex. 192.168.1.55.

På denna sida ska du logga in med ett inloggningsnamn som står i filen:

<code>/etc/koha/sites/instansnamn/koha-conf.xml</code>

Informationen står nästan längst ner i filen och användarnamnet är uppbyggt så här: koha_instansnamn (t.ex. bibliotekets namn). Exempel:

<code><user>koha_test</user>
<pass>d7yrN6G8hXyVmPjn</pass></code>

När man loggat in fortsätter installationen och man får då välja diverse inställningar och principer. Sedan är installationen helt klar och man kan logga in och börja administrera systemet.

OPAC besöker du sedan genom att skriva in serverns lokala IP-adress i en webbläsare med ändelsen :8080, t.ex. 192.168.1.55:8080.

=== Aktivera plack ===

Med plack förbättras prestandan avsevärt i Kohas personalgränssnitt. Test är instansnamnet, byt ut mot det du valt.

Installera de nödvändiga Apache2-modulerna

<code>$ sudo a2enmod headers proxy_http</code>

Starta om Apache2

<code>$ sudo service apache2 restart</code>

Aktivera plack

<code>$ sudo koha-plack --enable test</code>

Starta plack

<code>$ sudo koha-plack --start test</code>

Starta om Apache2 igen

<code>$ sudo service apache2 restart</code>

=== Länkar ===

* Denna guide bygger på [https://wiki.koha-community.org/wiki/Debian en officiell guide i Koha’s wiki].
* [https://koha-community.org/documentation/ Koha dokumentatio]n – här kan du läsa mer om Koha och hur du konfigurerar det.
* [https://wiki.koha-community.org/wiki/Newbie_guide Newbie guide] – Guide för den som är ny på Koha och biblioteksdatasystem.

Installationsguide

2017-03-28T22:58:56Z

Tobias.carlsson: /* Du behöver */

== Installation av Koha 16.11 + plack på Debian Jessie 8.6 ==

Syftet med denna installation är att testa och utvärdera det fria biblioteksdatasystemet Koha.

=== Du behöver ===

* Debian 8.6 Jessie installationsmedia: Hämta CD/DVD-avbild [https://www.debian.org/distrib/ här].

* En server/dator eller ett virtualiseringsverktyg som t.ex. VirtualBox. Debian fungerar på i princip alla moderna datorer och även på lite äldre maskiner. Jag rekommenderar minst en dator med Athlon II X2 eller Core2Duo med minimum 2 GB RAM-minne. För virtualisering krävs en processor med stöd för det.

Dokument för att komma igång med Debian Linux

* [https://www.debian.org/releases/stable/amd64/install.pdf.sv Debian’s officiella installationsguide på svenska].
* Information om hur du använder Debian finner du i [https://debian-handbook.info/browse/stable/ The Debian Administrator’s Handbook].

Debian är ett icke-kommersiellt och helt fritt operativsystem, det är känt för sin stabilitet och pålitlighet.

==== Debian 8.6 (Jessie) innehåller följande versioner av programvara som fungerar med Koha och plack ====

* MySQL Server 5.5.53-0+deb8u1
* Apache 2.4.10

==== Några ord om att redigera filer i denna guide ====

För att redigera en systemfil i Debian används en editor, t.ex. Nano. Kommandot för att redigera en fil kan då se ut så här:

<code> $ sudo nano /etc/koha/sites/instansnamn/koha-conf.xml</code>

=== Installation av Koha 16.11 ===

==== Ställ in paketförråd ====

Lägg till nyckeln till Kohas paketförråd genom att köra följande kommando:

<code>$ wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -</code>

Lägg till Koha (stable) i ditt paketförråd:

<code>$ echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list</code>

==== Installation av paket ====

Kör följande kommandon:

<code>$ sudo apt-get update</code>
<code>$ sudo apt-get install koha-common</code>

Detta kan ta lite tid beroende på din maskinvara och din uppkoppling.

=== Installera databashanterare ===

Installera MySQL-server. Det vill du antagligen göra på samma maskin om ditt syfte är att testa Koha. Om du vill använda en databas på en annan server hänvisar jag till information på installationsguiden på Kohas wiki (under ”Create a Koha instance”).

<code>$ sudo apt-get install mysql-server</code>

=== Konfigurera Koha och dess webbplatser ===

Koha-sites.conf är en fil som hjälper till att ställa in de två virtuella sajterna i Apache. Sökvägen till filen är:

<code>/etc/koha/koha-sites.conf</code>

Denna fil ska ställas in, men det är inga problem att ändra URL:erna i efterhand. Det gör man så här:

<code>sudo nano /etc/apaches2/sites-available/instansnamn.conf</code>

Efteråt måste man starta om Apache:

<code>$ sudo service apache2 restart</code>

Det är inte nödvändigt att ange domain, intraprefix, intrasuffix, opacprefix, opacsuffix, men för att få till t.ex. koha.bitlabbet.se för personaldelen och opac.bitlabbet.se för OPAC gör jag enligt följande:

DOMAIN="bitlabbet.se" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
INTRAPORT="80" # Port för den administrativa sidan.
INTRAPREFIX="koha" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
INTRASUFFIX=""
OPACPORT="8080" # Jag ställer in port 8080 för OPAC:en, men det är inte nödvändigt om man använder domäner/subdomäner
OPACPREFIX="opac" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
OPACSUFFIX=""

Utelämna alltså ovanstående information efter ”domain”, intraprefix” och ”opacprefix” om du bara är ute efter en testinstallation utan att använda domäner. Det krävs att du utelämnar domäner m.m. om du inte ska komma åt webbplatsen via domänerna utan endast med intern IP-adress.

Glöm ej att ställa in att Apache2 ska lyssna på port 8080 om du behöver den. Det gör du genom att lägga till ”Listen 8080” i filen:

<code>/etc/apache2/ports.conf</code>

Ställ in Apache:

<code>$ sudo a2enmod rewrite cgi</code>
<code>$ sudo a2dissite 000-default.conf</code>
<code>$ sudo service apache2 restart</code>

=== Skapa en Koha-instans och stöd för svenska ===

Installera stöd för svenska:

<code>$ sudo koha-translate --install sv-SE</code>

Skapa en ny instans av Koha (Koha instance)

<code>$ sudo koha-create --create-db instansnamn</code>

Instansnamn kan t.ex. vara bibliotekets namn. Jag väljer ordet ”test” som instansnamn i denna installation.

Nu ska det gå att besöka Koha’s administrationssida genom att ange serverns lokala IP-adress i en webbläsare, t.ex. 192.168.1.55.

På denna sida ska du logga in med ett inloggningsnamn som står i filen:

<code>/etc/koha/sites/instansnamn/koha-conf.xml</code>

Informationen står nästan längst ner i filen och användarnamnet är uppbyggt så här: koha_instansnamn (t.ex. bibliotekets namn). Exempel:

<code><user>koha_test</user>
<pass>d7yrN6G8hXyVmPjn</pass></code>

När man loggat in fortsätter installationen och man får då välja diverse inställningar och principer. Sedan är installationen helt klar och man kan logga in och börja administrera systemet.

OPAC besöker du sedan genom att skriva in serverns lokala IP-adress i en webbläsare med ändelsen :8080, t.ex. 192.168.1.55:8080.

=== Aktivera plack ===

Med plack förbättras prestandan avsevärt i Kohas personalgränssnitt. Test är instansnamnet, byt ut mot det du valt.

Installera de nödvändiga Apache2-modulerna

<code>$ sudo a2enmod headers proxy_http</code>

Starta om Apache2

<code>$ sudo service apache2 restart</code>

Aktivera plack

<code>$ sudo koha-plack --enable test</code>

Starta plack

<code>$ sudo koha-plack --start test</code>

Starta om Apache2 igen

<code>$ sudo service apache2 restart</code>

=== Länkar ===

* Denna guide bygger på [https://wiki.koha-community.org/wiki/Debian en officiell guide i Koha’s wiki].
* [https://koha-community.org/documentation/ Koha dokumentatio]n – här kan du läsa mer om Koha och hur du konfigurerar det.
* [https://wiki.koha-community.org/wiki/Newbie_guide Newbie guide] – Guide för den som är ny på Koha och biblioteksdatasystem.

Installationsguide

2017-03-28T22:57:01Z

Tobias.carlsson: Skapade sidan med ' == Installation av Koha 16.11 + plack på Debian Jessie 8.6 == Syftet med denna installation är att testa och utvärdera det fria biblioteksdatasystemet Koha. === Du behö...'

== Installation av Koha 16.11 + plack på Debian Jessie 8.6 ==

Syftet med denna installation är att testa och utvärdera det fria biblioteksdatasystemet Koha.

=== Du behöver ===

* Debian 8.6 Jessie installationsmedia: Hämta CD/DVD-avbild här.

* En server/dator eller ett virtualiseringsverktyg som t.ex. VirtualBox. Debian fungerar på i princip alla moderna datorer och även på lite äldre maskiner. Jag rekommenderar minst en dator med Athlon II X2 eller Core2Duo med minimum 2 GB RAM-minne. För virtualisering krävs en processor med stöd för det.

Dokument för att komma igång med Debian Linux

* [https://www.debian.org/releases/stable/amd64/install.pdf.sv Debian’s officiella installationsguide på svenska].
* Information om hur du använder Debian finner du i [https://debian-handbook.info/browse/stable/ The Debian Administrator’s Handbook].

Debian är ett icke-kommersiellt och helt fritt operativsystem, det är känt för sin stabilitet och pålitlighet.

==== Debian 8.6 (Jessie) innehåller följande versioner av programvara som fungerar med Koha och plack ====

* MySQL Server 5.5.53-0+deb8u1
* Apache 2.4.10

==== Några ord om att redigera filer i denna guide ====

För att redigera en systemfil i Debian används en editor, t.ex. Nano. Kommandot för att redigera en fil kan då se ut så här:

<code> $ sudo nano /etc/koha/sites/instansnamn/koha-conf.xml</code>

=== Installation av Koha 16.11 ===

==== Ställ in paketförråd ====

Lägg till nyckeln till Kohas paketförråd genom att köra följande kommando:

<code>$ wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -</code>

Lägg till Koha (stable) i ditt paketförråd:

<code>$ echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list</code>

==== Installation av paket ====

Kör följande kommandon:

<code>$ sudo apt-get update</code>
<code>$ sudo apt-get install koha-common</code>

Detta kan ta lite tid beroende på din maskinvara och din uppkoppling.

=== Installera databashanterare ===

Installera MySQL-server. Det vill du antagligen göra på samma maskin om ditt syfte är att testa Koha. Om du vill använda en databas på en annan server hänvisar jag till information på installationsguiden på Kohas wiki (under ”Create a Koha instance”).

<code>$ sudo apt-get install mysql-server</code>

=== Konfigurera Koha och dess webbplatser ===

Koha-sites.conf är en fil som hjälper till att ställa in de två virtuella sajterna i Apache. Sökvägen till filen är:

<code>/etc/koha/koha-sites.conf</code>

Denna fil ska ställas in, men det är inga problem att ändra URL:erna i efterhand. Det gör man så här:

<code>sudo nano /etc/apaches2/sites-available/instansnamn.conf</code>

Efteråt måste man starta om Apache:

<code>$ sudo service apache2 restart</code>

Det är inte nödvändigt att ange domain, intraprefix, intrasuffix, opacprefix, opacsuffix, men för att få till t.ex. koha.bitlabbet.se för personaldelen och opac.bitlabbet.se för OPAC gör jag enligt följande:

DOMAIN="bitlabbet.se" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
INTRAPORT="80" # Port för den administrativa sidan.
INTRAPREFIX="koha" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
INTRASUFFIX=""
OPACPORT="8080" # Jag ställer in port 8080 för OPAC:en, men det är inte nödvändigt om man använder domäner/subdomäner
OPACPREFIX="opac" # Utelämna detta om du inte ska ansluta via domännamnet under installationen.
OPACSUFFIX=""

Utelämna alltså ovanstående information efter ”domain”, intraprefix” och ”opacprefix” om du bara är ute efter en testinstallation utan att använda domäner. Det krävs att du utelämnar domäner m.m. om du inte ska komma åt webbplatsen via domänerna utan endast med intern IP-adress.

Glöm ej att ställa in att Apache2 ska lyssna på port 8080 om du behöver den. Det gör du genom att lägga till ”Listen 8080” i filen:

<code>/etc/apache2/ports.conf</code>

Ställ in Apache:

<code>$ sudo a2enmod rewrite cgi</code>
<code>$ sudo a2dissite 000-default.conf</code>
<code>$ sudo service apache2 restart</code>

=== Skapa en Koha-instans och stöd för svenska ===

Installera stöd för svenska:

<code>$ sudo koha-translate --install sv-SE</code>

Skapa en ny instans av Koha (Koha instance)

<code>$ sudo koha-create --create-db instansnamn</code>

Instansnamn kan t.ex. vara bibliotekets namn. Jag väljer ordet ”test” som instansnamn i denna installation.

Nu ska det gå att besöka Koha’s administrationssida genom att ange serverns lokala IP-adress i en webbläsare, t.ex. 192.168.1.55.

På denna sida ska du logga in med ett inloggningsnamn som står i filen:

<code>/etc/koha/sites/instansnamn/koha-conf.xml</code>

Informationen står nästan längst ner i filen och användarnamnet är uppbyggt så här: koha_instansnamn (t.ex. bibliotekets namn). Exempel:

<code><user>koha_test</user>
<pass>d7yrN6G8hXyVmPjn</pass></code>

När man loggat in fortsätter installationen och man får då välja diverse inställningar och principer. Sedan är installationen helt klar och man kan logga in och börja administrera systemet.

OPAC besöker du sedan genom att skriva in serverns lokala IP-adress i en webbläsare med ändelsen :8080, t.ex. 192.168.1.55:8080.

=== Aktivera plack ===

Med plack förbättras prestandan avsevärt i Kohas personalgränssnitt. Test är instansnamnet, byt ut mot det du valt.

Installera de nödvändiga Apache2-modulerna

<code>$ sudo a2enmod headers proxy_http</code>

Starta om Apache2

<code>$ sudo service apache2 restart</code>

Aktivera plack

<code>$ sudo koha-plack --enable test</code>

Starta plack

<code>$ sudo koha-plack --start test</code>

Starta om Apache2 igen

<code>$ sudo service apache2 restart</code>

=== Länkar ===

* Denna guide bygger på [https://wiki.koha-community.org/wiki/Debian en officiell guide i Koha’s wiki].
* [https://koha-community.org/documentation/ Koha dokumentatio]n – här kan du läsa mer om Koha och hur du konfigurerar det.
* [https://wiki.koha-community.org/wiki/Newbie_guide Newbie guide] – Guide för den som är ny på Koha och biblioteksdatasystem.

Ny med Koha? Tips och hjälp

2017-03-28T22:27:30Z

Tobias.carlsson:

Här samlar nätverket tips och hjälp till dig som är ny med Koha eller undersöker möjligheten att implementera Koha vid ditt bibliotek.

[[Tips vid extern leverantör]] summerar en del erfarenheter från befintliga Koha-bibliotek för att hjälpa de som är nya.

[[Installationsguide]] för utvärdering och test av Koha