Guía a la instalación de Oratio® en SME Server

Esta guía ha sido escrita en el marco del proyecto SMERP. Quiero dar las gracias a las personas que han escrito las diferentes guías a la instalación de Postgres y SQL-Ledger, de las que este documento es una síntesis.

Sumario

Prerequisitos
Instalación de Postgres
Instalación de LaTeX
Creación de los templates
Instalación de Oratio®

Prerequisitos

Oratio® es un software de gestión integrada ERP distribuido con licencia GPL. El software utiliza una base de datos Postgres y funciona en modalidad "CGI", es decir es accesible a través de un navegador internet. Por esta razón, antes de poder utilizar Oratio® hace falta asegurarse de que las herramientas utilizadas por este último están presentes en el servidor en el que se instalará Oratio®.

La instalación de Oratio se ha efectuado con la versión 6.0.1 de SME Server. En esta guía se supone que se haya creado un Information Bay llamado "oratio".

Instalación de Postgres

Instalación del servidor de la base de datos

1. Download de los paquetes RPM

2. Instalación de los paquetes RPM

# rpm -uvh --NODEPS *.rpm

3. Puesta en marcha de PostgreSQL

# /etc/init.d/postgresql start
Resultados previstos :


						Initializing database: [ OK ]

						Starting postgresql service: [ OK ]

4. Creación de los templates de configuración

Creación del archivo de templates :
# mkdir -p /etc/e-smith/templates/var/lib/pgsql/data # mkdir -p /etc/e-smith/templates-custom/var/lib/pgsql/data
Copia de los ficheros de base en el archivo de templates :
# cp /var/lib/pgsql/data/postgresql.conf /etc/e-smith/templates/var/lib/pgsql/data # cp /var/lib/pgsql/data/pg_hba.conf /etc/e-smith/templates/var/lib/pgsql/data # cp /var/lib/pgsql/data/postgresql.conf /etc/e-smith/templates-custom/var/lib/pgsql/data # cp /var/lib/pgsql/data/pg_hba.conf /etc/e-smith/templates-custom/var/lib/pgsql/data

5. Modificación de los ficheros de configuración

Modificación del fichero postgresql.conf de manera que el servidor acepte las conexiones TC/IP :
# pico /etc/e-smith/templates-custom/var/lib/pgsql/data/postgresql.conf Elimine el comentario en la raya #tcpip_socket = false y sustitúyalo con :
tcpip_socket = true
Grabe CTRL+o y salga CTRL+x
Modificación del fichero pg_hba.conf para regular los accesos TCP/IP :
# pico /etc/e-smith/templates-custom/var/lib/pgsql/data/pg_hba.conf Sostituya la raya #local all ident sameuser al final del fichero con :
local all trust host all [IP_LOCAL] [MASK] trust host all all 0.0.0.0 255.255.255.255 reject IP_LOCAL ha sido sustituido por su dirección IP, y MASK ha sido sustituido por su network mask.

6. Creación de los templates


					# /sbin/e-smith/expand-template /var/lib/pgsql/data/pg_hba.conf

					# /sbin/e-smith/expand-template /var/lib/pgsql/data/postgresql.conf

7. Puesta en marcha de postgresQL


					/etc/init.d/postgresql stop

					Stopping postgresql service: [ OK ]

					/etc/init.d/postgresql start

					Starting postgresql service: [ OK ]

8. Creación de los links simbólicos para volver a poner en marcha postgres:


					# ln -s /etc/init.d/postgresql /etc/rc.d/rc7.d/S56postgresql

					# ln -s /etc/init.d/postgresql /etc/rc.d/rc6.d/K03postgresql

Instalación de los drivers de la base de datos

Instale los drivers de interfaz hacia las bases de datos para Perl DBI, y los drivers específicos para PostgreSQL DBD-Pg.

1. Download de los paquetes RPMs

2. Instalación de los paquetes RPMs

# rpm -Uvh perl-DBI-1.14-10.i386.rpm perl-DBD-Pg-0.95-1.i386.rpm
Los drivers DBI podrían haber sido ya instalados junto con el paquete Postgres-Perl; en este caso, RPM le avisa, pero no le haga caso.

Configuración de PostgreSQL

Cree un usuario para el acceso a la base de datos, que será utilizado posteriormene por Oratio® para conectarse a la base de datos.
# su postgres $ createuser -d oratio
Si desea asignar una clave a este usuario (se aconseja hacerlo), utilice el mando :
$ createuser -d -P oratio
Conteste 'y' a la pregunta: "Shall the new user be allowed to create more dataset? (y/n) y"
Conteste 'n' a la pregunta: "Shall the new user be allowed to create more new users? (y/n) n"

Instalación de LaTeX

1. Download de los paquetes RPMs

2. Instalación de los paquetes RPMs

