Searcher is an aglet-based implementation of a utility for files that contains an specified string in its file name. It consists of two aglets, one stationary (Searcher) and one mobile (SearcherSlave). The latter is dispatched by Searcher to visit (sequentially) multiple remote locations, looking for files whose file name contains a specific string. Having gathered all the file names, the SearcherSlave finally returns to the Searcher and displays these file names.
To be written.
Run at least two aglet servers in your network (read here how to run an aglet server).
Use the "new aglet" panel of Tahiti to create your Searcher aglet by specifying its class name: "samples.patterns.Searcher"(read Tahiti User's Guide for more information about aglet creation). When the Searcher aglet is created, its dialog window is displayed:
The panel bellow the "File Name Substring" field shows the itinerary of the SearcherSlave (the URLs of the remote aglet servers to visit). Next, is the result panel where the file names are displayed..
atp://aglets.trl.ibm.com
or, if your aglet server is running on a port other than the default one (434):
atp://aglets.trl.ibm.com:500
Specify, in the "File Name Substring" field, the string which will be matched against file names. An empty field (see the example above) means an empty string which is always matched against any file name. Regular expressions are not supported.
Press the Go button. A new WriterSlave aglet will be created and dispatched to the first aglet server. If errors occurs, corresponding error messages will be displayed in the bottom panel (the message panel) of the dialog window.
Note: The SearcherSlave aglet searches those files that are allowed to access in "Security Configuration" dialog of every remote Tahiti.
In order to update the AddressBook, click once to display its panel. Then, either select an address and remove it (via the delete button) or add the current address in the "Address" field (via the add button). Click on the close button to hide the AddressBook panel.
The SearcherSlave notifies the Slave of successful completion of the local search in every remote aglet server. These messages will be displayed on the message panel (see the example above).
The file name will be displayed on the result panel, in the form of <hostname>::<file name>. You can watch only the files of a specific remote aglet server by selecting its URL in the itinerary panel and pressing the show button.
Read here about troubleshooting for the sample aglets.