Instalación - Actualización

Volver a índice de la
documentación de usuario

Los siguientes procedimientos describen cómo instalar o actualizar Dolibarr.

Procedimiento de instalación

En un puesto/servidor dedicado

Con DoliWamp (paquete Windows .exe)

- Prerrequisitos : Windows

- Nivel: Debutante

Si ya controla la instalación de un servidor Web Apache, Php y MySql, el siguiente capítulo será más apropiado. Para los menos experimentados, que trabajan bajo windows, existe una distribución de Dolibarr llamada DoliWamp que permite realizar una instalación Dolibarr bajo Windows con todos sus prerequisitos (Apache, MySql, PHP) sin conocimientos informáticos. Como instalarla:

• Consigua la versión de Dolibarr para Windows.

Para ello, vea la página descarga de DoliWamp desde NLTechno.

• Ejecute el archivo .exe descargado y sigua las instrucciones.

Con DoliBuntu (Paquete Ubuntu .deb)

- Prerrequisitos : Linux Ubuntu

- Nivel: Debutante

Este proceso funciona únicamente para los usuarios de Linux Ubuntu o Debian, y es recomendado para los que no tengan conocimientos informáticos. Si es un administrador experimentado en Apache, PHP y MySql, el siguiente capítulo le será más útil. En el caso contrario, puede utilizar DoliBuntu. Este paquete le permite instalar Dolibarr en Ubuntu o Debian con todos sus prerrequisitos (Apache, MySql y PHP) sin conocimientos técnicos.

• El proceso para instalar DoliBuntu se describe en la página Dolibarr para Ubuntu.

Con Dolibarr (paquete standard .tgz)

- Prerrequisitos: Apache, PHP y (MySQL o PostgreSQL) están presentes y en funcionamiento.

- Nivel: Unos pocos conocimientos informáticos y de administración web.

Este procedimiento describe la instalación manual (recomendada) en un GNU/Linux (Debian, Mandriva, ...), es válido con otros sistemas, con algunas modificaciones. Es aplicable a cualquier versión de Dolibarr >= 2.0.0

• Asegúrese de tener Apache, PHP y (MySQL o PostgreSQL) instalado (Para ello ver la lista de paquetes instalados en su máquina con el gestor de actualización de paquetes de su distribución).

Nota: El instalador puede opcionalmente crear la base de datos en caso de que no exista, pero en este caso, debe conocer el login administrador de su base de datos y su contraseña.

Para los usuarios de Linux, si acaba de instalar la base de datos MySQL, el login administrador es root. Para inicializar la contraseña, deberá ejecutar el siguiente comando desde un shell root para iniciar el monitor de mysql

mysql

Una vez dentro de la interfaz de MySql, ejecute el comando que dará privilegios y asignará la contraseña al login administrador

grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;

a continuación cierre la sesión tecleando \q

Puede probar la conexión para el usuario creado mediente el comando

mysql -u root -p

tecleando la contraseña newrootpass y \q para cerrar la sesión si todo ha ido bien.

Para los usuarios de Linux, si acaba de instalar la base de datos PostgresSQL, en primer lugar deberá crear un usuario administrador y su contraseña. Para ello añada la siguiente línea en el fichero /etc/postgresql/x.x/main/pg_hba.conf (sustituya x.x con su versión de postgres)

local   all         dolibarrowner    md5

A continuación, bajo un shell root ejecute el comando

sudo -s -u postgres
createuser dolibarrowner
psql -d template1 -c "alter user dolibarrowner with password dolibarrownerpass"
exit
sudo /etc/init.d/postgresql-x.x restart

Puede probar la conexión para el usuario creado mediente el comando

psql -d postgres -U dolibarrowner -W

Y teclee la contraseña dolibarrownerpass y \q para cerrar la sesión si todo ha ido bien.

• Póngase en el directorio en el que instalar Dolibarr (el directorio raíz se define en su servidor web)

1. Para Debian y las familias Ubuntu, generalmente es: /var/www
2. Para Mandriva: /var/www/html
3. Para RedHat: a completar
4. Para Suse: a completar

$ cd /var/www

• Obtener el archivo de la aplicación

$ wget http://www.dolibarr.org/files/dolibarr.tgz

• Descomprimir el archivo

$ tar xvfz dolibarr.tgz

• Cambie el nombre de la carpeta Dolibarr-xyz a Dolibarr con el fin de tener un nombre de directorio independiente de la versión (o xyz corresponde a la versión origen)

$ mv dolibarr-x.y.z dolibarr

