Manual de instalación y configuración de Liferay SO

Índice Instalación y Configuración ............................................................................................ 3 Instalación y configuración configuración de JDK................................................................................. 3 Instalación de Liferay Social Office................................................................................. 4 Configuración Configuración de la base de datos ................................................................................. 7 Backup a la Base de datos ............................................................................................. 8 Restaurar la Base de Datos ........................................................................................... 8 Estructura de Archivos de Liferay Social Office .............................................................. 9 Data .......................................................................................................................... 10 Deploy ...................................................................................................................... 10 Tomcat ..................................................................................................................... 10 Estructura de carpetas de ROOT.............................................................................. 12 Personalización Personalización Gráfica de Liferay Social Office .......................................................... 13 Configuración Configuración de las Propiedades de Personalización.............................................. 15

Funcionalidades Funcionalidades y Configuraciones Configuraciones............................................................................. 17 Acceso a Liferay Social Office ...................................................................................... 17 Página de Inicio de Liferay Social Office ...................................................................... 18 Sitios web ................................................................................................................. 18 Contactos ................................................................................................................. 18 Avisos ....................................................................................................................... 20 Actividades Actividades (Activities) .............................................................................................. 20 Tareas (Tasks).......................................................................................................... 21 Eventos de Hoy (Today’s Events) ............................................................................. 22

Clima (Weather)........................................................................................................ 22

Sitios Web ...................................................................................................................... 24 Inicio (Home)................................................................................................................ 25 Welcome (Bienvenida) (Bienvenida) .............................................................................................. 25 Enlaces..................................................................................................................... 25 Feeds ....................................................................................................................... 26 Avisos ....................................................................................................................... 27

Manual de Instalación y Configuración de Liferay Social Office

Actividades Actividades ............................................................................................................... 28 Documentos recientes .............................................................................................. 28 Eventos de hoy (Today’s event) ................................................................................ 28 Calendario (Calendar) .................................................................................................. 28 Documentos (Documen ( Documents) ts) ............................................................................................ 31 Foro ............................................................................................................................. 33 Blog.............................................................................................................................. 34 Wiki .............................................................................................................................. 36 Chat ............................................................................................................................. 37

Gestión de Usuarios ...................................................................................................... 38 Perfil de Usuario........................................................................................................... 38 Creación de Usuarios................................................................................................... 39 Creación de Roles........................................................................................................ 40

2


Actividades Actividades ............................................................................................................... 28 Documentos recientes .............................................................................................. 28 Eventos de hoy (Today’s event) ................................................................................ 28 Calendario (Calendar) .................................................................................................. 28 Documentos (Documen ( Documents) ts) ............................................................................................ 31 Foro ............................................................................................................................. 33 Blog.............................................................................................................................. 34 Wiki .............................................................................................................................. 36 Chat ............................................................................................................................. 37

Gestión de Usuarios ...................................................................................................... 38 Perfil de Usuario........................................................................................................... 38 Creación de Usuarios................................................................................................... 39 Creación de Roles........................................................................................................ 40

2


Instalación y Configuración Instalación y configuración de JDK Liferay Social Office requiere de JDK (Java Delopment Kit) para poder ejecutarse y utilizar sus funciones. Para poder acceder a la última versión de JDK se debe ir a la dirección http://www.oracle.com/technetwork/java/javase/downloads/index.html. La versión de JDK debe ser 1.6 o superior. En este caso se explicará la instalación de JDK en una distribución GNU/Linux Debian y derivadas. Para ello primeramente creamos una carpeta donde se encontrará JDK:

mkdir usr/java

Luego movemos el paquete comprimido y lo descomprimimos por medio del siguiente comando:

tar zxvf jdk--linux.tar.gz jdk--linux.tar.gz Finalmente eliminamos el archivo tar.gz Ahora hay que configurar la variable JAVA_HOME para ello hay que seguir los siguientes pasos: Editamos el archivo bashrc escribiendo el siguiente comando: nano /home/<>/.bashrc

Agregar estas líneas: 

export JAVA_HOME=/usr/java/ JAVA_HOME=/usr/java/jdk1.6.0_05 jdk1.6.0_05



export PATH=$JAVA_HOME/bin PATH=$JAVA_HOME/bin:$PATH :$PATH

3


Instalación de Liferay Social Office La versión de Liferay Social Office (SO) con la que se trabajará es la 1.5b que puede conseguirse de la página oficial de Liferay. Esta versión trabaja con la versión 6 de Tomcat. Primeramente extraemos Liferay SO en la ubicación donde se instalará.

