Instalación y Configuración de Prontus

desde paquetes

Prontus es un desarrollo de fuente abierta de AltaVoz S.A.(www.altavoz.net)

v. 1.4

Este documento lo guiará a través de la instalación de Prontus desde paquetespreparados para distribuciones Debian o CentOS, los cuales puede obtener desde elsitio web de Prontus, www.prontus.cl, sección descargas.

Los paquetes de instalación han sido testeados en sistemas Ubuntu 13.04 (paquete.deb) y CentOS 6.4 (paquete .rpm)

Instalación

Instalar el paquete deb

Para ejecutar el instalador, sólo debe abrir el archivo Prontus_<version>.deb quedescargó con el gestor de paquetes de Debian, haciendo clic con el botón secundarioy elegir la opción “Abrir con instalador de paquetes GDebi”. Para poder instalarProntus usted debe poseer una conexión a internet y conocer la contraseña delusuario root del sistema, o tener acceso al comando sudo. Si no tiene el accesonecesario, consulte con el administrador de su respectiva red.

Una vez abierto el instalador Gdebi, debe dar clic sobre el botón “Instalar paquete”.En este instalador usted también puede ver la descripción de Prontus, y consultarsobre los cambios que se realizan al instalar el programa, como muestra la Figura 1.

Figura 1: Instalación paquete .deb

MySQL es el motor de base de datos necesario para el funcionamiento de prontus, sino está instalado en el sistema el instalador lo hará por usted. Para tal efecto, se desplegará una ventana solicitando ingresar la contraseña para elusuario root de MySQL como se muestra en la Figura 2, es importante que recuerdela clave que ingresará.

Una vez haya finalizado el proceso, aparecerá una confirmación de instalacióncorrecta, con una alerta que le recordará ejecutar el archivo var/www/lib_install.sh,

como se muestra en la Figura 3. Posteriormente se desplegarán los archivosREADME.txt y license.txt.

Figura 2: Clave de Mysql

Figura 3: Alerta de instalación

Ejecutar Script de post instalación

Para completar la instalación debe ejecutar el script de post instalación, para estodebe abrir un terminal como usuario root, y ejecutar el script con el siguientecomando, como se indica en la Figura 4:

/var/www/lib_install.sh

Una vez finalizado este proceso debe abrir su navegador web, y ejecutar el asistentede creación para nuevo sitio Prontus.

Ahora solo falta crear el nuevo sitio con la ayuda del wizard_prontus. Para acceder alasistente abra su navegador web e ingrese en la barra de direcciones la siguiente urlhttp://localhost/wizard_prontus

Si usted no sabe cómo ingresar comandos como root lea la sección “Ejecutarcomandos como root”

Figura 4: Ejecutar Script post-instalación

Ejecutar comandos como root

Para ejecutar comandos como root, usted debe abrir una terminal, para ello vaya almenú Aplicaciones, Accesorios, Terminal de «Root» como lo indica la Figura 5,inmediatamente se desplegará un cuadro de dialogo, donde debe ingresar lacontraseña de root. Luego debe ejecutar el script de instalación ingresando elsiguiente comando:

/var/www/lib_install.sh

Figura 5: Abrir terminal

Alternativamente, sobre todo en sistemas Ubuntu, deberá tener acceso al comando sudo. El funcionamiento es prácticamente el mismo, deberá abrir una terminal como se describió antes, y luego anteponer la orden sudo a cada comando. Por ejemplo:

sudo /var/www/lib_install.sh

Se le solicitará ingresar su contraseña de usuario. Si su usuario no tiene permisos parausar sudo, consulte a su administrador de red.

Ejecutar el paquete .rpm

Para ejecutar el instalador, sólo debe abrir el archivo prontus-<version>.rpm quedescargó, haciendo clic con el botón secundario y elegir la opción “Abrir con Instaladorde paquetes”, como se muestra en la Figura 6. Para poder instalar Prontus usteddebe poseer una conexión a internet y acceso como usuario root.

