Notas antes de la instalación

EspaBiblio deriva de OpenBiblio, pero no es conveniente actualizar OpenBiblio en ingles a EspaBiblio en español ya que EspaBiblio ha sufrido algunas modificaciones en las bases de datos las cuales han sido adaptadas a nuestros requerimientos, aunque las bases de datos son muy similares. Lo recomendable es hacer una Exportación de los registros a formato SQL de todas las bases de datos de openBiblio y después insertarlos en EspaBiblio mediante la herramienta gratuita de gestión de bases de datos Mysql phpmyadmin.

EspaBiblio es compatible con las versiones de PHP 4.2.0 en adelante ya que entre sus funcionalidades posee la generación de archivos PDF, para la impresión de etiquetas o cartas por material en atraso.

Si UD. necesita migrar datos de otros programas a EspaBiblio quizás necesite contactar al soporte técnico de EspaBiblio para analizar la factibilidad, y si UD ha usado como bases de datos un registro en una planilla de MS Exel también es posible conservar esos registros mediante la exportación a Mysql, si usted realiza todo esto por sus cuenta tenga presente que el o los creadores de EspaBiblio no serán responsables ante cualquier desastre que pueda ocurrir.

EspaBiblio ha sido testeado satisfactoriamente en los siguientes Sistemas Operativos :

Nota: Esto manual exige poseer cierta experiencia en Mysql

Contenidos:

Notas de la Versión :

EspaBiblio 2.0 introduce un nuevo sistema de impresión y los informes. Este nuevo sistema evita la escalada de privilegios agujero de seguridad en el antiguo sistema de informes.

Ver el ChangeLog para más detalles.

EspaBiblio funcionó s con éxito en las siguientes configuraciones despues de realizar un conjunto de pruebas:

Operating System: Ubuntu 6.06.1 (GNU/Linux) Ubuntu 6.06.1 (GNU/Linux) Ubuntu 6.06.1 (GNU/Linux) Windows Vista Bussiness
PHP Version: 5.1.2 5.1.2 5.1.2 5.2.3
Web Server: lighttpd/1.4.8 lighttpd/1.4.8 lighttpd/1.4.8 XAMPP 1.6.3a
MySql Version: 5.0.22 5.0.22 4.0.12 5.0.45
Browser: Firefox 1.5.0.8 MS Internet Explorer 6.0.2800.1106 (under Wine) Firefox 1.5.0.8 Firefox 2.0 / MS IExporer 7.0

Instrucciones de Instalación (sistema nuevo):

Requiremientos

Procedimiento

  1. Instalar un servidor web como Apache, que es compatible con PHP. Si instala Apache, debe familiarizarse con arrancar y detener su servidor Web Apache. Si está utilizando Windows 95 o Windows 98 no habrá "Start Apache" y "Stop Apache" iconos que le ayudarán a iniciar y detener su servidor web. Si lo desea, puede considerar la posibilidad de añadir un icono "Start Apache" en su carpeta de inicio. Si está ejecutando NT o Windows 2000 puede agregar Apache como un servicio que va a correr, al iniciar el sistema. Si está ejecutando Linux de su servidor Apache debe ser empaquetado con su instalación de Linux y se iniciará cuando se inicia Linux.
  2. Añadir PHP en su servidor web como modulo de apache. Si está usando Apache 2,0, le recomendamos que instale PHP como un módulo en lugar de una aplicación cgi. En mi experiencia el módulo de Apache de PHP realizó más de 4 veces más rápida que la de CGI de PHP. Ver Ejemplo 3-9. 2,0 Apache y PHP como módulo, vea el Manual de PHP para obtener más información sobre la instalación de PHP como un módulo.

  3. EsaBiblio utiliza datos de sesión. Por lo tanto, usted tendrá que asegurarse que las sesiones de PHP están activadas. Asegúrese de crear un directorio para el período de sesiones de datos en su servidor y especifique el session.save_path en su archivo php.ini. El valor por defecto de php.ini establece session.save_path "/ tmp". Por lo tanto, usted tiene que crear un directorio llamado c: / tmp (para Windows) de usuarios. Sin embargo, por lo general puede crear un nombre más descriptivo dentro del directorio de PHP y luego cambiar el archivo php.ini.

    Ejemplo de la directiva php.ini: 

    session.save_path = C:\PHP\sessiondata

    Véase la sección XCIII en el manual PHP . El eríodo de sesiones y las funciones de gestión de PHP para más detalles sobre las sesiones.

  4. Instalación de la base de datos MySQL desde http://www.mysql.com/. para mas información de como arrancar y parar el servidor MySQL en win 95/98. Véase Arrancar MySQL en Windows 95 o Windows 98 para obtener más información.

    Si está ejecutando Windows NT o 2000, Instale MySQL como un servicio para que arranque cada vez que la máquina de poderes. Véase Starting MySQL on Windows NT or Windows 2000. Para más información sobre cómo comenzar con MySQL como un servicio.

    Si está ejecutando Linux, MySQL debe ser empaquetado con su instalación de Linux y se iniciará cuando se inicia Linux.

  5. Puede Familiarícese con la consola en MySQL con su cuenta de administrador dentro de una ventana de DOS. Puede utilizar la siguiente secuencia de comandos como una prueba. 
    C:\>c:\mysql\bin\mysql -uroot mysql