Una vez descomprimido necesitamos configurarlo para poder utilizarlo. Para ello seguiremos los siguientes pasos: -

Se debe crear o modificar el archivo portal-ext.properties que se encuentra en <>\tomcat-6.0.18\webapps\ROOT\WEB-INF\classes.

4


-

Una vez ubicado o creado el archivo según el caso agregaremos las siguientes líneas de configuración. jdbc.default.driverClassName=com.mysql.jdbc.Driver jdbc.default.url=jdbc:mysql://localhost/<>?useUnicode=true&characte rEncoding=UTF-8&useFastDateParsing=false jdbc.default.username=<> jdbc.default.password=<>

Para iniciar Liferay SO debemos iniciarlo a través del archivo starup.sh para ello nos ubicaremos en la carpeta donde se encuentra por medio de un terminal de comandos y luego iniciarlo por medio del siguiente comando.

5


Luego de ejecutar el comando nos aparecerán unas líneas de código que indican que se está ejecutando. Sólo se debe esperar a que cargue la aplicación y será lanzada en el navegador.

Si se desea ver los procesos por línea de comandos se debe utilizar el siguiente comando al inicializar.

./startup tail -f ../logs/catalina.out

Una vez cargada la aplicación aparecerá la página de acceso con la cual se podrá ingresar a la aplicación.

6


Configuración de la base de datos Para configurar la base de datos previamente debemos instalar MySQL que es la base de datos con la que se ha desarrollado Liferay Social Office. Luego de ello simplemente debemos abrir un terminal de Linux donde ingresaremos a MySQL.

Luego crearemos la base de datos “social” y le asignaremos los permisos necesarios para utilizar la base de datos.

7


Backup a la Base de datos Si se desea realizar un resguardo de la base de datos se tiene que ingresar, desde la terminal de comandos, el siguiente comando.

mysqdump -uroot –p123456 portal --opt > portal.sql Dónde:     

–u debe ir seguido del usuario de la base de datos. –p debe ir seguido de la contraseña del usuario portal representa la base de datos que deseamos resguardar. --opt realiza un resguardo de la base de datos óptimo. portal.sql es el nombre del archivo con el que se guardará el resguardo.

Nótese que el resguardo se guardará en la ruta donde se está ubicado, en este caso es la carpeta documentos.

Restaurar la Base de Datos Para restaurar un backup o resguardo de la base de datos se debe ingresar por el terminal a mysql y seleccionar la base de datos que se desea utilizar para la restauración. Si no existiera se crea una nueva.

8


Luego cargamos el archivo del resguardo indicando su ruta con el siguiente comando.

Luego de ello la base de datos estará restaurada.

Estructura de Archivos de Liferay Social Office Liferay Social Office posee una estructura de carpetas que está incluida en el servidor Tomcat y que detallaremos a continuación.

9


Data En esta carpeta se almacenan los documentos que se guardan en el portal (biblioteca de documentos y galería de imágenes) e imágenes propias del portal.

Deploy En esta carpeta se colocan los portlets que desea mostrarse como un portlet en el portal.

Tomcat Esta es la carpeta de configuración del servidor donde se puede encontrar una serie de subcarpetas de las cuales detallaremos las principales.

a. Bin Es la carpeta donde se hallan los archivos del servidor y que incluye los archivos para iniciar y detener el mismo.

10


Para iniciar o detener el servicio se utilizan los siguientes archivos.

Windows: startup.bat (inicia el servicio) y shutdown.bat (detiene el servicio). Linux: startup.sh (inicia el servicio) y shutdown.sh (detiene el servicio). b. Conf En esta carpeta se hallan los archivos de configuración del servidor.

Destaca el archivo server.xml, que es donde se configura el puerto por el que trabajará Liferay Social Office. Este puerto puede ser cambiado por otro si no está disponible.

11


c. Webapp Esta carpeta incluye toda los portlets y archivos propios del portal. En ella se pueden observar los diferentes portlets que se utilizan. Dentro de estas carpetas, la carpeta ROOT es la principal ya que contiene la estructura de carpetas del portal.

Estructura de carpetas de ROOT En esta carpeta se encuentra la distribución y configuración del portal con una serie de carpetas.

12


a. Html En esta carpeta se registran los portlets y la línea gráfica del portal.

b. Layaouttpl En esta carpeta se encuentran las plantillas que se muestran en el portal.

c. WEB-INF En esta carpeta se encuentran los archivos de registro de los portlets, templates y conexión a la base de datos.

d. Templates En esta carpeta se encuentran las carpetas de las plantillas que manejan la línea gráfica del portal.