Figura 6: instalar el paquete RPM.

Ejecutar Script de post instalación

El script de post-instalación para CentOS que usted deberá ejecutar es /var/www/html/install/lib_install.sh. Deberá abrir una terminal, que en CentOS por

defecto está en el menú Aplicaciones –> Herramientas del Sistema, como se muestra en la Figura 7.

Figura 7: Acceso a la Terminal en CentOS.

Durante el proceso de post-instalación se le solicitará ingresar una contraseña paraacceso al backoffice de su Prontus. Deberá ingresar esta contraseña (para el usuario“prontus”) en el siguiente paso de la instalación, cuando aparezca una ventanaemergente de su navegador solicitando credenciales de acceso al área restringida deProntus.

Una vez finalizado este proceso debe abrir su navegador web, y ejecutar el asistentede creación para nuevo sitio Prontus.

Ahora solo falta crear el nuevo sitio con la ayuda del Asistente Prontus. Para accederal asistente abra su navegador web e ingrese en la barra de direcciones la siguienteurl: http://localhost/wizard_prontus.

Ejecutar asistente de creación de sitio Prontus

Para crear un sitio debe abrir su navegador web, y en la barra de navegación ingresarla siguiente url http://localhost/wizard_prontus , esta desplegará el asistente deconfiguración que se muestra en la Figura 8.

Figura 8: Asistente de instalación de un nuevo sitio Prontus

Al dar clic sobre el botón siguiente, se desplegará la pantalla que se muestra en laFigura 9, donde deberá completar los datos solicitados como se muestra en elejemplo.

Figura 9: Datos Básicos requeridos

Datos requeridos

• Identificador de Sitio Prontus: El primer dato que debe ingresar es elidentificador del sitio Prontus, este dato corresponde al nombre que

tendrá la carpeta que contendrá su sitio web, y el que se verá en la barrade navegación.

• Nombre del Sitio Prontus: Este campo se utilizará para desplegarlo enla etiqueta 'title' de las páginas del sitio, actuando como titular en cadapágina web.

• Base de Datos MySQL: A continuación se debe completar lainformación requerida sobre la base de datos, esta se asociará al nuevositio Prontus, en ella se almacenará la información necesario para elcorrecto funcionamiento de su sitio web.

• Si no tiene una base de datos creada para este fin, el asistente puedecrearla por usted, solo deberá agregar los nuevos datos para ésta:nombre de la nueva base de datos, nombre del nuevo usuario, y surespectiva nueva clave.

• Si está creando una nueva base de datos, debe completar, con unacuenta que tenga privilegios suficientes, los campos usuario y clave bajoel título “Cuenta para creación de BD (optativa)”. Puede usar lacuenta root y la password que ingresó para MySQL al instalar Prontus.

• Para el campo del servidor SMTP, puede ingresar la IP de donde seencuentra este, o utilizar localhost como servidor SMTP, este campo noes obligatorio. Una vez completados los datos, dar clic sobre el botón“siguiente”.

Selección de Modelos Prontus

Luego usted debe seleccionar alguno de los modelos prediseñados, se recomiendahacer clic sobre ellos, para verlos en detalle y así elegir el que más se adecue para susitio web, ya que después no podrá cambiarlo. Si desea saber más acerca de losmodelos prediseñados vea la sección “Modelos prediseñados”.

Figura 10: Selección de Modelos Prontus

Luego de esto usted se encontrará con la pantalla de confirmación, para continuar declic sobre el botón “generar mi sitio”, al hacer esto Prontus creará su nuevo sitiocon los datos que usted ingresó previamente.

Figura 11: Confirmar Configuración

La última pantalla del instalador le informa que el sitio se creó con éxito y presentados links, uno para visualizar el sitio creado y el otro para acceder al panel de control,en el cual usted podrá agregar y editar contenido. Luego deberá proceder a establecerla contraseña para el sitio creado.

