KOHA-ES

• Paso a ser root

sudo -s

• Actualizo la base de datos que usa locate (puede tomar unos cuantos segundos)

updatedb

• Busco y voy a donde está tmpl_process3.pl

locate tmpl_process3.pl
cd /usr/share/koha/misc/translator/

• Desgargo los .po en español

wget http://www.famaf.unc.edu.ar/kohatrad/es-ES-opac-v-3.po
wget http://www.famaf.unc.edu.ar/kohatrad/es-ES-staff-v-3.po

• Creo los directorios es-ES donde irán los archivos traducidos:

mkdir ../../opac/htdocs/opac-tmpl/prog/es-ES
mkdir ../../intranet/htdocs/intranet-tmpl/prog/es-ES

• Ejecuto script tmpl_process3.pl (devuelve unos cuantos warnings que no parecen molestar)

./tmpl_process3.pl install -i ../../opac/htdocs/opac-tmpl/prog/en/ -o ../../opac/htdocs/opac-tmpl/prog/es-ES -s ./es-ES-opac-v-3.po -r
./tmpl_process3.pl install -i ../../intranet/htdocs/intranet-tmpl/prog/en/ -o ../../intranet/htdocs/intranet-tmpl/prog/es-ES/ -s ./es-ES-staff-v-3.po -r

Nota: En caso de recibir el error Can't locate Locale/PO.pm in @INC, probablemente la solución sea instalar Locale::PO ejecutando sudo cpan Locale::PO.

• Borro los .po usados

rm es-ES-opac-v-3.po es-ES-staff-v-3.po

• Apache bandwidth tuning in default config
• I switched mysql config from my-large.cnf to my-medium.cnf and temporarily added 1 GB swapfile. That fixed it, but quite a memory hog for an installer…
• robots.txt

• Ingresamos en la consola:

sudo apt-get install build-essential

• Instalar Apache, Mysql y algún software de desarrollo y herramientas para CPAN

sudo apt-get install apache2-mpm-prefork apache2 apache2-utils apache2.2-common libapache2-mod-php5 mysql-server php5-mysql
sudo apt-get install gzip tar unzip make lynx wget gcc libgcrypt-dev libgdbm-dev libxml2-dev libyaz-dev libgd2-xpm-dev

Ahora vamos a predeterminar Mysql en UTF-8 para que todo nuestro sistema sea compatible con UNICODE.

• Verificamos configuración:

locale

Obtendremos una salida como esta:

LANG=es_AR.UTF-8 
LC_CTYPE=”es_AR.UTF-8″ 
LC_NUMERIC=”es_AR.UTF-8″ 
LC_TIME=”es_AR.UTF-8″ 
LC_COLLATE=”es_AR.UTF-8″ 
LC_MONETARY=”es_AR.UTF-8″ 
LC_MESSAGES=”es_AR.UTF-8″ 
LC_PAPER=”es_AR.UTF-8″ 
LC_NAME=”es_AR.UTF-8″ 
LC_ADDRESS=”es_AR.UTF-8″ 
LC_TELEPHONE=”es_AR.UTF-8″ 
LC_MEASUREMENT=”es_AR.UTF-8″ 
LC_IDENTIFICATION=”es_AR.UTF-8″ 

Si no lo tenemos en UTF-8, podemos reconfigurarlo:

sudo dpkg-reconfigure locales

• Continuamos con MYSQL, desde consola:

sudo gedit /etc/mysql/my.cnf

Una vez abierto el archivo de configuración buscamos estas líneas:

[mysqld]
#
# * Basic Settings #

Debajo de donde dice Basic Settings va lo siguiente:

 # UTF-8 Defaults for Koha (added DATE by YOURNAME)
init-connect=’SET NAMES utf8′
character-set-server=utf8
collation-server=utf8_general_ci

Nos debería quedar así:

[mysqld]
#
# * Basic Settings
#
# UTF-8 Defaults for Koha (added DATE by YOURNAME)
init-connect=’SET NAMES utf8′
character-set-server=utf8
collation-server=utf8_general_ci 

• Guardamos y cerramos el archivo. Reseteamos Mysql desde consola:

sudo /etc/init.d/mysql restart

• Continuamos con Apache, editamos el httpd.conf

sudo /etc/init.d/mysql restart
sudo gedit /etc/apache2/httpd.conf

y le agregamos lo siguiente:

AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

Si tenemos algún problema más conviene revisar:

• http://wiki.koha.org/doku.php?id=encodingscratchpad

Instalar Yaz y Zebra

• Debemos incorporar los repositorios de IndexData a nuestra source list. Desde consola:

sudo gedit /etc/apt/sources.list

• Una vez abierto el archivo agregamos estas líneas al final:

 # IndexData Repository
deb http://ftp.indexdata.dk/pub/ubuntu/ hardy main

• También necesitmos los Backports

sudo gedit /etc/apt/sources.list.d/backports.list

* y copiamos allí:

 # Backports Repository
deb http://www.backports.org/debian/ etch-backports main

• Se necesita una llave, la conseguimos e instalamos:

sudo aptitude update
sudo aptitude install debian-backports-keyring

• Creamos una carpeta en nuestro HOME (SW) para descargar todo lo que nos va a hacer falta,descargamos la llave para los paquetes de indexdata y la instalamos:

mkdir SW 
cd /SW
wget http://ftp.indexdata.dk/debian/indexdata.asc
apt-key add indexdata.asc
sudo aptitude update

• Bajar Koha, descomprimir

cd /SW
wget http://download.koha.org/koha-3.00.02.tar.gz 
tar -xzvf koha-3.00.02.tar.gz

Instalar YAZ y ZEBRA

• Instalar libssl0.9.7 (necesario para Yaz). Hardy tiene libssl0.9.8, pero Yaz no se instalará con eso. Hay que descargar la versión anterior e instalar a mano.

wget http://mirrors.kernel.org/ubuntu/pool/universe/o/openssl097/libssl0.9.7_0.9.7g-5ubuntu1.1_i386.deb
sudo dpkg -i libssl0.9.7_0.9.7g-5ubuntu1.1_i386.deb

• Ahora instalamos Yaz, Zebra y la documentación de Zebra

sudo aptitude install yaz idzebra idzebra-doc

• Instalando módulos Perl con CPAN

sudo aptitude install \
    liblingua-stem-perl libxml-sax-machines-perl libmarc-record-perl libcgi-session-perl \
    libdate-pcalc-perl libdate-ical-perl libdate-manip-perl liblist-moreutils-perl \
    libmarc-charset-perl libmarc-xml-perl libnet-ldap-server-perl libpdf-report-perl \
    libpdf-reuse-barcode-perl libxml-csv-perl libtext-csv-perl libtext-iconv-perl \
    libxml-dumper-perl libxml-libxml-common-perl libxml-filter-xslt-perl \
    libxml-rsslite-perl libxml-simple-perl libyaml-syck-perl libxml-rss-perl \
    libschedule-at-perl libhtml-template-pro-perl libhtml-scrubber-perl \
    libmarc-crosswalk-dublincore-perl libdate-calc-perl \
    libclass-factory-perl libdata-ical-perl libmodule-pluggable-perl libyaml-perl

• Además instalar estos:

sudo perl -MCPAN \
    -e 'install Time::Piece;' \
    -e 'install Email::Date;' \
    -e 'install Mail::Sendmail;' \
    -e 'install Text::Iconv;' \
    -e 'install Biblio::EndnoteStyle;' \
    -e 'install Algorithm::CheckDigits;' \
    -e 'install SMS::Send;' \
    -e 'install MIME::Lite;' \
    -e 'install Class::Factory::Util;' \
    -e 'install HTML::Template::Pro;' \
    -e 'install Net::Z3950;' \
    -e 'install Net::Z3950::ZOOM;' \
    -e 'install POE;' \
    -e 'install Text::CSV;' \
    -e 'install Text::CSV_XS;' \
    -e 'install MARC::File::XML;' \
    -e 'install Unix::Syslog;' \
    -e 'install GD;' \
    -e 'install HTTP::OAI;' \
    -e 'install JSON;' \
    -e 'install IPC::Cmd;' \
    -e 'install Digest::SHA;'

