LumisPortalConfig

A seguir serão apresentados trechos do arquivo “lumisdata/config/lumisportalconfig.xml” seguido da explicação de cada configuração:

a) O elemento <serverId> determina o identificador do servidor de aplicação:

O valor desse elemento deve ser único entre servidores em um ambiente multi-server.

b) No elemento <frameworkUrl> são atribuídos o host e o valor da porta do servidor de aplicação HTTP, utilizados pelo usuário acessar o portal. É também utilizado pelo gerador de cache de página, utilizar a URL para exbibir páginas HTM, caso ela não esteja determinada no elemento <frameworkUrl> da configuração <htmlGeneration>:

c) O elemento <deviceDetection> determina quais são os arquivos de configurações de dispositivos que serão reconhecidos durante o processamento das requisições realizadas às páginas do portal. No nó <deviceDetections> existem nós filhos cujo o objetivo é representar o arquivo principal que contém as definições dos dispositivos e possíveis atualizações da lista de dispositivos definidos no arquivo principal. Ou seja, o primeiro arquivo informado é considerado o arquivo principal e os demais arquivos são considerados atualizações. A medida que novos dispositivos forem surgindo basta adicionar um novo arquivo com as definições dos novos dispositivos como sendo uma atualização.

Por padrão o Lumis utiliza uma lista de definições de dispositivos publicada pelo projeto WURFL. Caso o administrador do portal deseje desativar a opção de detecção de dispositivos, basta informar a configuração abaixo. Desta forma o Lumis irá ignorar a lista de definições de dispositivos publicadas pelo WURFL.

d) Os elementos <nonSSLConnectorPort> e <SSLConnectorPort> devem conter respectivamente as portas http e https. Para que o portal faça o correto redirecionamento e exiba o número da porta na URL, os valores especificados no arquivo lumisportalconfig.xml devem ser iguais aos especificados no arquivo de configuração do servidor de aplicação, senão ocorrerá erro. Somente nos casos de estarem especificados os valores default dos protocolos http e https no arquivo de configuração do servidor (ex: 80 para http e 443 para https ), não será necessário explicitá-los no lumisportalconfig.xml (não precisando retirar o comentário do código):

e) O elemento <defaultLocale>define a língua, formatação de data/hora e formatação numérica default do Portal:
 

f) O elemento <defaultPageDocType> permite determinar qual dos possíveis valores de DocType será incluído nas páginas geradas pelo Lumis Portal para que sejam validadas pelo W3C:

Se for especificado o valor "NONE" não será incluído nenhum DOCType na página gerada pelo Lumis Portal. Além disso, se o DOCType for "NONE" ou qualquer outro que comece com "HTML", de acordo com as regras do W3C, os links e os elementos HTML meta-tag não serão fechados na sintaxe XML. Isso porque no XSL tem que ser utilizado <xsl:output omit-xml-declaration = "yes" method="xml" />.

Para uma lista de todas os DOCTypes W3C, consultar: http://www.w3.org/QA/2002/04/valid-dtd-list.html.
 

g) No elemento <cache> podem ser configurados:

h) O elemento <defaultDeadline> do elemento <locks> define o tempo máximo para (em minutos) antes de ser realizado um lock no portal:
 

i) Por default o serviço de clock do portal está habilitado. Para desabilitá-lo, deve-se atribuir o valor zero para o elemento <enable>. O intervalo em segundos do operador deve ser atribuído ao elemento <tickInterval> que por default é 30:
 

j) Para alterar o tempo de expiração da sessão, será necessário configurar o arquivo lumisportalconfig.xml, como é mostrado abaixo:

O elemento <sessionTimeout> define o tempo para expirar a sessão:
 

É recomendado configurar o tempo de sessão no servidor de aplicação com a mesma duração, configurando-o no web.xml em session-config/session-timeout. Caso esta configuração seja diferente do lumisportalconfig.xml, objetos armazenados na sessão (HttpSession) poderão sofrer expiração em momentos distintos em relação à sessão do usuário no Lumis Portal.

l) Em <fileUpload> podem ser configurados o tamanho do arquivo para upload, bem como as extensões de arquivos não permitidas.

Através do <maxSize> pode-se controlar globalmente o tamanho de um arquivo submetido à upload. O valor "-1" significa tamanho ilimitado.

Já o elemento <deniedExtensions> contém como valor uma expressão regular que é comparada com a extensão do arquivo enviado. Se ocorrer um match, o upload do arquivo não é permitido. Essa restrição não é aplicada para qualquer envio do arquivo ao portal, mas está disponível para os componentes que queiram utilizar. O lumis.portal.file.IFileManager restringe a adição de arquivos conforme esta configuração. Campos do douidefinition do tipo file ou files utilizam essa configuração e portanto sofrem a mesma restrição.
 

m)  O elemento encryption define os algoritmos de criptografia utilizados. O Lumis Portal disponibiliza dois tipos criptografias:
 

n) O elemento < interfaceTitleBarStyle> define o arquivo XSL que customiza a barra de título global das interfaces:
 

