manual de instalación y configuración de liferay so

ndiceInstalacin y Configuracin ............................................................................................ 3 Instalacin y configuracin de JDK................................................................................. 3 Instalacin de Liferay Social Office................................................................................. 4 Configuracin 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 Personalizacin Grfica de Liferay Social Office .......................................................... 13 Configuracin de las Propiedades de Personalizacin.............................................. 15 Funcionalidades y Configuraciones ............................................................................. 17 Acceso a Liferay Social Office ...................................................................................... 17 Pgina de Inicio de Liferay Social Office ...................................................................... 18 Sitios web ................................................................................................................. 18 Contactos ................................................................................................................. 18 Avisos ....................................................................................................................... 20 Actividades (Activities) .............................................................................................. 20 Tareas (Tasks).......................................................................................................... 21 Eventos de Hoy (Todays Events) ............................................................................. 22 Clima (Weather)........................................................................................................ 22 Sitios Web ...................................................................................................................... 24 Inicio (Home) ................................................................................................................ 25 Welcome (Bienvenida) .............................................................................................. 25 Enlaces ..................................................................................................................... 25 Feeds ....................................................................................................................... 26 Avisos ....................................................................................................................... 27

Manual de Instalacin y Configuracin de Liferay Social Office Actividades ............................................................................................................... 28 Documentos recientes .............................................................................................. 28 Eventos de hoy (Todays event) ................................................................................ 28 Calendario (Calendar) .................................................................................................. 28 Documentos (Documents) ............................................................................................ 31 Foro ............................................................................................................................. 33 Blog .............................................................................................................................. 34 Wiki .............................................................................................................................. 36 Chat ............................................................................................................................. 37 Gestin de Usuarios ...................................................................................................... 38 Perfil de Usuario ........................................................................................................... 38 Creacin de Usuarios ................................................................................................... 39 Creacin de Roles ........................................................................................................ 40

2

Manual de Instalacin y Configuracin de Liferay Social Office

Instalacin y ConfiguracinInstalacin y configuracin de JDK Liferay Social Office requiere de JDK (Java Delopment Kit) para poder ejecutarse y utilizar sus funciones. Para poder acceder a la ltima versin de JDK se debe ir a la direccin http://www.oracle.com/technetwork/java/javase/downloads/index.html. La versin de JDK debe ser 1.6 o superior. En este caso se explicar la instalacin de JDK en una distribucin 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 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 lneas:

export JAVA_HOME=/usr/java/jdk1.6.0_05 export PATH=$JAVA_HOME/bin:$PATH

3


Instalacin de Liferay Social Office La versin de Liferay Social Office (SO) con la que se trabajar es la 1.5b que puede conseguirse de la pgina oficial de Liferay. Esta versin trabaja con la versin 6 de Tomcat. Primeramente extraemos Liferay SO en la ubicacin 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 segn el caso agregaremos las siguientes lneas de configuracin. 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 travs 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 aparecern unas lneas de cdigo que indican que se est ejecutando. Slo se debe esperar a que cargue la aplicacin y ser lanzada en el navegador.

Si se desea ver los procesos por lnea de comandos se debe utilizar el siguiente comando al inicializar. ./startup tail -f ../logs/catalina.out

Una vez cargada la aplicacin aparecer la pgina de acceso con la cual se podr ingresar a la aplicacin.

6


Configuracin 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 Dnde: u debe ir seguido del usuario de la base de datos. p debe ir seguido de la contrasea 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.

Ntese 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 restauracin. 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 continuacin.

9


Data En esta carpeta se almacenan los documentos que se guardan en el portal (biblioteca de documentos y galera de imgenes) e imgenes 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 configuracin 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 configuracin 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 distribucin y configuracin del portal con una serie de carpetas.

12

Manual de Instalacin y Configuracin de Liferay Social Office a. Html En esta carpeta se registran los portlets y la lnea grfica 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 conexin a la base de datos. d. Templates En esta carpeta se encuentran las carpetas de las plantillas que manejan la lnea grfica del portal. Personalizacin Grfica de Liferay Social Office Liferay Social Office puede ser personalizado para adaptar la lnea grfica. Esta personalizacin 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 continuacin 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 mayora de las principales clases css es el archivo custom.css.

13


Images En esta carpeta se guardan todas las imgenes relacionadas a la interfaz grfica 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 estn escritos en cdigo 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. Configuracin de las Propiedades de Personalizacin Liferay Social Office requiere una configuracin especial para poder editar la lnea grfica. Para incluir esta configuracin debemos hallar el archivo portal-ext.properties ya utilizado anteriormente y agregarle al final las siguientes lneas de cdigo. 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

Manual de Instalacin y Configuracin de Liferay Social Office Este cdigo es necesario para que los cambios surtan efecto sobre la interfaz grfica. Una vez ingresado el cdigo se debe guardar el archivo portal-ext.properties y es necesario reiniciar el servidor si es estuviera en uso.

16


Funcionalidades y ConfiguracionesAcceso a Liferay Social Office Para ingresar a la aplicacin debemos ingresar nuestro usuario y contrasea. El usuario por defecto es admin y su contrasea es admin. Una vez logueado, si se es un usuario nuevo se pedir primeramente una pregunta de seguridad que nos servir para recuperar nuestra contrasea.

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

