Interchange How-To for Red Hat Linux ES4

Un sistema versátil de servidor de aplicaciones, catálogo electrónico, y despliegue de bases de datos.

Características

Open source.

Escrito en Perl.

Automatiza y conecta sitios web con bases de datos.

Esencialmente es un servidor de aplicaciones.

Usos: e-commerce (B2C B2B), CMS, Gestión de Proyectos,colaboración etc.

Características (2)

Funciona stand-alone o como parte de sistemas más complejos: ERP, POS etc.

Extensible.

SIN EMBARGO

Curva de aprendizaje larga.

Cierto nivel de complejidad: no aconsejable en proyectos de corto alcance.

Historia

1995: Andrew Wilcox desarrolla “VEND” para e-commerce.

Retomado por Mike Heins como “MiniVEND” en los 4 siguientes años. Miles de instalaciones.

AKOPIA desarrolla a la vez otro sistema e-commerce, Tallyman.

AKOPIA adquiere MiniVEND para complementar su paquete.

Historia (2)

Se combinan ambos productos lanzando así INTERCHANGE.

En 2001 Red Hat adquiere AKOPIA y con ello a INTERCHANGE.

En 2002 Red Hat abandona el producto.

INTERCHANGE queda en manos de la comunidad OS que lo ha seguido mejorando coordinado por el Interchange Development Group, y sigue vigente.

Plataformas

Linux

BSD

Solaris

Mac OS-X

Otras variantes UNIX.

Licenciamiento

Licencia GNU GPL

Copyright del Interchange Development Group, Red Hat y de desarrolladores individuales.

Sitio web

http://www.icdevgroup.org/

Ejemplo de tienda (1)

Interface Administrativa (1)

Interface administrativa (2)

Interface administrativa (3)

Instalación

Versión actual 5.4.0

Requisitos: Perl (sin hilos), Apache, gdbm, gdbm-devel, ncftpget

Descarga fuentes de Interchange desde el website icdevgroup (aprox 2.2 MB)

No hay aún RPM binaria de la versión vigente.

Tener en cuenta afiliarse a las listas de correo y foros de desarrollo y usuarios.

Procedimiento instalación (1)

# wget http://ftp.icdevgroup.org/interchange-latest.tar.gz

--09:36:38-- http://ftp.icdevgroup.org/interchange-latest.tar.gz

=> `interchange-latest.tar.gz'

Resolving ftp.icdevgroup.org... 69.57.146.17

Connecting to ftp.icdevgroup.org|69.57.146.17|:80... connected.

HTTP request sent, awaiting response... 200 OK

Length: 2,295,141 (2.2M) [application/x-gzip]

100%[====================================>] 2,295,141 75.10K/s ETA 00:00

09:37:05 (83.38 KB/s) - `interchange-latest.tar.gz' saved [2295141/2295141]

Verificación librería gdbm en Red Hat Linux (si no está: instálela):

# rpm -qa | grep gdbm

gdbm-devel-1.8.0-24

gdbm-1.8.0-24

#

Perl debe estar compilado sin soporte a threads (hilos) !!  RED HAT LO TRAE CON SOPORTE HILOS !!

Obtenga e instale ncftp

Website: http://www.ncftpd.com/download/

URL descarga: ftp://ftp.ncftp.com/ncftp/ncftp-3.1.9-src.tar.gz

Instalación:

tar zxvf ncftp-3.1.9.src.tar.gz

cd ncftp-3.1.9.src.tar.gz

./configure

make

make install

(Quedará disponible en /usr/local/bin)

Corregir situación con Perl:

Instalaremos una nueva instancia de Perl pero sin soporte de threads.

$ perl -MCPAN -e 'shell'

cpan shell -- CPAN exploration and modules installation (v1.7601)

ReadLine support enabled

(otros anuncios)

cpan> install N/NW/NWCLARK/perl-5.8.5.tar.gz

