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

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.

Pasos

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.

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

Servidor de 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?

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!

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'