• Crear usuario Koha, desde consola:

sudo adduser --gecos "Koha server" koha

nos muestra algo como lo que está a continuación, colocamos el password y nombre del usuario:

Adding user ‘koha’ …
Adding new group ‘koha’ (1001) …
Adding new user ‘koha’ (1001) with group ‘koha’ …
Creating home directory ‘/home/koha’ …
Copying files from ‘/etc/skel’ …
Enter new UNIX password:
Retype new UNIX password:
passwd: password updated successfully
Changing the user information for koha
Enter the new value, or press ENTER for the default
Full Name []:
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [y/N] y

• Crear MySQL Database

Creamos la base de datos Koha en MYSQL y reemplazamos: kohaadmin'@'localhost por nuestro usuario elegido: 'usuario?'@'localhost' y ' katikoan' por nuestra nueva contraseña.

sudo mysqladmin -uroot create koha -p 
sudo echo “grant all on koha.* to ‘kohaadmin’@'localhost’ identified by ‘katikoan’;” | mysql -uroot -p
sudo mysqladmin -uroot -p flush-privileges

Verificar Parser SAX

• Confirme que su sistema está utilizando el analizador SAX (XML:: libxml). Después de ejecutar el siguiente comando debería ver algo como “XML:: libxml:: SAX:: Parser = hash (0x81f0a74)”.

cd /SW/koha-3.00.03/misc 
sudo ./sax_parser_print.pl

Si tu sistema tiene problemas con los caracteres extendidos (por ejemplo, caracteres acentuados) entonces para corregir este problema tendrá que editar el archivo ParserDetails.ini. En primer lugar encontrar el archivo para luego editarlo:

locate ParserDetails.ini 
sudo gedit /etc/perl/XML/SAX/ParserDetails.ini

dejamos solo XML::LibXML::SAX::Parser (podemos comentar las otras entradas) y volvemos a ejecutar

sudo ./sax_parser_print.pl

Y nos sale un mensaje de que esta todo bien

Koha wants something like: 

    XML::LibXML::SAX::Parser=HASH(0x81fe220) 

You have: 

    XML::LibXML::SAX::Parser=HASH(0x868a5b8) 

Looks good. 

sudo update-perl-sax-parsers

• Instalación de KOHA: nos posicionamos en el directorio

cd koha-3.00.02 
perl Makefile.PL
make
make test
sudo make install

El comando “perl Makefile.PL” tendrá una duración de varios minutos, hace varias preguntas, en general aceptar las respuestas por defecto, salvo que hayamos cambiado usuario, password de koha (respondemos con los datos actuales). Cuando se le indique “Por favor, especifique el nombre del usuario que posee la base de datos a ser utilizada por Koha”, proporcionar la información de acceso para el usuario de MySQL Koha que creamos anteriormente. A la salida del comando perl Makefile.PL se nos mostrará si hubo algún módulo sin instalar.

• Ejecutamos:

sudo perl -MCPAN -e shell

• e instalamos

cpan> install “XXX::XXX”

Make test y make install son comandos que también funcionan durante varios minutos, pero no será necesario para responder a ninguna pregunta. Siguiente, tenemos que configurar Apache para que reconozca como válido al sitio web de Koha. Para ello, el directorio predeterminado de configuración de Apache debe tener un enlace simbólico al archivo de configuración de Apache Koha, Koha-httpd.conf.

• Exportamos las variables:

export KOHA_CONF=/etc/koha/koha-conf.xml 
export PERL5LIB=/usr/share/koha/lib

• Crear el enlace simbólico de este modo:

sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha

• Paso siguiente:

sudo a2enmod rewrite 
sudo a2ensite koha

• Configuramos puertos en Apache

sudo gedit /etc/apache2/ports.conf

• Agregamos esta línea al archivo:

Listen 8080

• Guardamos, cerramos y reiniciamos apache:

sudo apache2ctl restart

Vamos a http://127.0.1.1:8080 y comenzamos la configuración de koha con un asistente