Personalización Gráfica de Liferay Social Office Liferay Social Office puede ser personalizado para adaptar la línea gráfica. Esta personalización se da al configurar una serie de archivos. En Liferay Social Office la plantilla por defecto que utiliza se encuentra en la carpeta so-theme que está dentro de la carpeta webapps.

Dentro de esta carpeta se pueden ver claramente una serie de subcarpetas ordenadas que integran la plantilla por defecto. A continuación se describe cada una. 

Css

En esta carpeta se guardan las hojas de estilo del portal. De todas las hojas de estilo la que maneja la mayoría de las principales clases css es el archivo custom.css.

13




Images

En esta carpeta se guardan todas las imágenes relacionadas a la interfaz gráfica del Liferay Social Office. 

Javascript

En esta carpeta se encuentran los archivos Javascript que utiliza el portal. 

Templates

En esta carpeta se hallan los archivos de estructura de las plantillas. Estos archivos están escritos en código Velocity combinado con html.

Dentro de estos archivos, el que maneja la estructura principal del portal es el archivo “portal_normal.vm”.

14




WEB-INF

En esta carpeta se encuentran los archivos de registro la plantilla.

Configuración de las Propiedades de Personalización Liferay Social Office requiere una configuración especial para poder editar la línea gráfica. Para incluir esta configuración debemos hallar el archivo “portal -ext.properties” ya utilizado anteriormente y agregarle al final las siguientes líneas de código. theme.css.fast.load=false theme.images.fast.load=false javascript.fast.load=false javascript.logs.load=false layout.template.cache.enabled=false browser.launcher.url= last.modified.check=false velocity.engine.resource.manager.cache.enabled=false com.liferay.portal.servlet.filters.cache.CacheFilter=false

15


Este código es necesario para que los cambios surtan efecto sobre la interfaz gráfica. Una vez ingresado el código se debe guardar el archivo “portal -ext.properties” y es necesario reiniciar el servidor si es estuviera en uso.

16


Funcionalidades y Configuraciones Acceso a Liferay Social Office Para ingresar a la aplicación debemos ingresar nuestro usuario y contraseña. El usuario por defecto es “admin” y su contraseña es “admin”. Una vez logueado, si se es un usuario nuevo se pedirá primeramente una pregunta de seguridad que nos servirá para recuperar nuestra contraseña.

Una vez ingresada la pregunta de seguridad se podrá ver la pantalla principal de Liferay Social Office.

17


Página de Inicio de Liferay Social Office En la página de inicio de Liferay SO se encuentra toda la información de cada usuario con diferentes secciones para una mejor organización.

Se pueden distinguir las siguientes secciones:

Sitios web Esta sección contiene los sitios web a los que está suscrito el usuario o que ha creado. Además posee la opción de agregar nuevos sitios web o eliminar los ya existentes.

Contactos En esta sección se pueden ver los contactos del usuario, pudiendo ver su estado, mandar un correo o un mensaje. Los usuarios que comparten un mismo sitio web son agregados automáticamente a los contactos.

18


También se puede agregar contactos manualmente, para ello se debe pulsar sobre la opción “Anadir Contacto”. Luego de ello aparecerá una ventana donde se deben llenar los datos del contacto y guardarlos para finalizar.

Además de ello se puede editar los contactos agregando información adicional que no estaba disponible en el momento de crearlos. Para ello se debe pulsar sobre la imagen blanca ( ) al lado del nombre del contacto para que aparezca una ventana donde se puede llenar la información adicional.

19


También se puede enviar mensajes a los contactos para ello hay que pulsar sobre la imagen azul ( ) la lado del nombre del contacto y se abrirá una ventana donde se puede escribir el mensaje.

Avisos En esta sección se muestran los avisos de todas las áreas a las que esté relacionado el usuario. Así mismo posee opciones de editar, eliminar y marcar como leído de acuerdo a nivel de privilegios que se posea.

Actividades (Activities) En esta sección se ven las últimas actividades de las diferentes áreas con las que esté relacionado el usuario. Se pueden ver las actividades de los sitios web del usuario, sus propias actividades y las de sus amigos.

20


Tareas (Tasks) En esta sección se ven las tareas que se le han asignado al usuario así como su avance. Además también muestra las tareas que ha creado y asignado el usuario.

Para agregar una tarea se debe pulsar sobre la opción “Añadir tarea”, luego de ello se abrirá una ventana donde se podrá ingresar la tarea con opciones prioridad, asignación a una persona y fecha. Además de ello se pueden colocar etiquetas para sea más sencillo ordenar las tareas en categorías.

