Difference between revisions of "AMuleWeb-it"

Latest revision as of 12:55, 4 August 2008

aMuleWeb è un'utility che vi permette di controllare aMule tramite un browser web da qualsiasi luogo. L'interfaccia web offre una ristretta cerchia delle funzionalità di aMule, tra cui la ricerca di file, l'aggiunta di nuovi download, e la visualizzazione della vostra coda di download. Mostra inoltre le informazioni di stato e vi permette di modificare alcune opzioni.

aMule di per sè non supporta connessioni HTTP; aMuleWeb, che le supporta, funziona quindi da intermediario tra aMule e un browser web. Una volta che la connessione tra aMuleWeb e l'utente remoto è stata stabilita, aMuleWeb si connette ad aMule attraverso l'interfaccia Connessioni Esterne.

Di base, aMuleWeb attende le conenssioni HTTP sulla porta 4711, ma questo può essere cambiato in Preferenze.

Installare aMuleWeb

Molte, se non tutte le distro hanno un pacchetto aMule nei propri repository. Se installate aMule con un pacchetto RPM, DEB, o attraverso altri sistemi di gestione dei pacchetti, aMuleWeb sarà incluso nell'installazione. Se siete un utente debian o ubuntu e usate Synaptic, accertatevi di installare non solo i pacchetti amule e amule-common, ma anche il pacchetto amule-daemon.

Questo è il più semplice e preferibile metodo di installare aMule e aMuleWeb.

Compilare aMuleWeb

Se non avete installato aMule usando un pacchetto, necessiterete di compilarlo dal codice sorgente.

aMuleWeb non è compilato separatamente; è compilato contemporaneamente ad aMule usando il flag --enable-amuleweb quando eseguite configure. (Vedere la Pagina principale per i link a pagine riguardo alla compilazione di aMule per vari sistemi operativi).

Configurare aMuleWeb

Per usare aMuleWeb, avrete prima bisogno di impostare alcune opzioni nella sezione Preferenze di aMule. Nella pagina "Controlli Remoti" dovrete:

• Abilitare "Accetta Connessioni Esterne".
• Inserire una password per le Connessioni Esterne.
• Abilitare webserver all'avvio.

Potete anche modificare la porta predefinita di aMuleWeb (4711) e la porta delle Connessioni Esterne (4712) in questa pagina, ma facendolo, dovrete riavviare aMule per rendere effettive le modifiche.

(Se state usando aMuled e non volete usare aMule per configurare aMuleWeb, guardare le istruzioni sotto)

Quindi, ciò di cui avete bisogno è generare remote.conf, il file dove aMuleWeb salva le proprie informazioni di configurazione. (Potete trovarlo nella directory .aMule.) Tra le altre cose, questo file contiene il numero di porta che aMule usa per le Connessioni Esterne e le password necessarie per accedere ad aMule.

Per creare un file remote.conf, immettere da terminale il comando:

$ amuleweb -w

aMuleWeb leggerà le informazioni di configurazione necessareie da amule.conf e cenererà un file remote.conf , quindi uscirà.

Ora lanciate aMuleWeb normalmente:

$ amuleweb

(In realtà se avete installato aMule come pacchetto seguendo le suddette istruzioni, questi due comandi non sono necessari, basterà effettuare le impostazioni corrette in "Controlli Remoti" e riavviare aMule affinchè tutto funzioni)

Ora dovreste essere in gradi di aprire aMuleWeb in un browser digitando l'URL (sulla macchina su cui gira aMule):

 http://localhost:4711

oppure, con il nome di dominio del computer (in locale o da remoto):

 http://hostname:4711

Se volete far girare aMuleWeb su una macchina diversa da quella di aMule, semplicemente copiate remote.conf nella directory .aMule di quel computer, e cambiate correttamente il valore che segue a "Host=".

NOTA: aMuleWeb usa i cookies per salvare le informazioni della sessione. Assicuratevi che i cookies siano abilitati nel vostro browser.

Lanciare aMuleWeb

Ci sono due modi per lanciare aMuleWeb.

Il primo, e preferibile, è di abilitare l'attivazione di aMuleWeb nelle preferenze di aMule. Quando viene lanciato, aMule (o aMuled) lancerà aMuleWeb. A seguito dell'uscita, aMuleWeb sarà automaticamente terminato.

La seconda opzione è di lanciare aMuleWeb manualmente, digitando il comando "amuleweb" nel terminale.

Configurare aMuleWeb con aMuled

Innanzitutto, se aMuled sta girando, chiudetelo.

Quindi digitate:

 $ amuleweb -w

per generare un file remote.conf. Avrete bisogno di modificare queste opzioni nella sezione [ExternalConnect] di amule.conf:

• AcceptExternalConnections=1 <-- To enable External Connections.

• ECPassword=ca3c365274907c6fd527068788e14639 <-- MD5 string

Potete ora riavviare aMuled e aMuleWeb.