• Paso 1: idioma: elegimos inglés EN (luego lo traducimos)

• Paso 2: Se le pedirá a revisar la configuración de base de datos y haga clic en Siguiente si son correctos. Si no están correctamente tendrás que editar el archivo de configuración correcta (por lo general, Koha-config.xml).

Si todo está bien, después de hacer clic en “Siguiente” dice que una conexión de base de datos se ha establecido y que el usuario MySQL tiene derechos.

• Paso 3: Haga clic en “Siguiente”. Usted debería ver el mensaje, ” Tablas de bases de datos creadas con exito.”

• Paso 4: Haga clic en el siguiente “Instalar con configuraciones básicas” hipervínculo y seleccionar el MARC adecuado (Marc 21)

• Paso 5: Instalaciones opcionales: elegimos lo que consideremos apropiado o lo dejamos así.

• Paso 6: Zebra or NoZebra? Elegimos de acuerdo al tamaño de nuestras bases, mas de 200,000 registros Zebra, sino NoZebra

Si todo ha ido bien obtendremos el mensaje “Felicidades, instalación completa”.

• Intranet: http://127.0.1.1:8080

• OPAC: http://127.0.1.1:80

Configurar e iniciar Zebra: Ejecutar los procesos de Zebra como demonios, y añadir al proceso de inicio

• Zebra Server:

sudo su
ln -s /usr/share/koha/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
update-rc.d koha-zebra-daemon defaults
/usr/share/koha/bin/koha-zebra-ctl.sh start

• Zebraqueue Daemon:

sudo su
ln -s /usr/share/koha/bin/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon
update-rc.d koha-zebraqueue-daemon defaults
/etc/init.d/koha-zebraqueue-daemon start

• Preferencias del Sistema, ejecutar lo siguiente

echo "UPDATE systempreferences SET value='es-ES,en' WHERE variable='language';" | mysql -ukuser -pkpass kohadb

echo "UPDATE systempreferences SET value='es-ES,en' WHERE variable='opaclanguages';" | mysql -ukuser -pkpass kohadb

Donde kuser, kpass y kohadb corresponden a el usuario, contraseña y base de su instalación. Este cambio permite que tanto el OPAC como STAFF se muestren por defecto en castellano. Al menos para el OPAC sugiero que se conserve la versión en ingles, cambiando de idioma es posible verificar la consistencia de la traducción. Por otro lado dejamos disponible el catálogo a visitantes que no comprenden nuestro idioma. Tags MARC traducidos:

• 1-biblio_framework-noauth-generico.sql (http://www.famaf.unc.edu.ar/kohatrad/1-biblio_framework-noauth-generico.sql)

• 2-marc_tag_structure-noauth-generico.sql (http://www.famaf.unc.edu.ar/kohatrad/2-marc_tag_structure-noauth-generico.sql)

• 3-marc_subfield_structure-noauth-generico.sql (http://www.famaf.unc.edu.ar/kohatrad/3-marc_subfield_structure-noauth-generico.sql)

Antes de utilizar: editar y hacer búsqueda y reemplazo en el archivo marc_subfield_structure-noauth-generico.sql del código de biblioteca AR-CdZZZ por el código correspondiente a su biblioteca. Se puede reemplazar por cualquier cadena o gestionar en la Library of Congress el código único apropiado.

• Para aplicar ejecutar:

mysql -ukohauser -pkohapass kohadb < 1-biblio_framework-noauth-generico.sql
mysql -ukohauser -pkohapass kohadb < 2-marc_tag_structure-noauth-generico.sql
mysql -ukohauser -pkohapass kohadb < 3-marc_subfield_structure-noauth-generico.sql

• Fuentes:

• Installing Koha 3 On Ubuntu Hardy Heron (8.04, LTS)

http://wiki.koha.org/doku.php?id=koha_3_install_guide_ubuntu_hardy

• Famaf: Traducción de Koha 3.x a Castellano (es_ES)

http://www.famaf.unc.edu.ar/kohatrad/

• KOHA-ES WIKI: Agregado de idioma español a Koha 3

http://wiki.koha.org/doku.php?id=es:start