o) Para a segurança do portal, tem-se as seguintes configurações: O elemento <httpAuthenticator> habilita a autenticação NTLM (Retirar o comentário quando for utilizar este tipo de autenticação). Já o elemento <configurantionFile> serve para customizar a segurança do portal:

p) O elemento < securityAlias> deve ser utilizada em ambientes que possuem duas soluções em um mesmo servidor de aplicação que utilizam módulos de login diferentes.

Por default, o valor do elemento < securityAlias> é "LumisPortal". Este valor está determinado em “lumisdata/config/lumissecuritylogin.config”. Para atribuir um valor diferente de “LumisPortal” deve-se substituí-lo no arquivo lumisdata/config/lumissecuritylogin.config e atribuir o novo valor no elemento securityAlias. O Lumis Authentication Manager, através desse elemento, requisita ao servidor de aplicação, um LoginModule do JAAS:
 

q) A configuração de cache está detalhadamente documentada na seção Gerenciador de Páginas em Cache.

r) O elemento <errorPage> serve para customização de página de erro para a solução:
 

O portal vai retornar erro 404, através de uma página de erro customizada, caso seja acessada uma página (HTML ou JSP ) que não existe.

Inserir a string <!-- Lumis Portal Error Page --> na nova página de erro para que o gerador de cache detecte que é uma página de erro e não gere seu cache HTML.

A página de erro customizada da Lumis é exibida ao ser acessada uma página, canal ou arquivo com um id que não existe, e fora do F12 (modo usuário). Caso o portal esteja no F12 (modo administrativo do portal), o usuário é redirecionado para o canal portal.

s) Uma funcionalidade importante do Lumis Portal, é permitir que conteúdos dinâmicos sejam transformados em estáticos com a finalidade de aumentar o desempenho no acesso à solução.

As páginas dinâmicas são transformadas em páginas HTML estáticas, e os outros elementos como imagens, documentos, arquivos css, entre outros são armazenados no contexto, normalmente a partir da pasta raiz.

Alguns servidores de aplicação não permitem que os arquivos do contexto da aplicação sejam alterados enquanto a aplicação está em execução.

Para solucionar esse problema, pode-se configurar o caminho de uma pasta externa ao do servidor de aplicação para que o portal armazene esses arquivos que são acessados através de um servidor HTTP. A configuração da pasta externa é realizada em <webRootPath>:

t) O elemento <cluster> deverá ser habilitado  quando desejar que um servidor do ambiente multi-server participe do cluster. Para habilitar a confguração de cluster é necessário retirar o comentário que envolve tal configuração.

Três propriedades da configuração devem ser especificadas. As máquinas que estão em cluster devem ter o mesmo endereço mcastAddress e a mesma porta mcastPort.  Além disso, todos os servidores devem estar utilizando o mesmo banco de dados para que se tenha o correto funcionamento do cluster.

Os valores apresentados são default, mas outros podem ser especificados. Recomenda-se informar o valor para bindAddress caso haja mais de um endereço externo de rede, pois caso não seja especificado, será escolhido aleatoriamente:

Pode-se configurar também o cluster para utilizar TCP (ao invés do default UDP multicast) com os seguintes parâmetros:
 

Os trechos em destaque definem os endereços ip e as portas a serem utilizadas, e precisam ser ajustados para a solução de acordo com as seguintes observações:

O primeiro trecho, entre parênteses após TCP, define como o socket servidor deste nó será aberto:

• start_port e end_port: especifica o número mínimo e máximo que será utilizado para a porta aberta;

•   bind_addr: especifica o endereço ip da placa de rede que será utilizada para abrir a porta;

O segundo trecho, entre parênteses após TCPPING, define como os outros nós são encontrados:

•   initial_hosts: é uma lista de hosts no formato <endereço_ip>[porta_inicial],<endereço_ip>[porta_inicial],…

• port_range: quantas portas são procuradas em cada host, na lista definida em initial_host, começando pela porta inicial especificada;

• num_initial_members: recomenda-se que seja igual ao número máximo de servidores ligados em cluster.

Maiores detalhes sobre tais propriedades consultar: http://www.jgroups.org.

u) No elemento <executor> podem ser configurados quantidade mínima e máxima de processos a serem utilizados nas execuções realizadas pelo portal:
 

Mais detalhes no javadoc da interface IExecutorManager .

v) No elemento <loadingHtmlMessage> é possível configurar uma indicação de progresso nas chamadas das interfaces client-side. Por default, O usuário visualizará uma imagem juntamente com a string "Carregando". A renderização das interfaces client-side passou a ser assíncrona, ou seja, o portal não espera que uma interface seja renderizada, para renderizar a outra. As renderizações são realizadas em paralelo:
 

x) No elemento <documentBuilderPool> podem ser configurado o pool de DocumentBuilder utilizado internamente pelo lumis.util.XmlUtil. Esta configuração pode se realizada se desejar efetuar ajustes finos neste pool.

Abaixo a descrição de cada parâmetro:

z) No elemento <layoutFile>, pode ser configurado o comportamento do Layout File.