[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# adduser postgres
[/sourcecode]

Cuando se nos pregunte la contraseña le podremos la que deseemos, pero deberemos recordarla, ya que se nos pedirá en un futuro.

9.3 Crear e inicializar el directorio de datos

El siguiente paso será crear e inicializar el directorio de datos, donde PostgreSQL guardará la información:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# mkdir /usr/local/pgsql/data
[/sourcecode]

Hacemos propietario de este directorio al usuario postgres:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# chown postgres /usr/local/pgsql/data
[/sourcecode]

A continuación asumimos la identidad del usuario postgres para inicializar el directorio de datos:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# su – postgres
[/sourcecode]

y finalmente inicializamos el directorio de datos:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
$ initdb -D /usr/local/pgsql/data
[/sourcecode]

Llegados a este punto, y si todo ha ido bien, el deberemos ver en nuestra terminal algo parecido a esto

[sourcecode language=»text» gutter=»false» wraplines=»false»]
Success. You can now start the database server using:

postgres -D /usr/local/pgsql/data
or
pg_ctl -D /usr/local/pgsql/data -l logfile start

[/sourcecode]

En este momento, tal y como indica el sistema podremos arrancar la base de datos en primer plano con:

[sourcecode language=»text» gutter=»false» wraplinec=»false» highlight=»1″]
# postgres -D /usr/local/pgsql/data
[/sourcecode]

y detenerla simplemente pulsando la combinación de teclas Ctr-C

Si deseamos arrancar la base de datos en segundo plano, lo haremos usando la segunda opción:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# pg_ctl -D /usr/local/pgsql/data -l logfile start
[/sourcecode]

y la detendremos con el siguiente comando:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
$ pg_ctl -D /var/pgsql/data stop -m fast
[/sourcecode]

9.4 Configurar contraseña de acceso a la base de datos para el usuario postgres

Para configurar la contraseña de acceso del usuario postgres a la base de datos, lo primero que habrá que hacer lógicamente es iniciar el servidor:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# pg_ctl -D /usr/local/pgsql/data -l logfile start
[/sourcecode]

Una vez iniciado el servidor, y manteniendo en el sistema la identidad del usuario postgres, accederemos al interprete de ordenes de PostgreSQL:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
$psql
[/sourcecode]

Una vez dentro, escribiremos:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
postgres=# alter user postgres with password ‘passwd’;
[/sourcecode]

donde passwd es la nueva contraseña que deseamos poner.El sistema debe responder con un:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
ALTER ROLE
postgres=#
[/sourcecode]

Salimos del cliente de linea de ordenes con la orden:

[sourcecode language=»text» gutter=»false» wraplines=»false»]postgres=#\q [/sourcecode]

Y salimos de la cuenta en el sistema del usuario postgres con un simple:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]$exit [/sourcecode]

9.5 Crear script de arranque automático

Para hacer que PostgreSQL se ejecute automáticamente al iniciar el sistema, debemos copiar desde el directorio /contrib/start-scripts del arbol del código fuente de postgreSQL, el fichero denominado linux al directorio /etc/init.d. En este punto de la instalación, deberíamos estar en el directorio ./postgresql-9.2.4/contrib/pldebugger, por lo que ejecutaremos el siguiente comando:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# cp ../start-scripts/linux /etc/init.d/postgresql
[/sourcecode]

Una vez copiado el script, debemos editarlo para añadirle las etiquetas LSB. Para ello, añadiremos al comienzo del fichero /etc/init.d/posgresql, justo debajo de #! /bin/sh las siguientes líneas:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»2″]
### BEGIN INIT INFO
# Provides: PostgreSQL
# Required-Start: $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start Postgresql at boot time
# Description: Enable service provided by daemon.
### END INIT INFO
[/sourcecode]

Además, debemos dar permisos de ejecución al script, con el siguiente comando:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# chmod 755 /etc/init.d/postgresql
[/sourcecode]