Para ver el avance de una tarea sólo hay que observar la barra que está hacia la derecha del nombre de la tarea. Si deseamos agregar o cambiar el avance sólo debemos poner el puntero sobre la barra y seleccionar el porcentaje de avance que deseamos y luego pulsar para mantener el cambio.

21


Eventos de Hoy ( Today’s Events) Esta sección muestra los eventos del día de todas las áreas a las que esté relacionado el usuario.

Clima (Weather) Sección donde se muestra información del clima. Los lugares de donde se muestra la información son personalizables.

Para agregar un o cambiar una nueva ciudad, se debe utilizar el buscador para encontrarla en el sitio web del clima.

22


Luego de presionar en el botón buscar aparecerán los términos de búsqueda que coinciden dentro de la página externa que da el servicio del clima. Seleccionamos y copiamos el que sea el correcto.

Luego de copiarlo volvemos a la sección del clima en el portal y presionamos sobre la opción “Configurar”. Luego de ello nos aparecerá un formulario donde colocaremos el lugar deseado.

Luego de ello sólo bastaría guardar para que se apliquen los cambios.

23


Sitios Web Los sitios web son portadas donde cada usuario puede poner información que desee y compartirla con los usuarios que desee. Para crear un sitio web se debe posicionar sobre la sección “Sitios web” y seleccionar el enlace “Añadir Sitio”. Se abrirá una ventana donde se pondrá la información base del sitio como su nombre, descripción y tipo.

Una vez creado el sitio web se puede ingresar a él a través del menú superior “Mis Sitios Web”. Al ingresar se podrá ver la portada del sitio web.

Figura 15. Portada del sitio web. Dentro del sitio web existen diferentes secciones que son de utilidad y que explicaremos a continuación.

24


Inicio (Home) Es la portada del sitio web donde se encuentran las diferentes secciones que posee y que reúnen un resumen general del contenido e información del sitio web. Posee las siguientes secciones.

Welcome (Bienvenida) En esta sección se puede colocar un mensaje de bienvenida para los miembros del sitio.

Para ingresar un nuevo mensaje de bienvenida pulsando en la opción “Configurar ”. Luego de ello aparecerá una ventana con diversas opciones de personalización del mensaje. Al finalizar sólo basta guardar para mantener los cambios.

Enlaces En esta sección se puede colocar los enlaces web externos que se consideren de interés para el sitio web.

25


Para ingresar nuevos enlaces se debe pulsar sobre la opción “Anadir Entrada” . Luego de ello aparecerá un formulario para ingresar el enlace.

Feeds En esta sección en la que se puede agregar suscripciones RSS de páginas web para darles seguimiento.

Para ingresar o modificar los feeds se debe pulsar sobre la opción “Configurar” donde aparecerán las opciones de configuración para los feeds como la URL, el título, la cantidad, etc.

26


Avisos En esta sección se colocan los avisos de la página.

Dentro de esta sección se tienen dos opciones. La primera es “Añadir Entrada”, con esta opción se ingresa un nuevo aviso con opciones de configuración como fecha de expiración, tipo y prioridad.

27


Actividades Esta sección es donde se mostrarán las actividades relacionadas con el sitio web que se estén realizando. Se pueden distinguir tres pestañas, una que lista las actividades del sitio web, otra que lista las actividades del usuario y otra para las actividades de los amigos.

Documentos recientes En esta sección se muestran los documentos recientemente compartidos del sitio web. Se puede descargar la información de cada uno de ellos pulsando sobre su nombre.

Eventos de hoy (Today’s event) Donde se muestran los eventos del día que son propios del sitio web.

Calendario (Calendar) El calendario es la siguiente sección donde se encuentra un completo calendario donde se puede agregar y ver las diferentes actividades del sitio web. Posee múltiples opciones dependiendo del nivel de privilegios del usuario.

28


Para agregar un nuevo evento al calendario se debe pulsar sobre la opción “Agregar evento” en la parte superior del calendario. Luego de ello aparecerá un formulario donde se puede configurar el evento de acuerdo lo deseado.

29


También se puede ingresar un nuevo evento haciendo click en el figura ( ) al lado de cada fecha del calendario llenando el mismo formulario. Así mismo se puede ver el calendario a nivel de semana o día para ello seleccionamos la opción que deseemos que se ubican en la parte superior de la página.

Además de ello se pueden filtrar los eventos de acuerdo a su tipo seleccionando el tipo de la lista de eventos que se encuentra en la parte superior derecha sobre el calendario.

30


Documentos (Documents) El sitio web también cuenta con una sección para documentos donde se puede colgar la documentación de forma ordenada y por secciones para mantener un control de los mismos hasta en versiones.

