Verlihubin asennus- ja käyttöohjeet
Ohjeet toimivat suoraan Debianille ja Ubuntulle. Muut joutuvat käyttämään eri komentoja ainakin pakettien lataamiseen. Jos etäkäytät palvelinta, jolle asennat Verlihubin Puttyllä, voit liittää komennot hiiren oikealla painikkeella. Muista myös ohjeet chat-tilastojen tekemiseen sivulla Chat-tilastot Aquilaan ja Verlihubiin.
Tarvittavien pakettien lataaminen
Varmista ensin, että olet kirjautunut järjestelmänvalvojan oikeuksin kirjoittamalla seuraava komento
su
Asenna tämän jälkeen paketit alla olevalla komennolla
apt-get install gcc g++ libpcre3-dev mysql-server mysql-client libmysqlclient15-dev make libgeoip-dev libssl-dev git-core bzip2
Asennuksessa pyydetään MySQL:n salasanaa. Kirjoita vapaavalintainen salasana (salasanaa tarvitaan myöhemmin).
phpMyAdminin asentaminen (ei pakollinen)
phpMyAdmin mahdollistaa asetusten varmuuskopioimisen sekä niiden muokkaamisen nettiselaimella, vaikka Verlihub ei olisikaan käynnissä.
Lataa paketit
apt-get install libapache2-mod-php5 phpmyadmin apache2 php5
Kysymykset asennuksessa:
Configure database for phpmyadmin with dbconfig-common? (yes)
Password of the database's administrative user: (aiemmin asetettu salasana tietokannan pääkäyttäjälle)
MySQL application password for phpmyadmin: (jätä tyhjäksi)
Web server to reconfigure automatically: apache2 (valitse tämä välilyönnillä!!)
phpMyAdmin löytyy sen jälkeen osoitteesta koneen_ip/phpmyadmin (laita selaimeen).
Esim: http://123.123.123.123/phpmyadmin
Jos phpMyAdmin on samalla koneella, jolla koitat käyttää sitä ja sinulla on NAT käytössä, yhdistä osoitteeseen http://localhost/phpmyadmin
Verlihubin lataaminen ja asentaminen
Lataa verlihub kansioon, jonne haluat sen asentaa
git clone git://verlihub.git.sourceforge.net/gitroot/verlihub/verlihub
Asenna ohjelma seuraavilla komennoilla. Jos asentaessa tulee ongelmia, joita et saa ratkaistua, voit laittaa viestiä keskustelualueelle.
cd verlihub ./configure make make install
Asetusscripti
Ohjelman mukana tulee scripti, jonka avulla voit rekisteröidä itsellesi käyttäjätilin sekä asettaa tärkeimmät asetukset. Käynnistä scripti komennolla
vh_install_cli
Your name ? (root)
Paina enteriä
Hello root, let's start with configuration of database access.. -------------------------------- mysql database for verlihub will be called? (verlihub)
Paina enteriä, jolloin verlihubin MySQL-tietokannaksi luodaan verlihub. Voit myös kirjoittaa toisen nimen tietokannalle.
mysql user to access verlihub gonna be? (verlihub) press enter to accept the default or change according to your wishes
Paina enteriä, jolloin verlihubin MySQL-tietokannan käyttäjäksi luodaan verlihub. Voit myös kirjoittaa toisen nimen käyttäjälle.
password to access verlihub be? (1110079846) press enter to accept the default or change according to your wishes
Hyväksy satunnaisesti luotu salasana paimalla enteriä tai kirjoita toinen. Tällä ei ole tekemistä aiemmin asetetun salasanaan kanssa.
mysql server will run where? (localhost)
Paina enteriä.
-------------------------------- user = verlihub password = 1110079846 host = localhost database = verlihub -------------------------------- This database account cannot be accessed -------------------------------- Is this info correct ? (Y/N)
Kirjoita Y ja paina enteriä, jos tiedot ovat oikein. Kirjoita N, jos haluat muuttaa niitä.
Do you want to create database now? (Y/N)
Kirjoita Y ja paina enteriä.
Ok preparing mysql.. You probably need administrator access to mysql database mysql administrator username? (root)
Paina enteriä
You'll be now promted by mysql client for password of root@localhost Enter password:
Anna salasana, jonka määritit osiossa MySQL:an asettaminen ja paina enteriä (ensimmäisessä salasanalauseessa)
-------------------------------- This database account exists -------------------------------- -------------------------------- root, you need to choos a place for the configuration files -------------------------------- The order of folder that verlihub is looking for is following: 1 - variable $VERLIHUB_CFG - -inexisting- 2 - ./.verlihub - /home/lua/.verlihub -inexisting- 3 - /root/.verlihub - /root/.verlihub -inexisting- 4 - /usr/local/etc/verlihub - /usr/local/etc/verlihub -inexisting- 5 - /etc/verlihub - /etc/verlihub -inexisting- if two or more of these exist, lower number has priority -------------------------------- -------------------------------- what is will be the configuration folder ? (/etc/verlihub)
Paina enteriä, jos haluat asetustiedostojen kansioksi /etc/verlihub tai kirjoita toinen hakemisto.
The config folder /etc/verlihub does not exist and would be created -------------------------------- Do you want to continue with these settings (if not then select another folder) ? (Y/N)
Kirjoita Y ja paina enteriä.
-------------------------------- Written: /etc/verlihub/dbconfig -------------------------------- Wait few seconds.. /usr/local/bin/vh_install: line 74: 7580 Keskeytetty $bindir/verlihub 22 >&/dev/null -------------------------------- root, now I will ask you few more questions about your future hub, if you permit.. -------------------------------- Try to not put many special characters, you'll be able to put some laer Give me your DC hub master nickname.. ([SU]root)
Kirjoita oma käyttäjänimesi, jonka haluat rekisteröitävän hubiin.
Choose your password.. (1198589024)
Anna käyttäjätilille salasana.
Which will be default ONE hub port number? (411)
Valitse hubin portti. Paina enteriä, jos haluat portiksi 411. Huomaa, että alle 1024 olevia portteja käytettäessä Verlihub on käynnistettävä järjestelmänvalvojan oikeuksin.
What will be your hub hostname? (xxx)
Kirjoita tähän hubin osoite, joka näkyy hubilistassa. Kirjoita myös portti perään, jos asetit edellisessä kohdassa jonkin muun portin kuin 411. Esimerkki: testi.no-ip.org:4111
Give me the name of your hub (hub of root)
Kirjoita hubin nimi.
-------------------------------- Hub: 'hub of root' url: 'dchub://testi.no-ip.org:4111:411' Master user: '[SU]root' Master's password: '1198589024' -------------------------------- Is this info correct ? (Y/N)
Kirjoita Y ja paina enteriä, jos tiedot ovat oikein. Kirjoita N, jos haluat muuttaa niitä.
FYI: settings are going to be created or updated /etc/verlihub /etc/verlihub /etc/verlihub will invoke the command class is 10 nick is [SU]root password is 1198589024 done
Hubin käynnistäminen
Jos hubiin on tarkoitus ottaa yli tuhat käyttäjää, muuta järjestelmän ulimit:
ulimit -n 20000
Käynnistä hubi komennolla
verlihub
Voit käyttää myös seuraavaa komentoa, jos haluat hubin pyörimään taustalle (daemonina). Tämä ei ole suositeltavaa käynnistettäessä ensimmäistä kertaa, koska et näe mahdollisia virheitä.
vh_runhub
Daemonina käynnistetyn hubin saa sammutettua komennolla
vh_runhub -s
Yhdistä tämän jälkeen hubiin. Laita osoitteeksi oma/palvelimen IP, jossa on mahdollinen hubin käyttämä portti perässä (jos hubi käyttää muuta porttia kuin 411). Jos hubi on samalla koneella, jolta koitat yhdistää sinne ja sinulla on NAT käytössä, laita osoitteeksi localhost ja mahdollinen portti perään.
Saat yhdistettäessä admineille privana lähetettävät ilmoitukset pois kirjoittamalla mainchatissa seuraavat komennot
!modtrigger +admin_reminder -c11 !modtrigger +news -c11 !modtrigger +updates -c11 !modtrigger +vh_donation -c11
Perusasetukset ja -komennot
Näet hubin asetukset kirjoittamalla mainchattiin komennon
!gc
Asetuksia muutetaan kirjoittamalla
!= ASETUS ARVO
Jakorajan asettaminen
!= min_share JAKORAJA
Korvaa JAKORAJA halutulla jakorajalla. Jakoraja on megatavuina, eli 1 Gt = 1024 Mt. Esim. komento != min_share 10240 asettaa jakorajaksi 10 gigaa.
Uusien käyttäjien rekisteröiminen tapahtuu komennolla
!rn NICK LUOKKA
Korvaa NICK käyttäjän nimimerkillä ja LUOKKA halutun luokan numerolla. Luokat ovat: 1=reg, 2=vip, 3=op, 4=cheef (hieman kuin SOP), 5=admin, 10=omistaja
Tarkemmat ohjeet komennoista löytyvät osoitteesta http://www.verlihub-project.org/doku.php?id=manual
Usean hubin pitäminen samalla koneella
Ohjelmaa ei tarvitse asentaa moneen kertaan, jos haluat tehdä toisen hubin samalle hubille. Määritä toisen hubin asetukset komennolla
vh_install
Muista asettaa eri tietokanta ja eri asetuskansio kuin toiselle hubille!
Käynnistä hubi tämän jälkeen alla olevalla komennolla (muuta oikea asetuskansio ja mahdollisesti ulimit)
VERLIHUB_CFG=/toisen/hubin/asetuskansio verlihub
tai daemonina
VERLIHUB_CFG=/toisen/hubin/asetuskansio vh_runhub
Samalla tavalla voit tehdä lisää hubeja.
Triggerit
!lsttrigger
Näyttää kaikki hubissa olevat triggerit.
!addtrigger +rules
Lisää valitun nimisen triggerin. Nimi toimii myös triggerin näyttämiseen vaadittavana komentona. Jos trigger on tarkoitettu käytettäväksi komentona nimen edessä on oltava + tai ! (vain operaattorit voivat käyttää ! alkavia komentoja). Oletuksena kaikki pystyvät käyttämään komentoa ja se lähetetään sitä käyttävälle käyttäjälle itselleen mainchatiin.
!modtrigger +rules -d %[CFG]/rules
Määrittää tekstitiedoston kohteen hubikoneella. Parametri %[CFG] tarkoittaa Verlihubin asetuskansiota. Voit laittaa tähän myös lähetettävän tekstin, mutta tällöin parametrilla -f pitää olla määritettynä 16.
!modtrigger +rules -h "Hubin säännöt"
Triggerin kuvaus. Kuvausta ei näytetä itse hubissa ollenkaan; se on ainoastaan tietokannassa.
!modtrigger +rules -n NIMIMERKKI
Lähettää tekstin määritellyllä nimimerkillä. Jos tätä ei aseteta, viesti lähetetään hubin botin nimellä.
!modtrigger +rules -c NUMERO
Matalin luokka, jossa oleville käyttäjille teksti lähetetään/jotka voivat käyttää komentoa.
!modtrigger +rules -C NUMERO
Suurin luokka, jossa oleville käyttäjille teksti lähetetään/jotka voivat käyttää komentoa.
!modtrigger +rules -f NUMERO
Määrittää triggerin ominaisuudet, kuten minne se lähetetään. Voit käyttää useampia ominaisuuksia laskemalla haluttujen kohtien numerot yhteen. Katso käytettävissä olevat numerot alta.
0 Teksti lähetetään mainchatiin (näytetään vain komentoa käyttäneelle)
1 Suorita komento
2 Teksti lähetetään yksityisviestinä
4 Lähetään automaattisesti, kun käyttäjä kirjautuu sisään
8 Teksti lähetetään komentoa +help/!help käytettäessä
16 parametri -d toimii näytettävän tekstinä
32 Mahdollistaa muuttujien käyttämisen tekstitiedostossa
64 Teksti lähetetään kaikille mainchatiin
Tekstissä käytettävät muuttujat (-f 32 pitää olla käytössä näitä käytettäessä)
%[CC] Käyttäjän maakoodi
%[IP] Käyttäjän IP-osoite
%[HOST] Käyttäjä host (toimii vain jos dns_lookup on 1)
%[USERS] Hubin käyttäjämäärä
%[USERSPEAK] Näyttää hubin käyttäjäennätyksen
%[UPTIME] Hubin päälläoloaika
%[VERSION] Verlihubin versio
%[VERSION_DATE] Käytettävän Verlihubin version julkaisupäivämäärä
%[HUBNAME] Hubin nimi
%[NICK] Käyttäjän nimimerkki
%[SHARE] Käyttäjän jakomäärä
%[TOTAL_SHARE] Hubin kokonaisjakomäärä
Pluginit
Saatavilla olevat pluginit
lua
- Mahdollistaa lua-scriptien käyttämisen.
forbid
- Voit estää haluamiesi sanojen lähettämise mainchattiin tai yksityisviesteissä
chatroom
- Voit lisätä chathuoneita.
iplog
- Kirjaa kaikki käyttäjien IP:t lokitiedostoihin. Käyttää paljon resursseja suuressa hubissa.
floodprot
- Auttaa hubin suojaamisessa floodaamiselta.
stats
- Kirjaa mm. kaistankäytön ja käyttäjämääriä. Lisää resurssienkäyttöä suuressa hubissa.
messanger
- Käyttäjät voivat lähettää viestejä muille käyttäjille, jotka eivät ole hubissa.
python
- Mahdollistaa python-scriptien käyttämisen.
replacer
- Korvaa halutut sanat asetetuilla.
funny
- Muuttaa mainchatiin lähetettyjä sanoja.
Pluginien lataaminen
Tässä ohjeessa käsitellään myöhempänä LUA- ja Forbid-pluginien lataaminen. Muiden pluginien latausosoitteet löytyvät osoitteesta http://www.verlihub-project.org/doku.php?id=download
Asentaminen
Aja jokaisen pluginin kansiossa seuraavat komennot
./configure make make install
HUOM!
Jos verlihub päivitetään tai asennetaan uudestaan, myös kaikki pluginit on asennettava uudestaan.
Pluginien käynnistäminen Verlihubissa
Näet kaikki käynnissä olevat pluginit kirjoittamalla hubissa
!pluglist all
Voit käynnistää yksittäisen pluginin niin, että se käynnistyy aina Verlihubin käynnistämisen yhteydessä komennolla
!onplug PLUGIN
Korvaa PLUGIN pluginin nimellä. Pluginien nimet saat selville listasta, jonka näet komennolla
!lstplug
LUA-plugin
Ennen LUA-pluginin asentamista järjestelmässä pitää olla LUA asennettuna. Asentaminen onnistuu alla olevalla komennolla (LUA 5.1):
apt-get install liblua5.1-socket-dev liblua5.1-socket2 lua5.1 liblua5.1-0-dev
Mene kansioon, jonne haluat ladata pluginin ja lataa se komennolla:
git clone git://verlihub.git.sourceforge.net/gitroot/verlihub/lua
Siirry lua-kansioon ja aja seuraavat komennot
cd lua ./configure make make install
Lataa plugin tämän jälkeen hubissa kirjoittamalla komento
!onplug lua
Käytettävät scriptit laitetaan Verlihubin asetuskansiossa olevaan scripts-kansioon (oletuksena /etc/verlihub/scripts). Scripti ladataan tämän jälkeen hubin kautta komennolla
!luaload /etc/verlihub/scripts/SCRIPTITIEDOSTON_NIMI
Vaihda tarvittaessa scriptin sijaintipolku.
Esim. !luaload /etc/verlihub/scripts/log.lua
Scriptejä voi ladata Verlihubin sivuilta osoitteesta http://forums.verlihub-project.org/viewforum.php?f=14 tai foorumista osoitteesta http://forums.verlihub-project.org/viewforum.php?f=14
Forbid-plugin
Lataaminen ja asentaminen
Mene kansioon, jonne haluat ladata pluginin ja lataa se komennolla:
wget http://downloads.sourceforge.net/verlihub/forbid-1.3.tar.gz
Pura paketti komennolla
tar zxvf forbid-1.3.tar.gz
Siirry forbid-kansioon ja asenna plugin ajamalla seuraavat komennot
cd forbid ./configure make make install
Lataa plugin tämän jälkeen hubissa komennolla
!onplug forbid
Forbidin käyttäminen
Tämän jälkeen voit lisätä kielletyn sanan komennolla
!addforbid SANA
Voit asettaa luokan, josta lähtien sanaa voi käyttää
!modforbid SANA -C 1
Tällä esimerkillä sana on kielletty vain rekisteröitymättömiltä käyttäjiltä.
Kielletyn sanan kirjoittaja voidaan asettaa potkittavaksi seuraavalla komennolla
!modforbid SANA -r "kielletty sana!"
Voit kirjoittaa syyhyn myös bannin ajan (esim. _BAN_60s)
Kiellettyä kohdetta (mainchat/yksityisviesti) ja ilmoitusta opchatiin pystyy muokkaamaan komennolla
!modforbid SANA -f NUMERO
jossa numero on jokin seuraavista
1 = kielletty mainchatissa, 2 = kielletty yksityisviestissä, 4 = lähettää ilmoituksen opchatiin
Useita toimintoja saa käyttöön laskemalla lukuja yhteen, esim. numero 7 (1+2+4) estää sanan lähettämisen mainchatissa ja yksityisviesteissä sekä lähettää lisäksi ilmoituksen opchattiin.
Hubin siirtäminen toiselle koneelle
Näiden ohjeiden mukaan tehtynä phpMyAdminin on oltava asennettuna molemmilla koneilla (katso asentaminen ohjeiden alusta). Tee seuraava ennen ohjelman asentamista uudelle koneelle.
Mene ensin phpMyAdminiin koneella, jolta asetukset siirretään ja valitse vasemmalla olevasta luettelosta Verlihubin tietokanta (esim. verlihub). Paina tämän jälkeen ylävalikosta painiketta Vienti (Export). Kicklist ja Banlist voivat aiheuttaa ongelmia mahdollisen suuren kokonsa takia, joten niiden valinnan voi halutessaan poistaa napsauttamalla tauluja luettelossa Ctrl pohjassa. Napsauta tämän jälkeen Siirry-painiketta. Tietokanta latautuu koneelle sql-tiedostona. Jos hubin asetuksissa on määritetty kohdan listen_ip arvoksi muu kuin 0.0.0.0, sen muuttaminen voi olla tarpeellista, jos toisella koneella on eri IP. Muussa tapauksessa hubi ei käynnisty. Kohdan voi etsiä ja muuttaa avaamalla sql-tiedoston tekstieditorissa.
Mene tämän jälkeen toisen palvelimen phpMyAdminiin ja tee sinne uusi tietokanta (onnistuu etusivulla). Napsauta tämän jälkeen ylävalikosta SQL-painiketta ja liitä toiselta palvelimelta otettu teksti ruutuun. Napsauta Siirry.
Lataa ja asenna tämän jälkeen Verlihub. Muista vh_install-scriptiä käytettäessä antaa tietokannalle sama nimi kuin sille, johon veit tiedot phpMyAdminissa.
Huom! Keskeytä scripti näppäinyhdistelmällä Ctrl+C, kun se kysyy hubin omistajan nimimerkkiä. Näiden tietojen antaminen on tarpeetonta, koska ne ovat jo tietokannassa ja niiden syöttäminen uudestaan voi sekoittaa porttiasetukset (jos annetaan eri portti kuin ennen oli).
Linkkejä
Hubin lisääminen hubilistoihin
Chat-tilastot Aquilaan ja Verlihubiin
http://www.verlihub-project.org/doku.php?id=manual
- Käyttöohjeet englanniksi
http://www.verlihub-project.org/doku.php?id=lua
- Lua-scriptejä
http://forums.verlihub-project.org/viewforum.php?f=14
- Lisää lua-scriptejä
http://vhcp.verlihub-project.org
- Web-hallinta
