Installare Verlihub per Linux

Tutto su Verlihub
• Download Verlihub
Per scaricare verlihub possiamo sia procurarci i file in formato compresso da qualche
sito (.tar.gz , .tar.bz2 …) o prenderli in maniera più rapida dal CVS.
_____________________________________________________________________
___________
Se non si possiede il CVS bisogna installarlo. Vi illustrerò come installarlo in maniera
rapida con alcune distro differenti:
Debian: Aprire la shell (terminale) e digitare “apt-get install cvs” (senza le
virgolette”)
Suse: Bisogna innanzi tutto procurarsi l’apt-get per SuSE, in modo da velocizzare
qualsiasi operazione futura.
Downlaod e Installazione apt4suse
Innanzi tutto dobbiamo scaricare il pacchetto più recente (rpm) di apt4suse da qui :
http://linux01.gwdg.de/~scorot/install-apt4suse.rpm
Poi bisogna installarlo, accedendo da root nella shell e digitando il seguente comando
rpm -Uvh install-apt4suse.rpm
O con l’aiuto di Yast cliccando sul file all’interno di una finestra di konqueror
Ora bisogna digitare la seguente stringa per completare l’installazione
install-apt4suse
Ora apt-get per SuSE è installato e quando vorrete scaricare o installare qualche file
direttamente dalla shell potrete dare il comando “apt-get install nomefile”
P.S. potrete trovare una guida più dettagliata sull’apt4SuSe cliccando qui
Tornando all’installazione del CVS , ora basterà aprire una shell del nostro SuSE e
digitare : “apt-get install cvs” (senza virgolette”)
Gentoo: Aprire la shell (terminale) e digitare “emerge cvs”
Ora che abbiamo il cvs installato possiamo scaricare il verlihub dando il seguente
comando da shell
(assicuratevi che siete nel terminale come root)
cvs –z1 –d:pserver:[email protected]:/cvsroot/verlihub “login”
Con questo comando effettuiamo il login nel cvs
Ora tocca digitare la password e basterà schiacciare “INVIO”
**Attenzione** se non dovesse andare digitate questa stringa
export cvs_RSH=ssh
Ora che siamo nel cvs, dobbiamo scaricare il verlihub con questo comando
cvs –z1 –d:pserver:[email protected]:/cvsroot/verlihub co verlihub
Adesso dobbiamo rieffettuare il login (in una nuova finestra di terminale)
cvs –d:pserver:[email protected]:/cvsroot/verlihub login
Scarichiamo le varie cartelle utili per la configurazione del verlihub
cvs –d:pserver:[email protected]:/cvsroot/verlihub co lua iplog isp floodprot chatroom isp perl
stats
Requisiti per l’installazione
• gcc versione >= 3.2 (digitando da console gcc –version potrai vedere la versione
installata)
• MySQL versione 4.1- o superiore (per controllare le versioni presenti digitare da
shell
“rpm –qa | grep mysql”)
• Perl (pcre)
• GeoIP
Siti utili da cui poter scaricare queste librerie in formato .rpm (www.rpmfind.net o
http://rpm.pbone.net) . ricordo comunque che si possono installare con l’apt-get di
Debian (e SuSE) e l’emerge di Gentoo.
MySQL
I pacchetti da scaricare sono MySQL-devel , MySQL-server, MySQL-client,
MySQL-shared, MySQL-shared compat.(reperibili dal nostro sito : ciccando qui)
Una volta scaricati ed INSTALLATI correttamente i vari pacchetti procediamo…
Ora dobbiamo startarlo
mysql_install_db
/etc/init.d/mysql start
Se non dovesse andare, fate partire il mysql server in questo modo
ps aux | grep mysqld
Adesso dobbiamo configurarlo per il VerliHub (ricordo che una volta dentro il mysql
digiteremo le varie stringhe in questo modo :
mysql> nostrastringa
mysql> \q (questo è il comando per uscire)
-u root
DELETE FROM mysql.user WHERE User=’’;
FLUSH PRIVILEGES;
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('nuovapassword');
Ricordo che dove sta (‘nuovapassword’) dobbiamo inserire la nostra password
SENZA omettere gli apostrofi ‘’
Una volta fatto questo potrete accedere al MySQL quando vorrete, basta digitare da
shell
“mysql” (senza virgolette)
Se da problemi questa stringa potrete inviare questa :
mysql -p
Ma dopo dovrete inserire la password che avete settato nel passaggio di prima :P
Per vedere le versioni e le tipologie di mysql installate potete dare questo comando
(da shell)
rpm –qa | grep mysql
Attenzione potete sempre cercare di accedere al mysql con il comando “mysql –p” ,
ma se non avete mai impostato la passsword , basterà schiacciare “INVIO” alla sua
richiesta.
Domande Frequenti
Un errore riscontrato da parecchi utenti è la seguente stringa all’invio del comando
“mysql”
“Can't connect to local MySQL server through socket
/var/lib/mysql/mysql.sock”
Il problema proviene dal fatto che non avete tutte le librerie mysql richieste installate
oppure se sono di versione diversa (es. MySQL-server 4.0.19 e MySQL-client 5.0).
Se dopo aver controllato risulta tutto ok, ma vi ridà quell’errore, digitate questa
stringa :
safe_mysqld &
La procedura completa delle operazioni è la seguente:
mysql [si riceve l’errore in output)
mysql_install_db
safe_mysqld &
mysql (oppure nel nostro caso: mysql –u root)
In questo modo potrete accedere sicuramente al mysql.
Installazione Verlihub & Plugins
Una volta scaricato il verlihub (possibilmente in /root/) dobbiamo compilarlo ed
installarlo
Entriamo nella cartella con il comando
“cd verlihub” (se ci troviamo in root, altrimenti “cd /root/verlihub”)
E compiliamolo con i soliti comandi
./configure
make
make install
Se da errore, leggete la tipologia di errore e capirete cosa avete sbagliato (nella
maggior parte dei ci sono librerie mancanti come la pcre o mysql)
Procediamo allo stesso modo per tutti gli altri plugins che abbiamo scaricato prima
(ips,floodprot, lua ecc..)
ATTENZIONE :: per il LUA c’è appunto bisogno del LUA, e vi consiglio la versione
5.0 (le successive non vanno bene) potete scaricarle sempre dal nostro sito cliccando
qui. [sito ufficiale]
Successivamente dobbiamo compilare il lua scaricato dal CVS allo stesso modo del
Verlihub ossia
./configure
make
make install
Ora non ci tocca che installare il verlihub nel database mysql dando questo comando
(sempre da root)
vh_install
Con questo comando c’è la procedura guidata per l’installazione e la configurazione
del verlihub. Ricordo che dove c’è la richiesta di inserire la password del database
dovete inserire quella scelta da voi in precedenza (quando abbiamo configurato il
MySQL).
Mi raccomando di impostare come cartella di installazione /etc/verlihub .
Ora non ci resta che startare l’hub con il seguente comando
vh_runhub
E connettendovi all’hub vedrete finalmente sorgere il vostro caro hubbetto su un
grande Sistema Operativo, come Linux :P
Per stoppare il Verlihub basta utilizzare questo comando
vh_runhub -s
Plugins
Prima di startare il vostro hub vi consiglio di impostare per bene i plugins anche dal
MySQL in questo modo:
entriamo nel Database del verlihub con questo comando
vh_getdb
Ora carichiamo uno per volta tutti i plugins installati in questo modo
update pi_plug set autoload=1 where nick"lua";
Dove sta nick”lua”; bisogna sostituire ogni volta il nome del plugin tra le virgolette
(tipo nick”floodprot” ..ecc..)
Impostando set autoload=1 facciamo partire il plugin automaticamente, all’avvio del
verlihub, se impostiamo 0 bisogna caricarlo manualmente ogni volta!
Un altro comando utile da digitare sempre nel mysql è
select * from pi_plug;
Con il quale vediamo tutti i plugins installati
Comandi per Plugin (dall’hub)
Una volta startato l’hub, e fatto il login con il nostro username e password possiamo
caricare , disabilitare o vedere la lista dei plugin installati con i seguenti comandi:
Lista Plugin
!pluglist all
Avvio di un Plugin
!plugin <plugin_nomefile.so>
Disabilitare un Plugin
!plugout <nome_plugin>
Riavviare un Plugin
!plugreload <nome_plugin>
Il plugin "Plugin Manager" (plagman)
Questo plugin consente di gestire gli altri plugin installati, ti consente di avviarli, di
visualizzarli e disattivarli. Il Plugin Manager deve essere compilato quando installi
Verlihub e non verrà caricato automaticamente. La cartella predefinita di Verlihub in
cui vi sono i plugin è /usr/local/lib. Per avviare il Plugin Manager manualmente
digita:
!plugin libplug_pi.so
Tramite questo comando avvierai il plugin, ma attenzione al prossimo riavvio non
sarà avviato automaticamente. Per caricare un plugin in automatico all’avvio di
Verlihub devi creare un link simbolico alla cartella di configurazione (in questa guida
è /etc/verlihub):
mkdir /etc/verlihub/plugins
ln -s /usr/local/lib/libplug_pi.
/etc/verlihub/plugins/libplug_pi.so
Ora riavvia Verlihub, e il Plugin Manager verrà avviato in automatico. Gli utenti
Gentoo possono usare questo comando per riavviare Verlihub
/etc/init.d/verlihub restart
Per una spiegazione più dettagliata sui plugin potete vistare questo sito
LUA
Una volta installato il lua 5.0 con il relativo plugin (vedere sopra), possiamo
aggiungere tanti diversi BOT per il nostro hub con differenti funzioni!
Una volta scaricato uno script lua, lo inseriamo nella cartella /etc/verlihub/scripts
(consigliata) e lo possiamo caricare automaticamente dall’hub con il seguente
comando
!luaload /etc/verlihub/scripts/nomefile.lua
Se verlihub da un errore vuol dire che avete sbagliato il percorso di dove è situato il
file .lua
Una lista aggiornata da dove poter scaricare tutti gli ultimi bot è qui !
Per vedere quali scripts sono stati caricati digitiamo (sempre dall’hub) il seguente
comando:
!lualist all
Per rimuovere uno script caricato possiamo digitare nell’hub
!luaunload /etc/verlihub/scripts/nomefile.lua
Ricordo che /etc/verlihub/scripts è il percorso che abbiamo utilizzato in questa guida,
ma voi potreste trovare la cartella scripts altrove, dipende in che percorso è stato
installato il verlihub.
Comandi Verlihub
I seguenti comandi sono inclusi nel file di configurazione di Verlihub, visibile agli
Admin e i Master dell' hub con il comando !gc
min_share_reg scrivere la grandezza desiderata espressa in Mb (es: 1GB sarà scritto
così 1024)
min_share_vip scrivere la grandezza desiderata espressa in Mb (es: 1GB sarà scritto
così 1024)
min_share_ops scrivere la grandezza desiderata espressa in Mb (es: 1GB sarà scritto
così 1024)
max_share scrivere la grandezza desiderata espressa in Mb (es: 1GB sarà scritto così
1024)
max_share_reg scrivere la grandezza desiderata espressa in Mb (es: 1GB sarà scritto
così 1024)
tban_kick scrivere la durata desiderata del KICK espressa in secondi (es: 10 minuti
sarà scritto così 600)
hub_name srivere il nome dell' hub
hub_version versione dell' hub software
hub_version_special versione speciale del tipo (by SuPeRKoO)
hub_desc descrizione hub
max_nick lunghezza massima nick
min_nick lunghezza minima nick
nick_chars caratteri speciali consentiti
listen_port porta di ascolto del server (la porta 411 è quella predefinita)
extra_listen_ports porta d' ascolto secondaria
min_class_bc minima classe a cui è consentito di inviare mass message
min_class_bc_regs minima classe a cui è consentito di inviare mass message agli user
registrati
min_class_redir minima classe a cui è consentito reindirizzare gli utenti su un altro
server
hub_security nome del bot security
hub_security_desc descrizione del bot
opchat_name nome della chat operatori
opchat_desc descrizione della chat operatori
hub_owner nome di ki ha creato l' hub
int_search intervallo di ricerca espresso in secondi
int_chat_ms intervallo di chat espresso in millisecondi
show_tags 1 per visualizzare - 0 per nascondere
show_desc_len 1 per visualizzare - 0 per nascondere
show_email 1 per visualizzare - 0 per nascondere
msg_chat_onoff = << To turn your chat on, use command !chaton >>
msg_change_pwd = << Please change your password NOW using command +passwd
new_passwd!!! See +help, 5 minutes remaining >>
msg_banned = <>
msg_hub_full = <>
msg_nick_prefix = <>
msg_welcome_guest Messaggio di benvenuto per utenti
msg_welcome_reg Messaggio di benvenuto per utenti registrati
msg_welcome_vip Messaggio di benvenuto per utenti vip
msg_welcome_op Messaggio di benvenuto per operatori
msg_welcome_cheef Messaggio di benvenuto per super operatori
msg_welcome_admin Messaggio di benvenuto per admin
msg_welcome_master Messaggio di benvenuto per master
redir_host0 indirizzo di redirect
redir_host1 indirizzo di redirect
redir_host2 indirizzo di redirect
redir_host3 indirizzo di redirect
redir_host4 indirizzo di redirect
redir_host5 indirizzo di redirect
redir_host_max = inserire numero massimo di host di redirect
Profilo
Registrato
Vip
Operatore
SuperOperatore
Admin
Master
Livello
1
2
3
4
5
10
Di seguito vi illustrerò alcuni dei comandi più usati
Inviare MassMessage (messaggio in privato a tutti gli utenti)
!bc <messaggio>
Registrare utente
La registrazione di un utente avviene in 2 fasi :
1. !regnew nick classe
[esempio : !regnew [REG]-Paolo 1 – in questo caso l’utente diviene di livello 1, ossia
REG . vedere tabella sopra per le varie classi ]
2. !regpasswd nick password
[esempio: !regpasswd [REG]-Paolo passworddipaolo]
Volendo si può aggiungere un’altra fase per definire meglio la classe dell’utente
registrato
!regclass nick classe
Cancella registrazione
!regdelete nick
Imposta Topic
!topic <messaggio topic del giorno :P>
Banna nick
!bannick nick motivazione
Banna IP
!ban IP motivazione
Sbanna nick/ip
!unban nick/ip motivazione
Mostra lista bannati
!lsban 100
In questo modo verrà visualizzata la lista degli ultimi 100 bannati, il numero a fianco
al comando !lsban indica il numero di ultimi bannati da visualizzare
Cancella lista bannati
!clearbans
Attenzione verranno sbannati tutti i nick bannati tranne i SuperBan e gli IP
Aggiunta Chatroom
Aggiungere una chatroom in verlihub è semplice, basta dare il comando dall’hub
!addroom <nome> -CC<country_code> -ac<min_auto_class> -AC<max_auto_class> -c
<min_class> -t<”topic”>
Allora a posto di <nome> ovviamente inseriamo il nick della ChatRoom;
-CC sarebbe la tag della nazione (es. IT-SP-FR ecc…) che viene riconosciuta dal verli
e si può anche omettere
-ac si imposta la classe minima che entra in automatico nella chatroom
-AC si imposta la classe massima che entra in automatico nella chatroom
-c minima classe che può entrare nella chatroom (con comando e non AutoJoin)
-t si imposta il topic (che verrà visualizzato nella descrizione della chatroom in lista
user)
Modifica ed Elimina Chatroom
Per modificare una chatroom esistente basta digitare in main il comando
!modroom <stringa di sopra modificata>
Per eliminare una Chatroom basta dare il seguente comando
!delroom <nome>
Aggiunta Trigger
In verlihub è inoltre possibile aggiungere trigger (del tipo se digito in main +Network
uscirà in pvt/main all’utente il proprio network).
Per prima cosa bisogna creare nella cartella /etc/verlihub/ un file di testo con il nome
del trigger con cui digiteremo in main il comando (es. chiamiamo un file di testo
Network e il comando da digitar e in main per aprirlo sarà +Network).
Modifichiamo poi il contenuto del file di testo Network con quello che vogliamo (per
esempio gli hub del nostro net appunto). Ora non ci resta che impostare il trigger
dall’hub con il seguente comando
!addtrigger nome -d “definizione” –h <help_desc> -f <flags> -n <sendas_nick> -c <min_class> -C
<max_class>
Come per le chatroom i comandi aggiuntivi (per modificare ed eliminare i trigger)
sono
!modtrigger <stringa di sopra modificata>
!deltrigger nome_trigger
·· ··÷¦÷··· ·· WwW.GoLdEnZoNe.iT:888 ·· ··÷¦÷··· ·· ··
Questa guida è stata scritta da SuPeRKoO nel giorno 02/06/06 e illustra il
funzionamento del miglior hubsoft al mondo quale il VerliHub.
Un ringraziamento speciale va a MaRcOS, colui che mi ha insegnato a vivere nel
mondo del pinguino! ;)
• Sito progetto : http://www.sf.net/projects/verlihub
• Home page progetto : http://www.verlihub.net
• Form verlihub per la segnalazione dei bug : http://forum.verlihub.net
• Hub VAZ (Verlihub Admin Zone) : dchub://hub.verlihub.net:7777
Alcune informazioni contenute in questo documento sono state prese da altri siti quali
• www.pierotofy.it (ottimo sito di programmazione)
• www.laterradeilol.com
Siti amici
• www.blackzoneweb.it/public/public_html/
Ricordo che è sempre a disposizione il nostro HTTPServer solo per Fastweb®
all’indirizzo http://www.goldenzone.it:888 , dal quale è stato prelevato anche questo
documento.
Per qualsiasi chiarimento, richiesta o informazione non esistate a contattarmi
all’email [email protected].
·· ··÷¦÷··· ·· WwW.GoLdEnZoNe.iT:888 ·· ··÷¦÷··· ·· ··