Manual de Instalacin en Ubuntu / Debian

Manual de Instalacin en
Ubuntu / Debian

-1-

Manual de Instalacin en Ubuntu / Debian

ndice de contenido
1. Paquetes de Software y archivos necesarios....................................................................3
2. Instalacin de Sun Java JDK 6..........................................................................................3
3. Instalacin de PostgreSQL................................................................................................3
3.1 Instalacin de libreras requeridas...............................................................................3
3.2 Compilacin, Instalacin y Configuracin...................................................................4
3.3 Instalacin del mdulo PL/Java...................................................................................5
3.4 Instalacin de PL/Java en una base de datos.............................................................6
3.5 Instalacin de PostgreSQL como un servicio al arranque..........................................7
3.6 Otros ajustes y tareas relacionadas con PostgreSQL................................................7
4. Instalacin de Libertya.......................................................................................................7
4.1 Configuracin e instalacin de binarios.......................................................................8
4.2 Creacin de la base de datos......................................................................................8
4.3 Configuracin de Libertya............................................................................................9
4.4 Instalacin del Servidor de Libertya como un servicio al arranque.............................9
5. Instalacin de FreeNX.......................................................................................................9

-2-

Manual de Instalacin en Ubuntu / Debian

1. Paquetes de Software y archivos necesarios

Libertya

ServidorOXP_VAA.MM.zip

dump_libertya_AAMMar.zip

libertyad_ubuntu-debian.sh (script para autoarranque del servidor)

PostgreSQL

postgresql-8.3.11.tar.gz (fuentes)

pljava-i686-pc-linux-gnu-pg8.3-1.4.0.tar.gz (32 bits). No necesario a partir de

Libertya 11.10.

pljava-x86_64-unknown-linux-gnu-pg8.3-1.4.0.tar.gz (64 bits). No necesario a partir

de Libertya 11.10.

2. Instalacin de Sun Java JDK 6

Obtener permisos de root
sudos

Comando para instalar JDK de Sun. Si no est en los repositorios habr que buscar en
Internet algn repositorio que disponga del paquete y agregarlo al apt (ver Repositorios
conocidos).
aptgetinstallsunjava6jdk

Si el servidor tiene otro java instalado (OpenJDK por ejemplo) es recomendable ejecutar
el siguiente comando para definir la JVM por defecto, que debera ser la java-6-sun
updatealternativesconfigjava

2.1 Repositorios
Ubuntu 10.04
addaptrepository"debhttp://archive.canonical.com/lucidpartner"
aptgetupdate

Ubuntu 11.04

-3-

Manual de Instalacin en Ubuntu / Debian

addaptrepositoryppa:ferramroberto/java
aptgetupdate

Si no est instalado add-apt-repository, ejecutar:

aptgetinstallpythonsoftwareproperties

3. Instalacin de PostgreSQL
Realizar todo como root
sudos

3.1 Instalacin de libreras requeridas

aptgetinstalllibreadline5dev
aptgetinstallzlib1gdev

3.2 Compilacin, Instalacin y Configuracin

Descomprimir los fuentes en /usr/local/src
cppostgresql8.3.11.tar.gz/usr/local/src
cd/usr/local/src
tarxzfpostgresql8.3.11.tar.gz

Compilar e instalar postgres (ejecutar los comandos de a uno a la vez)

cd/usr/local/src/postgresql8.3.11
./configure
make
makeinstall

Crear el usuario postgres

adduserpostgres

Nota: para crear el usuario sin home y como un usuario del sistema usar:
adduserpostgresnocreatehomesystemshell/bin/bashgroup

Crear el directorio donde estarn las Bases de Datos . El directorio puede estar en
cualquier lugar no necesariamente dentro del pgsql. Incluso en otro disco rgido . Este es
el directorio por defecto.
-4-

Manual de Instalacin en Ubuntu / Debian

mkdir/usr/local/pgsql/data
chownpostgres:postgres/usr/local/pgsql/data

Iniciar el cluster de base de datos. Esto inicializa el directorio anteriormente creado

copiando los archivos y directorios requeridos por el servidor para alojar las bases de
datos (archivos de configuracin, etc).
supostgres
/usr/local/pgsql/bin/initdbD/usr/local/pgsql/data
exit

Agregar al final del archivo /etc/profile

exportPGDATA=/usr/local/pgsql/data
exportPATH=$PATH:/usr/local/pgsql/bin

Editar el archivo pg_hba.conf (ubicado en el directorio PGDATA) para permitir acceso

desde cualquier lugar
#"local"isforUnixdomainsocketconnectionsonly
localallalltrust
#IPv4localconnections:
hostallall127.0.0.1/32trust
hostallall0/0trust
#IPv6localconnections:
hostallall::1/128trust

