Reset-log

When investigating Genero Application Server (GAS) issues, one of the first things you might be asked to do is to increase the level of logging.  This can be done by changing the CATEGORIES_FILTER value to ALL or DEBUG and will normally result in a groan being emitted by the GAS system administrator as they believe this means stopping and restarting the GAS dispatcher.

Since 4.01, there is a way this can be done that without stopping and restarting the GAS dispatcher as mentioned in the 4.01 GAS New Features.  This involves using the gasadmin tool and is achieved via use of the reset-log verb.

At its simplest you might execute …

gasadmin reset-log --categories "ALL" dispatcher

… to set the level of detail to include all categories.

You might need to use -f or -E arguments if you originally launched the dispatcher using -f and -E arguments, in particular those necessary to communicate with the dispatcher on its admin port.  I find the simple rule of thumb is to use same -f and -E arguments as used when launching the dispatcher for your gasadmin arguments.

You might also use the session argument rather than the dispatcher argument if you only want to change the level of detail for a known session rather than the whole dispatcher.  So having found a session id, a more typical usage might be something like …

gasadmin -E res.ic.admin.port=6999 --output-type "CONSOLE,DAILYFILE" --categories ALL 1170f560ca4d03fd3aa4bbac75da97e9

If you are not aware of it already, examine the reset-log verb in conjunction with gasadmin and have that in your toolbox to add detail to logs without stopping and restarting the dispatcher.