Con ello, podremos arrancar y parar postgresql con el tipico comando:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# /etc/init.d/postgresql accion
[/sourcecode]

donde accion representa alguna de las siguientes posibles acciones:

• start Arranca el servidor de bases de datos.
• stop Detiene el servidor de bases de datos.
• restart Detiene el servidor de bases de datos, y lo vuelve a arrancar.
• reload Recarga la configuración del servidor de bases de datos.
• status Informa si el servidor de bases de datos se esta ejecutando o no.

Por último, debemos añadir el script de inicio de PostgreSQL a los scripts de arranque del sistema, para lo cual ejecutaremos el siguiente comando:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# update-rc.d postgresql defaults
[/sourcecode]

Si por alguna razón deseamos eliminar el script de la secuencia de arranque, deberemos ejecutar el comando:

[sourcecode language=»text» gutter=»false» wraplines=»false» highlight=»1″]
# update-rc.d -f postgresql remove
[/sourcecode]

9.6 Editar el fichero postgresql.conf

El siguiente paso es editar el fichero /usr/local/pgsql/data/postgresql.conf para, por un lado permitir que el servidor escuche por todas las interfaces de red, y por otro lado, indicarle que cargue el plugin pldebugger.

Para permitir que el servidor escuche por todas las interfaces de red, buscaremos la línea:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»59″]#listen-addresses = ‘localhost’ [/sourcecode]

(suele ser la línea 59), la copiamos debajo, la descomentamos, y la modificamos quedando :

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»60″]listen-addresses = ‘*’ [/sourcecode]

Si se quisera que PostgreSQL escuchase sólo las peticiones de determinadas IPs, bastaría con poner estas IPs separadas por comas, y todo el conjunto entre comillas simples. Por ejemplo:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»60″]
listen-addresses = ‘192.168.0.2,192.168.0.3’
[/sourcecode]

Nota: por custiones de seguridad no se recomienda permitir el acceso desde cualquier máquina.

Para indicarle a PostgreSQL que cargue el plugin pldebugger al arrancar, buscaremos la línea:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»127″]
#shared_preload_libraries = » # (change requires restart)
[/sourcecode]

(suele ser la línea 127), la copiamos debajo, la descomentamos, y la modificamos quedando :

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»128″]
shared_pbeload_libraries = ‘$libdir/plugin_debugger’ # (change requires restart)
[/sourcecode]

9.7 Configurar permisos de acceso

9.7.1 Configurar permisos de acceso local:

Al compilar desde las fuentes, PostgreSQL es muy poco restrictivo a la hora de gestionar permisos, ya que por defecto, permite a todos los usuarios del sistema el acceso sin contraseña. Por ello deberemos restringir ciertos permisos locales.

Para ello debemos editar el fichero /usr/local/pgsql/data/pg_hba.conf
Buscaremos la línea cuyo contenido es:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»84″]local all all trust[/sourcecode]

y la modificamos de forma que quede:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»84″]local all all md5[/sourcecode]

Con ello permitimos el acceso a cualquier cuenta de usuario desde la maquina local siempre que se especifique una contraseña encriptada mediante md5. Ello implica que al reinicar el servidor podremos acceder al cliente de linea de ordenes de PostgreSQL desde cualquier cuenta de usuario con la cuenta de postgres, escribiendo:

[sourcecode language=»text» gutter=»false» wraplines=»false»]$psql -U postgres -W [/sourcecode]

9.7.2 Configurar permisos de acceso remoto:

Por último, debemos configurar los permisos de acceso remoto. Se trata de responder a las siguientes preguntas:

• ¿Que usuarios tienen permisos para conectarse?
• ¿Desde que IPs se pueden conectar?
• ¿A que bases de datos?
• ¿Y.. que método de auteticación tienen que usar?

En este post, daremos permisos a todos los usuarios de la base de datos, para conectarse a todas las bases de datos, desde cualquier IP, usando una contraseña encriptada con MD5.