Figura 12: Reporte de Instalación

Establecer contraseña

La primera vez que acceda al panel de control, Prontus le solicitará la modificación dela contraseña, como se muestra en la Figura 13, para llegar hasta acá usted puedeingresar en la barra de navegación la url http://127.0.0.1/<miSitio>/cpan o alhaber hecho clic en el link panel de control cuando finaliza la configuración.

Para toda nueva instalación el usuario es “admin” y la contraseña es “prontus”; luegose le solicitará cambiar la contraseña por una nueva, la cual no puede ser “prontus”.Si la contraseña fue cambiada exitosamente el sistema lo informará.

Figura 13: Cambiando Contraseña

Finalizando

¡Felicitaciones! Si el cambio de contraseña fue exitoso usted ya dispone de su sitioProntus totalmente instalado, puede acceder al panel de control ingresando en labarra de url de su navegador

http://127.0.0.1/<miSitio>/cpan

Notará en la esquina superior izquierda que aparece el nombre del sitio.

Si desea ingresar al sitio instalado ingrese http://127.0.0.1/<miSitio > , recuerdeque esta es la visualización que un usuario tendrá de su web.

Figura 14: Fin de la Instalación

Publicar Contenido

Hasta acá ya tenemos un sitio prontus correctamente instalado, ahora crearemosnuestro propio contenido para luego añadirlo al sitio Prontus. Antes de comenzarusted debe conocer cierta nomenclatura y el área de trabajo de Prontus.

• Artículo: Página web que desarrolla un tema ingresado por el operador. Estetema se puede desarrollar incorporando texto, imágenes, archivosdescargables, videos y cualquier otro material que se desee visualizar y sea deimportancia.

• Portada: Página web que agrupa un conjunto de links a artículos y/o a otrasportadas de acuerdo algún criterio de orden temático.

• Área: Sector dentro de una portada que contendrá uno o más artículospublicados. Cada área permite publicar artículos dándoles un determinadonúmero de orden. Un área define por tanto toda la información variable y que eloperador de Prontus puede manejar.

• Plantilla: Las plantillas son páginas que sirven de moldes para crear artículos yportadas. En éstas se define todo el diseño de las páginas, la distribución de loselementos a publicar (titular, fecha, texto del cuerpo, etc.), los formatos detexto y toda la programación asociada a efectos de presentar contenidoprocesado.

• Formulario de ingreso de datos (FID): El formulario de ingreso de datos oFID, corresponde al formulario encargado de recibir la información, la que va aser reemplazada en la plantilla de artículo, y crear finalmente la página deartículo, la que luego es almacenada en el servidor.

• Categorías: Sección, Tema y Subtema; Son niveles de grupos temáticos enlos cuales se puede categorizar una publicación, de esta manera es posibleagrupar artículos. La ventaja que proporciona tener artículos agrupados pordistintas categorías, consiste en que automáticamente se crean artículosrelacionados y portadas relacionadas, ya sea sección y/o tema y/o subtema quepueden ser fácilmente incluidos en el sitio web.

Crear nuevo contenido

Para crear nuevo contenido en su sitio web Prontus, debe seguir los siguientes pasos:

• Desde su navegador web, Ingrese al panel de control Prontus escribiendohttp://localhost/<Misitio>/cpan, donde Misitio corresponde al nombre del sitioProntus, podrá visualizar una pantalla similar a la de la figura 15.

Figura 15: Panel de Control Prontus

• Una vez dentro, podrá visualizar una serie de controles, los del panel derechocorresponden a los artículos disponibles, en el costado superior derecho, está elbotón crear nuevo artículo, para efectos de agregar nuevo contenido vamos acrear un nuevo artículo.