Editar el archivo postgresql.conf (ubicado en el directorio PGDATA) habilitando la

siguiente lnea para escuchar conexiones en todas las interfaces de red
listen_addresses='*'

Probar si el servidor inicia correctamente. Cerrar la sesin o consola actual para que las
variables definidas en /etc/profile surtan efecto.
Iniciar el servidor
/usr/local/pgsql/bin/pg_ctlstart

Probar conectarse con PgAdmin desde el mismo servidor o desde otra PC de la LAN.
Luego detener el servidor para continuar
/usr/local/pgsql/bin/pg_ctlstop

-5-

Manual de Instalacin en Ubuntu / Debian

3.3 Instalacin del mdulo PL/Java

IMPORTANTE: A partir de la versin 11.10 de Libertya ya no se requiere instalar el
mdulo de PL/Java por lo que este paso se puede obviar si se est instando Libertya
11.10 o superior.
Copiar y descomprimir el archivo en /usr/local/pgsql/lib
32 bits
cppljavai686pclinuxgnupg8.31.4.0.tar.gz/usr/local/pgsql/lib
cd/usr/local/pgsql/lib
tarxzfpljavai686pclinuxgnupg8.31.4.0.tar.gz

64 bits
cppljavax86_64unknownlinuxgnupg8.31.4.0.tar.gz
/usr/local/pgsql/lib
cd/usr/local/pgsql/lib
tarxzfpljavax86_64unknownlinuxgnupg8.31.4.0.tar.gz

Editar el archivo postgresql.conf que se encuentra en el directorio en donde se inicializ el

cluster de base de datos (por defecto /usr/local/pgsql/data). Agregar o descomentar segn
corresponda
32 bits
dynamic_library_path='/usr/lib/jvm/java6
sun/jre/lib/i386:/usr/lib/jvm/java6
sun/jre/lib/i386/client:/usr/local/pgsql/lib'
custom_variable_classes='pljava'
pljava.classpath='/usr/local/pgsql/lib/pljava.jar'

64 bits
dynamic_library_path='/usr/lib/jvm/java6
sun/jre/lib/amd64:/usr/lib/jvm/java6
sun/jre/lib/amd64/server:/usr/local/pgsql/lib'
custom_variable_classes='pljava'
pljava.classpath='/usr/local/pgsql/lib/pljava.jar'

Atencin: Esta gua asume que java se encuentra instalado en /usr/lib/jvm/java-6-sun.

Ajustar los directorios en caso de ser necesario.
Editar el archivo /etc/ld.so.conf y agregar
32 bits

-6-

Manual de Instalacin en Ubuntu / Debian

/usr/lib/jvm/java6sun/jre/lib/i386
/usr/lib/jvm/java6sun/jre/lib/i386/client
/usr/local/pgsql/lib

64 bits
/usr/lib/jvm/java6sun/jre/lib/amd64
/usr/lib/jvm/java6sun/jre/lib/amd64/server
/usr/local/pgsql/lib

Ejecutar el siguiente comando para configurar los path de libreras dinmicas

anteriormente agregados al archivo
ldconfig

Reiniciar el servidor de Postgres si el mismo estaba corriendo

supostgres
pg_ctlstop
pg_ctlstart
exit

3.4 Instalacin de PL/Java en una base de datos

IMPORTANTE: A partir de la versin 11.10 de Libertya ya no se requiere instalar el
mdulo de PL/Java por lo que este paso se puede obviar si se est instando Libertya
11.10 o superior.
Instalar PL/Java en la base de datos de postgres para corroborar si el mdulo fue
instalado correctamente
psqlUpostgresf/usr/local/pgsql/lib/install.sql

Nota: Al ejecutar este comando no debe dar errores. Si muestra algn error implica que el
mdulo de PL/Java no fue instalado correctamente y se deber revisar la seccin anterior.
Configurar la base de datos template1 de modo que cada vez que se cree una nueva BD
ya tenga el esquema SQLJ.
psqlUpostgresdtemplate1f/usr/local/pgsql/lib/install.sql

3.5 Instalacin de PostgreSQL como un servicio al arranque

Copiar el script provisto en los fuentes y darle permisos de ejecucin

-7-

Manual de Instalacin en Ubuntu / Debian

sudocp/usr/local/src/postgresql8.3.11/contrib/start
scripts/linux/etc/init.d/postgresql
cd/etc/init.d/
chmod+xpostgresql

Si el directorio PGDATA no es el por defecto (/usr/local/pgsql/data), hay que modificar el

script postgresql y cambiar la siguiente lnea indicando el path del directorio utilizado
#Datadirectory
PGDATA="/usr/local/pgsql/data"

