Difference between revisions of "FAQ amuled"

Latest revision as of 22:22, 3 December 2008

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 Red Hat distros:
 chkconfig --add amuled
 chkconfig amuled on 2 3 5 .
 #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

Runscript for Gentoo

#!/sbin/runscript
# Copyright 1999-2008 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: $

NAME=$(basename "$0")
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DAEMON=/usr/bin/amuled
DESC=amuled
USER=foobar

depend()
{
        need net
}

start()
{
        ebegin "Starting $DESC"
        su "$USER" -c "$(printf "%q -f" "$DAEMON" )"
        eend $?
}

stop()
{
        ebegin "Stopping $DESC"
        killall --quiet "$DAEMON"
        eend $?
}

restart()
{
        svc_stop
        svc_start
}

Script for SUSE ditribution (Novell SUSE Linux, openSUSE)

#!/bin/bash
#
### BEGIN INIT INFO
# Provides:          amuled
# Required-Start:    $ALL
# Should-Start: $ALL
# Required-Stop:     $ALL
# Should-Stop: $ALL
# Default-Start:     3 5
# Default-Stop:      0 1 2 6
# Short-Description: aMule Daemon
# Description:       Start aMuled, Daemon for aMule
### END INIT INFO

NAME=$(basename "$0")
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DAEMON=/usr/local/bin/amuled
DESC=amuled
USER=username #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

This script can be inserted in the startup list by making it executable and by running the command insserv (see man page for more informaion on insserv).