======= Instalación de la base de datos =======

* Generalidades
------------

El fichero de configuración de la base de datos es /config/define_db.ini

La aplicación se ha configurado por defecto y en su conjunto, para utilizar la codificación UTF-8.

Cree el usuario 'linea' con la contraseña 'linea' y concédale los permisos requeridos sobre la base de datos previamente creada (llamarla 'linea' también), o bien cambie el nombre de usuario y la contraseña en /config/define_db.ini

¡¡¡ Cambie inmediatamente el usuario y la clave si va a desplegar linea21 en un entorno de producción !!!


* Instalación en MySQL
------------------------

- ejecute el script /scripts_sql/buildDB.mysql.sql
- ejecute el script /scripts_sql/input.mysql.es.sql parar inserar datos en la base (requerido)


* Instalación en PostGreSQL
------------------------

- ver la sección "instalación en PostGreSQL"


======= Parámetros específicos de la instalación =======

Recuerde: desde la versión 1.2, Linea21 dispone de un configurador de ficheros del sistema, denominado "módulo de configuración" 

Si no utiliza el configurador, la parametrización específica de su instalación se efectúa en el fichero /config/define_release.ini
En una instalación típica, deben parametrizarse las secciones siguientes: SERVER_SETTINGS, MAIL_INFORMATIONS y MAIL_SETTINGS
Linea21 se distribuye con el nombre de organización "mylinea" por defecto. Modifique en su instalación las secciones necesarias con la URL, las direcciones e-mail y el nombre de su organización.


======= Acceso a la interfaz de administración =======

Para acceder a la interfaz de administración, abra linea21 en su navegador.
La URL será similar a:

http://localhost/linea21/admin/

login : admin
password : linea

¡¡¡ Cambie la contraseña de administrador si ha desplegado linea21 en producción !!!


======= Definir la raíz del sitio web =======

Determinadas operaciones apelan a las constantes SITE_CITY_URL, SITE_ROOT_URL y SITE_PATH definidas en /config/define_release.ini
Asegúrese de que los valores establecidos son los correctos.

SITE_CITY_URL = "http://localhost/linea21/public/" //en local
SITE_CITY_URL = "http://linea21.misitioweb.com" //en línea

SITE_ROOT_URL = "http://localhost/linea21/" //en local
SITE_ROOT_URL = "http://www.misitioweb.com" //en línea

SITE_PATH = "C:/server/apache/Apache2/htdocs/linea21/" // ejemplo sobre Windows

Consulte la variable $_SERVER["DOCUMENT_ROOT"] y añádale el nombre del directorio de instalación de Linea21 para definir el valor de SITE_PATH


======= Advertencia sobre la codificación UTF-8 =======

Los archivos de la aplicación están codificados en UTF-8. Para modificarlos es preciso utilizar un editor de texto que soporte esta codificación, y guardar los ficheros en el mismo formato.


======= Migración desde la versión 1.1 hacia 1.2.x =======

1 - Salvaguarde la aplicación existente: por defecto, el directorio linea21

2 - Haga una copia de seguridad de la base de datos existente: mysqldump -hlocalhost -ulinea -plinea linea21 > /home/backup_linea21/linea21_1_date.dmp

3 - Integre el parche de migración (en /scripts_sql/patches) hacia linea21 1.2.x: mysql -hlocalhost -ulinea -plinea linea21 < /home/linea21/scripts_sql/patches/patch_1.2.mysql.es.sql

4 - Elimine la aplicación existente: rm -R /home/linea21 también puede instalarla en un nuevo directorio.

5 - Descomprima el archivo con la nueva versión de linea21: linea21_1_2.zip ó linea21_1_2.tgz en el directorio de ejecución apache, por ejemplo /home/linea21

6 - Aplique los parámetros específicos de su instalación, moviendo los siguientes ficheros:
	/config/define_release.php (versión antigua) -> config/define_release.ini (nueva versión)
	/config/define_db.php (versión antigua) -> config/define_db.ini (nueva versión)

7 - Copie los contenidos de los siguientes directorios de la antigua versión sobre la nueva:
	/contents/input
	/multimedia/input
	/news/input
	/newsletter/input
	/publication/contents
	/user/avatar


Si va a utilizar la opción URL Rewrite del servidor web, verifique la parametrización del fichero /public/.htaccess de acuerdo con la configuración de virtualhost.

Traslade cualquier configuración específica efectuada en la antigua versión sobre los ficheros de la nueva (por ejemplo: /public/tpl_home.php).

La versión 1.2.x integra un nuevo sistema de plantillas. Por defecto, la aplicación lee los archivos ubicados en /public/dist/. Puede crear sus propias plantillas y ponerlas directamente en /public/. Las plantillas de usuario tienen preferencia respecto a las plantillas por defecto.


======= Migración desde la versión 1.2.x hacia 1.3  =======

- repetir los pasos 1, 2, 3, 4, 5, 6 (arriba)
- Para el paso 3 : Ejecute el script /scripts_sql/patches/patch_1.3.mysql.sql


======= Documentación y soporte =======

http://dev.linea21.com				Wiki - Bug tracker
http://www.linea21.com/forum		Foro
http://www.linea21.com				Sitio web


======= Instalación en PostgreSQL =======

	1 - Cree la base de datos denominada 'linea'

	2 - Ejecute el script /scripts_sql/buildDB.pgsql.sql
	
	3 - Ejecute el script /scripts_sql/input.pgsql.es.sql

	4 - Modificar el valor de la constante 'SQL' definida en /config/define_release.ini.  Sustituir el valor por defecto 'mysql' por 'pgsql'.

¡¡¡ La versión 1.2.x no permite el funcionamiento del módulo 'búsqueda' con las versiones de pgsql >= 8.3 !!!

Motor de búsqueda PostgreSQL: Instalación de Tsearch2 (versión PGSQL <= 8.3)

	5 - Ejecutar el script SQL tsearch2.sql situado en /share/contrib/ del directorio raíz de PostgreSQL, con el fin de implementar el motor de búsqueda FTI (Full Text Indexing).

	6 - Por último, ejecutar el script/scripts_sql/buildDBindex.pgsql.sql para crear los índices requeridos para el correcto funcionamiento del motor de búsqueda interno.

Para mejorar la funcionalidad del motor de búsqueda se recomienda agregar un diccionario al FTI.

Diccionarios disponibles y procedimientos de instalación::

http://www.sai.msu.su/~megera/postgres/gist/tsearch/V2/
http://www.sai.msu.su/~megera/postgres/gist/doc/intro.shtml

Si va a instalar un diccionario, probablemente necesite cambiar el esquema especificado para la búsqueda. Edite /search/pgsql.inc.php, cambiando el valor \'default\' por el definido en la base de datos.


======= Errores frecuentes =======

* Instalación de la base de datos en postgresql:
   IF EXISTS solamente está disponible a partir de la versión 8.2. Suprima la instrucción en el script de instalación.
 
   
   





