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.
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-5.0 mysql-client-5.0 libmysqlclient15-dev apache2 make libgeoip-dev libssl-dev cvs
phpMyAdmin mahdollistaa asetusten muokkaamisen nettiselaimella vaikka Verlihub ei olisikaan käynnissä.
Lataa paketit
apt-get install libapache2-mod-php5 phpmyadmin apache2 php5
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
Tietoturvasyistä on suositeltavaa poistaa MySQL:n kaksi käyttäjää sekä asettaa salasanat root-käyttäjille.
Katso oman koneen hostname seuraavalla komennolla (sitä tarvitaan kohta)
hostname
Mene tämän jälkeen MySQL:ään
mysql -u root
Poista ylimääräiset käyttäjät ajamalla seuraavat komennot MySQL:ssä
DELETE FROM mysql.user WHERE User = ; FLUSH PRIVILEGES;
Aseta seuraavaksi root-käyttäjien salasanat. Korvaa lauseiden kohta oma_salasana haluamallasi salasanalla. Molemmilla käyttäjillä voi olla sama salasana, mutta vain ensimmäisen lauseen salasanaa tarvitaan myöhemmin näissä ohjeissa. Korvaa toisen lauseen kohta hostname sanalla, jonka sait aiemmin käyttämällä komentoa hostname.
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('oma_salasana');
SET PASSWORD FOR 'root'@'hostname' = PASSWORD('oma_salasana');
Poistu MySQL:stä:
quit
Tarkista ensin uusin versio osoitteesta [http://www.verlihub-project.org/doku.php?id=download] ja vaihda se tarvittaessa latauskomentoon!
Lataa verlihub kansioon, jonne haluat sen purkaa
wget http://www.verlihub-project.org/download/verlihub-0.9.8e-r2.tar.bz2
Pura paketti (vaihda tarvittaessa tiedoston nimi)
tar jxvf verlihub-0.9.8e-r2.tar.bz2
Asenna ohjelma seuraavilla komennoilla. Jos asentaessa tulee ongelmia, joita et saa ratkaistua, voit laittaa viestiä keskustelualueelle.
cd verlihub ./configure make make install
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
-------------------------------- 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
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
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.
!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ä 32.
!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ä
Lataa plugin(it) seuraavalla komennolla. Korvaa PLUGININ_NIMI/NIMET yhdellä tai useammalla alta löytyvällä pluginin nimellä. Erottele useat pluginit välilyönnillä.
cvs -z1 -d:pserver:anonymous@verlihub.cvs.sf.net:/cvsroot/verlihub co PLUGININ_NIMI/NIMET
Ennen LUA-pluginin asentamista järjestelmässä pitää olla LUA asennettuna. Asentaminen onnistuu alla olevalla komennolla (LUA 5.0.3):
wget http://ftp.gwdg.de/pub/languages/lua/lua-5.0.3.tar.gz && tar zxvf lua-5.0.3.tar.gz && cd lua-5.0.3 && ./configure && make install && cd ..
Lataa plugin:
cvs -z1 -d:pserver:anonymous@verlihub.cvs.sf.net:/cvsroot/verlihub co -D 2005-07-03 lua
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.
lua
forbid
chatroom
iplog
floodprot
stats
messanger
python
replacer
funny
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
Lataa ja asenna plugin ensin edellisen osion ohjeiden mukaan sekä käynnistä se Verlihubissa.
Lisää kielletty sana 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 ja ilmoitusta opchatiin pystyy muokkaamaan komennolla
!modforbid SANA -f NUMERO
jossa numero on jokin seuraavista
1 = kielletty mainchatissa, 2 = kielletty yksityisviestissä, 3 = kielletty molemmissa, 4 = lähettää ilmoituksen opchatiin, 5 = kielletty molemmissa ja ilmoitus opchatiin.
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. Kopioi teksti ruudusta ja tallenna se halutessasi tekstitiedostoon. 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.
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, jonka teit myadminissa.
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).
Hubin lisääminen hubilistoihin
Chat-tilastot Aquilaan ja Verlihubiin
http://www.verlihub-project.org/doku.php?id=manual
http://www.verlihub-project.org/doku.php?id=lua
http://vhcp.verlihub-project.org