Difference between revisions of "FAQ amuled"

Revision as of 00:33, 15 March 2006

aMuled is a full featured aMule, running without any user interface (GUI). It is controlled by remote access through aMuleWeb, aMuleCMD, aMuleGUI or other ed2k utilities.

Stripped from GUI, aMuled has reduced memory and CPU requirements and it can run without X at all.

Please note: Remember not to set your max-Connections higher than 1024, since wxBase cannot handle more connections.

If you just need to run aMule on a remote server try Xvfb (see this too).

Startup script

Here is an amuled startup script to make amuled start and stop with your computer. It is derived from the one at aMuleWeb, but follows stricter quoting rules, doesn't require a configuration file in /etc/defaults, and doesn't start a web server.

Run su, or prefix commands with sudo, to become root.

Edit the USER= line to set it to your current user (as reported by whoami).

Copy the script as /etc/init.d/amuled:

cp amuled /etc/init.d/amuled

Make it executable:

chmod 755 /etc/init.d/amuled

Set it to run at startup:

 #on debian distros:
 update-rc.d amuled defaults
 #on a generic distro
 ln -s /etc/init.d/amuled /etc/rc0.d/K20amuled;
 ln -s /etc/init.d/amuled /etc/rc1.d/K20amuled;
 ln -s /etc/init.d/amuled /etc/rc6.d/K20amuled;
 ln -s /etc/init.d/amuled /etc/rc4.d/S20amuled
 ln -s /etc/init.d/amuled /etc/rc5.d/S20amuled

The script contains the following lines:

#!/bin/bash

NAME=$(basename "$0")
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DAEMON=/usr/bin/amuled
DESC=amuled
USER=g2p #A user who already ran amule once to configure it.

test -x "$DAEMON" || exit 0

case "$1" in
 start)
   echo -n "Starting $DESC: "
     su "$USER" -c "$(printf "%q -f" "$DAEMON" )"
   echo "$NAME."
   ;;
 stop)
   echo -n "Stopping $DESC: "
     killall --quiet "$DAEMON"
   echo "$NAME."
   ;;
 restart|force-reload)
   echo -n "Restarting $DESC: "
     killall --quiet "$DAEMON"
   sleep 1
     su "$USER" -c "$(printf "%q -f" "$DAEMON" )"
   ;;
 *)
   printf "Usage: %q {start|stop|restart|force-reload}\n" "$0" >&2
   exit 1
   ;;
esac

exit 0

Startup script for RedHat (Fedora, RHEL, Centos, SME7, ...)

Run su, or prefix commands with sudo, to become root.

Edit the USER= line to set it to your current user (as reported by whoami).

Copy the script as /etc/init.d/amuled:

cp amuled /etc/init.d/amuled

Make it executable:

chmod 755 /etc/init.d/amuled

Then register the service :

chkconfig --add amuled

The alternate script contains the following lines :

#!/bin/sh
# aMule - script shell pour l'arret/demarrage du service

# description: amule p2p download service
# chkconfig: 345 97 03

# Source function library.
. /etc/rc.d/init.d/functions

USER=p2p #A user who already ran amule once to configure it.

RETVAL=0

case "$1" in
start)
  echo -n "Starting amule daemon: "
  daemon --user=$USER amuled -f
  RETVAL=$?
  echo
  [ $RETVAL -eq 0 ] && touch /var/lock/subsys/amule
  ;;
stop)
  echo -n "Stopping amule daemon: "
  killproc amuled
  RETVAL=$?
  rm -f /var/lock/subsys/amule && rm -f /var/lock/amule
  echo
  ;;
status)
  status amuled
  RETVAL=$?
  ;;
restart|force-reload)
  $0 stop
  $0 start
  RETVAL=$?
  ;;
*)
  printf "Usage: %q {start|stop|status|restart|force-reload}\n" "$0" >&2
  exit 1
  ;;
esac

exit $RETVAL