The referrals dialog manages a list of indexes that the currently open index can search in addition to itself. Each index has its own list of indexes it can refer to (search) and these indexes can either be stored locally on the same machine as the referring index, or can be on a remote machine running an instance of the WilmaServer program.

The list on the right of the dialog has three columns:

Name The name of the referral as it will appear in the search dialog referrals list and as the first element of the folder path in the search results list.
Machine The computer that the index referred to lives on. If this is the same as the referring index, it will be This Machine, otherwise it will be the IP address or domain name of the remote machine running WilmaServer.
Index Name The name of the index being referred to.

On the left of the dialog are the buttons you use to manage the list:

Add Local This button immediately adds a local reference and opens a dialog where you can edit its properties. These are:
Referral Name Replace the default name with the name you want the referral identified by.
Index Name Select the local index from the drop down menu of stored indexes.
Max Returned Results Enter the maximum number of results to return (default 10000)
Max Wait How long the program should wait for the results to be returned. This normally isn't an issue for local indexes. (default is 5 seconds, expressed as 50 tenths of a second)
Add Net This button immediately adds a network reference and opens a dialog where you can edit its properties. These are:
Referral Name Replace the default name with the name you want the referral identified by.
Server Port Number The port number used by the server. The default value is 4386, but can be set to other values. If you are using a firewall, you may have to tell it to allow the use of this port.
Server Domain You must supply either the domain name (e.g. myserver.mycompany.com) or the servers IP address in the next field. When one field is filled in, the other becomes disabled.
Server IP If the domain name isn't given in the field above, you must supply the IP address of the server (e.g. 192.168.0.123)
Index Name Enter the name of the index on the remote machine. Note that the index must be one that the server has selected as being available for remote use.
User Name In order to use a remote index, you must have a user name defined on the remote server.
Password Enter the password defined for your user name on the remote server.
Max Returned Results Enter the maximum number of results to return (default 10000)
Max Wait How long the program should wait for the results to be returned. This prevents an indefinite wait should there be some sort of network problem. (default is 5 seconds, expressed as 50 tenths of a second)
Edit Brings up the appropriate properties dialog for the referral selected.
Delete Deletes the selected referral.
Done Closes the dialog.