3 155
contributi
Wtf (discussione | contributi) |
Wtf (discussione | contributi) |
||
Riga 125: | Riga 125: | ||
== Versione Demone == | == Versione Demone == | ||
=== Premessa === | |||
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]]. | |||
=== 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. Si passi alla prossima [[#Configurazione|sezione]. | |||
=== 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 === |
contributi