====== Instal·lació de AbanQ - FacturaLux sobre una base de dades MySQL ======

Les següents instruccions expliquen com instal·lar [[http://www.abanq.org | AbanQ - FacturaLux]] i [[http://www.mysql.com | MySQL]] sobre Linux (s'ha testejat en un Linux Ubuntu 6.06).

Si vols instal·lar AbanQ - FacturaLux sobre Windows (recorda que AbanQ - FacturaLux funciona sobre Windows NT i 2000 i amb algun problema sobre Windows XP) els passos a seguir són similars:
  * Utilitza un descompressor de fitxers sobre windows (per exemple [[http://www.7-zip.org | 7-zip]]).
  * La base de dades MySQL la trobaràs [[http://dev.mysql.com/downloads/mysql/4.1.html | aquí]]. Escull la versió Windows Essentials (x86).

Si vols instal·lar AbanQ - FacturaLux sobre una base de dades postgreSQL segueix [[servers:postgresql | aquestes indicacions]] enlloc de les de mySQL.

===== Instal·lació de AbanQ - FacturaLux =====

Visita el web www.abanq.org, ves a la zona de descàrregues i et baixes l'aplicació base adequada a la teva plataforma (GNU/Linux, Windows 2000/NT o Mac OSX Tiger). Per exemple, si utilitzes Linux et descarregues el fitxer abanq-2.2.x86.Linux.bin.zip.

Suposem que descarregues aquest fitxer a l'escriptori (subdirectori **Desktop**).

Encara que alguns pasos del que expliquem a continuació es poden fer en mode gràfic, els farem des de la línea de comandes perquè és més fàcil explicar-ho i no hi ha lloc a equivocacions (pots copiar i enganxar les comandes).

  * Obrim una terminal (//Aplicacions / Utilitats / Terminal//)
  * Canvia al directori de l'escriptori:
<code>
cd Desktop
</code>
  * Descomprimeixes el fitxer abanq-2.2.x86.Linux.bin.zip:
<code>
unzip abanq-2.2.x86.Linux.bin.zip
</code>
  * Executa la comanda d'instal·lació com a superusuari:
<code>
sudo sh ./abanq-2.2.x86.Linux.bin.run
</code>
  * Accepta la llicència i el programa s'instal.larà

===== Instal·lació de la base de dades MySQL =====

Cal instal·lar els paquets:
  * mysql-server-4.1
  * mysql-common
  * mysql-client-4.1

Ho pots fer amb el programa //Aplicacions / Sistema / Gestor de paquets Synaptic// o des de la línie de comandes:
<code>
sudo apt-get install mysql-server-4.1 mysql-common mysql-client-4.1
</code>

===== Introducció de la contrasenya d'usuari root de MySQL =====

Ara has d'introduir el primer password de l'usuari principal (root) de MySQL. Escriu això a la línia de comandes canviant **novapassword** per la password que vulguis:

<code>
$ mysqladmin -u root -h localhost password 'novapassword' -p
</code>

Per a més detalls consulta [[servers:mysql#Introduir el primer password d'usuari root]].

===== Creació de la base de dades facturalux =====

Ara has de crear una base de dades anomenada facturalux:
<code>
mysqladmin -u root -p create facturalux
</code>

===== Arrancar FacturaLux =====

El programa FacturaLux està disponible en el menú //Aplicacions / Altres / FacturaLux// o des de la línia de comandes:
<code>
/usr/local/facturalux-lite/bin/fllite
</code>

Ens demana la base de dades a connectar. Fes clic a la icona vertical de la dreta (Més opcions) Introdueix les següents dades:
  * Base de dades: facturalux
  * Usuari: root
  * Contrasenya: La contrasenya que has assignat anteriorment a l'usuari root de MySQL
  * Controlador: MySQL
  * Servidor: localhost
  * Port: 3306

Nota: En el cas que la B.D. fos postgreSQL cal canviar el controlador (postgreSQL) i el port (5432).

L'aplicació arranca però només tenim disponible el mòdul //Sistema / Administración//. En el següent apartat instal·larem els altres mòduls.

===== Instal·lació de mòduls addicionals =====

Visita el web www.abanq.org, ves a la zona de descàrregues i et baixes els Mòduls oficials (actualment versió 2.1). Suposem que descarregues aquest fitxer a l'escriptori (subdirectori **Desktop**).

  * Obrim una terminal (//Aplicacions / Utilitats / Terminal//)
  * Canvia al directori de l'escriptori:
<code>
cd Desktop
</code>
  * Descomprimeixes el fitxer modulos-abanq-2.1.tar.bz2:
<code>
bunzip2 modulos-abanq-2.1.tar.bz2
tar -xvf modulos-abanq-2.1.tar
cd modulos-abanq-2.1
tar -xvzf cont-informes-2.1.tar.gz
tar -xvzf cont-principal-2.1.tar.gz
tar -xvzf fact-almacen-2.1.tar.gz
tar -xvzf fact-facturacion-2.1.tar.gz
tar -xvzf fact-informes-2.1.tar.gz
tar -xvzf fact-principal-2.1.tar.gz
tar -xvzf fact-tesoreria-2.1.tar.gz
</code>

Instal·larem els 7 mòduls que tenim descarregats a la carpeta Desktop/modulos-abanq-2.1/facturalux-modulos-oficial-2.1 que hem descomprimit abans:
  * Facturación / principal
  * Facturación / facturacion
  * Facturación / almacen
  * Facturación / tesoreria
  * Facturación / informes
  * Contabilidad / principal
  * Contabilidad / informes

El procés és senzill i intuitiu. [[http://abanq.org/documentacion/documento.php?ref=guia_instalacion | Aquí]] està explicat pas a pas com fer-ho amb l'ajut de captures de pantalla.

===== Documentació addicional =====

També et pots descarregar la documentació sobre com utilitzar de FacturaLux [[http://abanq.org/documentacion | aquí]].

===== Com arreglar problema introducció de vocals accentuades =====

És possible que en les instal·lacions sobre Linux la introducció de vocals accentuades i caràcters com la ç i ñ no funcioni bé (al teclejar alguns d'aquests caràcters apareixen caràcters estranys). Això és degut a que FacturaLux encara treballa amb la codificació de caràcters ISO-8859-15 (ho canviaran en properes versions) i el nostre Linux està configurat amb la codificació de caràcters més moderna UTF-8. Podem veure quina tenim per defecte si en una terminal escrivim:
<code>
set|grep "LANG"
</code>

Per arreglar-ho cal crear un script (fitxer de text executable) que canviï la codificació de caràcters abans d'executar FacturaLux. Des de la línia de comandes:
<code>
cd /usr/local/facturalux-lite/bin
sudo mv fllite fllite2
sudo gedit fllite
</code>

Dins de l'editor de text introduïm el següent text (copia i enganxa) i el guardem:
<code>
#!/bin/sh

export LANG="ca_ES.ISO-8859-15"
/usr/local/facturalux-lite/bin/fllite2
</code>

Després li donem permisos d'execució des de la línia de comandes:
<code>
sudo chmod a+x fllite
</code>

Ara s'ens executarà FacturaLux de forma que podrem teclejar qualsevol caràcter correctament.

===== Instal·lar Arial Narrow =====
AbanQ utilitza la tipografia Arial Narrow per generar informes i PDF's. Si no es troba instal·lada, es reemplaça per una altra del sistema, fent que no es visualitzi de la manera desitjada.

Amb Ubuntu la tipografia Arial Narrow no es troba amb el paquet **msttcorefonts** (Arial es una tipografia similar a l'Helvetica propietat de Microsoft).

Per instal·lar l'Arial Narrow farem:

Baixar-nos el fitxer ttf de [[http://penguinfonts.com/fontinfo.php?id=5056 | Pinguin Fonts]]

Obrim una terminal i executem:
<code>
$ sudo mkdir /usr/share/fonts/truetype/myfonts (en el cas que no tinguem el directori creat)
$ sudo mv Desktop/Arial_Narrow.ttf /usr/share/fonts/truetype/myfonts
$ sudo fc-cache -f -v
</code>

[[http://penguinfonts.com/howto/ubuntu.php|HOWTO Install fonts on Ubuntu]]