• Como root, cambie los permisos para asegurar que todos los archivos son de sólo lectura para los grupos y otros.

$ chmod -R 755 /var/www/dolibarr

• Como root, cree en el directorio Dolibarr/htdocs/conf un archivo de configuración vacío, estableciendo como propietario del archivo al usuario del servidor web (por ejemplo, www-data en debian, nobody en un viejo RedHat , apache en otra versión ...). Esto es necesario debido a que el servidor web tiene que escribir en este archivo durante la instalación.

$ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php

• Todavía como root cree el directorio que guardará los documentos generados o almacenados por Dolibarr (pdf facturas, fotografías, ...), y asígnele como propietario el usuario del servidor web (por ejemplo, www-data en Debian, nobody en Antiguo de Red Hat, Apache en un RedHat o Mandriva reciente ...). El servidor web debe tener derechos de escritura en este directorio.

$ mkdir documents ; chown www-data documents

• Apunte su navegador hacia la página principal

http://127.0.0.1/dolibarr/htdocs/

• Siga las instrucciones de la instalación

• Por razones de seguridad, le aconsejamos que, una vez completada la instalación, cree un archivo install.lock en el directorio de instalación al que sólo root tenga el derecho de borrar. Esto bloquea el proceso de instalación que ya no se podrá llamar por error (para realizar actualizaciones debe ser eliminado).

$ touch /var/www/dolibarr/install.lock; chmod go-w /var/www/dolibarr;

En un host mutualizado

No es posible presentar una solución genérica para este caso, ya que los procesos dependen del hospedaje. En la mayoría de los casos, el proceso de instalación en un puesto/servidor o una pequeña variante puede servir.

Hay unos cuantos documentos y procedimientos específicos para determinados hosts:

• Hosting FREE mutualizado: File:Installation Dolibarr Free-20100526.odt
• Hosting OVH oneclick: OVH propone una antigua versión de Dolibarr instalable desde su interface de administración dentro de su solución "OneClick".

Procedimiento de actualización

Con DoliWamp (paquete .exe)

Si ha instalado la versión Dolibarr específica llamada DoliWamp (que contiene el servidor Web, PHP y mySql), el proceso a seguir es este. En cualquier otro caso, utilice el proceso del siguiente captítulo.

• Descargue la nueva versión de DoliWamp.

• Ejecute el archivo .exe y déjese guuiar en todos los pasos sin cambiar ningún valor de los propuestos por defecto. Esto actualizará todos los ficheros

• Al final de la ejecución, se mostrará su explorador con una página que le preguntará por la actualización de su base de datos. Escoja la opción acorde a su caso.

Si su instalación es muy antigua, deberá ejecutar todos los pasos de actualización uno a uno hasta llegar a la versión más reciente.

Con Dolibarr (paquete standard .tgz)

Este procedimiento describe la actualización manual de Dolibarr (desde una versión anterior) a una más reciente. Se aplica cuando la actualización es para una versión de Dolibarr >= 2.0.0

• Póngase en el directorio donde fue instalado Dolibarr (el directorio raíz de tu servidor web, por ejemplo, /var/www en Debian)

$ cd /var/www

• Obtenga el archivo con la nueva versión

$ wget http://www.nltechno.com/files/dolibarr.tgz

• Descomprima el archivo

$ tar xvfz dolibarr.tgz

• Copie los archivos nuevos (que han sido desempaquetados en el directorio Dolibarr-xyz) al directorio donde usted tiene su versión antigua de Dolibarr. Esto reemplazará los archivos antiguos por los nuevos, manteniendo al mismo tiempo los archivos suyos específicos (como el fichero conf.php o sus módulos complementarios instalados instalados no oficiales).

$ cp -r dolibarr-x.y.z/* dolibarr

• A continuación, puede borrar el directorio de los archivos desempaquetados

$ rm -fr dolibarr-x.y.z

• Apunte su navegador a la página de instalación

http://127.0.0.1/dolibarr/install/

Si obtiene un mensaje de que el proceso de actualización está bloqueado por el archivo install.lock, borre el archivo (se encuentra en la carpeta raíz de Dolibarr)

• Escoja Actualización en el menú propuesto

• Por razones de seguridad, le aconsejamos que, una vez realizada la actualización, bloquee el directorio de instalación. En caso contrario, Dolibarr le advertirá de un mensaje en la interfaz una vez conectado

$ echo > dolibarr/install.lock
$ chmod 444 dolibarr/install.lock

Configurar una conexión LDAP

A completar.

Importar datos externos

Para ello, consulte la página Importaciones.

Configuraciones

Vea la página Primeras configuraciones.