Ero sivun ”IRC-ohjeet” versioiden välillä

Fuksiwikistä
Ei muokkausyhteenvetoa
Päivitetty viittaukset irc-kanaviin.
 
(158 välissä olevaa versiota 20 käyttäjän tekeminä ei näytetä)
Rivi 1: Rivi 1:
== Mikä IRC? ==
'''Tämän ohjeen tarkoitus on toimia mahdollisimman lyhyenä johdantona laitoksen etäpalvelimelta irkkaamiseen.'''


[http://fi.wikipedia.org/wiki/IRC IRC] eli Internet Relay Chat eli irkki on suosittu väline reaaliaikaiseen keskusteluun Internetin välityksellä. Tuutorit, aktiivit ja huomattavan osan fukseja löytää irkistä, missä on tarjolla turinaseuran lisäksi roppakaupalla hyviä neuvoja pitkälti vuorokauden ympäri. Irkkiä käytetään myös tapahtuma- ja muuhun tiedottamiseen ainejärjestön ja laitoksen sähköpostilistojen ohella. Tule siis irkkiin, siellä ovat kaikki muutkin.
Tarkoituksena ei ole opastaa syvällisempään Irssin (tai muunkaan) asiakasohjelman käyttöön. Irssin käyttöön opastaa [http://irssi.org/documentation/startup Irssi.org:in Startup HOWTO]. Kun on päässyt alkuun, ohjeita saa kysellä myös [[Fuksikanava]]lta.


Jos sinulla ei ole vielä laitoksen käyttäjätunnusta, allaolevan ohjeen pituus hirvittää, tai haluat vain oikeasti kysyä yhden nopean kysymyksen (kulkematta täyttymyksen tuovan irkkikoulutusputken kautta), ohjaa selaimesi osoitteeseen http://chat.ircnet.org/, naputa itsellesi joku lempinimi (nickname) ja valitse kanavaksi Other, #tkt-fuksit09 niin pääset ns. fuksikanavalle.
----


=== SSH-yhteys ja IRC ===
IRC ([http://www.ietf.org/rfc/rfc1459.txt Internet Relay Chat]), tutummin "irkki", on suosittu väline reaaliaikaiseen keskusteluun Internetin välityksellä.


Laitoksella on palvelimia, joita voit käyttää IRC-pääteohjelman (Irssi) ajamiseen. Tämä menettely on siitä hyödyllinen, että näet poissa ollessasi puhutut keskustelut kaikilta kanaviltasi. Voit kirjautua palvelimelle mistä tahansa verkkoon kytketystä koneesta, jossa on toimiva SSH-yhteysohjelma.
Irkkiin yhdistämiseen on olemassa useita eri tapoja, joista voi valita itselleen parhaiten sopivan.
 
Nopeiten pääset irkkiin yhdistämällä nettiselaimen kautta toimivalla webchatilla, jossa nettipalvelu yhdistää sinut IRCnetiin ilman että asennat mitään koneellesi. Toisin kuin monissa muissa keskustelualustoissa, viestejä ei tallenneta mihinkään pilveen. Tämän takia yhdistäessä verkkoon sinulle ei lähetetä minkäänlaista viestihistoriaa kanavilta tai mitä olet aiemmin vastaanottanut yksityisviesteinä. Tästä syystä myöskin webchatia käyttämällä et voi tietää, mikäli joku on vaikka vastannut kysymykseesi sillä aikaa kun olet katkaissut yhteyden verkkoon.
 
Tästä syystä yleinen irkin käyttötapa on asentaa IRC-verkkoon yhdistävä asiakasohjelma ns. shellille tai virtuaalipalvelimelle jonne ohjelman voi jättää ajoon taustalle ja palaa takaisin kun yhdistää jälleen terminaalilla SSH-yhteyden palvelimeen. Yliopisto tarjoaa muun muassa tähän käyttöön shellipalvelinta.
 
Lisäksi uutena vaihtoehtona IRCnetiä voi nykyään käyttää Matrix-kommunikaatioprotokollan kautta. University of Twente tarjoaa oman IRCnet-palvelimensa lisäksi siltaa heidän oman IRCnet-palvelimen ja Matrix-palvelinverkon välille. Toisin kuin irkissä, viestit tallennetaan usealle federaatiossa olevalle palvelimelle. Tämän ansiosta (myöskin irkissä) lähetetyt viestit säilyvät. Matrix-palvelinverkkoon voi myös yhdistää monella eri tavalla, joista suosituin on nettiselaimessa ja älypuhelimissa toimiva [https://about.riot.im/ Riot]. Tämä on helpoin vaihtoehto myös niille jotka eivät ole koskeneet komentoriviin tai muuten pelkäävät sitä.
 
__TOC__
 
== IRCnetiin yhdistäminen Matrixin kautta Riotilla ==
 
[https://matrix.org/ Matrix] on avoin kommunikaatioprotokolla, joka on suunniteltu reaaliaikaiseen viesti-, ääni- ja videokeskusteluun hajautetussa palvelinverkossa. Matrixin yhteisön ansiosta Matrixiin on toteutettu erinäisiä integraatioita, jotka yhdistää Matrix-palvelinverkon muihin viestintäprotokolliin. Näistä yksi on Matrixin ja IRCnetin välinen integraatio, minkä ansiosta Matrixin käyttäjä voi liittyä mille tahansa kanavalle IRCnetissä Matrix-asiakasohjelmastaan.
 
Matrixia voi käyttää muun muassa [Riotilla https://riot.im/app/], joka toimii nettiselaimessa sekä älypuhelimissa.
 
IRCnetissä olevat kanavat löytyvät Matrixissa muodossa <code>#_ircnet_#kanavanNimi:irc.snt.utwente.nl</code>. Esimerkiksi jos haluat liittyä kanavalle <code>#tkt-fuksitYYYY</code>, niin liityt Matrixissa kanavalle <code>#_ircnet_#tkt-fuksit2017:irc.snt.utwente.nl</code>.
 
Liittyessäsi ensimmäistä kertaa IRCnetin puolella olevalle kanavalle saat yksityisviestinä botilta tietoa ja ohjeita. Tämän botin kautta voit myös jatkossa liittyä muille IRCnetissä oleville kanaville kirjoittamalla <code>!join #kanava</code>. Lisäksi voit myös muuttaa IRCnetissä olevan nimimerkkisi kirjoittamalla <code>!nick nimimerkki</code>. HUOM! minkä vain IRC-komennon ajaminen onnistuu kirjoittamalla <code>!cmd irc.snt.utwente.nl KOMENTO #<channel> <parametrit></code>. Esimerkiksi oppien antaminen #tkt-random kanavalla olevalle käyttäjälle nimeltä velli-veikko sujuisi näin: <code>!cmd irc.snt.utwente.nl MODE #tkt-random +o velli-veikko</code>.
 
 
Kun lähetät kuvia tai videoita kanavalle, siltaa ylläpitävä ohjelmisto lähettää IRC:n puolelle URL-osoitteen kyseiseen liitteseen. Matrixissa nämä näkyvät suoraan keskustelussa.
 
== SSH-yhteys ja IRC ==
 
Homma toimii perusperiaatteessaan niin, että käyttäjä ottaa SSH-yhteyden koneeltaan etäpalvelimeen (jotkut puhuvat näistä "shelleinä"), jossa käynnistää IRC-pääteohjelman, joka puolestaan ottaa yhteyden johonkin tiettyyn IRC-palvelimeen. [http://fi.wikipedia.org/wiki/Ssh SSH-yhteys] itsessään on, näin yksinkertaisesti sanottuna, vahvan salauksensa vuoksi yleisesti käytetty tekstipohjainen etäkäyttöyhteys. Tulee myös huomata, että "etäpalvelinta" ja "IRC-palvelinta" ei tule tässä sekoittaa toisiinsa, vaan ne ovat kokonaan toisistaan riippumattomia asioita.
 
Tämän ohjeen tapauksessa kyseisenä etäpalvelimena toimii laitoksen oma Linux-palvelin, jota voi käyttää suositun IRC-pääteohjelman, [http://irssi.org Irssin] ajamiseen. Voit kirjautua palvelimelle SSH-yhteyden avulla mistä tahansa verkkoon kytketystä koneesta, jossa on toimiva SSH-yhteysohjelma. Näistä lisää seuraavaksi.  


== SSH-yhteyden luominen ==
== SSH-yhteyden luominen ==


=== Windowsilla ===
=== Windowsilla ===
<Windows-käyttöjärjestelmälle hyvä SSH-yhteysohjelma on Nutty, jonka voit ladata osoitteesta http://groehn.net/nutty/. Paina sivuilta "Nutty executable" -linkkiä, joka johtaa nutty.exe -nimiseen tiedostoon. Tallenna kyseinen tiedosto haluamaasi paikkaan koneellasi, ja käynnistä ohjelman kyseisestä tiedostosta. Muuta asennusta ei tarvita.
Windows 10 -käyttöjärjestelmälle hyvä SSH-yhteysohjelma on Powershell. Se löytyy koneelta valmiiksi asennettuna.
 
=== Linuxilla ja OS X:llä ===
Useimmissa Unix-järjestelmissä on ssh-yhteysohjelma yleensä valmiiksi asennettuna ja jonka nimi on ytimekkäästi "ssh".


Käynnistettyäsi ohjelman, kirjoita 'Host Name' -kenttään 'melkki.cs.helsinki.fi', 'Saved Sessions' -kenttään "Melkki" tai muu haluamasi nimi ja paina 'Save'. Nyt voit ottaa yhteyden palvelimeen tuplaklikkaamalla palvelimen nimeä listassa. Paina 'Yes' seuraavaksi ilmestyvään tietoturvavarmistukseen (tämä näkyy vain ensimmäisellä yhdistyskerralla). Tämän jälkeen syötä laitoksen käyttäjätunnuksesi ja salasanasi.
SSH-yhteyden laitoksen palvelimeen saa täten kirjoittamalla komentoriville/terminaaliin
ssh tunnus@melkki.cs.helsinki.fi


=== Linuxilla ===
=== Automaattinen tunnistautuminen ssh-avaimella ===
Luomalla ensin omalla koneellasi ssh-avainpari
ssh-keygen -t rsa -C "your_email@example.com"
sitten kopioidaan oletuksella polkuun <code>~/.ssh/id_rsa.pub</code> tiedoston sisältö laitoksen koneelle tiedostoon <code>~/.ssh/authorized_keys</code>.
Useampia avaimia voi lisätä tiedostoon rivinvaihdoilla erotettuna. Tiedosto voi näyttää esimerkiksi tältä:
#koti:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC4YFesUYLoafcu5aRM75AjxTZbc+[...]E4AUGrNzdtnjZ3oiTXJi6GnLl4NfMCzppXwtvlDGINpjG4VoHRM3b3FoCXa+poRUrFvNLtiZqUdLbVJrsh5pxq22j0oXJ/LN email@example.org
#jokutoinenautentikoitu:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC+jQlXHO6yNbesIn[...]hUBvy9Ebplg2Kp2UQNtvlDGINpjG4VoHRM3b3FoCXa+poRUrFvNLtiZqUdLFnEnZzIG80VaCsfvwnAO5L82uyExVoktnsf8ZnSQ== email@example.org


Kirjoita komentoriville:
== Irssin käyttö ==
ssh tunnus@melkki.cs.helsinki.fi
 
Jos jaksat nähdä hieman enemmän vaivaa niin suositellumpaa on asentaa ja konfiguroida [[#WeeChatin käyttö (Beta)|WeeChat]]. Irssikin toki on hyvä valinta - vanhan koulukunnan valinta.
 
=== Aloittaminen ===


Voit myös käyttää palvelimia melkinpaasi.cs.helsinki.fi ja melkinkari.cs.helsinki.fi
'''Huom!''' Tämän kohdan ohje kertoo miten Irssi käynnistetään Melkille. Älä käynnistä aina irkkaamaan halutessasi uutta Irssiä, vaan katso kohdasta '''Keskeyttäminen ja jatkaminen''' miten jätät Irssin pyörimään Melkille.


== Irssin käynnistys ==
Irssi toimii näppärästi screen-apuohjelman kanssa. Käynnistä Irssi syöttämällä komento
Sisäänkirjautumisen jälkeen kirjoita:
  screen irssi
  screen irssi


Laitoksen palvelimet yhdistävät sinut nyt automaattisesti palvelimelle irc.cc.tut.fi
Mikäli Irssin ruutu on aluksi tyhjä, yhdistetään ensin palvelimelle. Se tapahtuu komennolla
/CONNECT palvelin
jossa palvelin-kohtaan laitetaan haluttu IRC-palvelin, esimerkiksi irc.cc.tut.fi.


Seuraavaksi asetetaan nimimerkki komenolla:
Palvelimelle yhdistämisen jälkeen asetetaan oma nimimerkki eli "nick" ja oikea nimi seuraavilla komennoilla:
  /SET nick nimimerkkisi
  /SET nick nimimerkkisi
/SET real_name Etunimi Sukunimi


Oikea nimi komennolla:
Lopulta voimme siirtyä jutustelemaan fuksikanavalle!
  /SET real_name oikea nimesi
  /join #tkt-fuksit2016


Ja liitytään fuksikanavalle komennolla:
=== Keskeyttäminen ja jatkaminen ===


/join #tkt-fuksit09
Irssin voi sulkea /quit -komennolla - '''mutta sitä ei kannata yleensä käyttää!''' Irssin voi jättää pyörimään Melkille screenin avulla, jolloin et menetä poissaollessassi käytyjä keskusteluja ja pystyt ottamaan vastaan viestejä milloin vain.


== Irssin käyttö ==
Voit piilottaa Irssin näppäinyhdistelmällä '''Ctrl+a+d''', jolloin palaat Melkin komentoriville.


Irssin voit sulkea painamalla Ctrl-A+D, jolloin se kuitenkin jää pyörimään taustalle (screenin ansiosta). Tämä ei
Kun otat uudestaan SSH-yhteyden Melkki-palvelimelle, '''älä käynnistä Irssiä uudelleen''' vaan ota esille aiemmin piilottamasi Irssi komennolla
kuitenkaan ole pakollista, vaan voit vain sulkea ikkunan.
screen -rd


Kun olet saanut Irssin toimimaan halutulla tavalla ja otat uuden yhteyden palvelimeen, voit
Jos komento ei palauta Irssiäsi (There is no screen to attach), se voi olla kaatunut. Tällöin joudut käynnistämään uuden Irssin.
palauttaa Irssin ruudulle kirjoittamalla samalla palvelimella screen -dr


=== Tärkeimmät komennot ===
=== Tärkeimmät komennot ===
* Nimimerkin vaihtaminen: /nick uusnick
* Nimimerkin vaihtaminen: /nick uusnick
* Kanavalle liittyminen: /join #kanavannimi (tai /j)
* Kanavalle liittyminen: /join #kanavannimi (tai /j)
* Kanavalla olevien käyttäjien tulostaminen: /names (tai /n)
* Kanavan otsikon vaihtaminen: /topic uusi otsikko
* Operaattorioikeuksien (op) jakaminen: /op toinennick
* Kanavalta poistuminen: /part
* Kanavalta poistuminen: /part
* Irkistä kokonaan poistuminen: /quit
* Irkistä kokonaan poistuminen, sulkee Irssin: /quit
 
* Yksityisviestien lähettäminen: /msg kaverinnimi viesti
* Yksityisviestien lähettäminen: /msg kaverinnimi viesti
* Nimimerkin käyttäjän selvitys: /whois outonick
* Nimimerkin käyttäjän selvitys: /whois outonick
* "Vahinko-pasten" (puttyssa rightclick) estäminen: /set paste_verify_line_count 1
'''Oletuksena jokainen uusi kanava ja yksityiskeskustelu avautuu omaan ikkunaansa. Ikkunoita käsitellään seuraavasti:'''
* Näkyvän ikkunan vaihtaminen: alt+numero tai esc+numero (kanavasta 10 eteenpäin 11=Q, 12=W, 13=E..., myös /win numero)
* Seuraavaan ikkunaan siirtyminen: ctrl+n tai esc+→
* Edelliseen ikkunaan siirtyminen: ctrl+p tai esc+←
* Ikkunan sulkeminen: /window close (tai /wc)


* Kanavalla olevien nimien tulostaminen: /names (tai /n)
Edelliset keskustelut näkee scrollaamalla PageUpilla ja PageDownilla, tai fn+shift+↑ ja fn+shift+↓.
* Kanavan otsikon vaihtaminen: /topic uusiotsikko
 
 
Kaikki käytettävissä olevat komennot näet komennolla /help
 
Yksityiskohtaisempaa tietoa tietystä komennosta saat kirjoittamalla /help komennonnimi, esim /help whois
 
[http://en.wikipedia.org/wiki/Command-line_completion Tab-täydennys] on hyödyllinen työkalu myös irkatessa. Kirjoittamalla osan esim. nimimerkistä ja painamalla tabulaattoria irssi täydentää lopun automaattisesti.
 
Lisäohjeita Irssiin liittyen löydät sen kotisivuilta osoitteesta http://irssi.org/documentation
 
== WeeChatin käyttö (Beta) ==
 
=== Asennus ===
 
Melkiltä löytyy jo asennettuna jo WeeChatin ikivanha versio, Melkinkarilta jopa 1.3. Tämän takia Weechatin asentaminen lähdekoodista omaan kotihakemistoon voi olla suositeltavaa, mikäli aikoo esimerkiksi hyödyntää relay-ominaisuutta tai lukuisia skriptoja.
 
cd ~
# Lataa uusin WeeChatin lähdekoodi
wget http://weechat.org/files/src/weechat-1.6.tar.gz
tar zxvf weechat-1.6.tar.gz
 
# Luo käännetylle WeeChatille valmiiksi kansio
mkdir weechat
 
# Luo buildillesi kansio ja käännä lähdekoodi
cd weechat-1.6
mkdir build
cd build
# Melkiltä ei löydy Ruby-tuelle vaadittuja kehityskirjastoja, joten sen tuki joudutaan karsimaan pois.
cmake .. -DCMAKE_INSTALL_PREFIX=~/weechat -DENABLE_RUBY=OFF
make
make install
 
# Lisää WeeChatin binäärikansio PATH-muuttujaan
PATH=~/weechat/bin:$PATH
 
# Lisätään tämä muutos .bash_profileen/.bashrc:hen, jolloin muutos tulee voimaan jokaisella kirjautumisella.
echo 'PATH=~/weechat/bin:$PATH' >> .bash_profile
echo 'PATH=~/weechat/bin:$PATH' >> .bashrc
 
# Homma valmis.
weechat
 
 
=== Aloittaminen ===
'''Huom!''' Tämän kohdan ohje kertoo miten WeeChat käynnistetään Melkille. Älä käynnistä aina irkkaamaan halutessasi uutta WeeChat-instanssia, vaan katso kohdasta '''Keskeyttäminen ja jatkaminen''' miten jätät WeeChatin pyörimään Melkille.
 
WeeChat toimii näppärästi tmux-apuohjelman kanssa. Käynnistä uusi tmux-sessio syöttämällä komento
tmux new -s weechat
 
Käynnistä sen jälkeen WeeChat uudessa tmux-sessiossasi syöttämällä komento
weechat
 
Ennen palvelimeen yhdistämistä on hyvä asettaa nimimerkki ja oikea nimensä
/set irc.server_default.nicks "nimimerkki"
/set irc.server_default.realname Etunimi Sukunimi
 
Nicksiin voi myös lisätä useamman nimimerkin pilkuilla erotettuna, jolloin weechat käy niiden listaa vasemmalta oikealle läpi jos ensisijainen nimimerkki on käytössä.
 
Lisätään ensimmäinen irc-palvelin ja yhdistetään siihen.
/server add IRCnet PALVELIN -autoconnect
/connect IRCnet
jossa palvelin-kohtaan laitetaan haluttu IRC-palvelin, esimerkiksi irc.cc.tut.fi tai open.ircnet.net jos käytät WeeChatia muualla kuin yliopiston palvelimella ja yhdistät Suomen ulkopuolelta.
 
Palvelimelle yhdistämisen jälkeen asetetaan oma nimimerkki eli "nick"
/nick nimimerkkisi
 
Lopulta voimme siirtyä jutustelemaan fuksikanavalle!
/join #tkt-fuksit2016
 
=== Keskeyttäminen ja jatkaminen ===
 
WeeChatin voi sulkea /quit -komennolla - '''mutta sitä ei kannata yleensä käyttää!''' WeeChatin voi jättää pyörimään Melkille tmuxin avulla, jolloin et menetä poissaollessassi käytyjä keskusteluja ja pystyt ottamaan vastaan viestejä milloin vain.
 
Voit piilottaa WeeChatin näppäinyhdistelmällä '''Ctrl+b''' ja niiden jälkeen näppäin '''d''', jolloin palaat Melkin komentoriville.
 
Kun otat uudestaan SSH-yhteyden Melkki-palvelimelle, '''älä käynnistä Irssiä uudelleen''' vaan ota esille aiemmin piilottamasi WeeChat komennolla
tmux attach -t weechat
 
Jos komento ei palauta WeeChattiäsi, se voi olla kaatunut. Tällöin joudut käynnistämään WeeChatin uudelleen.
 
=== Tärkeimmät komennot ===
* Nimimerkin vaihtaminen: /nick uusnick
* Kanavalle liittyminen: /join #kanavannimi (tai /j)
* Kanavalla olevien käyttäjien tulostaminen: /names (tai /n)
* Kanavan otsikon vaihtaminen: /topic uusi otsikko
* Operaattorioikeuksien (op) jakaminen: /op toinennick
* Operaattorioikeuksien (op) jakaminen: /op toinennick
* Kanavalta poistuminen: /part
* Irkistä kokonaan poistuminen, sulkee WeeChatin: /quit
* Yksityisviestien lähettäminen: /query kaverinnimi viesti
* Nimimerkin käyttäjän selvitys: /whois outonick
'''Oletuksena jokainen uusi kanava ja yksityiskeskustelu avautuu omaan bufferiinsa. Buffereita käsitellään seuraavasti:'''
* Näkyvän bufferin vaihtaminen: alt+numero tai esc+numero (kanavasta 10 eteenpäin 11=Q, 12=W, 13=E..., myös /buffer numero)
* Seuraavaan bufferiin siirtyminen: ctrl+n tai esc+→
* Edelliseen bufferiin siirtyminen: ctrl+p tai esc+←
* Bufferin sulkeminen: /close
Edelliset keskustelut näkee scrollaamalla PageUpilla ja PageDownilla, tai fn+shift+↑ ja fn+shift+↓.


* Näkyvän ikkunan vaihtaminen: alt + numero
* Seuraavaan ikkunaan siirtyminen: ctrl+n
* Edelliseen ikkunaan siirtyminen: ctrl+p
* Ikkunan sulkeminen: /window close (tai /wc)


Enemmän komentoja ja ohjeita löydät osoitteesta http://irssi.org/documentation.
'''Hienosäätöä'''
* Hiiren käytön salliminen WeeChatissä: /mouse enable
* Kanavalta poistuminen sulkee bufferin: /set irc.look.part_closes_buffer on
* Bufferilista siirtäminen ikkunan alaosaan: /set weechat.bar.buffers.position bottom '''Huom!''' Bufferilistan saa scriptillä buffers.pl, ks. kohta '''Scriptit'''
* Nickien näytettävän merkkimäärän rajoittaminen keskustelualueella: /set weechat.look.prefix_align_max 15
* Prefiksi ja suffiksi nickeille:
/set weechat.look.nick_prefix <
/set weechat.look.nick_suffix >
* Yhtenäinen viiva nimimerkkien ja viestien erottajaksi sekä luettujen ja lukemattomien viestien erottajaksi:
/set weechat.look.prefix_suffix "│"
/set weechat.look.read_marker_string "─"
* Sekunnit pois timestampista: /set weechat.look.buffer_time_format [%H:%M]
* Enemmän rivejä pitkän topicin/otsikon näyttämiseen:
/set weechat.bar.title.size 0 
/set weechat.bar.title.size_max 3
/set weechat.bar.input.size 0
/set weechat.bar.input.size_max 3
*Lisää asetuksia voit selata: /set irc.*
 
 
'''Scriptit'''
* Scriptien (lisäosien) hallinnan välilehden avaaminen: /script
* Ohjeet scriptien asennukseen ja poistamiseen bufferin otsikossa
 
 
Kaikki käytettävissä olevat komennot näet komennolla /help
 
Yksityiskohtaisempaa tietoa tietystä komennosta saat kirjoittamalla /help komennonnimi, esim /help whois
 
[http://en.wikipedia.org/wiki/Command-line_completion Tab-täydennys] on hyödyllinen työkalu myös irkatessa. Kirjoittamalla osan esim. nimimerkistä ja painamalla tabulaattoria WeeChat täydentää lopun automaattisesti.
 
Lisäohjeita WeeChattiin liittyen löydät sen kotisivuilta osoitteesta https://weechat.org/doc/stable/
 
== Muuta huomioitavaa ==
*Irkin [[Fuksikanava]] toimii, nimestä huolimattaan, laitoksen useimpien irkkaavien tietojenkäsittelytieteilijöiden ensisijaisena tiedonlähteenä, ei pelkästään fuksien (ei koske Telegramin fuksikanavaa). Fuksikanava (#tkt-fuksit<vuosiluku>) vaihtuu kuitenkin vasta kesällä, ei siis vielä uutenavuotena.
 
*[[Keskustelukanavat]]-sivulta löydät useita IRC-kanavia. Jos tarvitset apua jonkin tietyn kurssin suhteen, sitä kannattaa kysellä ensisijaisesti kurssikohtaiselta kanavalta. Fuksikanavaltakin voi toki kysellä apua, mutta siellä kysymyksesi saattaa jäädä muun keskustelun jalkoihin.
 
*Jos olet kirjautuneena laitoksen Linux-työasemalle ja haluat ottaa ssh-yhteyden melkki.cs.helsinki.fi -palvelimeen, riittää pelkkä "ssh melkki" - siis ilman täydellistä osoitetta.
 
*Irssiin teemoja löydät osoitteesta http://irssi.org/themes. Laitoksen Linux-puolelta saatat joutua säätämään terminaalisi väreiksi linux-värit, jotta teemasi värit näkyvät oikein.
 
*Muitakin IRC-palvelimia on, ks. [http://www.ircnet.com/index.php?PHPSESSID=0ebab8ef7ab12d01cbaf911b048d1a22&p=5&cur=fi tämä listaus]. Kaikkiin näistä ei kuitenkaan esimerkiksi laitosympäristön melkki-palvelimelta pääse.


=== Muuta ===
*Jos haluat olla erilainen nuori, voit käyttää melkin sijasta myös melkinpaasi-nimistä palvelinta.
Irssiin teemoja löydät osoitteesta http://irssi.org/themes. Laitoksen Linux-puolelta saatat joutua säätämään konsolin väreiksi linux-värit, jotta teemasi värit näkyvät oikein.

Nykyinen versio 2. heinäkuuta 2018 kello 20.44

Tämän ohjeen tarkoitus on toimia mahdollisimman lyhyenä johdantona laitoksen etäpalvelimelta irkkaamiseen.

Tarkoituksena ei ole opastaa syvällisempään Irssin (tai muunkaan) asiakasohjelman käyttöön. Irssin käyttöön opastaa Irssi.org:in Startup HOWTO. Kun on päässyt alkuun, ohjeita saa kysellä myös Fuksikanavalta.


IRC (Internet Relay Chat), tutummin "irkki", on suosittu väline reaaliaikaiseen keskusteluun Internetin välityksellä.

Irkkiin yhdistämiseen on olemassa useita eri tapoja, joista voi valita itselleen parhaiten sopivan.

Nopeiten pääset irkkiin yhdistämällä nettiselaimen kautta toimivalla webchatilla, jossa nettipalvelu yhdistää sinut IRCnetiin ilman että asennat mitään koneellesi. Toisin kuin monissa muissa keskustelualustoissa, viestejä ei tallenneta mihinkään pilveen. Tämän takia yhdistäessä verkkoon sinulle ei lähetetä minkäänlaista viestihistoriaa kanavilta tai mitä olet aiemmin vastaanottanut yksityisviesteinä. Tästä syystä myöskin webchatia käyttämällä et voi tietää, mikäli joku on vaikka vastannut kysymykseesi sillä aikaa kun olet katkaissut yhteyden verkkoon.

Tästä syystä yleinen irkin käyttötapa on asentaa IRC-verkkoon yhdistävä asiakasohjelma ns. shellille tai virtuaalipalvelimelle jonne ohjelman voi jättää ajoon taustalle ja palaa takaisin kun yhdistää jälleen terminaalilla SSH-yhteyden palvelimeen. Yliopisto tarjoaa muun muassa tähän käyttöön shellipalvelinta.

Lisäksi uutena vaihtoehtona IRCnetiä voi nykyään käyttää Matrix-kommunikaatioprotokollan kautta. University of Twente tarjoaa oman IRCnet-palvelimensa lisäksi siltaa heidän oman IRCnet-palvelimen ja Matrix-palvelinverkon välille. Toisin kuin irkissä, viestit tallennetaan usealle federaatiossa olevalle palvelimelle. Tämän ansiosta (myöskin irkissä) lähetetyt viestit säilyvät. Matrix-palvelinverkkoon voi myös yhdistää monella eri tavalla, joista suosituin on nettiselaimessa ja älypuhelimissa toimiva Riot. Tämä on helpoin vaihtoehto myös niille jotka eivät ole koskeneet komentoriviin tai muuten pelkäävät sitä.

IRCnetiin yhdistäminen Matrixin kautta Riotilla

Matrix on avoin kommunikaatioprotokolla, joka on suunniteltu reaaliaikaiseen viesti-, ääni- ja videokeskusteluun hajautetussa palvelinverkossa. Matrixin yhteisön ansiosta Matrixiin on toteutettu erinäisiä integraatioita, jotka yhdistää Matrix-palvelinverkon muihin viestintäprotokolliin. Näistä yksi on Matrixin ja IRCnetin välinen integraatio, minkä ansiosta Matrixin käyttäjä voi liittyä mille tahansa kanavalle IRCnetissä Matrix-asiakasohjelmastaan.

Matrixia voi käyttää muun muassa [Riotilla https://riot.im/app/], joka toimii nettiselaimessa sekä älypuhelimissa.

IRCnetissä olevat kanavat löytyvät Matrixissa muodossa #_ircnet_#kanavanNimi:irc.snt.utwente.nl. Esimerkiksi jos haluat liittyä kanavalle #tkt-fuksitYYYY, niin liityt Matrixissa kanavalle #_ircnet_#tkt-fuksit2017:irc.snt.utwente.nl.

Liittyessäsi ensimmäistä kertaa IRCnetin puolella olevalle kanavalle saat yksityisviestinä botilta tietoa ja ohjeita. Tämän botin kautta voit myös jatkossa liittyä muille IRCnetissä oleville kanaville kirjoittamalla !join #kanava. Lisäksi voit myös muuttaa IRCnetissä olevan nimimerkkisi kirjoittamalla !nick nimimerkki. HUOM! minkä vain IRC-komennon ajaminen onnistuu kirjoittamalla !cmd irc.snt.utwente.nl KOMENTO #<channel> <parametrit>. Esimerkiksi oppien antaminen #tkt-random kanavalla olevalle käyttäjälle nimeltä velli-veikko sujuisi näin: !cmd irc.snt.utwente.nl MODE #tkt-random +o velli-veikko.


Kun lähetät kuvia tai videoita kanavalle, siltaa ylläpitävä ohjelmisto lähettää IRC:n puolelle URL-osoitteen kyseiseen liitteseen. Matrixissa nämä näkyvät suoraan keskustelussa.

SSH-yhteys ja IRC

Homma toimii perusperiaatteessaan niin, että käyttäjä ottaa SSH-yhteyden koneeltaan etäpalvelimeen (jotkut puhuvat näistä "shelleinä"), jossa käynnistää IRC-pääteohjelman, joka puolestaan ottaa yhteyden johonkin tiettyyn IRC-palvelimeen. SSH-yhteys itsessään on, näin yksinkertaisesti sanottuna, vahvan salauksensa vuoksi yleisesti käytetty tekstipohjainen etäkäyttöyhteys. Tulee myös huomata, että "etäpalvelinta" ja "IRC-palvelinta" ei tule tässä sekoittaa toisiinsa, vaan ne ovat kokonaan toisistaan riippumattomia asioita.

Tämän ohjeen tapauksessa kyseisenä etäpalvelimena toimii laitoksen oma Linux-palvelin, jota voi käyttää suositun IRC-pääteohjelman, Irssin ajamiseen. Voit kirjautua palvelimelle SSH-yhteyden avulla mistä tahansa verkkoon kytketystä koneesta, jossa on toimiva SSH-yhteysohjelma. Näistä lisää seuraavaksi.

SSH-yhteyden luominen

Windowsilla

Windows 10 -käyttöjärjestelmälle hyvä SSH-yhteysohjelma on Powershell. Se löytyy koneelta valmiiksi asennettuna.

Linuxilla ja OS X:llä

Useimmissa Unix-järjestelmissä on ssh-yhteysohjelma yleensä valmiiksi asennettuna ja jonka nimi on ytimekkäästi "ssh".

SSH-yhteyden laitoksen palvelimeen saa täten kirjoittamalla komentoriville/terminaaliin

ssh tunnus@melkki.cs.helsinki.fi

Automaattinen tunnistautuminen ssh-avaimella

Luomalla ensin omalla koneellasi ssh-avainpari

ssh-keygen -t rsa -C "your_email@example.com"

sitten kopioidaan oletuksella polkuun ~/.ssh/id_rsa.pub tiedoston sisältö laitoksen koneelle tiedostoon ~/.ssh/authorized_keys. Useampia avaimia voi lisätä tiedostoon rivinvaihdoilla erotettuna. Tiedosto voi näyttää esimerkiksi tältä:

#koti:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC4YFesUYLoafcu5aRM75AjxTZbc+[...]E4AUGrNzdtnjZ3oiTXJi6GnLl4NfMCzppXwtvlDGINpjG4VoHRM3b3FoCXa+poRUrFvNLtiZqUdLbVJrsh5pxq22j0oXJ/LN email@example.org

#jokutoinenautentikoitu:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC+jQlXHO6yNbesIn[...]hUBvy9Ebplg2Kp2UQNtvlDGINpjG4VoHRM3b3FoCXa+poRUrFvNLtiZqUdLFnEnZzIG80VaCsfvwnAO5L82uyExVoktnsf8ZnSQ== email@example.org

Irssin käyttö

Jos jaksat nähdä hieman enemmän vaivaa niin suositellumpaa on asentaa ja konfiguroida WeeChat. Irssikin toki on hyvä valinta - vanhan koulukunnan valinta.

Aloittaminen

Huom! Tämän kohdan ohje kertoo miten Irssi käynnistetään Melkille. Älä käynnistä aina irkkaamaan halutessasi uutta Irssiä, vaan katso kohdasta Keskeyttäminen ja jatkaminen miten jätät Irssin pyörimään Melkille.

Irssi toimii näppärästi screen-apuohjelman kanssa. Käynnistä Irssi syöttämällä komento

screen irssi

Mikäli Irssin ruutu on aluksi tyhjä, yhdistetään ensin palvelimelle. Se tapahtuu komennolla

/CONNECT palvelin

jossa palvelin-kohtaan laitetaan haluttu IRC-palvelin, esimerkiksi irc.cc.tut.fi.

Palvelimelle yhdistämisen jälkeen asetetaan oma nimimerkki eli "nick" ja oikea nimi seuraavilla komennoilla:

/SET nick nimimerkkisi
/SET real_name Etunimi Sukunimi

Lopulta voimme siirtyä jutustelemaan fuksikanavalle!

/join #tkt-fuksit2016

Keskeyttäminen ja jatkaminen

Irssin voi sulkea /quit -komennolla - mutta sitä ei kannata yleensä käyttää! Irssin voi jättää pyörimään Melkille screenin avulla, jolloin et menetä poissaollessassi käytyjä keskusteluja ja pystyt ottamaan vastaan viestejä milloin vain.

Voit piilottaa Irssin näppäinyhdistelmällä Ctrl+a+d, jolloin palaat Melkin komentoriville.

Kun otat uudestaan SSH-yhteyden Melkki-palvelimelle, älä käynnistä Irssiä uudelleen vaan ota esille aiemmin piilottamasi Irssi komennolla

screen -rd

Jos komento ei palauta Irssiäsi (There is no screen to attach), se voi olla kaatunut. Tällöin joudut käynnistämään uuden Irssin.

Tärkeimmät komennot

  • Nimimerkin vaihtaminen: /nick uusnick
  • Kanavalle liittyminen: /join #kanavannimi (tai /j)
  • Kanavalla olevien käyttäjien tulostaminen: /names (tai /n)
  • Kanavan otsikon vaihtaminen: /topic uusi otsikko
  • Operaattorioikeuksien (op) jakaminen: /op toinennick
  • Kanavalta poistuminen: /part
  • Irkistä kokonaan poistuminen, sulkee Irssin: /quit
  • Yksityisviestien lähettäminen: /msg kaverinnimi viesti
  • Nimimerkin käyttäjän selvitys: /whois outonick
  • "Vahinko-pasten" (puttyssa rightclick) estäminen: /set paste_verify_line_count 1


Oletuksena jokainen uusi kanava ja yksityiskeskustelu avautuu omaan ikkunaansa. Ikkunoita käsitellään seuraavasti:

  • Näkyvän ikkunan vaihtaminen: alt+numero tai esc+numero (kanavasta 10 eteenpäin 11=Q, 12=W, 13=E..., myös /win numero)
  • Seuraavaan ikkunaan siirtyminen: ctrl+n tai esc+→
  • Edelliseen ikkunaan siirtyminen: ctrl+p tai esc+←
  • Ikkunan sulkeminen: /window close (tai /wc)

Edelliset keskustelut näkee scrollaamalla PageUpilla ja PageDownilla, tai fn+shift+↑ ja fn+shift+↓.


Kaikki käytettävissä olevat komennot näet komennolla /help

Yksityiskohtaisempaa tietoa tietystä komennosta saat kirjoittamalla /help komennonnimi, esim /help whois

Tab-täydennys on hyödyllinen työkalu myös irkatessa. Kirjoittamalla osan esim. nimimerkistä ja painamalla tabulaattoria irssi täydentää lopun automaattisesti.

Lisäohjeita Irssiin liittyen löydät sen kotisivuilta osoitteesta http://irssi.org/documentation

WeeChatin käyttö (Beta)

Asennus

Melkiltä löytyy jo asennettuna jo WeeChatin ikivanha versio, Melkinkarilta jopa 1.3. Tämän takia Weechatin asentaminen lähdekoodista omaan kotihakemistoon voi olla suositeltavaa, mikäli aikoo esimerkiksi hyödyntää relay-ominaisuutta tai lukuisia skriptoja.

cd ~
# Lataa uusin WeeChatin lähdekoodi
wget http://weechat.org/files/src/weechat-1.6.tar.gz
tar zxvf weechat-1.6.tar.gz
# Luo käännetylle WeeChatille valmiiksi kansio
mkdir weechat
# Luo buildillesi kansio ja käännä lähdekoodi
cd weechat-1.6
mkdir build
cd build
# Melkiltä ei löydy Ruby-tuelle vaadittuja kehityskirjastoja, joten sen tuki joudutaan karsimaan pois.
cmake .. -DCMAKE_INSTALL_PREFIX=~/weechat -DENABLE_RUBY=OFF
make
make install
# Lisää WeeChatin binäärikansio PATH-muuttujaan
PATH=~/weechat/bin:$PATH
# Lisätään tämä muutos .bash_profileen/.bashrc:hen, jolloin muutos tulee voimaan jokaisella kirjautumisella.
echo 'PATH=~/weechat/bin:$PATH' >> .bash_profile
echo 'PATH=~/weechat/bin:$PATH' >> .bashrc
# Homma valmis.
weechat


Aloittaminen

Huom! Tämän kohdan ohje kertoo miten WeeChat käynnistetään Melkille. Älä käynnistä aina irkkaamaan halutessasi uutta WeeChat-instanssia, vaan katso kohdasta Keskeyttäminen ja jatkaminen miten jätät WeeChatin pyörimään Melkille.

WeeChat toimii näppärästi tmux-apuohjelman kanssa. Käynnistä uusi tmux-sessio syöttämällä komento

tmux new -s weechat

Käynnistä sen jälkeen WeeChat uudessa tmux-sessiossasi syöttämällä komento

weechat 

Ennen palvelimeen yhdistämistä on hyvä asettaa nimimerkki ja oikea nimensä

/set irc.server_default.nicks "nimimerkki"
/set irc.server_default.realname Etunimi Sukunimi

Nicksiin voi myös lisätä useamman nimimerkin pilkuilla erotettuna, jolloin weechat käy niiden listaa vasemmalta oikealle läpi jos ensisijainen nimimerkki on käytössä.

Lisätään ensimmäinen irc-palvelin ja yhdistetään siihen.

/server add IRCnet PALVELIN -autoconnect
/connect IRCnet

jossa palvelin-kohtaan laitetaan haluttu IRC-palvelin, esimerkiksi irc.cc.tut.fi tai open.ircnet.net jos käytät WeeChatia muualla kuin yliopiston palvelimella ja yhdistät Suomen ulkopuolelta.

Palvelimelle yhdistämisen jälkeen asetetaan oma nimimerkki eli "nick"

/nick nimimerkkisi

Lopulta voimme siirtyä jutustelemaan fuksikanavalle!

/join #tkt-fuksit2016

Keskeyttäminen ja jatkaminen

WeeChatin voi sulkea /quit -komennolla - mutta sitä ei kannata yleensä käyttää! WeeChatin voi jättää pyörimään Melkille tmuxin avulla, jolloin et menetä poissaollessassi käytyjä keskusteluja ja pystyt ottamaan vastaan viestejä milloin vain.

Voit piilottaa WeeChatin näppäinyhdistelmällä Ctrl+b ja niiden jälkeen näppäin d, jolloin palaat Melkin komentoriville.

Kun otat uudestaan SSH-yhteyden Melkki-palvelimelle, älä käynnistä Irssiä uudelleen vaan ota esille aiemmin piilottamasi WeeChat komennolla

tmux attach -t weechat

Jos komento ei palauta WeeChattiäsi, se voi olla kaatunut. Tällöin joudut käynnistämään WeeChatin uudelleen.

Tärkeimmät komennot

  • Nimimerkin vaihtaminen: /nick uusnick
  • Kanavalle liittyminen: /join #kanavannimi (tai /j)
  • Kanavalla olevien käyttäjien tulostaminen: /names (tai /n)
  • Kanavan otsikon vaihtaminen: /topic uusi otsikko
  • Operaattorioikeuksien (op) jakaminen: /op toinennick
  • Kanavalta poistuminen: /part
  • Irkistä kokonaan poistuminen, sulkee WeeChatin: /quit
  • Yksityisviestien lähettäminen: /query kaverinnimi viesti
  • Nimimerkin käyttäjän selvitys: /whois outonick


Oletuksena jokainen uusi kanava ja yksityiskeskustelu avautuu omaan bufferiinsa. Buffereita käsitellään seuraavasti:

  • Näkyvän bufferin vaihtaminen: alt+numero tai esc+numero (kanavasta 10 eteenpäin 11=Q, 12=W, 13=E..., myös /buffer numero)
  • Seuraavaan bufferiin siirtyminen: ctrl+n tai esc+→
  • Edelliseen bufferiin siirtyminen: ctrl+p tai esc+←
  • Bufferin sulkeminen: /close

Edelliset keskustelut näkee scrollaamalla PageUpilla ja PageDownilla, tai fn+shift+↑ ja fn+shift+↓.


Hienosäätöä

  • Hiiren käytön salliminen WeeChatissä: /mouse enable
  • Kanavalta poistuminen sulkee bufferin: /set irc.look.part_closes_buffer on
  • Bufferilista siirtäminen ikkunan alaosaan: /set weechat.bar.buffers.position bottom Huom! Bufferilistan saa scriptillä buffers.pl, ks. kohta Scriptit
  • Nickien näytettävän merkkimäärän rajoittaminen keskustelualueella: /set weechat.look.prefix_align_max 15
  • Prefiksi ja suffiksi nickeille:
/set weechat.look.nick_prefix <
/set weechat.look.nick_suffix >
  • Yhtenäinen viiva nimimerkkien ja viestien erottajaksi sekä luettujen ja lukemattomien viestien erottajaksi:
/set weechat.look.prefix_suffix "│"
/set weechat.look.read_marker_string "─"
  • Sekunnit pois timestampista: /set weechat.look.buffer_time_format [%H:%M]
  • Enemmän rivejä pitkän topicin/otsikon näyttämiseen:
/set weechat.bar.title.size 0  
/set weechat.bar.title.size_max 3
/set weechat.bar.input.size 0
/set weechat.bar.input.size_max 3
  • Lisää asetuksia voit selata: /set irc.*


Scriptit

  • Scriptien (lisäosien) hallinnan välilehden avaaminen: /script
  • Ohjeet scriptien asennukseen ja poistamiseen bufferin otsikossa


Kaikki käytettävissä olevat komennot näet komennolla /help

Yksityiskohtaisempaa tietoa tietystä komennosta saat kirjoittamalla /help komennonnimi, esim /help whois

Tab-täydennys on hyödyllinen työkalu myös irkatessa. Kirjoittamalla osan esim. nimimerkistä ja painamalla tabulaattoria WeeChat täydentää lopun automaattisesti.

Lisäohjeita WeeChattiin liittyen löydät sen kotisivuilta osoitteesta https://weechat.org/doc/stable/

Muuta huomioitavaa

  • Irkin Fuksikanava toimii, nimestä huolimattaan, laitoksen useimpien irkkaavien tietojenkäsittelytieteilijöiden ensisijaisena tiedonlähteenä, ei pelkästään fuksien (ei koske Telegramin fuksikanavaa). Fuksikanava (#tkt-fuksit<vuosiluku>) vaihtuu kuitenkin vasta kesällä, ei siis vielä uutenavuotena.
  • Keskustelukanavat-sivulta löydät useita IRC-kanavia. Jos tarvitset apua jonkin tietyn kurssin suhteen, sitä kannattaa kysellä ensisijaisesti kurssikohtaiselta kanavalta. Fuksikanavaltakin voi toki kysellä apua, mutta siellä kysymyksesi saattaa jäädä muun keskustelun jalkoihin.
  • Jos olet kirjautuneena laitoksen Linux-työasemalle ja haluat ottaa ssh-yhteyden melkki.cs.helsinki.fi -palvelimeen, riittää pelkkä "ssh melkki" - siis ilman täydellistä osoitetta.
  • Irssiin teemoja löydät osoitteesta http://irssi.org/themes. Laitoksen Linux-puolelta saatat joutua säätämään terminaalisi väreiksi linux-värit, jotta teemasi värit näkyvät oikein.
  • Muitakin IRC-palvelimia on, ks. tämä listaus. Kaikkiin näistä ei kuitenkaan esimerkiksi laitosympäristön melkki-palvelimelta pääse.
  • Jos haluat olla erilainen nuori, voit käyttää melkin sijasta myös melkinpaasi-nimistä palvelinta.