Enter password: *********
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 8 to server version: 3.23.26-beta

Type 'help;' or '\h' for help. Type '\c' to clear the buffer

mysql> show databases;
+--------------+
| Database     |
+--------------+
| mysql        |
+--------------+
6 rows in set (0.00 sec)

mysql> exit
Bye

C:\>
  6. Crear una base de datos EspaBiblio. Para ello, acceda a MySQL con su cuenta de administrador y ejecute el siguiente comando SQL. 
    mysql> create database EspaBiblio;
    Para comprobar y asegurarse de que la base de datos EspaBiblio se ha creado correctamente, ejecute el siguiente comando. 
    mysql> show databases;
+--------------+
| Database     |
+--------------+
| mysql        |
| EspaBiblio   |
+--------------+
  7. Crear una base de datos de usuario Espa
    8. Biblio. Para ello, acceda a MySQL con el usuario admin y ejecute el siguiente comando SQL, sustituyendo ebiblio_user y ebiblio_password Con su identificación de usuario y contraseña de su elección (debe haberlo creado antes como usuario de Mysql). 
  8. mysql> grant all privileges on EspaBiblio.* to ebiblio_user@localhost
    -> identified by 'ebiblio_password';
  9. Verifique su base de datos EspaBiblio y el usuario, luego acceda a la nueva base de datos MySQL con su nuevo usuario ebiblio_user (o que que ud. ha creado). 
    C:\mysql\bin\mysql -u ebiblio_user -pebiblio_password EspaBiblio
  10. copiar el directorio y todo su contenido de EspaBiblio en el servidor web instalado dentro de la carpeta htdocs o cualquier subdirectorio dentro de la htdocs..
  11. Editar el archivo database_constants.php (ubicado en el directorio principal Espabiblio) con el editor de texto de su elección. Cambiar el nombre de usuario y la contraseña para que coincida con el nuevo usuario de MySQL y contraseña que haya creado en los pasos anteriores.
    12.
  12. Crear tablas de la base de datos de EspaBiblio. Para ello ejecutar el script php instalar situado en la ruta http://localhost/espabiblio/install/index.php, asumiendo que esa es ruta donde esta almacenada la aplicación (conf. por defecto).
  13. Por Seguridad :Elimine el directorio de instalación (install) por completo para prevenir el uso no autorizado de instalar o actualizar la versión por terceros.
  14. Por Seguridad : Compruebe que la configuración en php.ini display_errors esta en ' Off 'para impedir la divulgación de información no deseada.
  15. Acceder a su nuevo sistema de automatización de bibliotecas en http://localhost/espabiblio/index.php, asumiendo que espabiblio esta colocado en el directorio raíz htdocs. Escriba "admin" tanto para el usuario y la contraseña cada vez que se le solicite. Puede cambiar la contraseña de administrador de la "Admin" pestaña -> lista de personal, donde se puede también agregar más personal de las bibliotecas miembros (es recomendado cambiar la contraseña que viene por defecto).

Actualizar una versión anterior de EspaBiblio:

IMPORTANTE: Las actualizaciones desde versiones OpenBiblio anteriores (por ejemplo, 0.5.1.7) debe realizarse manualmente. El script de actualización automática no sabe cómo manejar la base de datos ya que existen diferencias.

Nota: Este mensaje es solo para Los usuarios de OpenBiblio (aunque no recomiendo hacer este tipo de actualización una persona con experiencia lo puede realizar asumiendo las probelmas que puedan aparecer)

Para la versión 1.0 de EspaBiblio no existe ningún inconeviente en realizar esta actualización (antes debe estar seguro que no ha modificado las bases de datos)

  1. Cambiar el nombre de su antiguo directorio de EspaBiblio de e manera que no pierda su contenido. Le llamaremos el antiguo espabiblio_old.
  2. Copiar el nuevo directorio de EspaBiblio y todo su contenido en el directorio donde estaban los archivos de instalación antiguos.
  3. Copie el archivo de la database_constants.php espabiblio_old, en el nuevo directorio espabiblio, y sustituyalo por el existente, tambien puede editar el fichero database_constants.php y volver a agregar la base de datos y el usuario (Lo mejor es reemplazarlo por el anterior que posee).
  4. Copia de seguridad de su base de datos. Consulte su documentación de MySQL para obtener instrucciones
  5. Actualizar las tablas de la base de datos de EspaBiblio. Para ello ejecutar el script php instalar situado en la ruta http://localhost/espabiblio/install/index.php, asumiendo que esa es ruta donde esta almacenada la aplicación (conf. por defecto).
  6. Por Seguridad :Elimine el directorio de instalación (install) por completo para prevenir el uso no autorizado de instalar o actualizar la versión por terceros.
  7. Por Seguridad : Compruebe que la configuración en php.ini display_errors esta en ' Off 'para impedir la divulgación de información no deseada.