Web content member fix tool

O Web content member fix tool é uma ferramenta nativa no WebSphere Portal quando o mesmo possui o authoring instalado. Essa ferramenta possui uma grande utilidade. O member fix tool verifica todos os itens de referencia de usuários e grupos na biblioteca com o LDAP. As alterações causadas no LDAP não são imediatamente alteradas na referencia de usuários e grupos dentro biblioteca.
Por exemplo, um grupo foi removido do LDAP. Se na biblioteca tiver algum conteúdo onde esse grupo tem permissão, irá permanecer essa referencia do grupo na biblioteca, porém o grupo não existe mais no LDAP. O member fix tool tem como objetivo  atualizar e remover referencias não existentes ou alteradas no LDAP dentro da biblioteca.

A importância de utilizar o member fix tool é para manter atualizado todas as referencias entre a biblioteca e o LDAP.  Existem problemas que podem ser causados caso ocorra mudanças no LDAP.
O mais comum são os logs ficarem cheios de informações de usuários e grupos que não existem ou que seus Dns foram alterados. Isso cria muito I/O em disco diminuindo o desempenho do servidor.
Outro problema está no syndication. É muito comum o syndication não terminar com sucesso devido estas alterações.

Normalmente o erro abaixo ocorre no SystemOut.log

00000055 PrincipalInfo W IWKCW1005X: The Member: cn=fernando,cn=users,dc=domain,dc=com Could not be found in the User Repository. Reason: IWKMU1062X: Message: EJPSG0002E: Requested Member does not exist.

Neste erro foi encontrado que o usuário fernando não existe no User Repository. Isso siginica que o usuário foi removido ou alterado no LDAP. Neste caso deve-se utilizar o member fix tool para atulizar as referencias de usuários entre a biblioteca e o LDAP.

Usando o member fix tools

Primeiro devemos criar um relatório do que ocorre na biblioteca.
O resultado deste relatório irá informar qual será a opção a executar para atualizar a biblioteca, update ou remove.

Utilize a url para iniciae o member fix tools
http://hostname.yourco.com:port_number/wps/wcm/connect?MOD=MemberFixer&library=libraryname
Onde libraryname é o nome da sua bibliiteca.

Exemplo do relatório
IWKPL1365X: Log for Utility: Member Fixer Module


IWKPL1366X: Starting utility: Member Fixer Module
Check PortalServer log files for the detailed log of the module
Changed Session timeout to 14,400 seconds
IWKCW1055X: Library Processed: WCMLib
IWKCW1077X: Preserve dates option: False
Report mode only
IWKCW1077X: Force unlock option: True

IWKCW1045X: SUMMARY INFORMATION.
IWKCW1046X: Items Processed: 3,009.
IWKCW1047X: Items Saved: 0.
IWKCW1047X: Member References Removed: 0.
IWKCW1048X: Member References Updated: 0.
IWKCW1049X: Virtual Members Updated: 0.
Errors Detected: 0.
IWKCW1050X: Non-existent Members that have alternate Distinguished Names available: 1.
IWKCW1061X: Non-existent Members that have no alternate Distinguished Names available: 1,741.


NOTE: Some non-existent members have alternate DNs available. Please re-run this tool with the ‘alt_dn’ option to specify how to handle these members. Available options include:


UPDATE: To update the non-existent members with the alternate DN
REMOVE: To remove the non-existent members, even though they have alternate DNs


NOTE: Some non-existant members have no alternate DNs available. Please re-run this tool with the ‘invalid_dn’ option to specify how to handle these members. Available options include:


UPDATE: To update the non-existant members with the wcm administrators group
REMOVE: To remove the non-existant members entirely

IWKPL1368X: Utility completed.


Veja que no relatório, existem alguns membros que possuem o DN alterado e membros que não existem. Isso tanto para usuários como grupos. Outra informação é a forma de corrigir o problema. Você possui duas opções UPDATE ou REMOVE. Ele também informa qual o tipo de opção que deve-se rodar a ferramenta. Nesta caso são duas opções: alt_dn e  invalid_dn. O  invalid_dn são para membros que não existem mais no LDAP e ainda estão como a referencia na biblioteca. O alt_dn são para membros que tiveram seus Dns alterados no LDAP.

Existem duas formar para rodar o member fix.
Você pode optar em rodar individualmente cada opção ou pode concatenar ambos em um só.

Individualmente

alt_dn
http://hostname.yourco.com:port_number/wps/wcm/connect?MOD=MemberFixer&library=libraryname
&fix=true&alt_dn=update

invalid_dn
http://hostname.yourco.com:port_number/wps/wcm/connect?MOD=MemberFixer&library=libraryname
&fix=true&invalid_dn=update

Concatenado

http://hostname.yourco.com:port_number/wps/wcm/connect?MOD=MemberFixer&library=libraryname
&fix=true&alt_dn=update&invalid_dn=update

O resultado com UPDATE pode ser parecido com a relatório abaixo com usando alt_dn. Veja que ele solicita rodar novamente com a opção  invalid_dn.

IWKPL1365X: Log for Utility: Member Fixer Module


IWKPL1366X: Starting utility: Member Fixer Module
Check PortalServer log files for the detailed log of the module
Changed Session timeout to 14,400 seconds
IWKCW1055X: Library Processed: WCMLib
IWKCW1077X: Preserve dates option: False
Report and fix mode
IWKCW1077X: Force unlock option: True
IWKCW1043X: Alternate DN Option: UPDATE.


IWKCW1045X: SUMMARY INFORMATION.
IWKCW1046X: Items Processed: 3,009.
IWKCW1047X: Items Saved: 1.
IWKCW1047X: Member References Removed: 0.
IWKCW1048X: Member References Updated: 1.
IWKCW1049X: Virtual Members Updated: 0.
Errors Detected: 0.
IWKCW1061X: Non-existent Members that have no alternate Distinguished Names available: 1,741.


NOTE: Some non-existant members have no alternate DNs available. Please re-run this tool with the ‘invalid_dn’ option
to specify how to handle these members. Available options include:


UPDATE: To update the non-existant members with the wcm administrators group
REMOVE: To remove the non-existant members entirely

IWKPL1368X: Utility completed.


Para finalizar, faça um update da biblioteca
http://hostname.yourco.com:port_number/wps/wcm/connect?MOD=MemberFixer&library=libraryname&fix=true

Para saber mais sobre o member fix tools, clique aqui.