Esto lo lograremos editando de nuevo el fichero /usr/local/pgsql/data/pg_hba.conf y localizando la línea:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»86″]
host all all 127.0.0.1/32 trust
[/sourcecode]

y la modificandola forma que quede:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»86″]
host all all 0.0.0.0 0.0.0.0 md5
[/sourcecode]

Una explicación sencilla de esta regla de permisos del fichero /etc/postgresql/9.2/main/pg_hba.conf seria:

• host: Indica que la regla se refiere a conexiones remotas
• all: Responde a la pregunta ¿Que usuarios tienen permiso para conectarse?. En este caso todos.Si quisieramos especificar un usuario determinado, bastaría con sustituir «all» por el nombre del usuario deseado. Si queremos aplicar la misma regla a varios usuarios, tendremos que copiar y pegar la regla, cambiando el nombre de usuario.
• all: Responde a la pregunta ¿A que bases de datos?. En este caso a todas .Si quisieramos especificar una base de datos determinada, bastaría con sustituir «all» por el nombre de la base de datos deseada. Si queremos aplicar la misma regla a varios bases de datos, tendremos que copiar y pegar la regla, cambiando el nombre de la base de datos.
• 0.0.0.0 0.0.0.0: Responde a la pregunta ¿Desde que IPs se pueden conectar?. En este caso desde todas. el primer grupo de 4 digitos especifca la IP, mientras que el segundo es la mascara de red. Los valores 0.0.0.0 son valores comodin, cuyo significado es «cualquier IP» y «cualquier mascara» respectivamente.
• md5: Responde a la pregunta ¿Que método de auteticación tienen que usar?. En este caso una contraseña encriptada con MD5. Otros posibles valores son : «passowrd» para una contraseña sin encriptar o «trust» para permitir un acceso sin contraseña

Para una mayor información sobre como funciona el fichero /etc/postgresql/9.2/main/pg_hba.conf se puede consultar la documentación oficial en castellano en la dirección: http://www.postgresql.org/docs/9.2/interactive/auth-pg-hba-conf.html

Finalmente inhabilitaremos las conexiones locales a través de IP6, para lo cual, localizaremos la línea:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»88″]
host all all ::1/128 trust
[/sourcecode]

y la comentaremos de forma que quede:

[sourcecode language=»text» gutter=»true» wraplines=»false» firstline=»88″]
#host all all ::1/128 trust
[/sourcecode]

10.- Reiniciar el servidor

Para comprobar que todo ha ido bien, que el script de autoarranque esta correctamente instalado, y que las configuraciones definidas en la base de datos son correctas, Debemos reiniciar la máquina servidora. Para ello, ejecutaremos las siguiente instrucción:

[sourcecode language=»text» gutter=»false» wraplines=»false» highline=»1″]
# reboot
[/sourcecode]

11.- Probar el depurador

Para probar el depuraror, lo primero que hemos de hacer es crear una base de datos de prueba,con una tabla de prueba, y con un procedimiento almacenado de prueba que podamos depurar.

11.1.- Acceder al interprete de PostgreSQL

Accedemos al interprete de comandos de PostgresSQL con la siguiente instrucción:

[sourcecode language=»text» gutter=»false» wraplines=»false» highline=»1″]
$ psql -U postgres -W
[/sourcecode]

11.2.- Crear base de datos de prueba

Una vez dentro del interprete de comandos de PostgresSQL creamos la base de datos con el siguiente comando:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
postgres=# CREATE DATABASE prueba_debugger WITH ENCODING=’UTF8′;
[/sourcecode]

11.3.- Crear tabla de pruebas

Nos conectamos a la base de datos que acabamos de crear:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
postgres=# \c prueba_debugger
[/sourcecode]

y el sistema responde con:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
You are now connected to database "prueba_debugger".
[/sourcecode]

