Instalación a mano

Si no ha sido instalado aún el módulo CPAN - o no es el administrador del sistema - los pasos para una instalación son los siguientes:

• Visite http://search.cpan.org/.
• Una vez allí, en el menu eliga la opción distributions o bien all y en la casilla de búsqueda ponga el nombre del módulo o el tópico de búsqueda. Se nos mostrarán todos los módulos para los que la búsqueda tiene éxito.

• Elija el módulo concreto que le interesa. La documentación POD del módulo es automaticamente convertida a HTML (figura 5.1).

  Figura 5.1: Buscando en CPAN

  

• En la parte superior encontrará enlaces al autor y la distribución. Algo asi:

  David Robins >  Net-SSH-Perl-1.30 >  Net::SSH::Perl
  

  El enlace de distribución esta formado a partir del nombre y el número de versión (Net-SSH-Perl-1.30 en el ejemplo).

• Si elige el enlace de la distribución en la cabecera, iremos al listado de ficheros que conforman la distribución.

  Esto nos permite ver el fichero README que va con la distribución así como la puntuación que ha obtenido ( http://cpanratings.perl.org).

• Si se elije la opción source iremos al código fuente.

• En la página de la distribución, presione sobre la opción download para descárgar el módulo en el directorio que desea. La opción download suele estar en la parte superior de la página:

  This Release    Net-SSH-Perl-1.30        [Download] [Browse]    18 Mar 2006
  

• Después - supuesto que esta en un sistema Unix - continúe como sigue:

  > gunzip ese-modulo-6.12.tar.gz
  > tar xf ese-modulo-6.12.tar
  > cd ese-modulo-6.12
  

  Si eres el administrador de tu sistema, puedes hacer:

  > perl Makefile.PL
  

  Si, por el contrario, quieres instalar los módulos en tu propio directorio, deberas escribir algo parecido a esto:

  > perl Makefile.PL LIB=~/lib
  

  Y si tienes tu propia distribución completa en local, algo asi:

             perl Makefile.PL INSTALL_BASE=/path/to/your/home/dir
  

  o bien:

  > perl Makefile.PL PREFIX=~/perl5
  

  En ambos casos asegúrate que los directorios de búsqueda en los que las librerías quedan instalados (~/perl5/...) serán encontrados por Perl.

• Despues de esto deberás ejecutar el clásico mantra de instalación:

  > make
  > make test
  > make install