Installationsguide - Versionshistorik

OrjanH: /* Länkar */

2024-04-25T07:56:37Z

Länkar

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

2017-03-30T21:02:59Z

Konfigurera Koha och dess webbplatser

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

2017-03-30T21:01:50Z

Konfigurera Koha och dess webbplatser

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

2017-03-28T22:59:59Z

Konfigurera Koha och dess webbplatser

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

2017-03-28T22:58:56Z

Du behöver

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ö...'

2017-03-28T22:57:01Z

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ö...'

Ny sida

== 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.

@@ Rad 146: / Rad 146: @@
 * 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://koha-community.org/documentation/ Koha dokumentation] – 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.

@@ Rad 63: / Rad 63: @@
 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>
+<code>$ sudo nano /etc/apaches2/sites-available/instansnamn.conf</code>
 Efteråt måste man starta om Apache:

@@ Rad 71: / Rad 71: @@
 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.
+<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.
@@ Rad 93: / Rad 87: @@
 Ställ in Apache:
-<code>$ sudo a2enmod rewrite cgi</code>
+<pre>$ sudo a2enmod rewrite cgi
-<code>$ sudo a2dissite 000-default.conf</code>
+$ sudo a2dissite 000-default.conf
-<code>$ sudo service apache2 restart</code>
+$ sudo service apache2 restart</pre>
 === Skapa en Koha-instans och stöd för svenska ===

@@ Rad 6: / Rad 6: @@
 === Du behöver ===
-* Debian 8.6 Jessie installationsmedia: Hämta CD/DVD-avbild här.
+* 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.
@@ Rad 27: / Rad 27: @@
 <code> $ sudo nano /etc/koha/sites/instansnamn/koha-conf.xml</code>
 === Installation av Koha 16.11 ===