Aquilan asennus- ja käyttöohjeet Linuxiin

Ohjeet toimivat suoraan Debianille ja Ubuntulle. Muut joutuvat käyttämään eri komentoja ainakin pakettien lataamiseen. Koneessa, johon Aquila asennetaan, kannattaa olla 2.6 kernel. Asennus on myös mahdollista 2.4 kerneliä käyttävälle koneelle, mutta silloin saattaa tulla ongelmia suuremmilla käyttäjämäärillä (<1000). Jos etäkäytät palvelinta, jolle asennat Verlihubin Puttyllä, voit liittää ohjeen komennot hiiren oikealla painikkeella.

Ohjeet Aquilan asentamiseen Windowsille löytyy sivulta Aquilan asennus- ja käyttöohjeet Windowsiin. Muista myös ohjeet chat-tilastojen tekemiseen sivulla Chat-tilastot Aquilaan ja Verlihubiin.

Tarvittavien pakettien lataaminen ja asentaminen

Tarvittavien pakettien lataaminen apt-get:llä

Varmista ensin, että olet kirjautunut järjestelmänvalvojan oikeuksin kirjoittamalla seuraava komento

su

Päivitä pakettiluettelot, jotta kaikki paketit löytyvät

apt-get update

Asenna tämän jälkeen paketit alla olevalla komennolla

apt-get install gcc g++ make zlib1g-dev nano libgeoip-dev bzip2 libreadline5-dev mcrypt psmisc

Siirry kansioon, jonne haluat asentaa ohjelman, esim. /home

cd /home

LUA:n asentaminen

Versio 5.1.4

wget http://www.lua.org/ftp/lua-5.1.4.tar.gz && tar zxvf lua-5.1.4.tar.gz && cd lua-5.1.4 && make linux install && cd ..

Versio 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 ..

Aquilan lataaminen ja kääntäminen

Aja nämä komennot

wget files.adrenaline-network.com/aquila/aquila-0.1.11-pre2-beta2.tar.bz2

tar jxvf aquila-0.1.11-pre2-beta2.tar.bz2

cd aquila-0.1.11-pre2-beta2

./configure

make install

Suomennos

Aquilan mukana tulee tiedostot, joissa vain operaattoreille lähetettävät viestit on käännetty suomeksi, jossa myös confighelpin ohjeita on täydennetty ja selkeytetty. Suomennos toimii vain mikäli käyttöjärjestelmän kielenä on suomi. Jos kielenä on tällä hetkellä joku muu kieli, tee seuraavat:

Aja komento

dpkg-reconfigure locales

Valitse listasta haluamasi fi_FI -alkuiset kohdat (spacella). Seuraavassa ruudussa valitse oletukseksi jokin fi_FI-kohta.

Muokkaa myös tätä tiedostoa, jotta kielen valinta säilyy:

nano /etc/environment

Tiedoston tulisi näyttää tältä:

LANG=fi_FI

Tallenna (Ctrl+O) ja sulje (Ctrl+X) tiedosto. Testaa toimivuus esim. komennolla apt-get update ja katso tuleeko tekstit suomeksi.

Asetuskansion luominen

Asetuskansioon tallentuvat kaikki hubin asetustiedostot. Hubi käynnistetään aina kyseisestä kansiosta ja asetuskansioita voi luoda myös monta useamman hubin pitämistä varten. Näissä ohjeissa asetuskansioksi tehdään /home/aquila, mutta kansion voi laittaa minne tahansa ja nimen päättää itse.

Kansion luodaan komennolla

mkdir /home/aquila

Käynnistysscriptin lataaminen

Tämän scripin avulla hubin voi käynnistää ja sammuttaa helposti, sekä hubin saa käynnistymään automaattisesti palvelimen käynnistämisen yhteydessä.

Mene /etc/init.d -kansioon ja lataa scripti:

cd /etc/init.d
wget http://files.adrenaline-network.com/aquila/initscript/aquila

Muokkaa tiedostossa olevan rivin "/usr/local/bin/aquila -c /home/aquila -d" loppuosaan tarvittaessa hubin asetuskansio, jos se on eri kuin /home/aquila. Älä avaa tiedostoa, jos asetuskansiota ei tarvitse muuttaa! Scriptin muokkaaminen tapahtuu komennolla:

nano aquila

