MANUAL DE INSTALACIÓN DE KOHA EN BEDIAN 1. Requerim Requerimient ientos os para para la instalac instalación ión de de Koha Koha Para instalar Koha para su uso inmediato se recomienda: Un servidor Linux - Debian es lo que utilian la ma!or"a de las personas •
•
•
• •
apache #!$%L Perl acceso root al servidor Un superior al nivel medio de la habilidad con la l"nea de comandos& 'pache& #!$%L ! herramientas
Koha es un so(t)are *ratuito ! est+ disponible ba,o la Licencia Pblica eneral de /U& !a sea la versión 0 de la Licencia& o a su elección2 cualquier versión posterior
3. 4bt 4btener Ko Koha ' menudo ha! dos o tres versiones de Koha siendo liberados aqu" durante el mismo per"odo de tiempo. 5er el calendario de lanamientos para m+s in(ormación. 6nstalación - 5ersión actual 6nstalación de Paquetes Debian 7 Ubuntu2 'ctivamente apo!ado por paquetes: Debian 8 9hee!2& Debian ;essie2& Ubuntu 1<.=< >RU$>? >har2 Los paquetes son los pre(eridos cuando sea posible& pero si desea e,ecutar Koha en otra cosa: La versión estable actual .tar.*2 Las versiones m+s anti*uas& incluidas las versiones estables ! mantenimiento anteriores Lista de todas las versiones publicadas de Koha 0. Los Los paque paquetes tes de de debia debian n para para @oha @oha Los paquetes Debian son los pre(eridos& ! m+s (+cil& manera de instalar Koha en sistemas operativos basados en Debian& inclu!endo Ubuntu ! #int. versiones del sistema operativo se conoce que (uncionan:
1 el
•
Debian 8 9hee!2
•
Debian ;essie2
•
Ubuntu 1<.=< >RU$>? >har2
1
corredor in(orme pro*ramado se rompe en Ubuntu 1<.=< ! no (uncionar+ correctamente. Aonsulte el error 1<88< para 1<88< para m+s in(ormación.
1.1Proceso de instalación Los comandos que se encuentran en una ca,a ! se inician con BCB $ like this
est+n destinadas a e,ecutarse en la l"nea de comandos del servidor pero no inclu!en el BCB2. 1.1.1 Aon(i*uración de los or"*enes de los paquetes 'ada la clave P para su sistema para que sepa que los paquetes no se han manipulado: $ wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
Ele*ir quF versión de Koha que desee: antigua estable 0.332 si*ue una liberación detr+s de la actual versión estable •
•
•
estable 1G.=H2 es la versión estable actual inestable maestro2 si*ue el desarrollo actual& esto est+ destinado a desarrolladores ! probadores solamente
$i ha ele*ido antigua estable: $ echo 'deb http://debian.koha-community.org/koha oldstable main' | sudo tee /etc/apt/sources.list.d/koha.list
$i ha ele*ido estable: $ echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list
'ctualiar la lista de paquetes: $ sudo apt-get update
1.1.3 6nstalar Koha $ sudo apt-get install koha-common
1.1.3.1 'parte: un problema comn en Ubuntu sucede aqu"
Aparte: un problea !o"n en Ubuntu su!e#e a$u% $i ve esto: Errors were encountered while processing: libapache-mpm-itk apache-mpm-itk koha-common
' continuación& ha*a lo si*uiente: $ sudo adismod mpm!e"ent $ sudo apt-get install -#
? todo va a (i,ar a s" mismo. 1.1.0 6nstalación de la Iase de Datos $i usted est+ planeando para e,ecutar #!$%L en el mismo servidor que est+ en Koha& a continuación& e,ecute: $ sudo apt-get install mysql-ser"er
1.1.< Aon(i*urar los valores predeterminados Editar el archivo /etc/koha/koha-sites.con# ! a,ustarlo a la con(i*uración que desea. Establecer el valor de dominio para el dominio que desea acceder a este Koha partir. >ambiFn presta atención a la INTRASUFFIX como sus entradas D/$ tambiFn requerir+n esto. Las instrucciones para con(i*urar un dominio para Koha se pueden encontrar en la p+*ina Aómo con(i*urar un nombre de dominio para Koha . 1.1.H Puesta en (uncionamiento de 'pache $ sudo aenmod rewrite $ sudo aenmod cgi $ sudo ser"ice apache restart
1.1.G Arear una instancia de Koha $ólo ha*a esto si est+ e,ecutando #!$%L local. Reemplaar libraryname con el nombre de la biblioteca: $ sudo koha-create --create-db libraryname
$i est+ e,ecutando en otro servidor #!$%L: eliminar /etc/mysql/koha-common.cn# •
crear un nuevo archivo en el lu*ar que contiene la in(ormación de conexión para el servidor& en
•
(orma de un archivo my.cn#. leer las p+*inas del manual para koha-crear prestar atención a la in(ormación sobre
•
--request-db ! --populate-db.
1.1.8 'cceso a la inter(a )eb >endr+ que haber establecido su D/$ para esto. Los nombres de host por de(ecto son: •
libraryname. de dominio para la inter(a pblica
•
dónde:
libraryname-intra . de dominio para la inter(a del personal
•
libraryname es el nombre proporcionado a @oha-crear
•
dominio es el valor de dominio que se establece en /etc/koha/koha-sites.con#
$i desea cambiar los detalles de nombre de host de la instancia& puede editar / etc / apache / sites-enabled / con# libraryname
'bra un nave*ador )eb& ! el punto a su inter(a de personal& por ir a http: // dominio libraryname -intra o lo que sea que ha!a con(i*urado manualmente..
Auando vea el inicio de sesión para el pro*rama de instalación de Koha& el nombre de usuario ! la contrasea est+n en el archivo koha-conf.xml para la instancia. Puede verlas:
$ sudo %mlstarlet sel -t -" 'ya&g#s/con#ig/user' /etc/koha/sites/libraryname/kohacon#.%ml koha!libraryname $ sudo %mlstarlet sel -t -" 'ya&g#s/con#ig/pass' /etc/koha/sites/libraryname/kohacon#.%ml randompasswordte%t
1.3 Aon(i*uración adicional 1.3.1 E-mail De manera predeterminada& el correo electrónico se apa*a. Esto es para que pueda obtener todo listo antes de arries*ar transmisión de los anuncios no deseados a la *ente. Para activar el correo electrónico en: $ sudo koha-email-enable libraryname
1.3.3 >raducciones Las traducciones se pueden instalar: $ sudo koha-translate --install language-code
Para ver todos los códi*os de idioma: $ sudo koha-translate --list --a"ailable
1.3.0 4tros comandos Ja! una lista de los comandos proporcionados por los paquetes de Debian . >odos los comandos comienan con koha-, ! se han instalado las p+*inas de manual& por e,emplo: $ man koha-create
1.3.< $ervicios
Koha instala un servicio en /etc/init.d/koha-common. Esto ase*ura que el demonio ebra !& si est+ con(i*urado& demonio $6P se est+n e,ecutando. $e puede utiliar el inicio detener ! reiniciar los comandos de control de Fstos.
1.0 Koha 6n(ormation Pac@a*in* 1.0.1 Pol"tica de estreno El paquete estable tiene una nueva versión cada ve que el mantenedor de lanamiento para la versión estable actual crea una nueva versión. >an pronto como una nueva versión principal es liberado& este se actualiar+ con Fl tambiFn en un par de d"as lo ideal& de todos modos.2 El paquete antigua estable tiene una nueva versión cada ve que el mantenedor de liberación crea una nueva versión. $i ha! una nueva versión de la versión importante es liberado en estable& esto va a subir a la si*uiente versión principal que est+ detr+s estable. Esto si*ni(ica que obtendr+ una nueva versión principal sólo despuFs de que ha estado (uera durante varios meses ! se han encontrado con suerte todos los errores. El paquete inestable se libera cuando: •
el mantenedor del paquete recuerda hacerlo cada par de semanas& por lo *eneral. #+s veces.2
•
la rama maestra actual es capa de ser construido sin errores.
1.0.3 Aómo crear @oha-con(i*ura su sistema Auando se crea una instancia con koha-crear al*unas cosas suceden. Por el bien de e,emplo& esto supone que la instancia que ha creado se llama bibliote!a& $e crea un usuario del sistema& llamado biblioteca de oha. >odo lo que se puede hacer •
•
con esta instancia se e,ecutar+n como este usuario. $i tiene un local #!$%L2 se crea un nuevo usuario de #!$%L llamada koha!library
•
$i tiene un local #!$%L2 una nueva base de datos #!$%L se crea llamada koha!library
•
/ "ar / lib / koha / biblioteca se crea ! se rellena con una estructura de
•
directorios por de(ecto. El directorio de sitios Koha (/ etc / koha / sitios / biblioteca) se crea ! se rellena. En particular& se *enera una koha-con#.%ml ! puso en su lu*ar con las contraseas
•
que se han *enerado al aar para la base de datos ! la cebra. Un archivo de con(i*uración de 'pache se pone en /etc/apache/sitesa"ailable/library.con#. 'pache se reinicie para que los cambios surtan e(ecto.
•
$e inicia un demonio de cebra para esta instancia& se e,ecuta como el usuario del sistema de biblioteca de oha.
1.0.0 Emisiones de embala,e Ja! un poco de una mente-volcado de in(ormación sobre la construcción de paquetes de Debian para su liberación. $i desea mantener sus propios paquetes& tambiFn echar un vistao a Aonstru!endo
paquetes de Debian - la manera (+cil .
C'o !on(igurar un nobre #e #oinio para Ko)a Con(igurar un #oinio Ko)a * !on(igurar los +alores por #e(e!to Usted puede acceder a la instalación de Koha usando una dirección 6P& o el uso de un dominio. Este ltimo es casi siempre pre(erible ! es la situación tratado aqu". Utiliando el mFtodo de nombre de dominio si*ni(ica que o bien debe in(ormar lo que el nombre de dominio de su servidor de Koha es& probablemente& el administrador de red& o debe crear ! con(i*urar uno para Fl. Areación ! con(i*uración de un dominio se puede hacer en una de dos maneras: •
D/$
•
El archivo / etc / hosts
$i usted est+ en una *ran red habr+ mu! a menudo ser un servidor D/$ en esa red que asi*na los nombres de dominio de (amiliares a las direcciones 6P. $i es el administrador del servidor D/$& usted sabr+ cómo hacer esto ! ser+ capa de asi*nar un nombre de dominio a su servidor de Koha. $i no administrar el servidor D/$ entonces usted necesita hablar con el administrador que lo hace& ! pedirles que asi*nar un nombre de dominio& o decirle lo que es si !a existe una. Auando se le da el nombre de dominio& puede con(i*urar Koha usarlo& si*uiendo las instrucciones de aba,o. Recuerde que los cambios en los servidores D/$ pueden tardar hasta 3< horas en aplicarse. En redes mu! pequeas ha! otra posibilidad que consiste en el uso de archivos del servidor de Koha / etc / hosts ! el mismo archivo en cualquier otro equipo de la red que se necesita para acceder a
Koha2. Puede utiliar este mFtodo si est+ se*uro de que la red no tiene su propio servidor D/$ !& como siempre que se sepa que el nombre de dominio que eli*e no entrar+ en con(licto con uno especi(icado para cualquier otro equipo de la red. Este mFtodo es adecuado& por lo tanto& para las instalaciones de prueba ! para las instalaciones en redes mu! pequeas. /o es un mFtodo apropiado para los servidores de Koha los que se accede desde 6nternet. El proceso de instalación de Koha crea dos subdominios 'pache& el primero de los cuales se les dar+ el mismo nombre que el nombre de la biblioteca se especi(ica cuando se emite el comando koha-crear
m+s adelante. El se*undo sub-dominio se le dar+ el mismo nombre que la biblioteca& pero se*uido de un su(i,o arbitraria: -intra por de(ecto. 's" que decidir ahora lo que va a llamar a su biblioteca& si no lo ha hecho !a. $i se llama a su librar!name biblioteca ! si su dominio era peredur.cym ser"an llamados los dos subdominios: libraryname.peredur.cym
!: libraryname-intra.peredur.cym
Las si*uientes instrucciones se re(ieren a usar / etc / hosts para el dominio ! asumen que va a utiliar el dominio peredur.c!m. Puede omitir esto ! se*uir recto hasta la edición del archivo kohasites.con#ig si el servidor de Koha se ha asi*nado un dominio utiliando D/$.
Puede llamar al dominio de cualquier cosa que desee& siempre ! cuando no entre en con(licto con otro elemento de la red local. 5amos a se*uir utiliando peredur.c!m en los e,emplos que si*uen.
E#i!i'n , et! , )osts 'ntes de editar el archivo 7 etc 7 hosts que necesita saber la dirección 6P de su servidor de Koha. El servidor de Koha& como cualquier equipo de la red& tiene una dirección 6P. $i usted no sabe lo que es& usted lo puede encontrar emitiendo el si*uiente comando en un terminal: $ Espect*culo ip addr
Dependiendo de si est+ conectado a la red mediante una conexión por cable o una conexión inal+mbrica& lo normal es ver la dirección 6P en contra de cualquiera eth+ o wlan+ en la salida. $er+ una dirección 6P en notación de puntos& por lo *eneral se parecen mucho a ,.,.%% donde % representa un nmero. 's"& por e,emplo& podr"a ser ,.,.,.,0. Este es el resultado del comando show ip addr en mi port+til: ,: 12n: 34OO5678 95 4OE;!95< 1=9 >>0 qdisc grupo desconocido estado predeterminado noqueue qlen , enlace / bucle in"ertido ++: ++: ++: ++: ++: ++ d a ++: ++: ++: ++: ++: ++ inet ,?.+.+.,/ alcance lo an#itri@n "alid!l#t para siempre para siempre pre#erred!l#t : eth+: 3sin "eh2culo di#usi@n multidi#usi@n 95< 1=9 ,>++ qdisc p#i#o!#ast predeterminada del grupo de estado 7baAo qlen ,+++ enlace / B+ Cter: 6D: c: : ,+: + d a DD: DD: DD: DD: DD: DD 0: wlan+: 3di#usi@n multidi#usi@n 95 4OE;!95< 1=9 ,>++ qdisc p#i#o!#ast estado 7rriba predeterminado grupo qlen ,+++ enlace / Cter 0: b,: db: D: d: ?> d a DD: DD: DD: DD: DD: DD inet ,.,.,./ d amplio alcance ,.,.,.>> wlan+ din*mica mundial
"alid!l#t ,?+?sec pre#erred!l#t ,?+?sec inet #e+ :: 0ab,: B6DD: #e#: enlace d?> / alcance "alid!l#t para siempre para siempre pre#erred!l#t
La dirección 6P del ordenador port+til se da contra )lan= ! es 13.1G.1.. 'hora usted tiene la dirección 6P que necesita& puede con(i*urar el archivo / etc / hosts. Ja*a lo si*uiente& !a sea como root o por medio de sudo. 'sumo que usted puede usar sudo en las si*uientes instrucciones ! que tiene el editor de texto ge#it instalado. $i usted no tiene ge#it entonces o bien instalarlo o sustituir el nombre de su editor de texto (avorito para ge#it en las instrucciones de aba,o. $i usted no es un su#oer- entonces usted debe o bien haces uno& como root o e,ecutar el editor de texto como root. En una ventana de terminal& en el indicador& escriba: $ Fudo gedit / etc / hosts
El texto en el archivo 7 etc 7 hosts se ver+ al*o como lo si*uiente si usted est+ en un de(ecto instalación de: ,?.+.+., localhost ,?.+.,., nombre-de-su-ser"idor G 4as siguientes l2neas son recomendables en equipos que pueden H5" :: , localhost ip-ip-bucle de retroceso DE++ :: + ip-localnet DD++ :: + ip-mcastpre#i% DD+ :: ,-H5 allnodes DD+ :: -H5 allrouters
$uponiendo que la dirección 6P de su servidor de Koha es 13.1G.1.10G ! suponiendo que se va a llamar a su librar!name biblioteca& lue*o despuFs de la l"nea de localhost& insertar dos nuevas l"neas que dicen: libraryname.peredur.cym ,.,.,.,0 ,.,.,.,0 libraryname-intra.peredur.cym
Esto ase*ura que todas las peticiones a los dos subdominios se enviar+n al servidor con el ,.,.,.,0 dirección 6P el servidor de Koha2. uarde el archivo / etc / hosts.
NOTA: si utilia el archivo / etc / hosts para de(inir su dominio& tendr+ que hacer entradas como las que anteriormente en el directorio / etc / hosts archivos de todos los equipos que necesitan acceder a KohaM no sólo el que est+ en el servidor de Koha. Es por eso que es sólo una buena solución para redes pequeasN
E#i!i'n .o)a/sites&!on( En ge#it o su editor de texto (avorito2 abrir el archivo /etc/koha/koha-sites.con# para su edición. Recuerde que debe abrirlo con sudo: $ Fudo gedit /etc/koha/koha-sites.con#
o como ra". los valores predeterminados del Koha est+n contenidos en este archivo. Es necesario hacer al*unas modi(icaciones en la sección de variables de creación de m+quinas virtuales Para hacer que el traba,o Koha en su red. Por de(ecto& esta sección se parece a: G7pache Iariables de creaci@n de m*quinas "irtuales BO1HJHO K L. 1yBJFname.orgL E%pedici@n K L+L G ++ para el uso de una instalaci@n basada en H5. HJ=;75;EDHM K LL HJ=;7F9DDHM K L- intraL O5785O;= K L+L O5785;EDHM K LL O578F9DDHM K LL
La nica l"nea que es de interFs para una instalación b+sica es la l"nea D4#6/64. 'sumiendo que su dominio se llama peredur.cym a continuación& cambie esta l"nea a: BO1HJHO K L. 5eredur.cymL
Tenga en !uenta el punto al prin!ipio #el nobre #e #oinio& El 6/>R'$UOO6 de(ine el su(i,o utiliado para acceder al sitio personal. Puede ser cualquier cosa que desee& pero si lo cambia& recuerde que debe cambiar el nombre del subdominio& a travFs de D/$ o el archivo / etc / hosts s2& para que coincida.
Mo#i(i!ar el ar!)i+o #e puertos #e apa!)e: $ Fudo gedit /etc/apache/ports.con# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! G H# you Aust change the port or add more ports here you will likely also G ha"e to change the IirtualNost statement in G /etc/apache/sites-enabled/+++-de#ault.con#
4isten + 4isten ++
3H#1odule ssl!module< 4isten 0 3/H#1odule<
3H#1odule mod!gnutls.c< 4isten 0 3/H#1odule<
G "im: synta%Kapache tsK swK stsK sr noet !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Con(igurar el ar!)o+i #e +irtual)ost #el librar*nae: $ Fudo gedit /etc/apache/sites-enabled/libraryname.con# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! G oha instance bibcen 7pache con#ig.
G O578 3IirtualNost ,+..+.,0:+< 3H#Iersion
Hnclude /etc/koha/apache-shared-disable.con#
G
Hnclude /etc/koha/apache-shared-opac-plack.con# Hnclude /etc/koha/apache-shared-opac.con#
Fer"erJame bibcen
FetEn" ON7!8OJD L/etc/koha/sites/bibcen/koha-con#.%mlL FetEn" 1E1878NEB!FE;IE;F LL FetEn" 1E1878NEB!J71EF578E LL 7ssign9serHB bibcen-koha bibcen-koha
Error4og
/"ar/log/koha/bibcen/opac-error.log
G
=rans#er4og /"ar/log/koha/bibcen/opac-access.log
G
;ewrite4og
/"ar/log/koha/bibcen/opac-rewrite.log
3/IirtualNost<
G Hntranet 3IirtualNost ,?.+.+.:+< 3H#Iersion
Hnclude /etc/koha/apache-shared-disable.con#
G
Hnclude /etc/koha/apache-shared-intranet-plack.con# Hnclude /etc/koha/apache-shared-intranet.con#
Fer"erJame bibcen-intra FetEn" ON7!8OJD L/etc/koha/sites/bibcen/koha-con#.%mlL FetEn" 1E1878NEB!FE;IE;F LL FetEn" 1E1878NEB!J71EF578E LL 7ssign9serHB bibcen-koha bibcen-koha
Error4og
/"ar/log/koha/bibcen/intranet-error.log
G
=rans#er4og /"ar/log/koha/bibcen/intranet-access.log
G
;ewrite4og
/"ar/log/koha/bibcen/intranet-rewrite.log
3/IirtualNost< !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