# rpm -Uvh tetex*.rpm --NODEPS
Este mando instala el sistema TeTeX que permite crear, a partir del código fuente TeX , los documentos .dvi , .ps y .pdf necesarios para modificar posteriormente los documentos en formato pdf con Oratio.

Creación de los templates

El producto Oratio requiere una configuración de Apache ligeramente diferente a la estándar propuesta en SME Server. Por lo tanto, hay que volver a escribir los templates relativos a la estructura del fichero httpd.conf.

1. Añada el nombre del fichero file login.pl a los ficheros index

Modifique el fichero de la manera siguiente:

50DirectoryIndex00 : # pico /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/50DirectoryIndex00 Añada login.pl al final: el texto de su fichero deberá resultar:
# DirectoryIndex: Name of the file or files to use as a pre-written HTML # directory index. Separate multiple entries with spaces. DirectoryIndex index.htm index.html index.shtml index.cgi login.pl
50DirectoryIndex00PHP : # pico /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/50DirectoryIndex00PHP Añada login.pl: el texto de su fichero deberá resultar:
{ use esmith::config; use esmith::db; local $services{'php'} = $php; my $status = db_get_prop(\%services, 'php', 'status'); if (defined $status) { if ($status eq 'enabled') { $OUT .= "DirectoryIndex index.htm index.html index.shtml index.cgi index.php index.php3 login.pl\n"; } } }

2. Añada handler para el fichero Perl .pl

Para esto, modifique el template 80AddHandler00 :


			# pico /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/80AddHandler00

Añada los tipos de ficheros .pl: el texto de su fichero deberá resultar:

3. Configuración del information bay Oratio :

Modifique el template 90e-smithAccess40ibays :


			# pico /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/90e-smithAccess40ibays

Añada el Information Bay oratio que se puede sustituir con el nombre asignado al principio (descargue el fichero)
Hay que definir los permisos en los distintos archivos de oratio : se permite la ejecución de cgi Perl (.pl) y se niega el acceso al archivo users
.

#------------------------------------------------------------
# Information bay directories
#------------------------------------------------------------

{
    my %accounts;
    tie %accounts, 'esmith::config', '/home/e-smith/accounts';

my $key;
    my $value;
    my $result = "";

while (($key,$value) = each %accounts)
    {
	my ($type, %properties) = split (/\|/, $value, -1);
	if ($type eq 'ibay')
	{
	    #------------------------------------------------------------
	    # Figure out which combination of parameters to use. If
	    # PublicAccess parameter is present, this is e-smith 4.0.
	    # Otherwise, it's e-smith 3.0.
	    #------------------------------------------------------------

my $allow;
	    my $pass;
	    my $satisfy;

if ($properties{'PublicAccess'})
	    {
		if ($properties{'PublicAccess'} eq 'none')
		{
		    next;
		}
		elsif ($properties{'PublicAccess'} eq 'local')
		{
		    $allow   = $localAccess;
		    $pass    = 0;
		    $satisfy = 'all';
		}
		elsif ($properties{'PublicAccess'} eq 'local-pw')
		{
		    $allow   = $localAccess;
		    $pass    = 1;
		    $satisfy = 'all';
		}
		elsif ($properties{'PublicAccess'} eq 'global')
		{
		    $allow   = 'all';
		    $pass    = 0;
		    $satisfy = 'all';
		}
		elsif ($properties{'PublicAccess'} eq 'global-pw')
		{
		    $allow   = 'all';
		    $pass    = 1;
		    $satisfy = 'all';
		}
		elsif ($properties{'PublicAccess'} eq 'global-pw-remote')
		{
		    $allow   = $localAccess;
		    $pass    = 1;
		    $satisfy = 'any';
		}
	    }
	    elsif ($properties {'ReadAccess'} eq 'global')
	    {
		if ($properties {'UsePassword'} eq 'yes')
		{
		    $allow   = 'all';
		    $pass    = 1;
		    $satisfy = 'all';
		}
		else
		{
		    $allow   = 'all';
		    $pass    = 0;
		    $satisfy = 'all';
		}
	    }
	    else
	    {
		if ($properties {'UsePassword'} eq 'yes')
		{
		    $allow   = $localAccess;
		    $pass    = 1;
		    $satisfy = 'all';
		}
		else
		{
		    $allow   = $localAccess;
		    $pass    = 0;
		    $satisfy = 'all';
		}
	    }

my $dynamicContent = $properties{'CgiBin'} || "disabled";
            $result .= "\n";
            $result .= "#------------------------------------------------------------\n";
	    $result .= "# $key ibay directories ($properties{'Name'})\n";
            $result .= "#------------------------------------------------------------\n";

$result .= "\n";
            $result .= "<Directory /home/e-smith/files/ibays/$key/html>\n";
            if ($key eq 'oratio')
            {
	            $result .= "    Options ExecCGI FollowSymlinks\n";
	    }
	    else
	    {
            	$result .= "    Options Indexes\n";
	    }	
	    if ($dynamicContent eq 'enabled')
	    {
		$result .= "    Options +Includes\n";
	    }
	    else
	    {
		$result .= "    <FilesMatch \"\\.(php|php3|phtml)\$\">\n";
		$result .= "        order deny,allow\n";
		$result .= "        Deny from all\n";
		$result .= "    </FilesMatch>\n";
		$result .= "    Options +IncludesNOEXEC\n";
	    }
            $result .= "    AllowOverride None\n";
            $result .= "    order deny,allow\n";
            $result .= "    deny from all\n";
            $result .= "    allow from $allow\n";
	    if ($pass)
	    {
                $result .= "    AuthName \"$properties{'Name'}\"\n";
                $result .= "    AuthType Basic\n";
                $result .= "    AuthExternal pwauth\n";
                $result .= "    require user $key\n";
		$result .= "    Satisfy $satisfy\n";
	    }
            $result .= "</Directory>\n";
            $result .= "\n";

if ($key eq 'oratio')
            {
                $result .= "<Directory /home/e-smith/files/ibays/$key/html/users>\n";
                $result .= "    Options None\n";
                $result .= "</Directory>\n";
            }
            $result .= "\n";

$result .= "<Directory /home/e-smith/files/ibays/$key/cgi-bin>\n";
	    if ($dynamicContent eq 'enabled')
	    {
		$result .= "    Options ExecCGI\n";
	    }
            $result .= "    AllowOverride None\n";
            $result .= "    order deny,allow\n";
            $result .= "    deny from all\n";
            $result .= "    allow from $allow\n";
	    if ($pass)
	    {
                $result .= "    AuthName \"$properties{'Name'}\"\n";
                $result .= "    AuthType Basic\n";
                $result .= "    AuthExternal pwauth\n";
                $result .= "    require user $key\n";
                $result .= "    Satisfy $satisfy\n";
	    }
            $result .= "</Directory>\n";

$result .= "\n";
            $result .= "<Directory /home/e-smith/files/ibays/$key/files>\n";
            $result .= "    AllowOverride None\n";
            $result .= "    ForceType application/octet-stream\n";
            $result .= "    order deny,allow\n";
            $result .= "    deny from all\n";
            $result .= "    allow from $allow\n";
	    if ($pass)
	    {
                $result .= "    AuthName \"$properties{'Name'}\"\n";
                $result .= "    AuthType Basic\n";
                $result .= "    AuthExternal pwauth\n";
                $result .= "    require user $key\n";
                $result .= "    Satisfy $satisfy\n";
	    }
            $result .= "</Directory>\n";
	}
    }

$result;
}