Instalar el script para que se ejecute al inicio

chkconfigspostgresql23459802

Nota: si chkconfig no est instalado instalarlo

aptgetinstallchkconfig

3.6 Otros ajustes y tareas relacionadas con PostgreSQL

Ajustes bsicos a la instalacin de postgresql

Como crear y recuperar un backup de la base de datos

4. Instalacin de Libertya
Continuar como root
sudos

4.1 Configuracin e instalacin de binarios

Editar /etc/profile para agregar las variables JAVA_HOME y OXP_HOME necesarias
exportJAVA_HOME=/usr/lib/jvm/java6sun
exportOXP_HOME=/ServidorOXP

Descomprimir ServidorOXP_VXX.YY.zip en el raz /

unzipServidorOXP_V11.05.zip
mvServidorOXP/ServidorOXP
cd/ServidorOXP
chmodR+x*.sh
-8-

Manual de Instalacin en Ubuntu / Debian

cdutils
chmodR+x*.sh

4.2 Creacin de la base de datos

Crear el rol libertya
psqlUpostgresc"CREATEROLElibertyaLOGINENCRYPTEDPASSWORD
'md52b2861c4d594f29f9ce9107c4560f3ae'SUPERUSERCREATEDBCREATEROLE
VALIDUNTIL'infinity'INROLEpostgres;UPDATEpg_authidSET
rolcatupdate=trueWHERErolname='libertya';"

Crear el lenguaje plpgsql en la base de datos template1 para que cada vez que se cree
una nueva base de datos la misma ya contenga el lenduaje requerido por las funciones
que contiene la base de datos de libertya.
createlangUpostgresdtemplate1plpgsql

Crear base de datos libertya

psqlUpostgresc"CREATEDATABASElibertyaWITHENCODING='UTF8'
OWNER=libertya;"

Levantar el dump del esquema libertya

psqlUlibertyadlibertyafdump_libertya_1105ar.sql

IMPORTANTE: A partir de la versin 11.10 de Libertya ya no se requiere instalar el

mdulo de PL/Java por lo que los dos siguientes pasos (instalar el JAR de SQLJ y
verificar su funcionamiento) se pueden obviar si se est instando Libertya 11.10 o
superior.
Instalar el JAR de SQLJ sobre la base de datos libertya
psqldlibertyaUlibertyac"select
sqlj.install_jar('file:///ServidorOXP/lib/sqlj.jar','sqlj',true);"
psqldlibertyaUlibertyac"selectsqlj.set_classpath('public',
'sqlj');"

Verificar si SQLJ est funcionando correctamente ejecutando la siguiente consulta que

debe devolver 928.00.
psqldlibertyaUlibertyac"selectinvoiceopen(1011629,0)"

-9-

Manual de Instalacin en Ubuntu / Debian

4.3 Configuracin de Libertya

Ejecutar la interfaz de configuracin de Libertya y setear los parmetros
/ServidorOXP/Configurar.sh

Si no se dispone de interfaz grfica entonces utilizar el configurador por lnea de

comando.
Primero
copiar
el
archivo
LibertyaEnvTemplate.properties
a
LibertyaEnv.properties.
cd/ServidorOXP
cpLibertyaEnvTemplate.propertiesLibertyaEnv.properties

Editar LibertyaEnv.properties seteando todos los parmetros manualmente (para que

resulte mas sencillo se puede llevar un LibertyaEnv.properties ya configurado mediante la
interfaz grfica en otra implementacin, y editar directamente ese en donde la mayora de
los parmetros no van a cambiar).
Ejecutar el configurador automtico que toma los parmetros desde el archivo
LibertyaEnv.properties (no requiere interfaz grfica)
/ServidorOXP/ConfigurarAuto.sh

4.4 Instalacin del Servidor de Libertya como un servicio al arranque

Copiar el script provisto libertyad_ubuntu-debian.sh a /etc/init.d/libertyad
cplibeartyad_ubuntudebian.sh/etc/init.d/libeartyad

Asignar permisos de ejecucin al script

chmod+x/etc/init.d/libertyad

Registrar el script como servicio del sistema

sudoupdatecdrc.dlibertyaddefaults

Para iniciar o detener el servidor manualmente

servicelibertyadstart
servicelibertyadstop

5. Instalacin de FreeNX
Este programa es opcional y solo se requiere en ambientes en donde se necesite acceso
va WAN.
- 10 -

Manual de Instalacin en Ubuntu / Debian

Dependiendo la versin de ubuntu se deben realizar diferentes pasos para la instalacin.

La siguiente gua indica paso a paso, para cada versin del sistema, como hacer la
instalacin
Instalacin de FreeNX

- 11 -