Clean up the logs

About this task

You clean up the service replay debugging environment scripts and SERL files at your discretion. You can remove individual files or the serl directory.

In production, depending on the frequency of error events, the number of SERL files might become unmanageable, requiring periodic cleanup.

Procedure

Do one of the following:
  • For a small cluster, navigate to the %SOAM_HOME%\work\serl\appName\serviceName directory, where the log files to clean up reside, and remove the desired files.

    Windows: %SOAM_HOME%\work\serl\<appName>\<serviceName>

    Linux®: $SOAM_HOME/work/serl/<appName>/<serviceName>

  • For a large IBM® Spectrum Symphony cluster, you can use the rfa command to remove the distributed SERL directory for your application on a host-by-host basis. It is recommended that you create a script to do this removal to automate the process each time you remove the SERL files.

    For example, your script would contain the same command for each compute host in your cluster.

    Windows:
    rfa remove -t hostA -s %SOAM_HOME%\work\serl\MyApp -p /MyConsumer -d
    rfa remove -t hostB -s %SOAM_HOME%\work\serl\MyApp -p /MyConsumer -d
    rfa remove -t hostC -s %SOAM_HOME%\work\serl\MyApp -p /MyConsumer -d
    
    Linux:
    rfa remove -t hostA -s $SOAM_HOME/work/serl/MyApp -p /MyConsumer -d
    rfa remove -t hostB -s $SOAM_HOME/work/serl/MyApp -p /MyConsumer -d
    rfa remove -t hostC -s $SOAM_HOME/work/serl/MyApp -p /MyConsumer -d
    
    The options mean the following:
    -t
    The host on which to remove the file.
    -s
    The name of the file to remove.
    -p
    The consumer under which to execute the file removal. For the multi-user install, there is an OS execution user associated with each consumer.
    -d
    Flag that indicates that the specified file is a directory.