Tallenna tiedosto muokkaamisen jälkeen näppäinyhdistelmällä Ctrl+O ja sulje se (Ctrl+X).

Lisää tiedostolle tämän jälkeen suoritusoikeus:

chmod +x aquila

Lopuksi hubin voi vielä lisätä käynnistymään automaattisesti palvelimen käynnistämisen yhteydessä:

update-rc.d aquila defaults

Hubin asetukset ennen käynnistämistä

Mene ensin hubin asetuskansioon:

cd /home/aquila

Mikäli portti 411 on jo käytössä tai et halua käyttää sitä, niin muuta hubin käyttämä portti asetuksista esim. nanolla

Avaa tiedosto:

nano /home/aquila/hub.conf

ja lisää tämä rivi (tai muokkaa, jos tiedostossa on jo tekstiä)

nmdc.listenport 

Esimerkiksi:

nmdc.listenport 4111

(jos hubi suoritetaan tavallisena käyttäjänä niin alle 1024 olevat portit eivät toimi ilman uudelleenohjausta)

Tallenna tiedosto painamalla ctrl+o ja sammuta nano painamalla ctrl+x. Muita hubin käyttämiä portteja voit lisätä myöhemmin kun hubi on käynnissä.

Seuraavaksi hubiin täytyy luoda omistajan käyttäjätunnus, jolla yhdistät hubiin DC:ssä. Aja seuraavat komennot:

aqpasswd /home/aquila/accounts.conf NICK SALASANA

Korvaa loppuun nick ja salasana.

Hubin käynnistäminen

Käynnistysscriptin kanssa

Käynnistäminen tapahtuu käynnistysscriptin kanssa seuraavalla komennolla

/etc/init.d/aquila start

Tämän jälkeen Aquila on käynnissä ja voit mennä hubiin rekisteröimälläsi nimimerkillä. Yhdistä koneen IP:llä, 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.

Hubin voi sammuttaa kirjoittamalla

/etc/init.d/aquila stop

Jos hubi ilmoittaa olevansa täynnä, koitat yhdistää hubiin muulla kuin rekisteröidyllä nimimerkillä tai käyttäjätiliä ei ole luotu oikein. Tämä tapahtuu myös, jos käynnistysscriptiin on määritetty väärä asetuskansio. Jos yhdistämisessä on jotain muuta ongelmaa, hubin käyttämä portti on jo todennäköisesti käytössä. Sammuta tällöin hubi ja tarkista asetukset.

Ilman käynnistysscriptiä

Jos aiot ottaa hubiin yli tuhat käyttäjää, joudut muuttamaan järjestelmän ulimitin ennen hubin käynnistämistä komennolla

ulimit -n 20000

Käynnistä hubi seuraavalla komennolla

aquila -d

Tämän jälkeen Aquila on käynnissä ja voit mennä hubiin rekisteröimälläsi nimimerkillä. Yhdistä koneen IP:llä, 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.

Jos hubi ilmoittaa olevansa täynnä, koitat yhdistää hubiin muulla kuin rekisteröidyllä nimimerkillä tai käyttäjätiliä ei ole luotu oikein. Tämä tapahtuu myös kun koitat käynnistää hubia väärästä kansiosta. Jos yhdistämisessä on jotain muuta ongelmaa, hubin käyttämä portti on jo todennäköisesti käytössä tai hubi käyttää porttia, joka on alle 1024, etkä ole käynnistänyt hubia root-oikeuksin. Sammuta hubi tässä tapauksessa komennolla

pkill aquila

ja muuta porttia (selostettu tämän osion alussa) tai käynnistä hubi root-oikeuksin.

Kaksi tai useampi Aquila samalla koneella

Tee asetuskansio toiselle Aquilalle mkdir-komennolla, esim:

mkdir /home/aquila2

Mene tämän jälkeen juuri luomaasi kansioon ja muuta tarvittaessa hubin käyttämä portti hub.conf-tiedostossa. Jos Aquila ajetaan jollain muulla kuin root-käyttäjällä, muuta tiedoston oikeudet chmod-komennolla. Luo tällöin myös tyhjä Aquila.xml-tiedosto ja aseta oikeudet. Luo owner-käyttäjä seuraavalla komennolla (muuta polku, nick ja salasana):

 aqpasswd /home/aquila2/accounts.conf NICK SALASANA