NOTA: Le password devono essere nel formato md5sum. Per generare un MD5sum per la vosta password, da terminale:

$ echo -n yourpasswordhere | md5sum | cut -d ' ' -f 1
ca3c365274907c6fd527068788e14639

NotaSe ottenete la risposta FATAL ERROR: Cannot find template: default è perchè non avete lanciato make install. Se non volete installare aMule, copiate la directory src/webserver/default/ in ~/.aMule/webserver/ (createla se necessario). Se volete un qualsiasi altro template (probabilmente php-default), copiate anche quello. Quindi tornate al passo precedente.

aMuleWeb con versioni precedenti di aMule

Per istruzioni su come usare aMuleWeb con aMule pre-2.0.0 final, vedere this page per il materiale archiviato.

Porte standard

The ports can be set to anything, but by default aMule uses: Le porte possono essere settate a qualunque valore, ma come predefinite aMule usa:

• Connecssioni Esterne: 4712
• amuleweb: 4711

Assicuratevi di non confondere le due; nella configurazione predefinita, dovrebbe essere così:

aMule --> [4712] --> aMuleWeb --> [4711] --> web browser

Percorsi dei Template (skin)

aMuleWeb cerca i propri files in diversi posti:

• Nella vostra home directory: $HOME/.aMule/webserver/[skin name]/

• E nella sua directory di instalalzione, in questo ordine (di default, /usr/local/share/amule/webserver se avete compilato aMule, o /usr/share/amule/webserver se l'avete installato tramite pacchetto).

Il nome del template di Default è 'default'.

Se, dopo aver installato aMule, aMuleWeb si rifiuta di funzionare o non è in grado di caricare un template:

• Per favore, segnalaci la situazione e poi

• Create le directories webserver/default nella sottodirectory .aMule della vostra home, e copiate qui il contenuto della cartella src/webserver dall'archivio tarball di aMule (es, $HOME/.aMule/webserver/default).

aMuled e aMuleWeb come servizi

Benchè lanciare aMuleWeb abilitandolo nelle preferenze di aMule sia il metodo da preferire, potete anche lanciare aMuleWeb insieme ad aMuled come servizi, attraverso uno script init.d . Questo è un esempio:

/etc/init.d/amule

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DAEMON=/usr/bin/amuled
WEB=/usr/bin/amuleweb
NAME=amuled
DESC=amuled
RUNAMULE=no
USER=youramuleuser

test -x $DAEMON || exit 0

# Include amule defaults if available
if [ -f /etc/default/amule ] ; then
    . /etc/default/amule
fi

if [ "$RUNAMULE" != "yes" ] ; then
    echo "Amule not to be started. Edit /etc/default/amule first."
    exit 1
fi

set -e

case "$1" in
  start)
    echo -n "Starting $DESC: "
       su $USER -c "$DAEMON -f"
       while ! netstat -l -n -p -t | grep -q amuled ; do sleep 1 ; done
       su $USER -c "$WEB --quiet &"
    echo "$NAME."
    ;;
  stop)
    echo -n "Stopping $DESC: "
       killall --quiet --ignore-case $WEB
       killall --quiet --ignore-case $DAEMON
    echo "$NAME."
    ;;
  restart|force-reload)
    echo -n "Restarting $DESC: "
       killall --quiet --ignore-case $WEB
       killall --quiet --ignore-case $DAEMON
    sleep 1
       su $USER -c "$DAEMON -f"
       while ! netstat -l -n -p -t | grep -q amuled ; do sleep 1 ; done
       su $USER -c "$WEB --quiet &"
    echo "$NAME."
    ;;
  *)
    N=/etc/init.d/$NAME
    echo "Usage: $N {start|stop|restart|force-reload}" >&2
    exit 1
    ;;
esac

exit 0

Quindi semplicemente impostate che quello script venga eseguito all'accensione. Su Debian questo potrebbe essere fatto con il comando seguente:

update-rc.d amule defaults

Quindi, per far partire i demoni dovete creare un file etc/default/amule che contenga una sola linea:

RUNAMULE=yes

Sviluppo e lingua dei Template

I template di aMuleWeb sono normali file HTML. Per renderli "interattivi", il linguaggio lato server è implementato internamente. Questo linguaggio è un dialetto ridotto del PHP. Informazioni maggiormente dettagliate possono essere trovate a aMuleWeb_PHP.

Dove riportare problemi e domande?

Per Problemi o Domande semplicemente scrivete sul forum http://forum.amule.org o entrate nel canale IRC #amule su irc.freenode.net

Altre fonti di informazione

Read the aMuleWeb man page, which is available in English, French, German, Hungarian and Spanish. Leggete la pagina di manuale di aMuleWeb, che è disponibile in Inglese, Francese, Tedesco, Ungherese e Spagnolo.

Per ulteriori informazioni leggete la FAQ di aMuleWeb.