The active processing daemons have two main functions. The APD's can be used for debugging purposes and/or for improving performance of data intensive applications by pushing pages from servers in anticipation of expected memory use.
There are two entry points into APD processing. The APD- Administrator socket interface is one of them, and the other is a fork from an application process.
An administrator can send a request to start apd debugging over a socket interface. They will be able to turn on/off switches and set relevent thresholds interactivly to indicate the desired reports to be generated. Reporting can be done by process, by client and/or by server, showing average or maximum values.
In the virtual unit mode, the daemons use pagin/pageout statisics in conjunction with a priori knowlege of the type of application to determine when and which pages should be pushed. Debugging can also be done on a virtual unit basis.
There are three types of active processing daemon. On every server.there is a master apd that is responsible for the administrator interface and for processing the APD_TCP incoming messages. Virtual unit apd's are forked from a client application process requesting debugging and/or page pushing, and slave apd's are used for data collecting .
The APD uses the following interfaces with other system components:
The APD maintains the following internal data strutures:
The master apd performs the following initalization actions when it starts:
After initialization, the master apd enters its main loop in which the following processes are performed:
The slave apd's will be respnsible for:
An apd_push_controller daemon is forked from an application program requesting page pushing and/or debugging information.
The virtual unit apd performs the following initalization actions when it starts:
Debugging statistics can be displayed on a system wide basis or on a application process or virtual unit basis. The administrator can initiate and update requests for either on the socket interface. An application process can also request debug information. In the second case, a server may be selected to control the statistics gathering, and will periodically send updated information to the client. Either the master apd resident on the server side or the virtual unit apd on the client side maintain a statisics requirements table to be used by the statistics gathering process.
Page push processing is initiated by a client application during initialization. A virtual unit apd is forked to open and become the controlling process for the NMS virtual unit. The application issuing this request can set switches to turn on debugging and one to r uthe page push algorithm and debugging if any, locally on the client side.
If the algorithm isn't to run locally, a server is selected to start up a master apd for this purpose. In either case, a statisics process is started to calculate the statistics required to run the appropriate page pushing algorithm.
When it has been determined that a page should be pushed, a message is sent to the virtual unit apd or one of the servers containing that page. The virtual unit apd uses ioctl() calls on that unit to request pre-paging as determined by the apd_push_algorithm daemon on a remote server.
This is done in either a virtual unit apd on the client side, or on a master apd on the server side. The stastics requirement table is used to determine the filters to use on the event streams in the CSKM's and SSKM's.This filter is not necessarily the same for clients and servers. The statistics requirement table is also used to determine which clients and servers need to monitor the event streams.
Requests for data collecting apd's to be started up on clients and servers are sent over the ethernet. When there is an associated virtual unit, the virtal unit multicast group is used for the servers,.. If this is not the client machine then the event stream filter is sent over the ethernet to the virtual unit apd.
For system wide debugging, an individual request is sent to a single server /client when it is being monitored individually. In this case the multicast group for all clients/servers is used to monitor all paging information pertaining to this server/client. A multicast message is used for all servers and another for all clients when all are to be monitored.
Last modified: Thus. May 20, 1999