Troubleshooting the user life-cycle SPI

View traces in the log files to get information about the user life-cycle SPI.

About this task

The user life-cycle SPI is responsible for processing the user life-cycle commands that are sent from Profiles to the other applications.

Procedure

To troubleshoot events relating to the user life-cycle SPI, complete the following steps.
  1. Enable trace logging for the com.ibm.lconn.lconn.lifecycle process in the WebSphere® Application Server.
    For information about how to enable trace logging, see Enabling traces in WebSphere® Application Server.
  2. Check the log files for information relating to the user life-cycle SPI.
    Log entries relating to the user life-cycle SPI are identified with the prefix, com.ibm.lconn.lifecycle.*.
    For example, when Profiles initiates the record update, the log looks like the following:
    ***************
    Event data
    ***************
    _er_id: 7b743501-07b5-4abe-976f-68a865cc859e
    _er_time: 1284475145426
    _er_source: PROFILES
    _er_type: COMMAND
    _er_name: user.record.update
    _er_scope: PUBLIC
    _er_related_community: null
    _er_actor: null
    _er_actor_name: null
    _er_actor_email: null
    _er_properties:
    {"externalId":"DRcuidk001retired51","_msg_id":"1301","user.email":"dretired51@janet.iris.com","user.externalId":"DRcuidk001retired51","user.logins":"[\"dretired51
    \",\"dretired51@janet.iris.com\",\"Dan Retired51\"]","user.name":"Dan
    Retiring51"}
    
    Container:
    _er_container_id: null
    _er_container_name: null
    _er_container_html_path: null
    
    Item:
    _er_item_id: null
    _er_item_name: null
    _er_item_html_path: null
    _er_item_atom_path: null
    _er_item_external_url: null
    ***************
    When an application is called to receive an event life-cycle command, the log looks similar to the following.
    [9/14/10 10:39:05:567 EDT] 000000a8 UserLifeCycle <
    com.ibm.lconn.lifecycle.spi.UserLifeCycleSpiRegistry getComponentName
    RETURN Activities
    [9/14/10 10:39:05:567 EDT] 000000a8 UserLifeCycle I
    com.ibm.lconn.lifecycle.platformCommandConsumer.UserLifeCycleConsumer
    consumeCommand CLFWY0227I: The User Life Cycle Platform Command Consumer
    successfully invoked the registered SPI to update the application database
    for user with extId DRcuidk001retired51. Application name is Activities.
    When an application does not have a user in the local database to receive the life-cycle event, the log looks like this:
    [9/14/10 16:27:19:414 EDT] 000000a4 UserLifeCycle I
     com.ibm.lconn.lifecycle.platformCommandConsumer.UserLifeCycleConsumer
     consumeCommand CLFWY0225I: No user was found in application database
     with directory id DRcuidk001retired51. The person details were not
     updated in application database. Application name is blogs.
    The ACKCOM events are also fired as applications process the inactivateUser event. Here is an example of an acknowledgement from the Profiles event when an application successfully receives an update:
     [9/13/10 17:16:51:630 EDT] 0000008c UserLifeCycle <                   
     com.ibm.lconn.lifecycle.spi.UserLifeCycleSpiRegistry getComponentName 
     RETURN Communities                                                    
     [9/13/10 17:16:51:630 EDT] 0000008c AbstractEvent >                   
     com.ibm.lconn.events.internal.AbstractEvent DefaultEvent ENTRY        
     COMMUNITIES ACKCOM PUBLIC user.record.inactivate                      
     [9/13/10 17:16:51:630 EDT] 0000008c DefaultEvent >                    
     com.ibm.lconn.events.internal.object.DefaultEvent DefaultEvent ENTRY  
     COMMUNITIES ACKCOM PUBLIC user.record.inactivate