Overview

This document describes how to develop management aware applications using SAFplus Management. It assumes that SAFplus Management has been installed on your system. For information on how to install SAFplus Management, see SAFplus Management User's Guide. This document should be used in conjunction with the SAFplus Management example web services application available via download or in our source tree at (.../examples/eval/websvc).

Getting Started

To build the example, you must first install a small web server library.

apt-get install libmicrohttpd-dev

Next, download the SAFplusMgtEval.tgz file from download.openclovis.com and detar it:

wget http://download.openclovis.com/files/examples/SAFplusMgtEval.tgz
tar xvfz SAFplusMgtEval.tgz

Finally, let's build and run it to ensure that SAFplus is properly installed

cd eval/websvc
make

Debugging

Debugging the initial startup of your application

• Be tolerant of long instantiation times

The SAFplus AMF will restart an application that exceeds its "instantiation timeout" (30 seconds by default). This will disrupt debugging efforts. To fix this issue, change the component's instantiation timeout. This can be accomplished in a variety of ways... to do it via XML file, look for your the definition in your component (tags: component->instantiate->timeout) and change it to a very large number. For example:

   1  <Component name="mycomp">
   2 ...
   3       <instantiate>
   4         <command>./mycomp</command>
   5         <timeout>1000000000</timeout>
   6       </instantiate>
   7 ...
   8  </Component>

• Start gdb instead of your program

Rename your program 'X' to X.bin. Next create an executable script X with this content:

   1 #!/bin/bash
   2 echo /usr/bin/gnome-terminal --disable-factory --window --command "gdb --args $0.bin $1 $2 $3 $4 $5 $6 $7 $8 $9"
   3 exec /usr/bin/gnome-terminal --disable-factory --window --command "gdb --args $0.bin $1 $2 $3 $4 $5 $6 $7 $8 $9"

Now when SAFplus AMF starts your program, it will pop up a terminal window and run your program inside gdb. It is important that the process id (PID) of the terminal be the same PID that SAFplus AMF started so that it can monitor your program. This is the purpose of the "exec" prefix and the --disable-factory flag. If your process forks another process and quits, the AMF will see this as a failure (your process quit, after all) and restart it. This can result in repeated restarts.