
XQMAgent/generic Installation

- Login as root
- Unpack the archive and copy the Agent's directory to your preferred 
  location.
- Do NOT move any of the Agent's files to another location.
- Modify xqmagent.conf to your needs.
- Move xqmagent.conf to /etc/xqmagent.conf
- If you use RedHat >= 9.0, start the Agent with ./xqmagent.sh
- Otherwise start XQMAgent with: python xqmagent.pyc

The Agent immidiately detaches from the console and runs as a daemon 
process transparently in background.

Debugging

  ./xqmagent.sh --debug or: python xqmagent.pyc --debug
  
  This shows you the Agent's configuration and lets you monitor the
  remote procedure calls being processed.

  Debugging is generally a good idea to verify that all your settings are
  valid and that the Agent is bound correctly to its port.

Troubleshooting

If you get any error messages:
- Make sure, that xqmagent.conf is located in the /etc folder and all
  its settings are adapted to your own system.
- Make sure that libssl.so.0.9.6 and libcrypto.so.0.9.6 are in your 
  system's PATH. Both libs come with the openssl package. 
- If you have a newer release, e.g. libssl.so.0.9.7, then you'll need 
  to create symbolic links from 0.9.6 to 0.9.7:

  ln -s /lib/libssl.so.0.9.7 /lib/libssl.so.0.9.6
  ln -s /lib/libcrypto.so.0.9.7 /lib/libcrypto.so.0.9.6

  The exact syntax of the above example depends on your environment 
  and your installed libs.  

Further help:
- Check out 'XMail Queue Manager Forum' at http://xmailforum.homelinux.net
- .. or contact me directly at h_schneider@marketmix.com

Have fun,
Harald

