Café com Tecnologia

Posts Tagged ‘Portal Server’

Esta semana necessitei fazer a instalação do Portal Enable 6.1.0.1 para validar implementações feitas para o Portal 6.0.x e garantir a compatibilidade das aplicações, para REUSO.

As primeiras melhorias nesta versão são perceptíveis logo no processo de instalação:

• Os pacotes estão separados pelo tipo da licença (Portal, Express, Enable e Extend), o que facilita o entendimento do que pode ou não ser usado;
• Instala-se MUITO rapidamente o produto (menos de 1h30), pois requer basicamente os pacotes W-Setup, W-1, W-3, W-4 e W-5 (feita numa VM com Windows 2003 SP2 e 2 GB RAM).

Instalação

O processo de instalação consiste nos passos:

1 – Passar pela tela de boas vindas;

2 – Aceitar os Termos da Licença;

3 – Definir o tipo de instalação “Completo” ou “Administração”;

4 – Definir o diretório de instalação;

5 – Definir as propriedades da instância do servidor (nome do nó e host);

Defina o nome do nó com no máximo 5 caracteres e defina o nome do host com o nome completo (FQHN).

6 – Definir ID do usuário e senha para administração;

Verifique as regras para o sistema operacional e as regras específicas do produto.

7 – Para Windows, definir se será executado como serviço;

8 – Passar pela tela de resumo;

9 – Aguardar o término da instalação.

Quase não há ações a serem tomadas já que vários parâmetros são apresentados preenchidos. Como costumo dizer nos treinamentos de administração do Portal:

Instalar é SIMPLES, quase “next next finish”. O que pega são as configurações.

Após a instalação, já no primeiro acesso nota-se as alterações realizadas. Além das alterações/adições técnicas (maior foco na Web 2.0, JSR 286, configuração  com o WAS 7, etc etc etc), o usuário final ganha muito em usabilidade. Os autores de conteúdo ganham em melhorias nas ferramentas do WCM.

Uma coisa é certa: a IBM continuará por um bom tempo como líder do mercado de Portais.

Que o produto IBM WebSphere Portal Server é um dos principais produtos de Portal do mercado, ninguém discute. É um produto que possui muitas características positivas e flexíveis que permitem uma administração e customização bem rápidas.

Mas é claro, que dependendo das necessidades do projeto, muitas customizações podem ser necessárias.

A parte de Gerenciamento de Páginas é muito user-friendly, permitindo criar páginas, etiquetas e URLs muito rapidamente. Para páginas e etiquetas é possível, inclusive, definir um ícone para ser exibido na construção dos menus. Mas por algum motivo, que ainda não descobrir, esse recurso não está disponível para criação de uma URL.

Nem na alteração dos dados.

Bom, não está disponível não quer dizer que não seja possível implementar, e até de forma simples.

Todos esses recursos permitem que façamos a inclusão de parâmetros, que podem ser tratados nos códigos disponíveis na construção do Tema.

Nos códigos do Tema, vê-se o tratamento do parâmetro “com.ibm.portal.PageIcon” e intuitivamente podemos tentar adicionar esse parâmetro com o valor da localidade do ícone. Vejam bem, eu disse TENTAR, pois a tentativa mostrar-se-á impossível.

O produto não permite que sejam incluídos parâmetros que o texto seja iniciado com “com.ibm.portal”. Bom, então o que precisamos fazer é adicionar um parâmetro com nome diferente, como “com.SUAEMPRESA.PageIcon”.

Com o parâmetro adicionado, a única coisa que precisamos fazer agora é o tratamento no local onde queiramos exibí-lo.

No Tema do Portal podem existir vários pontos que exibem uma listagem de páginas, como os menus, rodapés, etc. O trecho de código que precisamos encontrar para tratar o parâmetro adicionado é similar ao abaixo.

Object pageIcon = iMetaData.getValue("com.ibm.portal.PageIcon");
if(pageIcon != null){
%>
<img src="<portal-logic:urlFindInTheme file='<%=pageIcon.toString()%>'/>" title="<portal-fmt:title/>" alt="<portal-fmt:title/>" border="0" align="absmiddle"/>
<% }
} else {  %>
<img src="<portal-logic:urlFindInTheme file='icons/page/default.gif'/>" border="0" align="absmiddle"/>
<% } %>