Muuta tarvittaessa myös tämän tiedoston oikeudet. Käynnistä tämän jälkeen hubi komennolla

aquila -d

Käynnistysscripti toimii oikein vain yhdelle hubille. Jos haluat käyttää scriptiä toisenkin hubin käynnistämiseen, niin tee scriptistä kopio eri nimellä /etc/init.d -kansioon ja muokkaa oikea asetuskansio. Jos hubi koitetaan sammuttaa millä tahansa sciptillä, niin kaikki palvelimella olevat Aquilat sammuvat.

Asetukset lyhyesti

Näet kaikki komennot kirjoittamalla +help mainchatiin. Hubin nykyiset asetukset saat kirjoittamalla +configshow ja ohjeet asetusten tekemiseen komennolla +confighelp. Asetuksia muutetaan komennolla !configset asetus arvo tai != asetus arvo.

Hubin käyttäjäraja rekistymättömille pitää muuttaa, jotta he pääsisivät hubiin. Se onnistuu komennolla

!= userlimit.unregistered HALUAMASI_LUKU

Hubin osoitteen asettaminen (esim. no-ip:seen rekisteröity). Älä laita porttia perään!

!= hubaddress HALUAMASI_OSOITE

HUOM!!!! Hubin nimi ja kuvaus pitää laittaa "-merkkien väliin, mikäli niissä on useampia sanoja. Esimerkki: "Oma hubi".

Hubin nimi

!= hubname HALUAMASI NIMI

Hubin kuvaus, joka näkyy hubilistassa

!= hubdescription HALUAMASI_KUVAUS

Hubin käyttämät portit

Seuraava portti näkyy hubilistassa osoitteen perässä

!= nmdc.listenport HALUAMASI_PORTTI

Muut portit, joilla hubiin pääsee (erottele spacella, jos useampia niin laita " " väliin)

!= nmdc.extraports HALUAMASI_PORTTI/PORTIT

Jakoraja (rekisteröitymättömille) esim.

1GB:

!= sharemin.unregistered 1g

100MB:

!= sharemin.unregistered 100m

Tallenna asetukset komennolla !save. Asetukset tallentuvat myös automaattisesti hubisoftassa asetetun ajan välein. Ennen sammuttamista asetukset kannattaa kuitenkin tallentaa itse.

Motd, Triggerit, Chatroom, LUA

Motd

Tee ensin tekstitiedosto johonkin kansioon. Tässä esimerkissä kyseinen kansio on /home/aquila/motd

Lisää trigger komennolla !triggeradd

Esimerkiksi:

!triggeradd motd file /home/aquila/motd

eli !triggeradd nimi file tiedoston_nimi

Tee sen jälkeen sääntö triggerin käyttöön. Esimerkissä motd lähetetään kaikille, jotka pystyvät lähtettämään viestejä mainchattiin.

!ruleadd motd login chat

eli siis !ruleadd triggerin_nimi login oikeudet

Testaa tämän jälkeen motdin toimivuus yhdistämällä hubiin uudestaan.

Käyttäjälle itselleen lähetettävät tekstit (triggerit)

Esimerkkinä tehdään hubin säännöt. Tee ensin trigger, kuten edellisessäkin kohdassa, komennolla !triggeradd.

!triggeradd rules file /home/aquila/rules

Tee seuraavaksi sääntö

!ruleadd rules command rules "Näytä säännöt" dl

Eli !ruleadd triggerin_nimi command käytettävä_komento "kuvaus_+help-komentoon" vaadittavat_oikeudet

Muita sääntötyyppejä saa kirjoittamalla pelkästään !ruleadd

LUA

Scriptejä löydät ainakin seuraavilta sivuilta:

LUA5: http://files.adrenaline-network.com/aquila/scriptit/_lua5.0

LUA 5.1.x: http://files.adrenaline-network.com/aquila/scriptit_lua5.1

http://aquiladc.sourceforge.net/forum/viewforum.php?f=10

Lataa scriptit Aquilan asetuskansioon. Huomaa, että forbid-scriptiä käytettäessä asetuskansiossa on oltava scripts-kansio ja siellä scripti libsimplepickle.lua. Lisäksi joudut luomaan sinne tiedoston forbid.settings.txt.

Jos haluat saada scriptit latautumaan automaattisesti, tee lua.conf-tiedosto (jos sitä ei vielä ole) ja lisää sinne scriptien nimet. Esim:

topic.lua
forbid.lua
regme.lua

Scriptin käynnistäminen:

!luaload tiedosto

Esimerkiksi !luaload topic.lua

Jos hubi ilmoittaa, että komentoa ei löydy, LUA ei ole asennettu oikein.

Scriptin pysäyttäminen:

!luaremove tiedosto

Katso käynnissä olevat scriptit:

!luastat

Chatroom

Tässä esimerkissä luodaan OpChat.

!chatroomadd OpChat "Chatroom for operators" private autorights rights key

( !chatroomadd huoneen_nimi "huoneen kuvaus" private autorights vaadittava_oikeus )

Tämän jälkeen voi olla hyvä laittaa käyttäjien raportit tulemaan op-chattiin, joka onnistuu seuraavalla komennolla (vaihda chathuoneen nimi tarvittaessa)

!= reporttarget Opchat

Hubin siirtäminen toiselle koneelle ja varmuuskopioiden ottaminen asetuksista

Vanhalla palvelimella suoritettavat vaiheet

Jos Aquilan asetuskansio on /home/aquila, siirry ensin /home-kansioon:

cd /home

Pakkaa Aquilan kansio seuraavalla komennolla. Muuta tarvittaessa asetuskansion nimi (aquila).

tar czvf asetuskansio.tar.gz aquila

Jos haluat vain tehdä asetuksista varmuuskopion, siirrä paketti sen sijaan omalle koneelle. Tämä onnistuu esim. Filezilla-ohjelmalla. Laita tyypiksi SFTP, kun lisäät palvelinta ohjelmaan.

Jos kuitenkin siirrät asetukset suoraan uudelle palvemimelle, tee siirto käyttämällä seuraavaa komentoa:

scp asetuskansio.tar.gz root@KORVAATÄMÄUUDENKONEENOSOITTEELLA:/home

Korvaa komennossa kohta "KORVAATÄMÄUUDENKONEENOSOITTEELLA" sen palvelimen (IP-)osoitteella, jonne haluat asetukset siirtää (älä poista perässä olevaa kaksoispistettä). RSA-avain on alussa hyväksyttävä kirjoittamalla 'yes' ja tämän jälkeen pyydetään antamaan kohdepalvelimen root-käyttäjän salasana. Jos kaikki menee oikein, paketin pitäisi löytyä uuden palvelimen /home-kansiosta.

Uudella palvelimella suoritettavat vaiheet

Asenna ensin Aquila tämän ohjeen mukaisesti. Älä kuitenkaan luo asetuskansiota tai käynnistä hubia! Tee alla kuvatut toimenpiteet, kun olet kohdassa Hubin käynnistäminen.

Pura siirretty asetuspaketti uuden palvelimen /home-kansiossa. Siirry ensin /home-kansioon:

cd /home

Pura paketti komennolla

tar zxvf asetuskansio.tar.gz

Tämän jälkeen voit käynnistää hubin normaalisti käynnistyscriptillä. Muokkaa tarvittaessa Aquila.xml-tiedostoa, jos joudut muuttamaan hubin käyttämiä portteja ennen käynnistämistä. Muokkaa tiedostoa myös siinä tapauksessa, jos olet määrittänyt vanhan palvelimen IP-osoitteen kohtaan "nmdc.listenaddress", koska muutoin hubi ei käynnisty. Haun saa käyttöön nanossa näppäinyhdistelmällä Ctrl+W.

Linkkejä

Hubin lisääminen hubilistoihin

Chat-tilastot Aquilaan ja Verlihubiin.

http://aquiladc.sourceforge.net

• Aquilan kotisivut

http://aquiladc.sourceforge.net/wiki/index.php/Manual

• Käyttöohje englanniksi, jossa on esim. selitetty kaikki komennot

http://aquiladc.sourceforge.net/forum/viewforum.php?f=10

• Scriptejä Aquilaan

http://www.adrenaline-network.com/index.php?page=16

• Ohjeet MRTG:n asentamiseen, joka näyttää nettisivulla monipuoliset tilastot mm. palvelimen resurssienkäytöstä sekä Aquila-hubin käyttäjämäärän sekä Aquilan käyttämän muistin.

Jos näistä ohjeista tai Aquilasta on kysyttävää, käytä tämän wikin keskustelualuetta.