Professional Documents
Culture Documents
Corficolombiana
PREPARADO POR:
PRAGMA S. A.
PARA:
ATH S.A.
29 de julio de 2014
F.DOC.014 Pgina 1 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Lista de cambios
F.DOC.014 Pgina 2 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Introduccin
0. Portal Virtual
1. Temas y skins
1.1 Exportar temas y skins
1.2. Descarga de Tema desde servidor origen por medio de un cliente WebDAV
1.3. Despliegue de Tema en servidor destino por medio de un cliente WebDAV
1.2. Descarga del Skin desde servidor origen por medio de un cliente WebDAV
2. Recursos dinmicos del Tema
2.1. Obtener TemaPortal.war desde el WAS del servidor de origen
2.2. Instalar TemaPortal.war en WAS
2.3. Referencias de recursos dinmicos para el tema
3. Sindicacin
3.1 Preparacin para la sindicacin haca un cluster
3.2 Procedimiento de establecimiento de la sindicacin
3.3. Errores comunes de la sindicacin
3.3.1 Elementos fallidos
3.3.2 Sindicador bloqueado
3.3.3 Error de conexin entre el sindicador y el suscriptor
4. Portlets
4.1. Exportar portlets desde el servidor <ServidorOrigen>
4.2. Importar portlets al servidor destino
5. Content Template Catalog
5.1 Instrucciones de instalacin de CTC en Portal Virtual
5.2 Instrucciones de instalacin de CTC en Cluster
5.3 Posibles conflictos en instalacin de CTC
6. Anexos
6.1 Configuracin de URL amigables
7. Configuracin de Libreras Compartidas
7.1 LIB-COMMON-CORF
7.2 LIB-CAPTCHA-CORF
F.DOC.014 Pgina 3 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
7.3 LIB-COMMONS-COLLECTIONS-CORF
7.4 LIB-CORREO-CORF
7.5 LIB-LOGS-CORF
7.6 LIB-ORACLE-CORF
7.7 LIB-WCM-CORF
7.8 LIB-EXCEL-CORF
8. Mapear libreras compartidas a Portlets
8.1 PA_Boletines
8.2 PA_CompartirAmigo
8.3 PA_ContactenosPQR
8.4 PA_CrearTipoInforme
8.5 PA_CrearUsuario
8.6 PA_MegaMenu
8.7 PA_Menu
8.8 PA_RtadorIconografico
8.9 PA_Ticker
8.10 PA_Proyecciones
9. Creacin de DataSource
10. Correlacin de Urls
11. Export de pginas si falla la sindicacin de pginas
12. Ejecucin procedimiento de configuracin para Boletines
13. Ejecucin procedimiento de configuracin para buscador
14. Configuracin de permisos para pginas administrativas
F.DOC.014 Pgina 4 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Introduccin
WebSphere Portal y Web Content Manager consiste en muchos elementos y componentes. Estos
incluyen portlets, themes y skins, pginas, eventos, configuraciones de portlet, contenido web
y reglas de personalizacin. Este manual contiene los pasos para mover estos elementos de un
ambiente a otro de forma controlada.
F.DOC.014 Pgina 5 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
0.PortalVirtual
Para realizar la creacin del Portal Virtual banco-occidente. Para esto, se deben ejecutar los
siguientes pasos:
1. En el portal base (http://<hostname>:<port>/wps/myportal/) ir a la seccin de
Administracin.
2. Ir a Portales virtuales e ingresar a Gestin de portales virtuales
3. Ir a la opcin Nuevo portal virtual y dar clic
4. Diligenciar los campos con los siguientes valores:
a. Ttulo del portal virtual: Corficolombiana
b. Descripcin del portal virtual:Portal virtual para Corficolombiana
c. Contexto de URL: corficolombiana
F.DOC.014 Pgina 6 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 7 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
5. Una vez el sistema termina de ejecutar la creacin del portal virtual se carga una
interfaz similar a la siguiente:
En cuyo caso se debe presentar el ttulo, la URL del portal virtual y la descripcin
diligenciadas en el punto 4 de la pgina 5.
/<RaizInstalacinPortal>/IBM/wp_profile/PortalServer/bin/wpscript.sh
-username USER -password PASSWORD
1.Temasyskins
1.1Exportartemasyskins
Desde una consola de comandos, ejecutar la siguiente instruccin desde el servidor origen:
/<RaizInstalacinPortal>/IBM/wp_profile/PortalServer/bin/xmlaccess.sh -in
F.DOC.014 Pgina 8 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
/<RaizInstalacinPortal>/IBM/Portal/doc/xml-samples/ExportThemesAndSkins.xml -out
/<DirectorioTemporal>/ExportThemesAndSkinsResult.xml -url
http://<HostnameOrigen>:<port>/wps/config/
F.DOC.014 Pgina 9 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 10 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 11 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
1.3.Despliegue deTemaenservidordestinopormediodeuncliente
WebDAV
Realizar el mismo procedimiento indicado en 1.2 para realizar la conexin al themelist
del WebDAV sobre el servidordedestinoyprocederaenviarelTemaCorficolombiana
copiadodesdeelservidordeorigen,althemelist.
Se podr notar que por la importacin xml realizada en el punto 1.1 de esta gua cre
los directorios iniciales del tema, consistente con los metadatos de propiedades y el
directorio principal, por tanto todos estos elementos deben ser sobreescritos por el
directoriocopiadodesdeelservidordeorigen.
F.DOC.014 Pgina 12 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Nota1: En el remoto caso de que la transferencia falle se debe realizar la conexin
sobre el fstype1/themes a partir del cliente WebDAV, por tanto la url a proporcionar
sera http://<hostname de destino>:<port>/wps/mycontenthandler/dav/fs-type1/themes
y crear el directorio TemaCorficolombiana a partir de un mkdir, esto debido a que la
referencia sobre el file system pudo no haber sido creada durante el proceso de
importacin.
F.DOC.014 Pgina 13 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Una vez eldirectorioTemaCorficolombiana hasido homologadoenelfstype1sedebe
realizar nuevamente la conexin sobre el themelist del servidor de destino y proceder
conlacargadeltemacopiadoapartirdelservidordeorigen.
Nota2: Si alguno de los directorios del temafallaencargar,sedebe crearlascarpetas
manualmentesobreelservidorremotoasociadoalservidordedestino.
Nota3: Si la instalacin de los temas se realiza sobre un servidor Cluster debe
efectuarse sobre el nodo principal del mismo y verificar que se transfiera
automticamentealosdemsnodosdelcluster.
F.DOC.014 Pgina 14 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 15 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 16 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
1.6.DesplieguedeSkinaservidordestinopormediodeunclienteWebDAV
Realizar el mismo procedimiento indicado en 1.2 pero sobre el skinlist del WebDAV
perteneciente al servidor de destino y proceder a enviar el SkinCorficolombiana
copiadodesdeelservidordeorigen,alskinlist.
Se podr notar que por la importacin xml realizada en el punto 1.1 de esta gua cre
los directorios iniciales del skin, consistente con los metadatos de propiedades y el
directorio principal, por tanto todos estos elementos deben ser sobreescritos por el
directoriocopiadodesdeelservidordeorigen.
F.DOC.014 Pgina 17 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Nota: Si la instalacin de los skins se realiza sobre un servidor Cluster debe efectuarse sobre el
nodo principal del mismo y verificar que se transfiera automticamente a los dems nodos del
cluster.
2.RecursosdinmicosdelTema
2.1.ObtenerTemaPortal.wardesdeelWASdelservidordeorigen
Una vez efectuado el paso a paso descrito en la seccin anterior, se procede a realizar el
export del WAR del tema. Para ello se debe ingresar a la consola administrativa e iniciar sesin
con un usuario administrador:
F.DOC.014 Pgina 18 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
https://<hostname>:10032/ibm/console/logon.jsp
Luego, se debe dar clic sobre cada enlace de los temas para descargarlos.
2.2.InstalarTemaPortal.warenWAS
Nota: Antes de proceder con este paso, se debe verificar que TemaPortal.war no exista en el
WAS de destino.
Una vez efectuado el paso a paso descrito en la seccin anterior, se procede a realizar la
instalacin del WAR del tema. Para ello se debe ingresar a la consola administrativa e iniciar
sesin con un usuario administrador:
https://<hostname>:<port>/ibm/console/logon.jsp
<hostname>: Direccin del host sobre el que est instalado la consola administrativa del
WAS, regularmente se proporciona la ip o localhost en caso de estar configurado, si se
tiene un nombre de host definido se debe especificar este ltimo.
<port>: Regularmente el puerto corresponde con 10032, en caso de variar se debe
especificar el respectivo.
F.DOC.014 Pgina 19 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Una vez presionado el botn de instalar el sistema presenta en pantalla una nueva interfaz
denominada Preparacin para la instalacin de la aplicacin. En esta interfaz se debe
cargar el archivo TemaPortal.war a partir del botn Seleccionar Archivo y posteriormente
seleccionar el botn Siguiente.
Posteriormente el sistema presentar una nueva interfaz donde se pregunta Cmo desea
instalar la aplicacin?, en este punto simplemente se debe seleccionar el botn de siguiente.
F.DOC.014 Pgina 20 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
De nuevo el sistema presentar una interfaz, pero esta vez para Seleccionar las opciones de
instalacin
De la anterior interfaz se recomienda tener especial cuidado de los puntos sealados como 1, 2
y3
1. En el elemento 1 se seala el nombre del WAR, este nombre se genera por defecto, no
hay necesidad de cambiarlo.
2. Se deben activar los valores de recarga
F.DOC.014 Pgina 21 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
2.3.Referenciasderecursosdinmicosparaeltema
1. Ir a Recursos> Entorno de recursos > Proveedor de entorno de recursos
2. Filtrar por: *Dynamic*
3. Dar clic sobre WP DynamicContentSpotMappings
1. Ir a Propiedades personalizadas.
F.DOC.014 Pgina 22 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
3.Sindicacin
3.1Preparacinparalasindicacinhacauncluster
Cuando se necesita sindicar hacia un servidor cluster se deben ajustar los nodos del servidor
para que el servidor authoring apunte hacia el IHS y en caso de que un nodo se encuentre
abajo se redireccione la sindicacin hacia el nodo que se encuentra arriba.
Se debe abrir la consola del Network Deployment del cluster y abrir la pgina Environment->
WebSphere Variables
Las variables WCM_HOST y WCM_PORT se deben reemplazar con la ruta completa del IHS en el
primer caso (fully qualified host name) y el puerto en el segundo. Estas variables existen tantos
nodos tenga el cluster (En el caso de arriba se tienen dos nodos).
3.2Procedimientodeestablecimientodelasindicacin
La sindicacin es un mecanismo que permite compartir contenido entre dos servidores
WebSphere Portal. Su ventaja frente al import es que si hay una sindicacin establecida
cuando un usuario crea o edita contenido en el servidor fuente, este es Enviado hacia el
servidor de destino sin necesidad de intervencin alguna por parte de los administradores.
Se procede a almacenar las credenciales del servidor de origen en el servidor destino, si ya
existe una ranura de almacenamiento con estas se puede omitir este paso. Abrir la
administracin del portal virtual pblico (/wps/myportal).
Seleccionar la opcin del men izquierdo almacenamiento de credenciales.
Seleccionar la opcin Agregar una ranura de almacenamiento, se abre una
visualizacin parecida a la siguiente:
F.DOC.014 Pgina 23 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 24 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Donde:
La ranura es compartida: Esta opcin debe llenarse.
Nombre y recurso de la bveda asociado con la ranura: Son dos nombres descriptivos
que se le dan al par de credenciales y por el cual se configura la sindicacin.
En los campos de usuario y contrasea se colocan las credenciales administrativas del
servidor de origen.
Se recomienda probar la conectividad entre ambos servidores mediante ping antes de
configurar la sindicacin.
Para configurar la sindicacin se debe seleccionar la opcin Suscriptores ubicada en el lado
izquierdo de la administracin del portal del servidor <ServidorDestino>
Se selecciona la opcin Suscribirse ahora
F.DOC.014 Pgina 25 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
El botn de actualizar enva al servidor destino solo los elementos que se han modificado desde
la ltima sindicacin. El botn de reconstruir transfiere la biblioteca completa, lo cual es una
accin que puede demorarse varios minutos y se recomienda que durante el transcurso de este
no se modifique contenido en ninguno de los dos servidores.
Nota: Es posible que la sindicacin de la biblioteca Sitio del portal (Portal Site) muestre
errores relacionados con Portlets. En cuyo caso es necesario Importar todos los portlets y
reintentar la sindicacin de los elementos con error.
F.DOC.014 Pgina 26 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
3.3.Errorescomunesdelasindicacin
3.3.1Elementosfallidos
La sindicacin presenta elementos fallidos:
Dar clic sobre el nmero de elementos con error y validar los errores en el listado de elementos
que presentan falla.
Algunas veces, es necesario editar los contenidos con falla y luego dar clic a Reintentar todos,
para que estos puedan sindicar correctamente.
3.3.2Sindicadorbloqueado
Cuando se requiere editar el sindicador y este muestra un mensaje de bloqueo por algn
usuario (Generalmente por el usuario asignado a las credenciales del suscriptor), se debe dar
clic sobre el enlace de desbloqueo e intentar la edicin nuevamente.
3.3.3Errordeconexinentreelsindicadoryelsuscriptor
Al probar la conexin sale el siguiente error:
IWKWC0052E: The syndicator was unable to communicate with the subscriber
"suscriptor-desde-sindicador".
Es necesario ir a la edicin del sindicador (Icono del lpiz) y validar la url del suscriptor:
*Subscriber URL:
4.Portlets
Inicialmente se deben subir los directorios de mdulos webs especificados en la carpeta Portlet
adjunta a este manual, en la siguiente ruta del servidor
/appl/IBM/wp_profile/PortalServer/deployed/archive
F.DOC.014 Pgina 27 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
4.1.Exportarportletsdesdeelservidor<ServidorOrigen>
En el servidor de pruebas se deben copiar las directorios que se nombran a continuacin
1. com.corficolombiana.crearusuario.portlets.CrearUsuarioPortlet.65f863e664.webmod
2. com.corficolombiana.boletines.portlets.EnvioBoletinesPortlet.52008d1074.webmod
3. com.corficolombiana.creartipoinf.portlet.CrearTipoInformePortlet.f8807b8d64.webmod
4. com.portal.menu.portlet.MenuPortlet.6d4528b864.webmod
5. com.corficolombiana.contactenospqr.portlets.ContactenosPQRPortlet.09f7aa3864.webmod
6. com.corficolombiana.compartiramigo.portlets.CompartirAmigoPortlet.4fb1b7cf54.webmod
7. com.corficolombiana.ticker.portlets.TickerPortlet.9a91198664.webmod
8. com.corficolombiana.rotadorico.portlet.RotadorIconograficoPortlet.691ac8a364.webmod
9. com.corficolombiana.navigation.megamenu.portlet.MegaMenuPortlet.48b68ecf54.webmod
10. com.corficolombiana.proyecciones.ProyeccionesPortlet.a2074b0674.webmod
desde la ruta <wp_profile_root>/PortalServer/deployed/archive del servidor de origen a la
misma ruta en el servidor <ServidorDestino>:
F.DOC.014 Pgina 28 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
4.2.Importarportletsalservidordestino
Inicialmente se deben subir los directorios
1. com.corficolombiana.crearusuario.portlets.CrearUsuarioPortlet.65f863e664.webmod
2. com.corficolombiana.boletines.portlets.EnvioBoletinesPortlet.52008d1074.webmod
3. com.corficolombiana.creartipoinf.portlet.CrearTipoInformePortlet.f8807b8d64.webmod
4. com.portal.menu.portlet.MenuPortlet.6d4528b864.webmod
5. com.corficolombiana.contactenospqr.portlets.ContactenosPQRPortlet.09f7aa3864.webmod
6. com.corficolombiana.compartiramigo.portlets.CompartirAmigoPortlet.4fb1b7cf54.webmod
7. com.corficolombiana.ticker.portlets.TickerPortlet.9a91198664.webmod
8. com.corficolombiana.rotadorico.portlet.RotadorIconograficoPortlet.691ac8a364.webmod
9. com.corficolombiana.navigation.megamenu.portlet.MegaMenuPortlet.48b68ecf54.webmod
10. com.corficolombiana.proyecciones.ProyeccionesPortlet.a2074b0674.webmod
en la siguiente ruta del servidor
/<RaizInstalacinPortal>/IBM/wp_profile/PortalServer/deployed/archive y posteriormente
proceder con la importacin del archivo PortletsOut.xmlobtenido previamente; para ello a
partir de una consola SSH se debe ubicar la ruta /<RaizInstalacinPortal>/IBM/Portal/bin y
ejecutar el siguiente comando de importacin:
./xmlaccess.sh -in /<DirectorioTemporal>/PortletsOut.xml -out
/<DirectorioTemporal>/ResultImport-PortletsOut.xml -url
http://<hostname>:<port>/wps/config/
5.ContentTemplateCatalog
Nota: Antes de proceder con este paso, se debe asegurar la disponibilidad del ambiente destino
para reinicios, CTC realiza reinicios espordicos durante la instalacin, as mismo, se
recomienda verificar que se tenga un espacio de crecimiento sobre el TableSpaces de portal
por lo menos de 1 giga, la instalacin de CTC cubre por lo menos 659MB de espacio.
F.DOC.014 Pgina 29 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
El CTC se puede instalar en un portal base o en su defecto en un portal virtual, en este caso lo
vamos a instalar en el Portal Virtual creado en esta gua:
5.1InstruccionesdeinstalacindeCTCenPortalVirtual
F.DOC.014 Pgina 30 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
4. Actualizar el -PortalAdminPwd y el -WasPassword en el archivo [WebSphere Install
Root]/wp_profile/ConfigEngine/properties/wkplc.properties.
5. Nos conectamos al servidor por medio de lnea de comandos.
6. Nos ubicamos en la carpeta CTCInstall (cd /appl/IBM/wp_profile/CTCInstall)
7. Ejecutar el archivo de instalacin: ./ctc-install.sh Nota: Si no se especific password en
wkplc.properties (Paso 3). Agregar los parmetros: -DWasPassword=[PASSWORD]
-DPortalAdminPwd=[PASSWORD]
Es posible que se necesiten los parmetros WasUserid y PortalAdminId
8. Una vez la instalacin ha finalizado correctamente, reiniciar el servidor para poder utilizar
CTC.
5.2InstruccionesdeinstalacindeCTCenCluster
1. Entrar a la consola (WebSphere Integrated Solutions Console).
2. Verificar que el CTC est en el server.
a. Aplicaciones > Tipos de aplicacin > Aplicaciones Websphere de empresas
b. Seleccionar CTC
F.DOC.014 Pgina 31 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 32 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
3. Ir a la pgina inicial.
4. Clic en Server > Tipos de servidor > Servidor Web
5. Seleccionar el server y clic en Generar Plug-in.
5.3PosiblesconflictoseninstalacindeCTC
Durante la instalacin del Content Template Catalog se pueden presentar inconvenientes como
que hagan falta instalar fix en el portal o en su defecto que el CTC no sea capaz de manipular
el WebDAV. Por tanto si la instalacin solicita la existencia de fix actualizados sobre el portal,
lo ms recomendable es que se instalen todos los fix antes de proceder, esto ltimo asegura
que WebSphere Portal se encuentre actualizado a la fecha.
Por ltimo, para que todos los cambios finales surtan efectos, se recomienda realizar un
reinicio sobre el servidor.
F.DOC.014 Pgina 33 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
6.Anexos
6.1ConfiguracindeURLamigables
Para implementar url sencillos sin informacin de estados se deben seguir estos pasos:
2. En el tema que desea configurar para abreviar los URL sin estado, establezca el
parmetro com.ibm.portal.theme.hasBaseURL en "true.".
Para ello, se debe ejecutar el siguiente xml por xmlaccess para los temas que deban
implementar el recorte url
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
<portal-dynamicui:closePage node="${node}">
<a class="wpthemeClose wpthemeLeft" href="<%closePageURL.write(out);%>">
<img alt="X"
src="${themeConfig ['resources.modules.ibm.contextRoot']}/themes/html/NavigationClose.gif">
</a>
</portal-dynamicui:closePage>
</li>
<portal-dynamicui:closePage node="${node}">
<a class="wpthemeClose wpthemeLeft" href="<%closePageURL.write(out);%>">
<img alt="X"
src="${themeConfig ['resources.modules.ibm.contextRoot']}/themes/html/NavigationClose.gif">
</a>
</portal-dynamicui:closePage>
</li>
F.DOC.014 Pgina 35 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Nota: Se debe tener especial cuidado cerrando las etiquetas, para evitar que el html
quede corrupto.
7.ConfiguracindeLibrerasCompartidas
Copiar el directorio Corficolombiana que se encuentra dentro del directorio Libraries adjunto
a este documento, en la siguiente ruta del servidor /<wp_profile_root/PortalServer/config/lib
si el directorio lib no existe, se debe crear.
Crear si no existen las siguientes librera compartidas:
En la administracin del WAS, elegir la opcin Bibliotecas compartidas de entorno
F.DOC.014 Pgina 36 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Colocar los datos de la librera compartida para cada uno de las libreras definidas, Por tanto
repita los pasos del 2 al 3 para cada una de las libreras
Despus de diligenciar cada uno de los campos presentados en la imagen anterior, presione el
botn Aceptar y luego en Guardar
F.DOC.014 Pgina 37 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
7.1LIBCOMMONCORF
Nombre: LIB-COMMON-CORF
Descripcin: Librera CommonsLang
Va de acceso de clases:
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/common/commons-lang-2.6.jar
7.2LIBCAPTCHACORF
Nombre: LIB-CAPTCHA-CORF
Descripcin: Libreras Captcha: SimpleCaptcha y Imaging
Va de acceso de clases:
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/simplecaptcha/simplecaptcha-1.1.1.jar
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/simplecaptcha/imaging.jar
7.3LIBCOMMONSCOLLECTIONSCORF
Nombre: LIB-COMMONS-COLLECTIONS-CORF
Descripcin: Libreras comunes para JPA: commons-collections-3.1
Va de acceso de clases:
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/commons-collections/commons-collections-3.1.jar
F.DOC.014 Pgina 38 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
7.4LIBCORREOCORF
Nombre: LIB-CORREO-CORF
Descripcin: Librera para velocity-1.7.jar
Va de acceso de clases:
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/correo/velocity-1.7.jar
7.5LIBLOGSCORF
Nombre: LIB-LOGS-CORF
Descripcin: Libreras para gestin de logs a partir de log4j
Va de acceso de clases:
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/logs/log4j-1.2.15.jar
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/logs/slf4j-api-1.5.8.jar
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/logs/slf4j-log4j12-1.5.6.jar
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/logs/wp.l2.urlhelper.jar
7.6LIBORACLECORF
Nombre: LIB-ORACLE-CORF
Descripcin: Librera para Oracle
Va de acceso de clases:
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/oracle/ojdbc6.jar
7.7LIBWCMCORF
Nombre: LIB-WCM-CORF
Descripcin: WCMPlugin para conexiones de WCM y lectura de estructura de pginas.
Va de acceso de clases:
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/wcm/WCMPlugin.jar
F.DOC.014 Pgina 39 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
7.8LIBEXCELCORF
Nombre: LIB-EXCEL-CORF
Descripcin: Librera de excel para proyecciones Corficolombiana.
Va de acceso de clases:
${USER_INSTALL_ROOT}/PortalServer/config/lib/Corficolombiana/excel/poi-3.9-20121203.jar
8.MapearlibrerascompartidasaPortlets
Una vez han sido definidas las libreras compartidas en el WAS, se debe proceder a relacionar
las mismas en cada uno de los Portlets desplegados en el punto 4 de esta gua. Para ello se
debe seleccionar la siguiente opcin en el WAS Aplicaciones de empresa de WebSphere y del
listado que carga, se debe seleccionar el portlet correspondiente y proceder a seleccionar la
opcin Referencias de bibliotecas compartidas.
F.DOC.014 Pgina 40 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Para mapear cada una de las libreras compartidas, se debe seleccionar el portlet
correspondiente y posteriormente seleccionar el botn Bibliotecas compartidas de
referencia
F.DOC.014 Pgina 41 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Posteriormente se carga una interfaz que permite seleccionar las libreras que quedarn
mapeadas al portlet en cuestin, en cuyo caso se realiza la relacin de izquierda a derecha.
Al terminar de seleccionar todas las libreras compartidas se presiona el botn de aceptar
El sistema retorna a la interfaz previa, en cuyo caso se debe seleccionar el botn de aceptar,
si se reporta el mensaje
8.1PA_Boletines
Las libreras que se deben mapear para el portlet corresponden con:
F.DOC.014 Pgina 42 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
8.2PA_CompartirAmigo
Las libreras que se deben mapear para el portlet corresponden con:
8.3PA_ContactenosPQR
Las libreras que se deben mapear para el portlet corresponden con:
F.DOC.014 Pgina 43 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
8.4PA_CrearTipoInforme
Las libreras que se deben mapear para el portlet corresponden con:
F.DOC.014 Pgina 44 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
8.5PA_CrearUsuario
Las libreras que se deben mapear para el portlet corresponden con:
8.6PA_MegaMenu
Las libreras que se deben mapear para el portlet corresponden con:
F.DOC.014 Pgina 45 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
8.7PA_Menu
Las libreras que se deben mapear para el portlet corresponden con:
8.8PA_RtadorIconografico
Las libreras que se deben mapear para el portlet corresponden con:
8.9PA_Ticker
Las libreras que se deben mapear para el portlet corresponden con:
F.DOC.014 Pgina 46 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
8.10PA_Proyecciones
Las libreras que se deben mapear para el portlet corresponden con:
9.CreacindeDataSource
Se recomienda antes de proceder con la creacin del DataSource, correr los scripts de la base
de datos proporcionados a la par este manual nombrados como:
1. 1_QADllos_Usuario_tablespaces_y_roles.sql y
2. Script_Base_Datos_Corficolombiana.sql
3. 2_QADllos_Usuario_tablespaces_y_roles_boletines.sql
4. 3_Secuencias.sql
para definir el esquema y las tablas asociadas a los portlets que contemplan persistencia en la
base de datos.
Posteriormente si no existe se debe crear el alias con la configuracin del usuario con
permisos de conexin a la base de datos, por tanto:
IngresarenlaconsoladeadministracindelWAS
Dar clic en Security Global security Java Authentication and Authorization Service
J2Cauthenticationdata
DarclicenNew
Configurarlossiguientesvalores:
Alias:Corficolombiana
UserID:USR_DESARROLLOSoelnombredelesquemaquesecree
Password:Contraseaasignadaalesquemacreado(USR_DESARROLLOS)
Descripcin:AliasdeusuarioparaconexinaesquemaUSR_DESARROLLOS
DarclicenOK
F.DOC.014 Pgina 47 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 48 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 49 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
5. El siguiente paso corresponde con Crear un nuevo proveedor de JDBC, para lo cual se
deben seleccionar las siguiente opciones del formulario:
a. Tipo de base de datos: Oracle
b. Tipo de proveedor: Oracle JDBC Driver
c. Tipo de implementacin: Origen de datos de la agrupacin de conexiones
d. Nombre: ConnCorficolombianaDS
e. Descripcin: ConnCorficolombianaDS_Pool
F.DOC.014 Pgina 50 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 51 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
especificado en el punto 7.
F.DOC.014 Pgina 52 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
11. Se debe en este punto seleccionar el botn de finalizar y con ello queda configurado el
DataSource corficolombianaDS.
10.CorrelacindeUrls
Ingresar al sitio administrativo de Portal:
1. Seleccionar del men izquierdo la opcin Valores del portal -> Correlacin de Url
2. Definir los contextos o etiquetas (suscripciones, resultado-informe) como sigue:
F.DOC.014 Pgina 53 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 54 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
11.Exportdepginassifallalasindicacindepginas
El procedimiento sobre export de pginas se recomienda nicamente cuando la sindicacin de
pginas no pasa correctamente, por tanto para efectuarlo siga estas recomendaciones:
12.EjecucinprocedimientodeconfiguracinparaBoletines
Se recomienda en este punto continuar con las configuraciones definidas para el
funcionamiento del portlet de boletines, especificadas en el manual Instalacin Boletines
Corficolombiana.pdf adjunto a esta documentacin.
13.Ejecucinprocedimientodeconfiguracinparabuscador
Se recomienda en este punto continuar con las configuraciones definidas para el
funcionamiento del buscador del portal, especificadas en el manual Manual de configuracin
de un buscador en IBM - Websphere Portal.pdf adjunto a esta documentacin.
14.Configuracindepermisosparapginasadministrativas
Para configurar los permisos respectivos sobre las pginas que contemplan la administracin de
F.DOC.014 Pgina 55 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
los portlets. Se debe realizar el siguiente procedimiento por cada pgina y permisos respectivo:
Nota: Importante, los permisos deben estar agregados sobre el directorio activo. Si el
ambiente corresponde a QA o superiores las pginas deberan contemplar el cambio una vez
realizado sobre PT y sindicado satisfactoriamente, sin embargo los permisos deben estar
nombrados exactamente igual para todos los ambientes. Validado lo anterior proceda como se
indica a continuacin:
1. Ingresar a la administracin del portal virtual Corficolombiana.
2. Ubicarse en la siguiente ruta de la estructura de pginas:
F.DOC.014 Pgina 56 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 57 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Seleccionar el botn aadir, sobre la nueva interfaz que se presenta de los Permisos de
recursos.
F.DOC.014 Pgina 58 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
Sin embargo se debe seleccionar el enlace que corresponde con el nombre de la pgina,
en este caso Administracin Contctenos y PQR, de forma que se devuelva a la
interfaz anterior.
F.DOC.014 Pgina 59 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23
F.DOC.014 Pgina 60 de 60
www.pragma.co
Bogot | Cra. 14 No. 85-68 Of. 303 Medelln | Cra. 50C No. 10 Sur 80 Of. 201 Cali | Cl. 15 No. 83B-35
t: +57 (1) 745 25 23 t: +57 (4) 605 25 23 t: +57 (2) 486 25 23