Este trecho de código captura um parâmetro, faz uma validação simples e exibe ou não a imagem. O que precisa ser feito é apenas a adição da linha abaixo antes da validação “if”.

if (pageIcon == null) iMetaData.getValue("com.SUAEMPRESA.PageIcon");

Simples assim.

Esta mesma técnica foi muito útil para apenas ESCONDER uma página da construção do menu. A página continua ativa mas apenas não é exibida no menu. Muito útil.

O WAS (WebSphere Application Server) permite que você defina usuários para acessar a console de administração com 4 possíveis regras:

• administrator
• operator
• configurator
• monitor

Esse é um recurso interessante pois permite você delegar responsabilidades para equipes distintas de seu cliente.

Porém, fazer essa configuração para administrar um Portal Server (versão 6.0) não é uma tarefa tão direta. É fácil, mas não tão direta.

Vou expor um cenário prático (e real) considerando um servidor Portal Server com segurança habilitada para um servidor LDAP.

Veja os passos para adicionar um usuário para acessar a console do WAS.

1 – Criar um usuário no LDAP

Crie um usuário no LDAP em qualquer ponto. Para exemplificar, foi criado o usuário “usuariotutorial” com senha “novasenha”. Vamos supor que o DN de seu usuário ficou “uid=usuariotutorial, ou=empregado, o=empresa.com”.

2 – Adicionar o usuário no console do WAS

Autentique com seu usuário administrador e adicione o usuário “usuariotutorial”, apenas o uid do seu usuário. Vá em “Administração do Sistema > Usuários do Console”.

Administração do Sistema

Clique no botão “Incluir”, digite “usuariotutorial”, selecione a função “Monitor” e clique em Aplicar.

Incluir Usuário no console

Você notará que o WAS aceitará seu usuário, uma vez que verifica sua existência no servidor LDAP usado para autenticação.

Usuário adicionado no Console para administração

Bom, a partir de agora você com certeza estará tentado a fazer um teste de autenticação com o usuário recém autenticado. Mas já lhe adianto: NÃO FUNCIONARÁ. Você notará no arquivo SystemOut.log do seu servidor do Portal a ocorrência a seguir.

SECJ0129E: Falha na autorização para usuariotutorial ao chamar GET em admin_host:/ibm/console/, Authorization failed, Not granted any of the required roles: administrator operator configurator monitor

E é aqui que entra uma configuração “adicional”.

3 – Alterar arquivo wmmWASAdmin.xml

Faça a edição do arquivo <portal_server_root>/wmm/wmmWASAdmin.xml e adicione o codigo XML a seguir.

  <admin logonId="usuariotutorial" logonPassword="bzv+ZzQoyHqUgewCtI1sIw==" uniqueUserId="uid=usuariotutorial, ou=empregado, o=empresa.com"/>

Note que em “logonPassword” há um código encriptado. Esse código pode ser gerado usando o script WPSconfig.[sh|bat].

./WPSconfig.sh wmm-encrypt -DPassword=novasenha

Esse comando terá uma saída como da imagem abaixo.

WPSconfig Encriptar Senha

4 – Reiniciar seu servidor

É isso ai, para terminar, reinicie seu servidor de Portal Server e teste a autenticação.

Achou simples? Que bom. Mas é um saco. Felizmente nas versões mais atuais isso é mais direto, como este blog.

Em uma recente experiência NADA AGRADÁVEL, solicitaram para que a configuração de timeout do Portal fosse configurado para 12h. O recomendado (InfoCenter, documento de Tunning, Suporte, etc) pela IBM é um timeout de 30 minutos.

Enfim, mesmo avisando as consequências, a configuração foi realizada após o horário comercial, já que necessitaria de um restart no servidor.

No dia seguinte não deu outra: o Portal ficou absurdamente lento e meu servidor passivo foi ativado.

Conclusão: hoje o cliente tem total ciência do problema encontrado e estamos fazendo reduções até chegar a um ponto que atenda aos usuários (que não gostam de fazer autenticação) e que seja suportado pelo Portal.