(Elegir todas las contestaciones “por defecto” excepto la que tiene que ver con soporte de threads). Seleccione una fuente de descargas de Norteamérica, preferiblemente.

Siguiendo la línea de comando CPAN:

Reinstalar Perl recompilando para quitar el soporte de threads.

Seleccione /usr/local como destino de la nueva versión de Perl.

Quedarán 2 instalaciones de Perl simultáneamente en la máquina. Se recomienda no quitar la original (RPM instalada por defecto en RHEL).

Procedimiento demorado, con muchas preguntas (normalmente confirmar valor por defecto).

Se confirma entre otras la existencia de la librería lgdbm que recién hemos instalado o confirmado.

Si todo termina bien, abandone CPAN con “quit”.

Verificamos Perl

/usr/local/bin/perl –v

This is perl, v5.8.5 built for i686-linux OK!

El Perl original de la máquina está aún en /usr/bin/perl , y produce un banner distinto:

/usr/bin/perl -v

This is perl, v5.8.5 built for i386-linux-thread-multi

Por lo tanto ya podemos seguir con Interchange, definiendo que busque Perl en /usr/local/bin !

Instale lynx (desde CD4 RPM de Red Hat). (Es un browser para Linux). rpm –ivh lynx-xxx.rpm

Instale (sofisticadas) extensiones de Interchange para Perl:

# /usr/local/bin/perl -MCPAN -e 'install Bundle::Interchange'

(diálogo con respuestas por defecto, elija servidores de Norteamérica para la descarga).

Procedimiento demorado, cada extensión será compilada e instalada por separado. Demora unos 30’ .

Ejemplos: leer-escribir en formato Excel, integración cron etc.

Ahora sí INTERCHANGE:

# cd /descargas/interchange

Como root:

# tar zxvf interchange-latest.tar.gz

# cd interchange-5.4.0

# ./configure (no hace nada, pues dice que debe hacerse:)

# /usr/local/bin/perl Makefile.PL

(Aquí deberá suministrarse un nombre de usuario existente distinto a root bajo el cual se ejecutará el instalador)

$ make

$ make test && make install

Si todo va bien, en menos de 1’ tendrá el aviso:

Your Interchange main software installation appears to have been successful.

You are now ready to cd to /usr/local/interchange and run 'bin/makecat‘ to set up your first catalog.

EUREKA !!

Interchange ha quedado instalado !

Módulo MYSQL

Para poder usar MySQL debemos tener el módulo de Perl respectivo DBD::Mysql , junto con otros accesorios: lo mejor es obtener el paquete “Bundle” :

(MySQL debe estar funcionando en el servidor, y deberemos configurar el módulo con el usuario y password de root).

# /usr/local/bin/perl -MCPAN -e 'install Bundle:: DBD::mysql

Nota: Si la ejecución de lo anterior saca errores, deberá obtener del ftp de Perl los siguientes módulos:

DBI/DBI-1.15.tar.gz

Data/Data-ShowTable-3.3.tar.gz

DBD/DBD-mysql-2.1001.tar.gz

Y para c/u ejecutar

/usr/local/bin/perl Makefile.PL

make

make test

make install (para DBD-mysql dar los parámetros –testuser=root –testpassword=passwordderoot al PL)

Listos para arrancar !

Preguntas ?

Alistamiento

MySQL arriba.

Vamos a crear un catálogo demostrativo inicial (viene con la instalación).

# cd /usr/local/interchange

# ./bin/makecat

(Genera el siguiente pantallazo si todo va bien).

Inicialización Interchange (1)

Inicialice la base de datos del sistema.

# updatedb –v

(esto durará un par de minutos a lo sumo).

Habilite la actualización cron diaria de la base de datos del sistema, editando /etc/updatedb.conf y cambiando el valor:

DAILY_UPDATE=NO a YES

Crear un usuario bajo el cual correrá interchange. Ej: “ecommerce”.

Ahora pasamos a inicializar el catálogo:

# cd /usr/local/interchange

# ./bin/makecat

Seleccione un nombre para su catálogo, minúsculas, corto (tendrá que digitarlo muchas veces).

Informe a makecat la ubicación del archivo de configuración de Apache, normalmente: /etc/httpd/conf/httpd.conf

Definir modo de operación. Opciones:

GROUP (problemas archivos compartidos, son visibles para otros usuarios).

MULTIPLE GROUP (recomendado) . Requiere que el usuario “interchange” pertenezca al grupo de usuarios.

USER (solo en caso monousuario)

Defina el servidor de correo, ej:

mail.ebstudio.com

Defina ubicación del directorio cgi-bin (usualmente /var/www/cgi-bin)

Raíz de cgi-bin (usualmente cgi-bin)

Raíz de documentos /var/www/html

Usuario bajo cuyo nombre correrá Interchange: ecommerce (según ejemplo)

Nombre de servidor (ej. ws01.ebstudio.com)

Demo type: standard

Tipo de permisos: M (otras opciones: G,U)

Usuario de destino pedidos: ej: ecommerce

Raíz del catálogo ej:

/catalogs/wsic

Nombre cgi-bin para catálogo:

/cgi-bin/ wsic (según ejemplo)

Deje en valores por defecto demás respuestas, hasta llegar a configuraciones de MYSQL. Determine allí nombre de usuario que será dueño ( ecommerce ), y suministre login y password de root (de MySQL) para crear las bases de datos.

Terminado !!

El catálogo de demostración estará accesible en:

http://ws01a.ebstudio.com/wsic

Y si llegara a fallar de todos modos aquí lo encuentra:

http://ws01a.ebstudio.com/cgi-bin/wsic

ANTES DE PROBAR, INICIE INTERCHANGE !

su -c "/usr/local/interchange/bin/interchange -r" ecommerce

Controle que las sesiones expiren, para esto se recomienda colocar en el crontab de root:

44 4 * * * /usr/local/interchange/bin/expireall –r (causará cancelación sesiones todos los días a las 4:44 am).

Interchange corre…

table orderline created: create table orderline (

code varchar(32) NOT NULL PRIMARY KEY,

store_id varchar(9) DEFAULT '' NOT NULL,

order_number varchar(14) NOT NULL,

session varchar(32) NOT NULL,

username varchar(32) default '' NOT NULL,

shipmode varchar(255) default '' NOT NULL,

sku varchar(64) NOT NULL,

quantity int NOT NULL,

price decimal(12,2) NOT NULL,

subtotal decimal(12,2) NOT NULL,

shipping decimal(12,2),

taxable varchar(3),

size varchar(128),

color varchar(128),

options varchar(255),

order_date varchar(32) NOT NULL,

update_date timestamp,

status varchar(32),

parent varchar(9),

affiliate varchar(128),

campaign varchar(128),

description varchar(128)

)

done.

Interchange server started in UNIX mode(s) (process id 9582)

Up and running …

Cómo usar

http://10.1.1.112/wsic

(En el servidor de pruebas de Web Studio).

Para administrar: hipervínculo “admin” en la parte inferior. Login: ecommerce Passwd=ecommerce0

Operación

Administrador crea productos, sube fotos, pone precios.

Lista de clientes.

CLIENTE: selecciona productos y los pone en su carro de compra.

Coloca pedido (e-mail).

Carrito de compras

Inscripción visitante

Colocar pedido

Lista de productos

Item individual

Creación menús

Funciones admin.

Manejo de pedidos

Lista de productos / precios

Lista de clientes

Gestión menús

Tablas (ej. tipo impuestos,inventarios)

Reportes

Extras (idioma, compañía etc.)

HOW TO de Interchange / RHEL 4 Preparado por: Ing. David Ramírez Molina Director de Tecnología WEB STUDIO e-SOLUTIONS S.A. Bogotá – Colombia Febrero, 2006

F I N