Creating a kernel trace
Microsoft Windows
Fabasoft Folio Kernel Trace Version
The trace version of coomk.dll can be found at the following locations:
- In the directory "Setup/ComponentsBase/Trace/<plattform>/" on the Fabasoft Folio installation disc or image.
Fabasoft Tracer
Creating the Trace
- Stop the Fabasoft Folio web-, AT- and/or conversion service.
- Rename the file "coomk.dll" in the Kernel installation directory to "coomk.dll.noTrace".
- Copy the trace version of "coomk.dll" into the Kernel installation directory.
- Set the environment variable "CHECKINSTALLATION" to "CHECKINSTALLATION=COMPONENTS" . This can be done either by editing the Registry value at
HKEY_CURRENT_USER\Software\Fabasoft\Environment
with the service user that runs the Kernel or via editing the .upd files (coomk.upd and cooprep.upd) located at C:\ProgramData\Fabasoft.
- Start the Fabasoft Folio web-, AT- and/or conversion services necessary to reproduce the problem.
- Prepare the steps necessary to reproduce the problem.
- Start the Fabasoft Tracer.
- Try to reproduce the problem.
- When the problem occurs, save the tracer output to a file using the menu "File->Save".
- Upload the trace file to the Fabasoft Support Service Desk.
Removing the Trace Version
- Stop the Fabasoft Folio web-, AT- and/or conversion service.
- Delete the trace version of the file "coomk.dll".
- Rename the file "coomk.dll.noTrace" back to "coomk.dll".
- Restore the environment variable "CHECKINSTALLATION" to its initial state by setting it to "CHECKINSTALLATION=yes".
- Start the Fabasoft Folio web-, AT- or conversionservice.
Linux
Fabasoft Folio Kernel Trace Version
- In the directory "Setup/ComponentsBase/Trace/<platform>/" on the Fabasoft Folio installation disc or image.
Trace Message Logging
- Webservices:
Webservices write trace messages into "/var/opt/fabasoft/log/web/WebService_<id>.error.log". - AT-Services:
AT-Services write into "/var/opt/fabasoft/instances/COOATService_<id>/log/main/current". - FSCEval:
FSCEval outputs the trace messages to the current console, in order to record this trace messages the console output has to be redirected.fsceval -file <path_to_script> > /tmp/tracefile.trc
Newer versions use the tool "tracer" to log these messages, for more information about the usage please see Fabasoft Tracer.
Creating the Trace
- Start a terminal.
- Login to the Fabasoft Folio service user.
su - fscsrv
- Locate any opened "libcoomk.so", which represent a single kernel instance each.
lsof |grep libcoomk.so
-
Stop the Fabasoft Folio web-, AT- and/or conversion service.
-
The following 2 steps must be executed for every "libcoomk.co" in every directory previously found.
-
Copy the file "libcoomk.so" in the directories, for instance "/opt/fabasoft/share/eval/" to "libcoomk.so.noTrace".
cp /opt/fabasoft/share/eval/libcoomk.so /opt/fabasoft/share/eval/libcoomk.so.noTrace
-
Copy the trace version of "libcoomk.so" into the directories, for instance "/opt/fabasoft/share/eval/" and replace the file that is there.
cp /<installdisc>/Setup/ComponentsBase/Trace//libcoomk.so /opt/fabasoft/share/eval/
-
Start the Fabasoft Folio web-, AT- and/or conversion services necessary to reproduce the problem.
-
Prepare the steps necessary to reproduce the problem.
-
Start the Fabasoft Tracer or flush the log file if you are using a version prior to Fabasoft Folio 2014 Spring Release
cp /dev/null /var/opt/fabasoft/<path_to_logfile>
-
Try to reproduce the problem.
-
When the problem occurs, save the log file in Fabasoft Tracer or if you are using a version prior to Fabasoft Folio 2014 Spring Release copy the log file using the following command:
cp /var/opt/fabasoft/<path_to_logfile> /tmp/tracefile.trc
-
Upload the trace file to the Fabasoft Support Service Desk.
Removing the Trace Version
If you want to stop using the trace version of the Kernel perform the following steps:
- Start a terminal.
- Login to the Fabasoft Folio service user.
su - fscsrv
- Stop the Fabasoft Folio web-, AT- and/or conversion service.
- Copy the file "libcoomk.so.noTrace" back to "libcoomk.so" and replace the trace version.
cp /opt/fabasoft/share/eval/libcoomk.so.noTrace /opt/fabasoft/share/eval/libcoomk.so
- Start the Fabasoft Folio web-, AT- or conversionservice.