1. Obtenga el software requerido:

• Python 2.5
• Django 1.0.2
• wxis 7.1 (16/60)
• Ext JS 2.1 SDK

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

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 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.

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/

4. Configure un servidor web siguiendo esta 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. 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 ícono de Catalis.

5. Para que el servidor pueda escribir en las bases de datos, configure los permisos de archivos de acuerdo con 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).

Como opción en los puntos 4 y 5, se puede usar el 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?

(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?

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!

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'