17

Manual de Instalacin y Configuracin de Liferay Social Office Pgina de Inicio de Liferay Social Office En la pgina de inicio de Liferay SO se encuentra toda la informacin de cada usuario con diferentes secciones para una mejor organizacin.

Se pueden distinguir las siguientes secciones: Sitios web Esta seccin contiene los sitios web a los que est suscrito el usuario o que ha creado. Adems posee la opcin de agregar nuevos sitios web o eliminar los ya existentes.

Contactos En esta seccin 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 automticamente a los contactos.

18


Tambin se puede agregar contactos manualmente, para ello se debe pulsar sobre la opcin Anadir Contacto. Luego de ello aparecer una ventana donde se deben llenar los datos del contacto y guardarlos para finalizar.

Adems de ello se puede editar los contactos agregando informacin 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 informacin adicional.

19

Manual de Instalacin y Configuracin de Liferay Social Office Tambin 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 seccin 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 ledo de acuerdo a nivel de privilegios que se posea.

Actividades (Activities) En esta seccin 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 seccin se ven las tareas que se le han asignado al usuario as como su avance. Adems tambin muestra las tareas que ha creado y asignado el usuario.

Para agregar una tarea se debe pulsar sobre la opcin Aadir tarea, luego de ello se abrir una ventana donde se podr ingresar la tarea con opciones prioridad, asignacin a una persona y fecha. Adems de ello se pueden colocar etiquetas para sea ms sencillo ordenar las tareas en categoras.

Para ver el avance de una tarea slo hay que observar la barra que est hacia la derecha del nombre de la tarea. Si deseamos agregar o cambiar el avance slo 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 (Todays Events) Esta seccin muestra los eventos del da de todas las reas a las que est relacionado el usuario.

Clima (Weather) Seccin donde se muestra informacin del clima. Los lugares de donde se muestra la informacin son personalizables.

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

22

Manual de Instalacin y Configuracin de Liferay Social Office Luego de presionar en el botn buscar aparecern los trminos de bsqueda que coinciden dentro de la pgina externa que da el servicio del clima. Seleccionamos y copiamos el que sea el correcto.

Luego de copiarlo volvemos a la seccin del clima en el portal y presionamos sobre la opcin Configurar. Luego de ello nos aparecer un formulario donde colocaremos el lugar deseado.

Luego de ello slo bastara guardar para que se apliquen los cambios.

23


Sitios WebLos sitios web son portadas donde cada usuario puede poner informacin que desee y compartirla con los usuarios que desee. Para crear un sitio web se debe posicionar sobre la seccin Sitios web y seleccionar el enlace Aadir Sitio. Se abrir una ventana donde se pondr la informacin base del sitio como su nombre, descripcin y tipo.

Una vez creado el sitio web se puede ingresar a l a travs 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 continuacin.

24

Manual de Instalacin y Configuracin de Liferay Social Office Inicio (Home) Es la portada del sitio web donde se encuentran las diferentes secciones que posee y que renen un resumen general del contenido e informacin del sitio web. Posee las siguientes secciones. Welcome (Bienvenida) En esta seccin se puede colocar un mensaje de bienvenida para los miembros del sitio.

Para ingresar un nuevo mensaje de bienvenida pulsando en la opcin Configurar. Luego de ello aparecer una ventana con diversas opciones de personalizacin del mensaje. Al finalizar slo basta guardar para mantener los cambios.

Enlaces En esta seccin se puede colocar los enlaces web externos que se consideren de inters para el sitio web.

25


Para ingresar nuevos enlaces se debe pulsar sobre la opcin Anadir Entrada. Luego de ello aparecer un formulario para ingresar el enlace.

Feeds En esta seccin en la que se puede agregar suscripciones RSS de pginas web para darles seguimiento.

Para ingresar o modificar los feeds se debe pulsar sobre la opcin Configurar donde aparecern las opciones de configuracin para los feeds como la URL, el ttulo, la cantidad, etc.

26


Avisos En esta seccin se colocan los avisos de la pgina.

Dentro de esta seccin se tienen dos opciones. La primera es Aadir Entrada, con esta opcin se ingresa un nuevo aviso con opciones de configuracin como fecha de expiracin, tipo y prioridad.

27

Manual de Instalacin y Configuracin de Liferay Social Office Actividades Esta seccin es donde se mostrarn las actividades relacionadas con el sitio web que se estn realizando. Se pueden distinguir tres pestaas, 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 seccin se muestran los documentos recientemente compartidos del sitio web. Se puede descargar la informacin de cada uno de ellos pulsando sobre su nombre.

Eventos de hoy (Todays event) Donde se muestran los eventos del da que son propios del sitio web.

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

28


Para agregar un nuevo evento al calendario se debe pulsar sobre la opcin 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

Manual de Instalacin y Configuracin de Liferay Social Office Tambin 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 da para ello seleccionamos la opcin que deseemos que se ubican en la parte superior de la pgina.

Adems 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