4. Grabe las modificaciones en los templates y vuelva a poner en marcha Apache :


			# /sbin/e-smith/expand-template etc/httpd/conf/httpd.conf

			# service httpd restart

Instalación de Oratio®

Instalación de los ficheros

1. Descargue el código de Oratio :

2. Instale los ficheros:


					#tar -C /home/e-smith/files/ibays/oratio/html -vzxf oratio.tar.gz

3. Verifique los permisos en los ficheros:


						#cd /home/e-smith/files/ibays/oratio/html

						#chown www:www -R *

						#chmod 555 -R *

						#chmod 700 -R users

Crear una base de datos

Abra un navegador internet y teclee la dirección http://localhost/oratio/admin.pl. Sostituire eventualmente localhost. Sustituya, si es el caso, localhost con la dirección del servidor en el que se ha instalado Oratio®
Acceda a la sección "Pg Database Administration"
Rellene los campos host, port, user y password indicando respectivamente la dirección ip del servidor de la base de datos (por default, localhost), la puerta (generalmente 5432), el nombre del usuario del servidor de la base de datos (en nuestro ejemplo, oratio) y la clave asignada durante la creación de este usuario.
Introduzca un nombre para la base de datos, elija una configuración de default y apriete Continue
La operación podría necesitar algunos minutos, según las dimensiones del plan de las cuentas predefinido.

Crear un usuario

Teclee la dirección http://localhost/oratio/admin.pl. Sustituya, si es el caso, localhost con la dirección del servidor en el que se ha instalado Oratio®
Acceda a la sección "Add User"
Introduzca los datos deseados
En la sección "Base de datos", introduzca los mismos valores utilizados para la creación de la base de datos
Cuando haya terminado de introducir los datos, apriete Save

Poner en marcha el programa

Teclee la dirección http://localhost/oratio/login.pl. Sustituya, si es el caso, localhost con la dirección del servidor en el que se ha instalado Oratio®
Introduzca los datos de login y la clave creados en el punto anterior.
Apriete login
Consulte el manuale del usuario de Oratio® proporcionado junto con el código.

¡Enhorabuena, Ud. ha instalado su ERP Open Source, Oratio® !