P2P wiki - Ohjeet mm. DC++:lle ja UTorrentille - Käyttäjän muokkaukset [fi]

Aquilan asennus- ja käyttöohjeet Linuxiin

2010-03-09T21:42:07Z

89.27.4.30:

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

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

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. Scriptin muokkaaminen tapahtuu komennolla:

nano aquila

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.

Verlihubin asennus- ja käyttöohjeet

2010-02-05T18:56:16Z

89.27.4.30: /* Verlihubin lataaminen ja asentaminen */

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 [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html 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-5.0 mysql-client-5.0 libmysqlclient15-dev apache2 make libgeoip-dev libssl-dev cvs

== phpMyAdminin asentaminen (ei pakollinen) ==

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

== MySQL:an asettaminen ==

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

== Verlihubin lataaminen ja asentaminen ==

Tarkista ensin uusin versio osoitteesta [[http://www.verlihub-project.org/doku.php?id=download 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

== Hubin asetukset ==

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

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

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

== Pluginit ==

=== Lataaminen (muut paitsi LUA-plugin) ===

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

=== LUA-pluginin lataaminen ja purkaminen ===

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

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

=== 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 pysthon-scriptien käyttämisen.

replacer

* Korvaa halutut sanat asetetuilla.

funny

* Muuttaa mainchatiin lähetettyjä sanoja.

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

== Forbid-plugin ==

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.

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

== Linkkejä ==

[[Oman hubin pitäminen#Hubin lisääminen hubilistoihin|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://vhcp.verlihub-project.org
* Web-hallinta

Hubilistat

2010-01-19T14:08:49Z

89.27.4.30:

Sivulla on tarkoitus olla vain toimivia hubilistoja.

== Listojen lisääminen / Adding the lists ==

'''Finnish'''

Katso ohjeet [[Julkisten hubien lista (Public hubs)#Asetetut hubilistat (Configured hub lists)|täältä]].

'''English'''

Adding: Public hubs ---> Configure ---> Add

Note: When you add a hublist in your client, check that you don't have spaces before or after the address. It will prevent the list from loading.

== Osoitteet / Addresses ==

'''http://hublist.openhublist.org/hublist.xml.bz2'''

* ~ 1200 hubia, päivittyy usein, näyttää sekä [[NMDC]]- että [[ADC]]-hubit, näyttää kaikkien sarakkeiden tiedot, kotisivu http://www.openhublist.org

* ~ 1200 hubs, is being updated often, shows both NMDC and ADC hubs, displays the info for all columns, homepage http://www.openhublist.org

'''http://list.hublist.nu/PublicHublist.config'''

* 700+ hubia, päivittyy usein.

* 700+ hubs, is being updated often.

'''http://xmllist.publichublist.nl'''

* ~ 2000 hubia, päivittyy melko usein, näyttää hubien maat ja kokonaisjaot, kotisivu http://www.publichublist.nl

* ~ 2000 hubs, is being updated quite often, show's hubs countries, limits and total shares, homepage http://www.publichublist.nl

'''http://www.hublist.awenet.info/PublicHubList.xml.bz2'''

* 2000+ hubia, päivittyy harvoin, näyttää hubien maat, kaikki rajat, kokonaisjaot sekä luotettavuuden.

* 2000+ hubs, is being updated seldom, displays the countries of the hubs, all limits, total shares and the reliability.

'''http://dchublist.com/hublist.xml.bz2'''

* ~ 3000 hubia, päivittyy melko harvoin, näyttää hubien maat, jakorajan, hubirajan sekä max käyttäjät, kotisivu http://www.dchublist.com

* ~ 3000 hubs, is being updated seldom, displays the countries of the hubs, min share, max hubs and max users, homepage http://www.dchublist.com

'''http://www.hublist.co.uk/hublist.xml.bz2'''

* ~ 1000 hubia, päivittyy usein, näyttää hubien maat, kotisivu http://www.hublist.co.uk

* ~ 1000 hubs, is being updated often, displays the countries of the hubs, homepage http://www.hublist.co.uk

'''http://hublist.te-home.net/all-hublist.xml.bz2'''

* 2200+ hubia (samat hubit moneen kertaan), päivittyy melkein reaaliajassa, näyttää vain sen hetken online hubit, yli 10 000 hubia tietokannassa, kotisivu http://hublist.te-home.net/

* HUBEJA JOKA MAASTA

* 2200+ hubs (many duplicate hubs), is updated almost in realtime, shows only current online hubs, over 10 000 hubs in database, homepage http://hublist.te-home.net/

* HUBS FROM ALL COUNTRIES

'''http://hublist.te-home.net/fi-hublist.xml.bz2'''

* 200+ hubia, päivittyy melkein reaaliajassa, näyttää vain sen hetken online hubit, yli 10 000 hubia tietokannassa, kotisivu http://hublist.te-home.net/

* VAIN SUOMALAISIA HUBEJA

* 200+ hubs, is updated almost in realtime, shows only current online hubs, over 10 000 hubs in database, homepage http://hublist.te-home.net/

* ONLY FINNISH HUBS

[[Category:DC]]

<meta name="description" content="Toimivia hubilistoja DC++:aan, listojen kuvaukset, ohjeet hubilistojen lisäämiseen, DC++ hublist, instructions for adding hublists"></meta>

ADC

2010-01-19T14:02:47Z

89.27.4.30:

ADC on [[NMDC]]:n seuraajaksi tarkoitettu protokolla. ADC-hubeihin yhdistettäessä osoitteen edessä on aina oltava adc:// (josta ADC-hubit erottaa muista) sekä hubin portti on määritettävä. ADC-hubejä on tällä hetkellä vain kymmeniä, mutta ne yleistyvät todennäköisesti tulevaisuudessa. Oman ADC-hubin pitämistä harkitsevat voivat käyttää [[DSHub]]ia (kehittynein) tai [[adchpp]]:tä (erittäin vaikea käyttöönotto sekä vain muutamia ominaisuuksia).

== Tavallisille käyttäjille näkyviä uusia ominaisuuksia ==

* Käyttäjät voidaan rekisteröidä CID:n perusteella, jota ei voi huijata. Tällöin salasanat eivät ole välttämättömiä. CID luodaan automaattisesti clientkohtaisesti PID:n perusteella. PID on määritettävissä asetusten [[Vain edistyneille (Experts only)]] -osiosta, joten jos kahteen clientiin laittaa saman PID:n, myös CID on sama ja ADC-hubien tunnukset toimivat molemmissa. Tämän vuoksi omaa PID:tä ei pidä antaa muille!

* Turvallisempi. Salasanat lähetetään salattuina. ADCS mahdollistaa datan siirtämisen käyttäjien ja hubien välillä salattuna sekä sertifikaattien käytön. Tiedostosiirrot voidaan suorittaa salattuina myös tavallisissa ADC-hubeissa, jolloin internetoperaattorin mahdolliset p2p-liikenteen hidastamiset eivät vaikuta nopeuksiin.

* Clientin tekemät automaattihaut erotetaan manuaalisesti tehdyistä, jolloin molemmille voidaan säätää eri rajoitukset, jolloin automaattihaut eivät häiritse tavallista hakemista.

* Nickiä pystyy vaihtamaan ilman uudelleenyhdistämistä hubiin.

* Hubikohtaiset jaot (tulevaisuudessa)

== Huonot puolet ==

* Bugeja (esim. haussa käyttäjien slotit näkyvät <vapaat slotit>/0, ongelmia käyttäjäkomennoissa..).

* ADC-hubien osoitteet eivät ole yhteensopivia NMDC-osoitteiden kanssa.

* Keskeneräiset hubiohjelmistot. Esimerkiksi missään ei toimi uudelleenohjaus ja toimintoja on muutenkin hyvin vähän.

* ADC-protokollasta on eri versioita, jonka takia vain uusinta käyttävät clientit (core 0.691 tai uudempi) pääsevät ADC-hubeihin. Vanhemmat versiot jäävät hubiin jumiin saaden viestejä connecting - connected - disconnected - connecting jne. eivätkä ohjaudu muualle. Ongelma saattaa korjautua uusissa hubisoftissa.

* ADC-hubit on listattuina vain kahdessa hubilistassa ([http://www.openhublist.org Openhublist.org] ja [http://www.dchublist.com DCHublist.com]). Tarkempia tietoja hubilistoista löytyy [[Hubilistat]]-sivulta

[[Category:DC]]

Aquilan asennus- ja käyttöohjeet Linuxiin

2010-01-15T12:54:13Z

89.27.4.30:

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

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

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

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. Scriptin muokkaaminen tapahtuu komennolla:

nano aquila

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.

Verlihubin asennus- ja käyttöohjeet

2010-01-14T20:47:55Z

89.27.4.30:

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 [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html 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-5.0 mysql-client-5.0 libmysqlclient15-dev apache2 make libgeoip-dev libssl-dev cvs

== phpMyAdminin asentaminen (ei pakollinen) ==

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

== MySQL:an asettaminen ==

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

== Verlihubin lataaminen ja asentaminen ==

Tarkista ensin uusin versio osoitteesta [[http://www.verlihub-project.org/doku.php?id=download 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 zxvf 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

== Hubin asetukset ==

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

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

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

== Pluginit ==

=== Lataaminen (muut paitsi LUA-plugin) ===

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

=== LUA-pluginin lataaminen ja purkaminen ===

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

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

=== 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 pysthon-scriptien käyttämisen.

replacer

* Korvaa halutut sanat asetetuilla.

funny

* Muuttaa mainchatiin lähetettyjä sanoja.

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

== Forbid-plugin ==

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.

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

== Linkkejä ==

[[Oman hubin pitäminen#Hubin lisääminen hubilistoihin|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://vhcp.verlihub-project.org
* Web-hallinta

Aquilan asennus- ja käyttöohjeet Linuxiin

2010-01-14T20:43:42Z

89.27.4.30:

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

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

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

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ä. HUOM! Scripti toimii vain yhdelle hubille, joten älä lataa sitä jos aiot ajaa palvelimella useita Aquiloita.

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. Scriptin muokkaaminen tapahtuu komennolla:

nano aquila

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

=== 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 et pääse hubiin, 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. Jos käynnistit ohjelman ilman daemontoolsia, sammuta tapauksessa 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

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

Aquilan asennus- ja käyttöohjeet Linuxiin

2010-01-14T20:39:56Z

89.27.4.30:

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

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

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

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ä. HUOM! Scripti toimii vain yhdelle hubille, joten älä lataa sitä jos aiot ajaa palvelimella useita Aquiloita.

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. Scriptin muokkaaminen tapahtuu komennolla:

nano aquila

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

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

Daemontoolsin ollessa asennettuna ulimit vaihdetaan automaattisesti. Käynnistä tämän jälkeen hubi seuraavalla komennolla (vain jos daemontoolsia ei ole asennettu)

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 et pääse hubiin, 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. Jos käynnistit ohjelman ilman daemontoolsia, sammuta tapauksessa 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

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

Aquilan asennus- ja käyttöohjeet Linuxiin

2010-01-14T20:33:20Z

89.27.4.30:

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

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

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

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ä. HUOM! Scripti toimii vain yhdelle hubille, joten älä lataa sitä jos aiot ajaa palvelimella useita Aquiloita.

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. Scriptin muokkaaminen tapahtuu komennolla:

nano aquila

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

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

ulimit -n 20000

Daemontoolsin ollessa asennettuna ulimit vaihdetaan automaattisesti. Käynnistä tämän jälkeen hubi seuraavalla komennolla (vain jos daemontoolsia ei ole asennettu)

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 et pääse hubiin, 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. Jos käynnistit ohjelman ilman daemontoolsia, sammuta tapauksessa 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 (ilman daemontoolsia) ==

Tee asetuskansio toiselle Aquilalle mkdir-komennolla, esim:

mkdir /home/aquila/hubi2

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/aquila/hubi2/accounts.conf NICK SALASANA

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

aquila -d

== 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/service/motd

Lisää trigger komennolla '''!triggeradd'''

Esimerkiksi:

!triggeradd motd file /home/aquila/service/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/service/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.

Aquilan asennus- ja käyttöohjeet Linuxiin

2010-01-14T20:16:13Z

89.27.4.30:

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

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

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

Testaa toimivuus esim. komennolla apt-get update ja katso tuleeko tekstit suomeksi.

== 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ä. HUOM! Scripti toimii vain yhdelle hubille, joten älä lataa sitä jos aiot ajaa palvelimella useita Aquiloita.

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. Scriptin muokkaaminen tapahtuu komennolla:

nano aquila

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 käynnistäminen (kaikille) ==

Tässä Aquilan asetuskansio on /home/aquila/service, joka on luotu daemontoolsia asentaessa. Mikäli et ole asentanut daemontoolsia, tee tämä
kansio itse, tai käytä jotain toista kansiota ja muokkaa komennot sille sopiviksi.

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/service/hub.conf

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

nmdc.listenport

Esimerkiksi:

nmdc.listenport 4111

(daemontoolsin kanssa vain yli 1024 olevat portit toimivat 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ä.

Aja seuraavat komennot:

cd /home/aquila/service
aqpasswd /home/aquila/service/accounts.conf NICK SALASANA

Korvaa loppuun nick ja salasana. Jos et ole asentanut daemontoolsia, ja aiot ottaa hubiin yli tuhat käyttäjää, joudut muuttamaan järjestelmän ulimitin ennen hubin käynnistämistä komennolla

ulimit -n 20000

Daemontoolsin ollessa asennettuna ulimit vaihdetaan automaattisesti. Käynnistä tämän jälkeen hubi seuraavalla komennolla (vain jos daemontoolsia ei ole asennettu)

aquila -d

Käynnistäminen Daemontoolsin ollessa asennettuna (tämä komento soveltuu vain ensimmäisen käynnistyksen yhteydessä käytettäväksi):

ln -s /home/aquila/service /service/aquila

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 et pääse hubiin, 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. Jos käynnistit ohjelman ilman daemontoolsia, sammuta tapauksessa hubi tässä tapauksessa komennolla

pkill aquila

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

Mikäli asensit daemontoolsin niin voit tarvittaessa pysäyttää hubin (niin että se ei lähde käyntiin heti sammuttamisen jälkeen) komennolla

svc -d /service/aquila

Saat Aquilan taas käyntiin komennolla

svc -u /service/aquila

== Kaksi tai useampi Aquila samalla koneella (ilman daemontoolsia) ==

Tee asetuskansio toiselle Aquilalle mkdir-komennolla, esim:

mkdir /home/aquila/hubi2

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/aquila/hubi2/accounts.conf NICK SALASANA

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

aquila -d

== 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/service/motd

Lisää trigger komennolla '''!triggeradd'''

Esimerkiksi:

!triggeradd motd file /home/aquila/service/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/service/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.

DC

2009-11-25T21:23:03Z

89.27.4.30:

Joitain tiettyjä DC++:n ja siihen perustuvien clientien käyttöön liittyviä ongelmia/kysymyksiä voi katsoa [[Usein kysytyt kysymykset (FAQ)]] -sivulta. Muista ongelmatapauksissa sivuston [http://keskustelu.p2p-wiki.org keskustelualue]!

DC++:n versiossa 0.705 ja uudemmissa tulee sivustolla käytettävä suomennos valmiiksi mukana ja vanhempiin versioihin voit ladata suomennoksen [http://www.adrenaline-network.com/index.php?action=tpmod;dl=item32 täältä].

'''[[Usein kysytyt kysymykset (FAQ)]]'''

1. '''[[Asennus ja käyttöönotto]]'''
* Lataaminen ja asentaminen, suomennos, tarvittavien asetusten säätäminen ennen käyttöä (mm. jakojen laittaminen)
2. '''[[Hubit]]'''
* Hubin valitseminen, hubiin yhdistäminen, ongelmat yhdistämisessä, hubin lisääminen suosikkeihin ja sinne rekisteröityminen
3. '''[[Hakeminen ja lataaminen]]'''
* Latausohjeet, haku ei toimi, latausnopeus on hidas, virheilmoitukset ym.
4. '''[[Ladattavat tiedostot]]'''
* Eri tiedostomuodot ja videotiedostojen perässä olevien termien selitykset
5. '''[[Yhteysongelmat]]'''
* Yhteys katkeaa, ohjelma häiritsee netin muuta käyttämistä...
6. '''[[Pääikkuna]]'''
* Ikkunan eri osat: valikot, työkalupalkki ym.
7. '''[[Ikkunat]]'''
* [[Hubi-ikkuna]]
* [[Siirtonäkymä uusi|Siirtonäkymä (DC++ 0.705 ja uudemmat versiot)]]
* [[Siirtonäkymä|Siirtonäkymä (DC++ 0.704 ja vanhemmat versiot)]]
* [[Julkisten hubien lista (Public hubs)]]
* [[Latausjono (Download queue)]]
* [[Latauspaikkaa odottavat käyttäjät (Waiting users)]]
* [[Ladatut tiedostot (Finished downloads)]]
* [[Lähetetyt tiedostot (Finished uploads)]]
* [[Suosikkihubit (Favorite Hubs)]]
* [[Etsi (Search)]]
* [[Suosikkikäyttäjät (Favorite Users)]]
* [[Automaattinen listahaku (ADLSearch)]]
* [[Hakusanavakooja (Search spy)]]
* [[Verkonkäyttötilasto (Network statistics)]]
* [[Muistio (Notepad)]]
* [[Tietokannan luonnin tila (Indexing progress)]]
* [[Järjestelmäloki (System log)]]
* [[Tiedostolista]]
8. '''[[Asetukset]]'''
* Ohjeet jokaisen asetussivun asetuksista.
9. '''[[Alkuperäisjulkaisut]]'''
* Hyödyt, eri tyypit, purkaminen
10. '''[[Bannit]]'''
* Yleisiä bannien syitä sekä bannien saaminen pois
11. '''[[Linkkejä]]'''

'''[[Aktiivitilan asettaminen]]'''

* Lue tämä, jos haku ei toimi tai olet passiivitilassa

'''[[NAT]]'''

* Useissa modeemeissa ja WLAN-tukiasemissa oleva ominaisuus, joka vaikuttaa P2P-ohjelmien käyttämiseen

'''[[Hubilistat]]'''

* Toimivien hubilistojen osotteita ja tietoja listoista

'''[[ADC]]'''

'''[[Chat-komennot]]'''
* Ohjelman chat-ikkunoihin kirjoitettavia komentoja, jotka nopeuttavat ohjelman käyttöä.
'''[[Clientejä]]'''
* Useita DC-clientejä latauslinkkeineen

'''[[Ketjuja]]'''

'''[[Oman hubin pitäminen]]'''
* Ohjeet oman hubin perustamiseen
'''[[Hubiohjelmistot]]'''
* Oman hubin pitämiseen tarkoitettuja ohjelmia sekä asennus- ja käyttöohjeet [[Aquila|Aquilalle]] ja [[Verlihub|Verlihubille]]

<font size="xx-large">Ladatut tiedostot</font>

'''[[Levykuvatiedostojen käyttäminen ja polttaminen levylle]]'''
* ISO, bin/cue, img, mds ym. tiedostojen käyttäminen Daemontoolsin avulla ja niiden polttaminen levylle

'''[[Leffojen katsominen ja polttaminen levylle]]'''
* Videotiedostojen katsominen VLC Playerilla tekstitysten kanssa sekä polttaminen CD:lle/DVD:lle

'''[[Ladattavat tiedostot#Tiedostomuodot|Tiedostomuodot]]'''
* Eri tiedostomuodot ja niiden käyttö

'''[[Koodekit]]'''
* Eri pakkauksenhallintoja kuvaa/ääntä varten

<meta name="description" content="Laajat ohjeet DC++:an käyttöön, mm. aktiivitilan asettaminen (jos haku ei toimi), porttiohjaukset, hubilistoja, asentaminen, lataaminen ja hakeminen, eri tiedostotyyppien avaaminen, tekstitykset, DAEMON Tools, koodekit">
<meta name="keywords" content="DC++, asentaminen, vista, aktiivitilan asettaminen, palomuurit, haku ei toimi, porttiohjaukset, nat, hubilistat, lataaminen, tekstitykset, subit, DAEMON Tools, tiedostojen polttaminen, yhteysasetukset"></meta>
<meta name="title" content="Direct Connect"></meta>

NAT

2009-11-25T21:19:36Z

89.27.4.30:

== Mikä on NAT? ==

Lyhenne NAT tulee sanoista Network Address Translation. Yleensä NAT-reitittimenä toimii ADSL- tai kaapelimodeemi, tai erillinen (WLAN-)reititin. NAT-reititin antaa siihen kytketyille koneelle oman sisäverkon IP-osoitteen, joka on yleensä muotoa 192.xxx.xxx.xxx tai 10.xxx.xxx.xxx. Ulospäin kaikki koneet näkyvät yhteisellä IP-osoitteella, joka on eri kuin sisäverkon osoite. NAT-reititin nimensä mukaisesti suorittaa IP-osoitteiden muuntamisen, joka on välttämätöntä kun liikennöidään ulkoverkkoon. Reittimeen kytketyt koneet voivat olla yhteydessä toisiinsa vain sisäverkon IP-osoitteella.

NAT toimii vain sen ollessa asetettuna käyttöön laitteen hallinnasta (kuten usein oletuksena on) ja modeemin on oltava reitittävässä tilassa. Ilman asetusten muuttamista ominaisuus estää useimpien P2P-ohjelmien toimimisen kunnolla, sillä ohjelmien on kyettävä ottamaan vastaan yhteysyrityksiä muilta käyttäjiltä. Koska kaikilla NATiin kytketyillä koneilla on sama ulkoinen IP-osoite, reititin ei tiedä, mille koneelle yhteysyritys on tarkoitettu. Tämän takia P2P-ohjelman käyttämän portin yhteydet pitää ohjata NAT-reitittimestä johonkin siihen kytketyistä koneista. Porttien ohjaaminen tapahtuu NAT-reitittimen (yleensä ADSL- tai kaapelimodeemin) web-pohjaiselta hallintasivulta. Ohjattu portti voi olla vain yhden koneen ja yhden ohjelman käytössä.

== Mitä hyötyä siitä on? ==

Yhtään porttia ei oletuksena ole auki reitittimeen kytketyille tietokoneille, joten internetistä päin tuleva liikenne jää NAT-reittimeen eikä pääse koneille asti, jos sisäverkon kone ei ole ensin luonut yhteyttä. Porttien ohjaaminen hieman heikentää sen koneen tietoturvaa, jolle portti on ohjattu. Useissa modeemeissa ja reitittimissä on palomuuriominaisuus, joka tarjoaa lisäturvaa ja estää mm. avoinna olevien porttien skannaamisen.

NAT myös mahdollistaa useamman koneen kytkemisen internetiin kuin internetliittymässä on käytettävissä ulkoisia IP-osoitteita. IP-osoitteita on yleensä riittävästi, mutta esim. kiinteää IP-osoitetta käytettäessä niitä voi olla vain yksi ja ylimääräiset on ostettava erikseen.

== Mitä haittaa NATista on ja miten sen saa pois käytöstä? ==

NAT aiheuttaa yhteensopivuusongelmia ohjelmien kanssa. Suosituimmat P2P-tekniikkaa käyttävät sovellukset, kuten Skype ja Spotify, toimivat NAT-käyttäjillä tavallisesti ilman ylimääräisiä toimenpiteitä. NAT haittaa myös joidenkin pelien ja FTP-ohjelmien käyttämistä.

Lisäksi NAT lisää reitittimen kuormitusta ja saattaa aiheuttaa tällöin sen kaatumiseen. Tämä on ongelma halvoissa ADSL-modeemeissa erityisesti, jos modeemin palomuuri, WLAN tai muita laitetta rasittavia ominaisuuksia on käytössä. Modeemin kaatuillessa näitä ominaisuuksia kannattaa karsia. Jos siitä ei ole apua, modeemin asettaminen siltaavaan tilaan voi ratkaista ongelman. Lisää tietoja näistä toimenpiteistä löytyy modeemien ohjeista. NATin ollessa pois käytöstä koneiden tietoturvasta pitää huolehtia muuten. NAT myös laskee tiedonsiirtonopeuksia joissain halvoissa, erityisesti alle 50 euron WLAN-tukiasemissa.

NAT

2009-11-25T21:18:20Z

89.27.4.30:

== Mikä on NAT? ==

Lyhenne NAT tulee sanoista Network Address Translation. Yleensä NAT-reitittimenä toimii ADSL- tai kaapelimodeemi, tai erillinen (WLAN-)reititin. NAT-reititin antaa siihen kytketyille koneelle oman sisäverkon IP-osoitteen, joka on yleensä muotoa 192.xxx.xxx.xxx tai 10.xxx.xxx.xxx. Ulospäin kaikki koneet näkyvät yhteisellä IP-osoitteella, joka on eri kuin sisäverkon osoite. NAT-reititin nimensä mukaisesti suorittaa IP-osoitteiden muuntamisen, joka on välttämätöntä kun liikennöidään ulkoverkkoon. Reittimeen kytketyt koneet voivat olla yhteydessä toisiinsa vain sisäverkon IP-osoitteella.

NAT toimii vain sen ollessa asetettuna käyttöön laitteen hallinnasta (kuten usein oletuksena on) ja modeemin on oltava reitittävässä tilassa.

NAT toimii vain sen ollessa asetettuna käyttöön laitteen hallinnasta (kuten usein oletuksena on) ja modeemin on oltava reitittävässä tilassa. Ilman asetusten muuttamista ominaisuus estää useimpien P2P-ohjelmien toimimisen kunnolla, sillä ohjelmien on kyettävä ottamaan vastaan yhteysyrityksiä muilta käyttäjiltä. Koska kaikilla NATiin kytketyillä koneilla on sama ulkoinen IP-osoite, reititin ei tiedä, mille koneelle yhteysyritys on tarkoitettu. Tämän takia P2P-ohjelman käyttämän portin yhteydet pitää ohjata NAT-reitittimestä johonkin siihen kytketyistä koneista. Porttien ohjaaminen tapahtuu NAT-reitittimen (yleensä ADSL- tai kaapelimodeemin) web-pohjaiselta hallintasivulta. Ohjattu portti voi olla vain yhden koneen ja yhden ohjelman käytössä.

== Mitä hyötyä siitä on? ==

Yhtään porttia ei oletuksena ole auki reitittimeen kytketyille tietokoneille, joten internetistä päin tuleva liikenne jää NAT-reittimeen eikä pääse koneille asti, jos sisäverkon kone ei ole ensin luonut yhteyttä. Porttien ohjaaminen hieman heikentää sen koneen tietoturvaa, jolle portti on ohjattu. Useissa modeemeissa ja reitittimissä on palomuuriominaisuus, joka tarjoaa lisäturvaa ja estää mm. avoinna olevien porttien skannaamisen.

Lisäksi NAT mahdollistaa useamman koneen kytkemisen internetiin kuin internetliittymässä on käytettävissä ulkoisia IP-osoitteita. Vaikka IP-osoitteita yleensä on riittävästi, esim. kiinteää IP-osoitetta käytettäessä niitä voi olla vain yksi ja muut on ostettava erikseen.

== Mitä haittaa NATista on ja miten sen saa pois käytöstä? ==

NAT aiheuttaa yhteensopivuusongelmia ohjelmien kanssa. Suosituimmat P2P-tekniikkaa käyttävät sovellukset, kuten Skype ja Spotify, toimivat NAT-käyttäjillä tavallisesti ilman ylimääräisiä toimenpiteitä. NAT haittaa myös joidenkin pelien ja FTP-ohjelmien käyttämistä.

Lisäksi NAT lisää reitittimen kuormitusta ja saattaa aiheuttaa tällöin sen kaatumiseen. Tämä on ongelma halvoissa ADSL-modeemeissa erityisesti, jos modeemin palomuuri, WLAN tai muita laitetta rasittavia ominaisuuksia on käytössä. Modeemin kaatuillessa näitä ominaisuuksia kannattaa karsia. Jos siitä ei ole apua, modeemin asettaminen siltaavaan tilaan voi ratkaista ongelman. Lisää tietoja näistä toimenpiteistä löytyy modeemien ohjeista. NATin ollessa pois käytöstä koneiden tietoturvasta pitää huolehtia muuten. NAT myös laskee tiedonsiirtonopeuksia joissain halvoissa, erityisesti alle 50 euron WLAN-tukiasemissa.

Linkkejä

2009-11-25T20:59:05Z

89.27.4.30:

== Julkaisusivustoja ==

[http://www.nfohump.com/index.php?switchto=nfos NFOHump]

[http://moviezoo.org Moviezoo]

[http://www.rlslog.net Releaselog]

[http://scenerls.com SceneReleaseNews]

[http://www.gotnzb4u.me.uk/x264/hdpre.php x264-julkaisuja]

[http://pre.scnsrc.net/ SceneSource]

[http://www.swecheck.net SweCheck]

[http://www.swedupe.com SweDupe]

[http://swenews.info SweNews]

== Tekstityssivustoja ==

[http://subsearch.org Subsearch.org]

* Tekstitysten hakemiseen useilta sivustoilta

[http://www.divxfinland.org DivX Finland]

[http://www.xvidsubs.com XvidSubs] (ei enää tarjoa ladattavaksi subeja, tekevät nykyään vain virallisia käännösprojekteja elokuviin, arvosteluihin ja lyhytelokuviin)

== DC-ketjujen kotisivuja ==

[[Adrenaline Network]] - http://www.adrenaline-network.com

[[Finnish Fast*Speed Network]] - http://www.ffs-network.com

[[Men In Black™ Network's]] - http://www.webbisivu.com/MIB

[[Category:DC]]

Linkkejä

2009-11-25T20:56:37Z

89.27.4.30: /* DC-ketjujen kotisivuja */

== Julkaisusivustoja ==

[http://www.nforce.nl NFOrce]

[http://moviezoo.org Moviezoo]

[http://www.rlslog.net Releaselog]

[http://scenerls.com SceneReleaseNews]

* Julkaisuja monilta alueilta

[http://www.swecheck.net SweCheck]

[http://www.swedupe.com SweDupe]

[http://swenews.info SweNews]

* Erityisesti pohjoismaisia DVDR-julkaisuja.

== Tekstityssivustoja ==

[http://subsearch.org Subsearch.org]

* Tekstitysten hakemiseen useilta sivustoilta

[http://www.divxfinland.org DivX Finland]

[http://www.xvidsubs.com XvidSubs] (ei enää tarjoa ladattavaksi subeja, tekevät nykyään vain virallisia käännösprojekteja elokuviin, arvosteluihin ja lyhytelokuviin)

== DC-ketjujen kotisivuja ==

[[Adrenaline Network]] - http://www.adrenaline-network.com

[[Finnish Fast*Speed Network]] - http://www.ffs-network.com

[[Men In Black™ Network's]] - http://www.webbisivu.com/MIB

[[Category:DC]]

Oman hubin pitäminen

2009-11-25T20:55:14Z

89.27.4.30:

== Yleistä ==

Omaa hubia voi pitää lähes kuka tahansa, mutta kohtalaiset taidot DC-clientin käyttämisestä ovat suositeltavat. Jos aktiivitila ei toimi, ei toimi hubikaan (katso ohjeet sivulta [[Aktiivitilan asettaminen|Aktiivitilan asettamiseen]]). Hubia varten on tarvittaessa avattava oma portti ja se on sallittava palomuurista.

Pienen hubin pitäminen ei rasita paljoa konetta, jolla hubia pidetään. Useamman sadan käyttäjän hubi käyttää paljon kaistaa, ja voi tavallista ADSL-/kaapelimodeemiyhteyttä käytettäessä hidastaa liittymää merkittävästi. Tällöin voi harkita hubin siirtämistä vuokratulla palvelimella. Hubin pitäminen palvelimella on yleensä ongelmatonta ja tällöin sen käytettävissä on enemmän kaistaa ja katkoksia on yleensä vähemmän. Jotkin palveluntarjoajat kieltävät hubien pitämisen palvelimella, sekä hubien yleensä aiheuttama suuri liikennemäärä voi aiheuttaa ongelmia.

== Käyttäjien määrä eri lähetyskaistoilla ==

Maksimi käyttäjämäärä riippuu lähetyskaistan nopeuden lisäksi hubiohjelmistosta, käyttöjärjestelmästä, modeemista, hubin asetuksista ja yli 10 mbit yhteyksillä mahdollisista verkkolaitteista. Esimerkeissä kaikki käyttäjät pystyvät hakemaan ja hakujen välinen aika on noin 30 sec.

{| border="1"
! Lähetyskaistan nopeus !! Max käyttäjämäärä
|-
!512 Kbit - 1 Mbit
|500-800
|-
!5 Mbit
|2000
|-
!10 Mbit
|3000
|-
!100 Mbit
|8000
|-
|}

== Hubiojelmiston lataaminen ja hubin osoite ==

[[Hubiohjelmistot]]-sivulta löydät yleisimmät hubisoftat tietoineen. Helppokäyttöinen yleisin hubisofta Windowsille on [[Ynhub]]. [[ADC]]-hubiohjelmistot ovat lähinnä testikäyttöön.

Hubille kannattaa rekisteröidä myös oma osoite, jonka saa ilmaiseksi mm. osoitteista [http://www.no-ip.com No-IP.com] ja [http://www.dyndns.com DynDNS.com]. Molemmille osoitteille on saatavilla ohjelmia osoitteen päivittämiseen IP:n muuttuessa ([http://www.no-ip.com/downloads.php No-IP DUC] ja [http://www.dyndns.com/support/clients DynDNS Updater]). Ilmaisia osoitteita käytettäessä on olemassa riski, että osoite poistetaan hubin takia (pientä hubia pitäessä tosin hyvin vähäinen) tai jos samalla käyttäjällä on paljon osoitteita, jotka ohjaavat eri IP-osoitteisiin. Isoja hubeja pidettäessä on paras ostaa oma domain.

Voit yhdistää hubiin itse käyttämällä osoitetta '''localhost:portti''' tai ''127.0.0.1:portti'' (paina ctrl+q ja syötä osoite tai lisää hubi suosikkeihin).Porttia ei tarvita, jos hubissa on portti 411 käytössä. Muut käyttäjät pääsevät hubiin tehdyllä osoitteella / omalla ip:llä, jonka perässä on hubissa käytettävä portti. Pääset hubiin itsekin tällä osoitteella, jos sinulla ei ole NAT käytössä.

== Hubiohjelmiston asetusten säätäminen ==

Seuraavissa on joitain tärkeimpiä asetuksia. Niiden asettamisesta saa lisätietoja kunkin hubiohjelmiston ohjeista.

'''Hubin nimi'''

'''Kuvaus'''

* Hubilistassa näkyvä hubin kuvaus.

'''Osoite'''

* Esimerkiksi no-ip- tai dyndns-osoite. Myös omaa IP-osoitetta voi käyttää, mutta se ei ole suositeltavaa.

'''Portit'''

* Oletusportti on yleensä 411, jota käyttäjien ei tarvitse lisätä osoitteen perään. Jonkin muun portin valitseminen voi olla kuitenkin hyvä, sillä jotkin operaattorit rajoittavat portin 411 liikennettä. Joissain ohjelmistoissa portti pitää lisätä myös osoitteen perään, jos se ei ole 411 (esim. osoite.no-ip.org:4151)

'''Uudelleenohjausosoitteet'''

* Voit asettaa, jos haluaa ohjata hubiin pääsemättömät käyttäjät muualle.

'''Hubilistojen rekisteröintipalvelimet'''

* Katso seuraava osio.

'''Tekstikomennot'''

* Esimerkiksi MOTD (teksti, joka näytetään kaikille hubiin tuleville) ja hubin säännöt on hyvä tehdä.

'''Käyttäjien rekisteröinti'''

* Ainakin itsellesi kannattaa tehdä tunnukset hubiin kirjautumista varten omistajan oikeuksin.

Myös hubiin päästettävien käyttäjien rajoituksia voidaan säätää, kuten jakorajaa, slottirajaa, max hubeja ym. Jos hubissa on liian korkeat rajat, käyttäjiä on vaikea saada (ainakin ilman apua).

Hubin resurssienkäyttöä voi vähentää mm. vähentämällä hakujen ja passiivikäyttäjien hakutulosten määrää, harventamalla MyINFOjen lähetyskertoja sekä poistamalla tavallisille käyttäjille lähetettävät tagit, kuvaukset ja sähköpostiosoitteet. Esimerkiksi hakujen rajoittaminen heikentää kuitenkin hubin käytettävyyttä, joten niitä ei kannata rajoittaa enemmän kuin on tarpeen.

== Hubin lisääminen hubilistoihin ==

Julkisen hubin näkyvyyden ja käyttäjien saamista voi parantaa lisäämällä hubin mahdollisimman moneen hubilistaan.

Seuraavassa on joitain toimivia rekisteröintipalvelimien osoitteita.

reg.hublist.nu ([http://www.hublist.nu Hublist.nu]) dc.wikfall.se (http://hublist.wikfall.se/dc/publichublist.config) reg.ancient.pl ([http://hublist.ancient.pl HubLisT AncienT]) hubs.hublist.co.uk ([http://www.hublist.co.uk www.hublist.co.uk]) publichublist-nl.no-ip.org ([http://www.publichublist.nl publichublist.nl])

Saat lisättyä ne '''Ynhubissa''' ohjelman Hublists-sivulta (nimi ja host riittävät), '''Verlihubissa''' komennolla ''!= hublist_host reg.hublist.nu dc.wikfall.se reg.ancient.pl hubs.hublist.co.uk maxweb.no-ip.com publichublist-nl.no-ip.org'' ja '''Aquilassa''' komennolla ''!= hublist.lists "reg.hublist.nu dc.wikfall.se reg.ancient.pl hubs.hublist.co.uk maxweb.no-ip.com publichublist-nl.no-ip.org"''

Joihinkin suuriin hubilistoin hubi on lisättävä listan kotisivulta

'''[http://www.openhublist.org/ OpenHublist.org]''' Tee oma käyttäjätili, jonka jälkeen pystyt lisäämään hubin. Omasta hallintasivusta voit esim. muokata hubin tietoja sekä pingata sen (päivittää käyttäjämäärän listaan ym.).

'''[http://www.dchublist.com DCHublist.com]''' Sama kuin edellisessä.

== Muuta ==

Hubin voi yrittää saada johonkin ketjuun (network), jota kautta voi joissain tapauksissa saada lisää käyttäjiä. Pienien ketjujen tapauksessa käyttäjien saaminen on vähäistä, mutta ketjun avulla hubiin voi löytyä hyviä operaattoreja ketjun muista hubeista, apua mahdollisissa ongelmissa, sekä siitä voi olla muita etuja. Löydät osoitteita joidenkin ketjujen kotisivuille [[Linkkejä#DC-ketjujen kotisivuja|Linkit]]-sivulta.

'''Älä mainosta hubia ilman lupaa muissa hubeissa'''

* Luvaton mainostaminen voi aiheuttaa ongelmia hubillesi, kuten bannin hubilistasta. Lisäksi mainostaminen ei edes lisää hubin käyttäjiä.

'''Potki laittomia tiedostoja jakavat käyttäjät'''

* Laitonta pornoa ym. kiellettyä jakavia käyttäjiä ei kannata pitää hubissa.

[[Category:DC]]

Yhteysasetukset (Connection settings)

2009-11-04T15:02:33Z

89.27.4.30:

Tällä sivulla määritetään DC++:an käyttämät yhteysasetukset. Lataaminen ja hakeminen ei välttämättä toimi, jos näitä asetuksia ei ole määritetty oikein. Katso lisäohjeita aktiivitilan asettamiseen [[Aktiivitilan asettaminen|tältä]] sivulta.

[[Kuva:Asetukset_yhteys.gif]]

== Sisääntulevan yhteyden asetukset (Incoming connection settings) ==

'''Suora yhteys (Direct Connection)'''

Valitse tämä, jos olet suoraan yhteydessä internetiin eikä sinulla ole laite-/ohjelmistopalomuuria tai reititintä. Katso lisäohjeita aktiivitilan asettamiseen [[Aktiivitilan asettaminen|tältä]] sivulta.

'''Palomuuri, UPnP (Firewall with UPnP)'''

* Valitse tämä, jos sinulla on palomuuri, joka tukee UPnP:tä. DC++ avaa automaattisesti tarvittavat portit ja hakee ulkoisen IP-osoitteen. Tämä tila toimii vain Windows XP:ssä ja uudemmissa.

'''Palomuuri/NAT manuaalisella porttien ohjauksella (Firewall with manual port forwarding)'''

* Valitse tämä, jos olet palomuurin (reitittimen) takana ja asetat TCP- ja UDP-porttiohjaukset itse. Sinun täytyy asettaa ulkoinen (reitittimen) IP-osoite alla olevaan ruutuun, jos haluat haun ja lataustan toimivan kunnolla. Katso lisäohjeita aktiivitilan asettamiseen [[Aktiivitilan asettaminen|tältä]] sivulta.

'''Palomuuri (passiivi, viimeinen keino) (Firewall (passive, last resort))'''

Valitse tämä, jos et saa edellisiä tiloja toimimaan. Tässä tilassa DC++ muodostaa yhteyksiä vain ulospäin. Passiivitilassa on seuraavat haitat:

# Aktiivikäyttäjät saavat 30-50% enemmän hakutuloksia
# Max 5 hakutulosta käyttäjää kohti
# Et voi ladata muilta passiivikäyttäjiltä (vähemmän lähteitä ja aktiivikäyttäjiltä enemmän lataajia --> lähteillä vähemmän latauspaikkoja --> huonommat nopeudet)
# Passiivikäyttäjät eivät pysty käyttämään useissa hubeissa hakua tai lataamaan ja jotkin hubit eivät salli passiivikäyttäjien pääsyä ollenkaan
# Useat hubit rajoittavat passiivikäyttäjille lähetettävien kokonaishakutulosten määrän. Yleensä voit saada yhdeltä hubilta enintään noin 100 hakutulosta, mutta raja voi olla myös matalampi (0-100 tulosta).

==== Valinnat ====

'''TCP-portti'''

* Portti, jota DC++ käyttää sisääntulevien clientyhteyksien kuuntelemiseen. Jos jätät portin tyhjäksi, DC++ käyttää satunnaista porttia väliltä 1025-32000, ja tämä väli on suositeltava myös itse asetetulle portille. Portin numero voi olla sama kuin UDP-portin (olettaen, että kyseinen portti on auki myös TCP:lle).

'''UDP-portti'''

* Portti, jota DC++ käyttää sisääntulevien hakutuloksien kuuntelemiseen. Jos jätät portin tyhjäksi, DC++ käyttää satunnaista porttia väliltä 1025-32000, ja tämä väli on suositeltava myös itse asetetulle portille. Portin numero voi olla sama kuin TCP-portin (olettaen, että kyseinen portti on auki myös UDP:lle).

'''TLS-portti'''

Portti, jota DC++ käyttää TLS-yhteyksien kuuntelemiseen (tarvitaan ainakin [[ADC]]-hubeissa). Jos jätät portin tyhjäksi, DC++ käyttää satunnaista porttia väliltä 1025-32000, ja tämä väli on suositeltava myös itse asetetulle portille. Käytä eri porttinumeroa kuin TCP- ja UDP-porteille!

'''Julkinen- / WAN IP (External / WAN IP)'''

* Ollessasi suoraan yhteydessä internetiin (ei NAT:ia ym.) DC++ kehottaa etäkäyttäjiä yhdistämään paikallisen IP-osoitteeseesi. Täytä tämä laatikko, jos sinulla jokin muu tila kuin suora yhteys tai passiivitila valittuna ja paikallinen osoite pitää korvata ulkoisella IP:llä. Yleisesti tämä koskee käyttäjiä, joilla on kotireititin (NAT). Voit laittaa tähän oma IP-osoitteen sijaan myös DNS-nimen (esim. no-ip.com:iin rekisteröity).

'''Älä salli hubin/UPnPn korvata IP:tä (Don't allow hub/UPnP to override)'''

* Valitse tämä ruutu vain, jos haluat aina käyttää Julkinen- / WAN IP (External / WAN IP) -kenttään asetettua IP:tä etkä halua UPnP:n tai hubien vaihtaa sitä.

== Lähtevän yhteyden asetukset (Outgoing connection settings) ==

'''Suora yhteys (Direct connection)'''

* Pidä tämä asetus valittuna. Seuraava vaihtoehto (SOCKS5) on tarkoitettu valittavaksi vain, jos tietää mitä tekee..

'''SOCKS5'''

* Valitse tämä, jos haluat tehdä lähtevät yhteydet SOCKS-välityspalvelimen kautta. Tähän tilaan pätevät passiivitilan haitat. SOCKS5-välityspalvelimet eivät ole samoja kuin HTTP-välityspalvelimet, DC++:an SOCKS5-tukeen ei kuulu GSSAPI.

==== SOCKS5:en asetukset ====

'''Socks IP'''

* SOCKS5-palvelimen IP (ei verkko-osoite)

'''Portti (Port)'''

* Portti, jota SOCKS5-palvelin käyttää. Oletus 1080.

'''Käyttäjätunnus (Login)'''

* SOCKS5-välityspalvelimen käyttöön tarvittava käyttäjätunnus. Ei tarvita kaikilla välityspalvelimilla.

'''Salasana (Password)'''

* SOCKS5-välityspalvelimen käyttöön tarvittava salasana. Ei tarvita kaikilla välityspalvelimilla.

'''Käytä SOCKS5-palvelina osotteiden selvittämiseen (Use SOCKS5 server to resolve host names)'''

* Valitse tämä asetus, jos haluat käyttää SOCKS5-välityspalvelinta osotteiden muuttamiseen IP-osoitteeksi paikallisen nimipalvelimen sijaan.

[[Category:DC]]
[[Category:Asetukset]]

Chat-tilastot Aquilaan ja Verlihubiin

2009-10-21T09:56:53Z

89.27.4.30: /* Tilastojen päivittäminen automaattisesti */

Nämä ohjeet toimivat suoraan Debianissa ja Ubuntussa. Ongelmatapauksissa voit kysyä apua [http://keskustelu.p2p-wiki.org Keskustelualueella].

== Tarvittavat paketit ==

Asenna ensimmäisenä tilastojen luomiseen vaadittava Perl-paketti komennolla

sudo apt-get install perl

Tilastojen näyttäminen vaatii myös www-palvelimen. Asenna se tarvittaessa komennolla

sudo apt-get install apache2

== Lokiscriptin lataaminen ==

Lataa scripti Aquilan asetuskansiossa komennolla

wget http://files.adrenaline-network.com/aquila/scriptit_lua5.1/log.lua

tai Verlihubiin komennolla

wget http://files.adrenaline-network.com/log.lua

Lataa scripti hubisoftassa komennolla

!luaload log.lua

Aquilassa scripti kannattaa myös laittaa latautumaan automaattisesti hubin käynnistämisen yhteydessä (lue lisää [[Aquilan_asennus-_ja_käyttöohjeet_Linuxiin#LUA|Aquilan käyttöohjeista]])

== Tilastojen luontiohjelman lataaminen ==

Lataa paketti komennolla

wget -P /home http://files.adrenaline-network.com/tilastot.tar.bz2

Pura se /home-kansiossa kirjoittamalla

tar jxvf tilastot.tar.bz2

== Kansion luominen www-hakemistoon ==

Näiden ohjeiden mukaan tehtynä tilastot näkyvät osoitteessa http://PALVELIMEN_(IP)OSOITE/tilastot

Tätä varten /var/www-kansioon on luotava ensin kansio tilastoille. Tämä onnistuu seuraavalla komennolla:

mkdir /var/www/tilastot

Tähän kansioon on myös luotava symlink tilastoissa näkyville kuville. Syötä komento

ln -s /home/pisg/gfx /var/www/tilastot

== Tilastojen asetukset ==

Muokkaa tämän jälkeen tilastojen asetuksia:

nano /home/pisg/pisg.cfg

Lisää tiedostoon ainakin hubin nimi ja mahdollisesti päivittäjä (kohta Maintainer) sekä kirosanoja (FoulWords). Vaihda myös tarvittaessa tilastosivujen tallennuskansio (kohta OutputFile). Tallenna painamalla Ctrl+O ja poistu yhdistelmällä Ctrl+X.

Tarkat ohjeet eri asetusten käyttöön löytyvät [tältä sivustolta http://pisg.sourceforge.net/docs/].

== Tilastosivun luominen ==

Voit päivittää tilastot itse komennolla

/home/pisg/pisg

jonka jälkeen niiden pitäisi näkyä osoitteessa

http://PALVELIMEN_(IP)OSOITE/tilastot

== Tilastojen päivittäminen automaattisesti ==

Aja seuraavat komennot

export EDITOR=nano
crontab -e

Lisää tiedostoon rivi

*/60 * * * * /home/pisg/pisg

Tässä tapauksessa tilastot päivittyvät tunnin välein. Kun lokitiedosto kasvaa isommaksi, myös tilastojen päivittäminen kestää kauemmin. Tällöin tilastot voi asettaa päivittymään esimerkiksi kerran vuorokaudessa, vaikkapa neljältä yöllä. Tällöin crontabiin lisättävä rivi näyttää seuraavalta:

* 4 * * * /home/pisg/pisg

Tallenna tiedosto ja poistu editorista. Lisätietoja crontabin käytöstä löytyy [http://www.adminschoice.com/docs/crontab.htm täältä].

Verlihub

2009-10-21T09:52:43Z

89.27.4.30:

Verlihub on Linuxille tarkoitettu hubisofta, josta on olemassa myös Windowsille tarkoitettu versio WinVerlihub, joka kuitenkin kestää vain muutamia satoja käyttäjiä. Toimii hyvin suurissa hubeissa, jos palvelin on nopea. Verlihubia kehitetään edelleen, mutta mitään merkittäviä ominaisuuksia ei ole tullut moneen vuoteen.

Etuja

* Paljon ominaisuuksia

* Paljon scriptejä ladattavissa

* Vakaa

* MYSQL

* Laajennettavuus (Lua-scriptit ja pluginit)

Haittoja

* Parin viime vuoden aikana ainoastaan pieniä päivityksiä

* Resurssienkäyttö, kun delayed_login on pois päältä. Asetuksen pitäminen käytössä puolestaan vähentää käyttäjämäärää.

Kotisivu: [http://www.verlihub-project.org linkki]

Lataussivu: [http://www.verlihub-project.org/doku.php?id=download linkki]

Ohje suomeksi: [[Verlihubin asennus- ja käyttöohjeet‎]]

[[Chat-tilastot Aquilaan ja Verlihubiin]]

Ohje englanniksi: [http://www.verlihub-project.org/doku.php?id=manual linkki]

[[Category:DC]]
[[Category:Hubisoftat]]

Aquila

2009-10-21T09:52:17Z

89.27.4.30:

Hubisofta Linuxille ja Windowsille. Sopii Linuxilla hyvin isoihinkin hubeihin vähäisen resurssienkäytön ja vakauden takia, mutta Windowsilla useamman tuhannen käyttäjän pitäminen saattaa aiheuttaa ongelmia. [http://aquiladc.sourceforge.net/forum/viewtopic.php?p=625 Ohjelman kehitys on lopetettu toukokuussa -07 uuden tekijänoikeuslain takia], mutta se on kuitenkin hyvä vaihtoehto joidenkin nykyaikaisten ominaisuuksien takia (mm. ZLine). Aquila on komentorivipohjainen, mutta sille on tehty myös hubille käyttäjänä yhdistettävä graafinen käyttöliittymä. Tästä huolimatta Aquila ei ole kovin helppokäyttöinen aloittelijoille varsinkaan Windowsin hubisoftiin verrattaessa. Aquilassa on tuki 5.0 ja 5.1 lua-scripteille.

Etuja

* Laajennettavuus (lua-scriptit ja pluginit)

* ZLine (datan pakkaaminen)

* Käyttää vähän CPU:ta ja muistia

* Vakaa

* Tuki käännöksille, myös suomeksi

Haittoja

* Windows-versio keskeneräinen

* Vaikeakäyttöinen

* Ei enää kehitetä

Kotisivu: [http://aquiladc.sourceforge.net linkki]

Lataussivu: [http://files.adrenaline-network.com/aquila/ linkki]

Ohjeita suomeksi:

[[Aquilan asennus- ja käyttöohjeet Linuxiin]]

[[Aquilan asennus- ja käyttöohjeet Windowsiin]]

[[Chat-tilastot Aquilaan ja Verlihubiin]] (vain Linux)

[[Category:DC]]
[[Category:Hubisoftat]]

RSX++

2009-09-06T07:42:55Z

89.27.4.30:

Operaattoreille tarkoitettu client

'''Kotisivut''': [http://rsxplusplus.sourceforge.net/ linkki]

'''Lataussivu''': [http://sourceforge.net/project/showfiles.php?group_id=198783 linkki]

'''Uusin versio ja julkaisupäivämäärä''': 1.1 (30. elokuuta 2009)

{| border="1"
! Ominaisuus !! Tuki clientissä
|-
!Mahdollisuus ladata samaa tiedostoa useammalta käyttäjältä
|kyllä
|-
!Mahdollisuus käyttää chat-ikkunoissa eri fontteja ja värejä
|kyllä
|-
!Chat-hymiöt
|kyllä
|-
!Hakutulosten lajittelu TTH:n perusteella
|kyllä
|-
!Soitettavan kappaleen näyttö
|Winamp, Windows Media Player, iTunes, Media Player Classic
|-
![[Peerguardian]]
|ei
|-
!Operaattoreiden ominaisuuksia
|clientien tunnistaminen ja tiedostolistojen tarkistaminen (myös automaattisesti uusille käyttäjille), pisteet kielletyille tiedostoille, potkiminen hitaasta latausnopeudesta, kiellettyjen TTH:iden etsiminen automaattisesti, feikkijakomäärien asettaminen.
|-
!IP-osoitteen automaattinen päivittäminen käynnistettäessä
|kyllä
|-
!Jakojen piilottaminen hubikohtaisesti
|kyllä
|-
!Käyttäjien hylkääminen
|ei
|-
!Mahdollisuus asettaa äänet eri tapahtumille
|kyllä
|-
!Tuki Lua-scripteille
|kyllä
|-
!Muuta
|työkalupalkin kuvakkeiden mukauttaminen, hubikohtainen passiivi-/aktiivivalinta, chatsuodattimet ja kohteiden korostaminen, hubikohtainen poissa-viesti, [[DHT]]
|-
|}

[[Category:DC]]
[[Category:Clientit]]

StrongDC++

2009-09-06T07:41:54Z

89.27.4.30:

'''Kotisivut''': [http://strongdc.sourceforge.net/index.php?lang=eng linkki]

'''Lataussivu''': [http://strongdc.sourceforge.net/download.php?lang=eng linkki]

'''Uusin versio ja julkaisupäivämäärä''': 2.30 (31. elokuuta 2009)

{| border="1"
! Ominaisuus !! Tuki clientissä
|-
!Mahdollisuus ladata samaa tiedostoa useammalta käyttäjältä
|kyllä
|-
!Mahdollisuus käyttää chat-ikkunoissa eri fontteja ja värejä
|kyllä
|-
!Chat-hymiöt
|kyllä
|-
!Hakutulosten lajittelu TTH:n perusteella
|kyllä
|-
!Soitettavan kappaleen näyttö
|Winamp
|-
!Mahdollisuus estää yhteydet määritettyihin IP-osoitteisiin
|ei
|-
!Operaattoreiden ominaisuuksia
|potkiminen automaattisesti kielletyistä tiedostoista tiedostolistoissa, clientien tunnistaminen (myös automaattisesti)
|-
!IP-osoitteen automaattinen päivittäminen käynnistettäessä
|ei
|-
!Jakojen piilottaminen hubikohtaisesti
|ei
|-
!Käyttäjien hylkääminen
|ei
|-
!Mahdollisuus asettaa äänet eri tapahtumille
|kyllä
|-
!Tuki Lua-scripteille
|ei
|-
!Muuta
|työkalupalkin kuvakkeiden mukauttaminen, hubikohtainen passiivi-/aktiivivalinta, [[DHT]]
|-
|}

[[Category:DC]]
[[Category:Clientit]]