Manual de Instalacin y Configuracin de Liferay Social Office Documentos (Documents) El sitio web tambin cuenta con una seccin para documentos donde se puede colgar la documentacin de forma ordenada y por secciones para mantener un control de los mismos hasta en versiones.

Para agregar una nueva carpeta de documentos slo hay que pulsar sobre la opcin Aadir carpeta luego de lo cual aparecer un formulario simple para crear la carpeta.

Para agregar un nuevo documento ingresamos primero a la carpeta donde se hallar y luego presionamos sobre la opcin Agregar documento. Luego aparecern las opciones para subir los documentos.

Existen dos opciones. La primera opcin de subida de documentos es por el mtodo de examinar y puede subir mltiples archivos a la vez. Slo basta con pulsar sobre la opcin Examinar y luego elegir en el explorador los archivos que deseemos subir. Luego de ello se listarn los archivos que se han escogido para verificarlos. Luego para subir los archivos slo hay que pulsar en la opcin Subir archivos y esperar a que acabe el proceso. 31


La segunda opcin de subida de documentos es por el mtodo clsico con el que se puede subir slo un archivo a la vez. Al presionar sobre esta opcin aparecer un formulario con el que se puede examinar y buscar el documento de manera similar al mtodo anterior. Luego de seleccionar el documento llenamos el formulario de informacin del documento y lo guardamos.

Tambin existen opciones sobre las carpetas y documentos subidos. Estas aparecen al lado derecho del nombre en la opcin Acciones de la carpeta o documento. Dependiendo de los privilegios las opciones son de eliminar, ver, editar y asignar permisos.

32


Foro Tambin se cuenta con un foro para poder crear temas de discusin 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 categora se debe pulsar sobre la opcin Aadir categora. Aparecer un formulario simple para agregar la categora. De la misma manera se agregan subcategoras.

Para aadir un nuevo hilo de discusin dentro de una categora se debe ingresar primeramente a la categora deseada y luego pulsar sobre la opcin Crear nuevo hilo de discusin. Aparecer un formulario para aadir el hilo con diferentes opciones.

33


Blog Existe tambin un Blog donde los usuarios autorizados podrn colgar sobre intereses diversos o especficos y compartirlos con los dems usuarios. Es muy simple pero posee muchas opciones de publicacin.

34


Para aadir una nueva entrada hay que pulsar sobre la opcin Aadir entrada de blog. Aparecer un formulario con diferentes opciones de personalizacin de la entrada. Para terminar el proceso slo basta con pulsar en la opcin Publicar.

35

Manual de Instalacin y Configuracin de Liferay Social Office Wiki Se posee adems de una Wiki para colgar manuales y guas diversas. Las Wikis son importantes para colgar diferentes guas, manuales, informacin y ms para que los usuarios puedan acceder directamente y no tengan la necesidad de buscarlas externamente.

Para editar o agregar informacin a la wiki hay que pulsar sobre la opcin editar. Luego de ello aparecer un formulario donde se puede llenar la informacin utilizando el cdigo personalizado que est detallado al lado derecho.

Para agregar subpginas hay que pulsar en la opcin Agregar subpgina que se encuentra en la parte inferior de la pgina. De la misma forma aparecer el mismo formulario que el mostrado anteriormente. 36


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

37


Gestin de Usuarios

Perfil de Usuario Cada usuario posee un perfil de usuario donde puede modificar su informacin y configuracin de su cuenta como cambio de nombre, contrasea, idioma, etc. Adems se puede ver las actividades de las diferentes reas con las que est relacionado. Para acceder al perfil se pulsa sobre la opcin Mi perfil que se encuentra en la esquina superior derecha de la pgina.

Para editar el perfil de un usuario hay que pulsar sobre la opcin Editar Perfil. Luego aparecer un formulario mostrando la informacin actual del usuario que puede ser editada. Para finalizar el cambio slo hay que pulsar la opcin Guardar.

38

Manual de Instalacin y Configuracin de Liferay Social Office Creacin de Usuarios Un usuario puede ser creado por dos mtodos. El primero es un registro de cuenta por parte del usuario, muy similar a cualquier sitio web, que se encuentra en la pgina de acceso, donde el usuario ingresa sus datos y correo electrnico y luego le llega a ese correo un correo de confirmacin para activar de cuenta. Luego de ello la cuenta estar activa y podr ser utilizada.

El segundo mtodo es crear el usuario por medio del panel de control. Este slo 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 seccin Portal se encontrar la opcin Usuarios y luego hacer ingresar a crear usuario.

39

Manual de Instalacin y Configuracin de Liferay Social Office Creacin de Roles Para crear un rol o roles se debe ingresar al Panel de Control y en la seccin Portal se encontrar la opcin roles. En esta seccin habr roles por defecto de Liferay SO que se pueden eliminar, editar o utilizar si fuera conveniente. Para crear un nuevo rol se va a la opcin aadir donde se colocar el nombre, descripcin y tipo del rol.

40

manual de instalación y configuración de liferay so

Documents

ndiceinstalacin y configuracin

sitios web

hoy todays events

personalizacin grfica

actividades activities

inicio home

documentos recientes

documentos documents