A continuación creamos la la tabla de pruebas

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
prueba_debugger=# CREATE TABLE tabla_prueba (
Id BIGSERIAL PRIMARY KEY ,
Valor VARCHAR (255) default »
);
[/sourcecode]

y el sistema responde con:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
NOTICE: CREATE TABLE will create implicit sequence "tabla_prueba_id_seq" for serial column "tabla_prueba.id"
NOTICE: CREATE TABLE / PRIMARY KEY will create implicit index "tabla_prueba_pkey" for table "tabla_prueba"
CREATE TABLE
[/sourcecode]

11.4.- Crear procedimiento almacenado de prueba

Seguimos creando objetos en la base de datos de prueba. En este punto crearemos un procedimiento almacenado:

+

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
prueba_debugger=#
CREATE OR REPLACE FUNCTION tabla_prueba_trigger() RETURNS TRIGGER AS $tabla_prueba_trigger$
DECLARE
sValor VARCHAR (255):= NEW.Valor;
iId INTEGER:= NEW.Id;
iCalculo INTEGER:= 0;
BEGIN
RAISE NOTICE ‘———- INICIO prueba_debugger.tabla_prueba_trigger() ———-‘;
RAISE NOTICE ‘———- => El nuevo registro tiene un Id: %’,iId;
RAISE NOTICE ‘———- => El nuevo registro tiene un Valor: %’,sValor;
iCalculo=iId +5;
RAISE NOTICE ‘———- => El Id del nuevo registro +5 es igual a: %’,iCalculo;
RAISE NOTICE ‘———- FIN prueba_debugger.tabla_prueba_trigger() ————-‘;
NEW.Id= iCalculo;
RETURN NEW;
END;
[/sourcecode]

Nota: para introducir el procedimiento almacenado desde la consola de PostgreSQL copiaremos todo el procedimiento almacenado y pulsaremos la tecla Enter.
A continuación le indicamos a PostgreSQL el lenguaje en el que está escrito el procedimiento almacenado:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
prueba_debugger=# $tabla_prueba_trigger$ LANGUAGE plpgsql;
[/sourcecode]

Despues de introducir el comando anterior y pulsar la tecla Enter, el sistema debe responder con:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
CREATE FUNCTION
[/sourcecode]

11.5.- Crear disparador para lanzar el procedimiento almacenado de prueba

Crearemos un disparador que lanzará el procedimiento almacenado después de cada inserción:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
prueba_debugger=# CREATE TRIGGER update_tabla_prueba AFTER INSERT
ON tabla_prueba FOR EACH ROW EXECUTE PROCEDURE tabla_prueba_trigger();
[/sourcecode]

y el sistema responde con:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
CREATE TRIGGER
[/sourcecode]

11.6.- Ejecutar el script de preparacion para la depuración

Para poder depurar los procedimientos almacenados, es necesario que antes hayamos ejecutado en la base de datos donde queremos hacer la depuración el siguiente comando:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
prueba_debugger=# CREATE EXTENSION pldbgapi;
[/sourcecode]

el sistema responderá con:

[sourcecode language=»sql» gutter=»false» wraplines=»false»]
CREATE EXTENSION
[/sourcecode]

Una vez ejecutado el comando, ya podemos conectarnos a la base de datos desde pgAdminIII y usar la función de depuración.

Nota: Debemos ejecutar este comando en cada base de datos donde deseemos usar la funcionalidad de depuración.

&ld;/p>

11.7.- Probar el depurador

Finalmente, obtendremos la recompensa a nuestro esfuerzo, al abrir pgAdminIII, abrir la base de datos de prueba que hemos creado, abrir el esquema public, abrir la tabla tabla_prueba desplegar la sección Trigger-Functions, y sobre nuestra función, hacer click con el boton derecho, y seleccionar la opción «Set breakpoint»

Estableciendo punto de ruptura con pgAdminIII

En la siguiente captura podemos ver el depurador en acción:

Depurador pgAdminIII en acción