• Al presionar, lo que usted ve en pantalla corresponde al FID para ingresar unnuevo artículo, existen distintos FID, se pueden ver y seleccionar en el costadoderecho. Luego de esto ya estamos en condiciones de completar con algunosdatos nuestro FID, como por ejemplo el “título”, “epígrafe”, “bajada”, “cuerpo”y alguna foto. En el ejemplo de las figuras se crea un artículo de tipo Generalcon título “Artículo de Ejemplo".

Figura 16: Creación de nuevo artículo

• Guarde el artículo.

• Vuelva a la pantalla principal presionando en el botón Artículos.

• Notará que su artículo fue creado, y se encuentra disponible en el panelderecho, arrástrelo hacia el lado izquierdo en alguna de las áreas, ahorapresione Guardar, asegúrese de que tenga un ticket verde, esto significa queel artículo será mostrado. Al hacer este paso, su artículo ya pertenece a laportada seleccionada, ahora solo nos queda ver el resultado de dichapublicación.

Figura 16: Visualización de artículo en Portada

Figura 17: Visualización de pagina de artículo

• Presione el botón previsualizar portada y aparecerá la portada con su artículoincluido, también puede hacer clic sobre los artículo para desplegarlos. Parapracticar cree nuevos artículo de distintos FID's y añádalos a distintas áreas delas portadas, de esta forma podrá ver el comportamiento de publicación.

Modelos Prediseñados

Actualmente el instalador de Prontus posee modelos prediseñados que le harán sutrabajo más fácil, cada modelo existente tiene como objetivo ser una base a undeterminado tipo de comercio o sitio web, los modelos Pontus que usted puedeencontrar, son los siguientes:

1. Modelo Autos: Modelo especial para publicar autos y maquinaria de motor,con secciones para nuevos y usados, sugerido para comercios de venta deproductos.

2. Modelo Blog: Modelo definido para mantener información a modo de bitácora,el objetivo es poder presentar información con carácter temporal y de formaorganizada. Es especial para subir reseñas, fotografías y atracciones de todo elmundo.

3. Modelo Empresa: Modelo de uso general para las empresas, se muestra datosbásicos de las empresas y noticias asociadas.

4. Modelo Imágenes: Utilice este diseño para publicar contenido artístico, lasimágenes se agrupan por álbumes y con efectos de transición entre ellas. Estapensado para ser un catalogo web de sus creaciones.

5. Modelo Mínimo: Modelo para crear sitios web simples, livianos y sin mayorcomplejidad.

6. Modelo Productos: Enfocado a empresas que cuentan con una serie deproductos y/o servicios, y que necesitan dar a conocer a sus clientes. Para esto,el modelo cuenta con una serie de artículos y portadas específicas comolistados de productos, galerías, integradores y otros. Es más completo que elmodelo Empresa.

7. Modelo Responsive: Apropiado para publicar noticias de artes, actualidad,entretención y urbanismo, tiene la ventaja que se adapta al tipo de dispositivoen donde se visualiza, ya sea navegadores web con diferentes resoluciones,tablet's y dispositivos móviles.

8. Modelo Simple: Modelo sugerido para comenzar a utilizar Prontus con lasopciones más típicas, le permite configurar gran cantidad de aspectos, loscuales en otros modelos ya se encuentran disponibles.

9. Modelo Vacío: No tiene contenido asociado, utilícelo cuando desee comenzardesde cero a construir su nuevo sitio web.

Cambios realizados por el instalador.

Para que Prontus funcione correctamente, es necesario contar con ciertas aplicacionesy bibliotecas en el sistema, además es fundamental la correcta configuración delservidor web apache. El archivo de instalación de Prontus se encarga de instalar lasdependencias y realizar las configuraciones, para garantizar el correctofuncionamiento.

Dependencias de Prontus que agregará el instalador ensistemas Debian.

Se instalarán automáticamente las siguientes aplicaciones:

• apache2

• mysql-server

• php5

• unzip

