====== Instalación de la versión de desarrollo de Catalis (2008) ======

<note>
Estas son notas preliminares para orientar a quienes hagan pruebas de instalación de Catalis. No deben considerarse de ninguna manera una versión final, ni destinadas a un //usuario// de Catalis.
</note>







===== Pasos =====


**1.** Obtenga el software requerido:

    * [[http://www.python.org/download/|Python 2.5]]
    * [[http://www.djangoproject.com/download/|Django 1.0.2]]
    * <del>[[http://bvsmodelo.bvsalud.org/php/level.php?lang=es&component=28&item=2|wxis 7.1 (16/60)]]</del>
    * <del>[[http://extjs.com/products/extjs/download.php|Ext JS 2.1 SDK]]</del>

Los dos primeros se instalan fácilmente. <del>; los dos restantes deben copiarse según se indica más adelante en **3**.</del>

También necesitará un servidor web, que supondremos es **Apache 2.x** con **mod_python**; la configuración requerida se explica más adelante, en **4**.

Como cliente debe usarse **Firefox 2 o 3**. (Para Internet Explorer aún hay
que corregir algunos problemitas.)

**2.** Descargue la versión más reciente de Catalis usando un [[http://subversion.tigris.org/links.html#clients|cliente Subversion]], en una carpeta de su elección (vea http://code.google.com/p/catalis/source/checkout). De aquí en adelante nos referiremos al path de esa carpeta como ''CATALIS_DIR''. P.ej., si la ubicación es ''/home/pepe/dev/catalis'', tendremos
''CATALIS_DIR'' = '''/home/pepe/dev/catalis/'''

Note que si está usando un //proxy// para acceder a la Web, deberá configurar apropiadamente el cliente de Subversion.

<del>**3.** Copie wxis y Ext en las carpetas correspondientes (o cree links simbólicos
si prefiere conservarlos en otra ubicación):

  * El archivo ''wxis''     en ''CATALIS_DIR/cgi-bin/''
  * La carpeta ''ext-2.1''  en ''CATALIS_DIR/static_files/''
</del>

**4.** Configure un servidor web siguiendo esta [[http://catalis.uns.edu.ar/doku/doku.php/django_con_apache_y_mod_python#ejemplo_de_configuracion|configuración de muestra]]. Recomendamos crear un nuevo virtual host, pero también pueden agregarse las directivas a la configuración de un host existente.

De aquí en adelante nos referiremos con SERVER al nombre de dominio (o número de IP) más el número de puerto que haya usado para su servidor. P.ej., si se usa 127.0.0.1 y el puerto 82, tendremos
SERVER = '127.0.0.1:82'.

**Intermedio.** Haga estas **comprobaciones** básicas, como para asegurar que todo esté marchando correctamente hasta este punto:

    * Python: ingrese a una consola y ejecute el comando ''python''. Debe ver el mensaje inicial del intérprete Python.
    * Django: dentro de esa misma consola, ejecute ''import django''. Debe ver que no se produce ningún mensaje de error.
    
    * Ext: acceda con el navegador a ''http://SERVER/catalis/media/ext-2.2/ext-all.js''. Debe ver un archivo JavaScript.
    * wxis: acceda con el navegador a ''http://SERVER/catalis/cgi-bin/wxis?hello''. Debe ver un mensaje de identificación de wxis. FIXME no deberíamos permitir el acceso directo a wxis desde la web, sólo para clientes locales. 
    * Catalis (archivos estáticos): acceda con el navegador a ''http://SERVER/catalis/media/catalis/img/favicon.ico''. Debe ver el [[http://catalis.uns.edu.ar/favicon.ico|ícono de Catalis]].


**5.** Para que el servidor pueda escribir en las bases de datos, configure los
**permisos** de archivos de acuerdo con [[http://catalis.uns.edu.ar/doku/doku.php/django_con_apache_y_mod_python#permisos|estas indicaciones]]. Esto solo es indispensable para crear/modificar/borrar datos; puede omitirse para una primera prueba de Catalis.

**6.** Cree una copia del archivo ''CATALIS_DIR/django_files/settings_local.template'', dentro de esa misma carpeta, y renómbrela como ''settings_local.py''. Abra este archivo con un editor. Sólo deberá modificar las siguientes opciones, en caso de que los valores por defecto no correspondan con los de su instalación:

   * WXIS_HOST
   * WXIS_PORT
   * WXIS_PATH


**7.** Ingrese con su navegador a

    http://SERVER/catalis/

Aparecerá el formulario de login; use estos datos:

    usuario: test
    contraseña: test

Debe encontrarse con una interfaz levemente similar a ésta: http://inmabb-ddd.criba.edu.ar/catalis-dev-2008.png (el aspecto exacto puede ir cambiando a medida que avance el desarrollo).


===== Servidor de desarrollo =====

Como opción en los puntos **4** y **5**, se puede usar el **[[http://www.djangoproject.com/documentation/django-admin/#runserver-optional-port-number-or-ipaddr-port|servidor de desarrollo de Django]]** para servir archivos dinámicos y estáticos, y usar Apache sólo para acceder a wxis. De hecho, esta es la opción recomendada si se pretende trabajar haciendo cambios en el código Python de Catalis. En tal caso, no se necesita modificar la configuración de permisos para la base sqlite. 



**TO-DO:** cómo mantener la instalación actualizada usando SVN?






===== Diferencias entre versiones para Linux y Windows =====

(En construcción!)

  * python depende del SO
  * wxis depende del SO

  * settings.py: qué barras se usan en los paths? Ver Django docs (pero parece que no necesitamos especificar ningún path en forma explícita)

  * bases de datos isis: generar a partir de un archivo de texto. usamos id2i o wxis para crear el archivo maestro? Luego generamos el invertido (con wxis o con mx?). Y los permisos?

      wxis: usando 'H tag len content'
      id2i?

  * permisos: que pasa en windows?



===== Observaciones sobre la guía de instalación =====

Lo que sigue es una lista de observaciones enviadas por Rubén Mansilla, que servirán de base para mejorar la guía de instalación. ¡Gracias Rubén!

<file>
Observaciones realizadas sobre:
http://catalis.uns.edu.ar/doku/doku.php/instalacion_de_catalis_con_django

Pasos
1. ok
2. Para poder realizar la operación de checkout de la última versión de 
   Catalis, deberá contar con un cliente SVN. Puede encontrar una lista de 
   algunos de los clientes disponibles aquí: 
   http://subversion.tigris.org/links.html#clients

   Suponiendo el uso de TortoiseSVN (http://tortoisesvn.tigris.org/), la
   operación de checkout podrá realizarse siguiendo los pasos detallados en:
   http://wsmoak.net/subversion/demo/tsvn-checkout.html

   * Usuarios que emplean proxies http:
   Es posible que para conectarse a Internet Ud deba especificar un servidor 
   proxy http. Suponiendo el uso de TortoiseSVN 
   (http://tortoisesvn.tigris.org/), Ud podrá indicar el servidor proxy a usar 
   siguiendo las instrucciones descritas en:
   http://tortoisesvn.net/docs/release/TortoiseSVN_es/tsvn-dug-settings.html
   (sección: Configuración de red)
   
   * Problemas al realizar el checkout para usuarios que emplean proxies http:
   Es posible que, para algunas configuraciones de los servidores proxies 
   http, no sea posible realizar la operación de checkout. Un posible error 
   informado por el cliente svn al intentar realizar el checkout es:

   --
       svn: requerimiento REPORT falló en '/svn/!svn/vcc/default'
       svn: REPORT de '/svn/!svn/vcc/default': 400 Bad Request
            (http://catalis.googlecode.com)
   --
   
   Si experimenta estos problemas, deberá comunicarlos a su administrador de
   red para que implemente la solución al mismo. Una solución está detallada 
   para este problema se encuentra en:
   http://wiki.lifetype.net/index.php/Subversion_Repository#Subversion_and_Squid
   
3. --
4. NOTA 1: debe reemplazarse /PATH/TO/CATALIS por el path que corresponda.
   * Ejemplo para usuarios Windows:
   Si la carpeta en la que se realizó la copia de Catalis es:
   --
       c:\project\catalis-dev
   --
   entonces /PATH/TO/CATALIS se reemplazará por:
   --
       c:/project/catalis-dev
   --
   Debe advertirse el uso de / en lugar de las \ propias de los paths en 
   ambientes Windows.

   * Intermedio: Para poder realizar la comprobación
     wxis: acceda con el navegador a http://SERVER/catalis/cgi-bin/wxis?hello

     deberá sustituir wxis por el nombre correcto del programa que se incluye
     en la distribución (dentro del directorio /path/to/catalis/cgi-bin/):

     1. Usuarios linux: wxis1660-7.1
     2. Usuarios Windows: wxis1660-7.1.exe

5. ¿Es posible que ambientes Windows no sea necesario realizar este cambio?
6. La ubicación del archivo en el que deben realizarse los cambios no es:
   "CATALIS_DIR/django/catalis_pack/settings_local.template", sino
   "CATALIS_DIR/django_files/settings_local.template"

   Modificación de WXIS_PATH:
   1. Usuarios Linux:
      WXIS_PATH ='/catalis/cgi-bin/wxis1660-7.1'
   1. Usuarios Windows:
       WXIS_PATH ='/catalis/cgi-bin/wxis1660-7.1.exe'
</file>


{{tag>catalis desarrollo}}