Para agregar una nueva carpeta de documentos sólo hay que pulsar sobre la opción “Añadir carpeta” luego de lo cual aparecerá un formulario simple para c rear la carpeta.

Para agregar un nuevo documento ingresamos primero a la carpeta donde se hallará y luego presionamos sobre la opción “Agregar documento”. Luego aparecerá n las opciones para subir los documentos.

Existen dos opciones. La primera opción de subida de documentos es por el método de examinar y puede subir múltiples archivos a la vez. Sólo basta con pulsar sobre la opción “Examinar” y luego elegir en el explorador los archivos que deseemos subir. Luego de ello se listarán los archivos que se han escogido para verificarlos. Luego para subir los archivos sólo hay que pulsar en la opción “Subir archivos” y esperar a que acabe el proceso. 31


La segunda opción de subida de documentos es por el método clásico con el que se puede subir sólo un archivo a la vez. Al presionar sobre esta opción aparecerá un formulario con el que se puede examinar y buscar el documento de manera similar al método anterior. Luego de seleccionar el documento llenamos el formulario de información del documento y lo guardamos.

También existen opciones sobre las carpetas y documentos subidos. Estas aparecen al lado derecho del nombre en la opción “Acciones” de la carpeta o documento. Dependiendo de los privilegios las opciones son de eliminar, ver, editar y asignar permisos.

32


Foro También se cuenta con un foro para poder crear temas de discusión y resolver dudas de los usuarios del sitio web. Posee un completo sistema de foro con el cual se puede trabajar perfectamente.

Para agregar una nueva categoría se debe pulsar sobre la opción “Añadir categoría” . Aparecerá un formulario simple para agregar la categoría. De la misma manera se agregan subcategorías.

Para añadir un nuevo hilo de discusión dentro de una categoría se debe ingresar primeramente a la categoría deseada y luego pulsar sobre la opción “Crear nuevo hilo de discusión”. Aparecerá un formulario para añadir el hilo con diferentes opciones.

33


Blog Existe también un Blog donde los usuarios autorizados podrán colgar sobre intereses diversos o específicos y compartirlos con los demás usuarios. Es muy simple pero posee muchas opciones de publicación.

34


Para añadir una nueva entrada hay que pulsar sobre la opción “Añadir entrada de blog”. Aparecerá un formulario con diferentes opciones de personalización de la entrada. Para terminar el proceso sólo basta con pulsar en la opción “Publicar”.

35


Wiki Se posee además de una Wiki para colgar manuales y guías diversas. Las Wikis son importantes para colgar diferentes guías, manuales, información y más para que los usuarios puedan acceder directamente y no tengan la necesidad de buscarlas externamente.

Para editar o agregar información a la wiki hay que pulsar sobre la opción editar. Luego de ello aparecerá un formulario donde se puede llenar la información utilizando el código personalizado que está detallado al lado derecho.

Para agregar subpáginas hay que pulsar en la opción “Agregar subpágina” que se encuentra en la parte inferior de la página. De la misma forma aparecerá el mismo formulario que el mostrado anteriormente. 36


Chat Además de todo esto Liferay Social Office posee un servicio de chat para poder comunicarse rápidamente con los contactos que un usuario posea. Este servicio está activo en todas las áreas de acceso del usuario.

37


Gestión de Usuarios Perfil de Usuario Cada usuario posee un perfil de usuario donde puede modificar su información y configuración de su cuenta como cambio de nombre, contraseña, idioma, etc. Además se puede ver las actividades de las diferentes áreas con las que esté relacionado. Para acceder al perfil se pulsa sobre la opción “Mi perfil” que se encuentra en la esquina superior derecha de la página.

Para editar el perfil de un usuario hay que pulsar sobre la opción “Editar Perfil”. Luego aparecerá un formulario mostrando la información actual del usuario que puede ser editada. Para finalizar el cambio sólo hay que pul sar la opción “Guardar”.

38


Creación de Usuarios Un usuario puede ser creado por dos métodos. El primero es un registro de cuenta por parte del usuario, muy similar a cualquier sitio web, que se encuentra en la página de acceso, donde el usuario ingresa sus datos y correo electrónico y luego le llega a ese correo un correo de confirmación para activar de cuenta. Luego de ello la cuenta estará activa y podrá ser utilizada.

El segundo método es crear el usuario por medio del panel de control. Este sólo está disponible para el administrador de Liferay SO y los usuarios que posean los privilegios. Para ello se ingresa al Panel de Control y la sección “Portal” se encontrará la opción “Usuarios” y luego hacer ingresar a crear usuario.

39

Manual de instalación y configuración de Liferay SO

Recommend Documents