AMule: differenze tra le versioni

Vai alla navigazione Vai alla ricerca
Riga 125: Riga 125:
== Versione Demone ==
== Versione Demone ==


Il demone può essere avviato/fermato attraverso il file binario '''<code>amuled</code>''' oppure tramite lo script '''<code>/etc/init.d/amule-daemon</code>'''.
=== Premessa ===


{{Suggerimento|Se è la prima volta che si usa amule è caldamente consigliato avviare il demone direttamente tramite il file binario e non con lo script. L'avvio tramite script dovrebbe essere adottato solo da quegli utenti che hanno già verificato il buon funzionamento del demone, che hanno confidenza con i parametri di configurazione di amule e in generale con la shell di linux.}}
Se è la prima volta che si usa amule-daemon e non si possiede già la cartella dei file di configurazione <code>.aMule</code> leggere la sezione [[#Primo avvio|Primo avvio]], in caso contrario è possibile saltare direttamente alla sezione dedicata all'[[#Esecuzione|Esecuzione]].


=== Esecuzione ===
=== Primo avvio ===
==== File binario amuled ====
===== Primo avvio =====
Digitare da terminale:
Digitare da terminale:
<pre>$ amuled</pre>
<pre>$ amuled</pre>
Riga 137: Riga 135:
{{Box|NOTE|
{{Box|NOTE|
* Amuled viene eseguito con gli stessi permessi dell'utente che avvia il demone.
* Amuled viene eseguito con gli stessi permessi dell'utente che avvia il demone.
* Prima di poter lanciare ''amuled'' con successo è necessario impostare sia una password che configurarlo per accettare connessioni esterne, ovvero connessioni da interfacce testuali o grafiche.
}}
===== Successivi avvii =====
Una volta configurato il demone (si veda [[#Configurazione|apposita sezione]]) è sufficiente digitare da terminale:
<pre>$ amuled -f</pre>
Il    demone stamperà un paio di messaggi e poi continuerà a girare in background. Questo significa che è possibile sloggarsi e/o fare altro    senza che questo comporti l'arresto dell'esecuzione di ''amule-daemon''.
{{Box|NOTE|
* Per questioni di sicurezza è caldamente '''S'''consigliato l'avvio del demone come root.
* In caso di crash è possibile che il file di configurazione ''amule.conf'' venga danneggiato e sostituito con una copia base dello stesso.
* Se il parametro ''AcceptExternalConnections'' è impostato su 0 il demone dopo essere stato avviato si arresta immediatamente (senza stampare a video particolari messaggi d'errore).
* Se lo script presente in <code>/etc/init.d</code> non è abilitato il demone può essere arrestato regolarmente solo attraverso un interfaccia che supporti tale possibilità, come ''amulecmd''.
}}
}}
Prima di poter lanciare ''amuled'' con successo è necessario impostare sia una password che configurarlo per accettare connessioni esterne, ovvero connessioni da interfacce testuali o grafiche. Si passi alla prossima [[#Configurazione|sezione].


==== Script amule-daemon ====
È essenziale specificare l'utente che lo script userà per eseguire il demone. Tale utente, pur totalmente arbitrario, deve:
* essere già presente nel sistema (non è finalità di questa guida spiegare come creare un nuovo utente in linux).
* avere i permessi rwx (lettura, scrittura ed esecuzione) sulla cartella </code>.aMule</code> (contenente i file di configurazione, posizione predefinita </code>~/.aMule</code>), su quella in cui sono creati i file temporanei e su quella in cui vengono salvati i file completati. Le ultime due sono di default sottocartelle della prima, a meno che l'utente non decida di definire posizioni differenti per una o entrambe.
* avere almeno i permessi rx (lettura ed esecuzione) su tutte le cartelle a monte (genitrici) di quelle citate al punto precedente.
* È consigliabile come sempre utilizzare un utente senza privilegi di amministratore.
La procedura varia leggermente a seconda che si decida di usare un utente dotato di home, ovvero un utente normale creato senza specificare l'opzione ''--no-create-home'', oppure un utente di sistema o un utente normale avendo specificato l'opzione ''--no-create-home''.
===== Utente con ''home'' =====
Editare il file <code>/etc/default/amule-daemon</code> e specificare alla riga contenente
<pre>AMULED_USER=""</pre>
il nome dell'utente che lo script userà per gestire il demone, ad esempio
<pre>AMULED_USER="sempronio"</pre>
===== Utente senza ''home'' =====
Se non si possiede già la cartella con tutti i file di configurazione (predefinita </code>~/.aMule</code>), perché per esempio è la prima volta che si usa amule, conviene avviare almeno una prima volta il demone in modo tradizionale, senza cioé usare lo script ''amule-daemon'', al fine di far generare in automatico la cartella con tutti i file di configurazione (si veda l'apposita parte di questa guida). Fatto ciò:
# Decidere dove collocare la cartella dei file di configurazione, dei file temporanei e dei file completati; mantenere le posizioni predefinite, cioè in </code>~/.aMule</code>, è assolutamente accettabile. Vale naturalmente quanto detto inizialmente sui permessi.
# Editare il file <code>/etc/default/amule-daemon</code> e specificare:
## l'utente da usare tramite la variabile ''AMULED_USER'', per esempio <code>AMULED_USER="sempronio"</code>
## la cartella contenente la cartella con i file di configurazione tramite la variabile ''AMULED_HOME'', per esempio <code>AMULED_HOME="/home/nome_utente/"</code> (quindi in tal caso il percorso della cartella ''.aMule'' sarà <code>/home/nome_utente/.aMule</code>).
# Editare il file </code>.aMule/amule.conf</code> e modificare opportunalmente i seguenti parametri in modo che siano coerenti
#* ''TempDir='' (percorso cartella file temporanei);
#* ''IncomingDir='' (percorso cartella file completati);
#* ''OSDirectory'' (percorso cartella ''.aMule'');
===== Comandi disponibili =====
* <code>/etc/init.d/amule-daemon start</code>, per avviare il demone.
* <code>/etc/init.d/amule-daemon stop</code>, per arrestare il demone.
* <code>/etc/init.d/amule-daemon restart</code>, per riavviare il demone.
* <code>/etc/init.d/amule-daemon force-reload</code>.


=== Configurazione ===
=== Configurazione ===
Riga 238: Riga 196:
* ''Enabled'' se impostato su 1 permette di amministrare il demone tramite interfaccia web. Si noti che è anche possibile evitare di rendere disponibile l'interfaccia web all'avvio del demone, in tal caso è sempre possibile avviarla successivamente tramite il comando <code>amuleweb</code> (si veda la relativa pagina man).
* ''Enabled'' se impostato su 1 permette di amministrare il demone tramite interfaccia web. Si noti che è anche possibile evitare di rendere disponibile l'interfaccia web all'avvio del demone, in tal caso è sempre possibile avviarla successivamente tramite il comando <code>amuleweb</code> (si veda la relativa pagina man).
* ''Port'' è la porta usata dal Web Server di aMule. Vale quanto detto al punto precedente per ''ECPort''.
* ''Port'' è la porta usata dal Web Server di aMule. Vale quanto detto al punto precedente per ''ECPort''.
=== Esecuzione ===
==== IMPORTANTE ====
Il demone può essere avviato/fermato attraverso il file binario '''<code>amuled</code>''' oppure tramite lo script '''<code>/etc/init.d/amule-daemon</code>'''.
{{Suggerimento|Se è la prima volta che si usa amule è caldamente consigliato avviare il demone direttamente tramite il file binario e non con lo script. L'avvio tramite script dovrebbe essere adottato solo da quegli utenti che hanno già verificato il buon funzionamento del demone, che hanno confidenza con i parametri di configurazione di amule e in generale con la shell di linux.}}
In entrambi i casi perché amule-daemon possa essere avviato correttamente è sia '''NECESSARIO''' che esista una cartella <code>.aMule</code> contenente i file di configurazione, sia che il demone sappia dove andare a recuperarla, ovvero che ne conosca la posizione.
==== File binario amuled ====
È necessario che la cartella con i file di configurazione <code>.aMule</code> sia presente nella home dell'utente che intende avviare il demone; tale cartella può essere generata seguendo le istruzioni della sezioni [[#Primo avvio|Primo avvio]] e [[#Configurazione|Configurazione]], oppure direttamente copiata (con lo stesso nome) da una precedente installazione.
Soddisfatto questo requisito è sufficiente digitare da terminale:
<pre>$ amuled -f</pre>
Il    demone stamperà un paio di messaggi e poi continuerà a girare in background. Questo significa che è possibile sloggarsi e/o fare altro    senza che questo comporti l'arresto dell'esecuzione di ''amule-daemon''.
{{Box|NOTE|
* Per questioni di sicurezza è caldamente '''S'''consigliato l'avvio del demone come root.
* In caso di crash è possibile che il file di configurazione ''amule.conf'' venga danneggiato e sostituito con una copia base dello stesso.
* Se il parametro ''AcceptExternalConnections'' è impostato su 0 il demone dopo essere stato avviato si arresta immediatamente (senza stampare a video particolari messaggi d'errore).
* Se lo script presente in <code>/etc/init.d</code> non è abilitato il demone può essere arrestato regolarmente solo attraverso un interfaccia che supporti tale possibilità, come ''amulecmd''.
}}
==== Script amule-daemon ====
È necessario che la cartella con i file di configurazione <code>.aMule</code> sia presente in un qualche punto del filesystem; tale cartella può essere generata seguendo le istruzioni delle sezioni [[#Primo avvio|Primo avvio]] e [[#Configurazione|Configurazione]], oppure direttamente copiata (con lo stesso nome) da una precedente installazione.
Soddisfatto questo requisito è essenziale specificare l'utente che lo script userà per eseguire il demone; tale utente, pur totalmente arbitrario, deve:
* essere già presente nel sistema (non è finalità di questa guida spiegare come creare un nuovo utente in linux).
* avere i permessi rwx (lettura, scrittura ed esecuzione) sulla cartella </code>.aMule</code> (contenente i file di configurazione, posizione predefinita </code>~/.aMule</code>), su quella in cui sono creati i file temporanei e su quella in cui vengono salvati i file completati. Le ultime due sono di default sottocartelle della prima, a meno che l'utente non decida di definire posizioni differenti per una o entrambe.
* avere almeno i permessi rx (lettura ed esecuzione) su tutte le cartelle a monte (genitrici) di quelle citate al punto precedente.
* È consigliabile come sempre utilizzare un utente senza privilegi di amministratore.
La procedura varia leggermente a seconda che si decida di usare un utente dotato di home, ovvero un utente normale creato senza specificare l'opzione ''--no-create-home'', oppure un utente di sistema o un utente normale avendo specificato l'opzione ''--no-create-home''.
===== Utente con ''home'' =====
Editare il file <code>/etc/default/amule-daemon</code> e specificare alla riga contenente
<pre>AMULED_USER=""</pre>
il nome dell'utente che lo script userà per gestire il demone, ad esempio
<pre>AMULED_USER="sempronio"</pre>
===== Utente senza ''home'' =====
Se non si possiede già la cartella con tutti i file di configurazione (predefinita </code>~/.aMule</code>), perché per esempio è la prima volta che si usa amule, conviene avviare almeno una prima volta il demone in modo tradizionale, senza cioé usare lo script ''amule-daemon'', al fine di far generare in automatico la cartella con tutti i file di configurazione (si veda l'apposita parte di questa guida). Fatto ciò:
# Decidere dove collocare la cartella dei file di configurazione, dei file temporanei e dei file completati; mantenere le posizioni predefinite, cioè in </code>~/.aMule</code>, è assolutamente accettabile. Vale naturalmente quanto detto inizialmente sui permessi.
# Editare il file <code>/etc/default/amule-daemon</code> e specificare:
## l'utente da usare tramite la variabile ''AMULED_USER'', per esempio <code>AMULED_USER="sempronio"</code>
## la cartella contenente la cartella con i file di configurazione tramite la variabile ''AMULED_HOME'', per esempio <code>AMULED_HOME="/home/nome_utente/"</code> (quindi in tal caso il percorso della cartella ''.aMule'' sarà <code>/home/nome_utente/.aMule</code>).
# Editare il file </code>.aMule/amule.conf</code> e modificare opportunalmente i seguenti parametri in modo che siano coerenti
#* ''TempDir='' (percorso cartella file temporanei);
#* ''IncomingDir='' (percorso cartella file completati);
#* ''OSDirectory'' (percorso cartella ''.aMule'');
===== Comandi disponibili =====
* <code>/etc/init.d/amule-daemon start</code>, per avviare il demone.
* <code>/etc/init.d/amule-daemon stop</code>, per arrestare il demone.
* <code>/etc/init.d/amule-daemon restart</code>, per riavviare il demone.
* <code>/etc/init.d/amule-daemon force-reload</code>.


=== Interfacce ===
=== Interfacce ===