Se instalarán también, las siguientes bibliotecas para Perl:

• libjson-perl

• libdbi-perl

• libdbd-mysql-perl

• libxml-parser-perl

• libhttp-response-encoding-perl

• liblwpx-paranoidagent-perl

• liburi-perl

• libgd-gd2-perl

• liblockfile-simple-perl

• libnet-dns-perl

• libhtml-parser-perl

3.2 Archivos y directorios que se verán afectados.

El Instalador de Prontus creará los siguientes archivos y directorios con suscontenidos, en la carpeta /var/www:

Árbol de directorios Prontus

• cgi-cpn

• cgi-bin

• wizard_prontus

• install (archivos de configuración de sistema y bibliotecas que necesita queno están disponibles)

• lib_install.sh

• README.txt

• license.txt

Será necesaria la modificación de los siguientes archivos:

• /etc/apache2/mods-available/php5.conf

• /etc/apache2/sites-available/default

• /etc/apt/sources.list

• /etc/php5/apache2/php.ini

El instalador realizará automáticamente un respaldo de cada uno de ellos en susrespectivas carpetas, antes de modificados. Los archivos de respaldo serán:

• /etc/apache2/mods-available/php5.conf.bak

• /etc/apache2/sites-available/default.bak

• /etc/apt/sources.list.bak

• /etc/php5/apache2/php.ini.bak

Por último, el Instalador modificará el propietario para la carpeta /var/www, dejandocomo nuevo propietario al usuario “www-data”, el usuario por defecto de Apache, ycambiará los permisos para los archivos con extensión cgi dentro de la carpetacgi-cpn, para que puedan ser ejecutadas.

• chown -R www-data /var/www;

• chmod 755 /var/www/cgi-cpn/*.cgi;

Dependencias de Prontus que agregará el instalador ensistemas CentOS.

De no estar previamente instaladas, se instalarán automáticamente las siguientesaplicaciones:

• apache2

• mysql-server

• php5

• unzip

• perl

• make

• automake

• gcc

• gcc-c++

• kernel-devel

Se instalarán también, las siguientes bibliotecas para Perl:

perl-HTML-Parser

perl-XML-Simple

perl-Net-DNS

perl-LockFile-Simple

perl-GD

perl-URI

perl-LWPx-ParanoidAgent

perl-HTTP-Response-Encoding

perl-XML-Parser

perl-DBD-MySQL

perl-DBI

perl-JSON

perl-Mail-Sender

ffmpeg

perl-UNIVERSAL-require

curl

libcurl-devel

php-mcrypt

perl-Time-HiRes

dialog

Archivos y directorios que se verán afectados.

El Instalador de Prontus creará los siguientes archivos y directorios con suscontenidos, en la carpeta /var/www/html/:

Árbol de directorios Prontus

• cgi-cpn

• cgi-bin

• wizard_prontus

• install (archivos de configuración de sistema y bibliotecas que Prontusnecesita y que no están disponibles).

• README.txt

• license.txt

Será necesaria la modificación de los siguientes archivos:

• /etc/httpd/conf.d/php.conf

• /etc/httpd/conf.d/php.conf

• /etc/sysconfig/iptables

• /etc/php.ini

El instalador realizará automáticamente un respaldo de cada uno de ellos en susrespectivas carpetas, antes de modificados. Los archivos de respaldo serán:

• /etc/httpd/conf.d/php.conf.bak

• /etc/httpd/conf.d/php.conf.bak

• /etc/sysconfig/iptables.bak

• /etc/php.ini.bak

Por último, el Instalador modificará el propietario para la carpeta /var/www/html,dejando como nuevo propietario al usuario “apache”, el usuario por defecto deApache, y cambiará los permisos para los archivos con extensión cgi dentro de lacarpeta cgi-cpn, para que puedan ser ejecutadas.

• chown -R apache /var/www/html;

• chmod -R apache /var/www/html;