Muokataan sivua 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 [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html 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

=== 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



== Linkkejä ==


[[Oman hubin pitäminen#Hubin lisääminen hubilistoihin|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.