Shellshare

Eesti keeles

Võimalus jagada käsurida Pythoni abil reaalajas veebipõhiselt ja võimaldada õppuritel paremini jälgida tunnis antud käske ja nende väljundit ja vältida ümberkirjutamisest tekkivaid vigu. Võimalus ka virtuaalmasinast otse käsurida edastada. Edastamine toimub vaid vaatamisrežiimis. Kui soovitakse muutmisrežiimis (aka collaborative hacking) siis näiteks Teleconsole võib huvi pakkuda.

Paigaldamine

• skripti allalaadimine https://github.com/vitorbaptista/shellshare/releases - valida Latest Release
  • on olemas ka programmi koduleht kus allalaadimise viide kuid võib juhtuda, et see ei tööta
• lahtipakitud kaustast leiab skripti ./public/bin/shellshare - selle võib ka ringi nimetada shellshare.py ja kopeerida endale meelepärasesse asukohta, võib paralleelselt ka sobivasse kohta veebis paigutada, et kiirelt näiteks virtuaalmasinasse alla laadida

Edastamine

• käsurea edastamise alustamiseks:

python /asukoht/shellshare.py --server linux.itcollege.ee:3000 --room ruuminimi --password salasõna

• asendada
  • asukoht tegeliku asukohaga
  • ruuminimi soovitud nimega
  • salasõna soovitud salasõnaga
• terminali edastamine on nähtav peale ülalnimetatud käsu käivitamist käsureal näidatud aadressil http://linux.itcollege.ee:3000/r/ruuminimi kus ruuminimi asemel on valitud nimetus
• veebi edastatud käsud on kopeeritavad, ajalugu vaadatav tagasi kerides (ei ole soovitav käsurida vahepeal puhastada)

Toetatud on ka mitmest terminalist korraga samale aadressile käsurea edastamine - nii on võimalik samaaegselt edastada käsurida klassiarvutist, virtuaalmasinast jne korraga samale sessioonile - nii on õppuri jaoks info ühes kohas. Info tuleb ära kopeerida, sest edastamise lõppemisel ja akna sulgemisel ajalugu ei säili.

Kui kirjutada:

python /asukoht/shellshare.py --room ruuminimi --password salasõna

... siis edastatakse shellshare.net serveri kaudu kui see töötab.

Kiire kasutamine

Võimalus teha ka lühikäsk ehk alias (vt Alias bash shellis, .bash_aliases), skript vms käsurea jagamise kiireks käivitamiseks soovitud ruuminimega

Edastamise lõpetamine

Käsurea edastamise lõpetamine: exit+Enter, sageli toimib ka CTRL+D

Erilised tänud

Erilised tänud TTÜ IT Kolledži Linuxi administraatorile Veiko Tuul serveripoole käivitamise ja selle suurepärase võimaluse loomise eest!

Viited

• https://shellshare.net/
• https://github.com/vitorbaptista/shellshare/

in English

There is an option to share command-line over Internet in real time using Python. This allows for students to follow lecturer commands and its output and avoid mistakes of rewriting commands. Streaming is going only in read-only mode. If there is edit mode needed then probably Teleconsole is one of the choices you may be interested in.

Setup

• download the appropriate script at https://github.com/vitorbaptista/shellshare/releases - choose Latest Release
  • there is also program homepage where download is described but it might happen that the site is offline
• from unpacked folder there can be found the script ./public/bin/shellshare - this can be renamed toshellshare.py and copy whenever needed. There is also possible to copy unpacked shellshare script to somewhere in the web so you can quickly download e.g. into virtual machine.

Streaming

• to start streaming the command-line in real time:

python /asukoht/shellshare.py --server linux.itcollege.ee:3000 --room roomname --password qwerty

• replace
  • roomname with real location
  • qwerty with real password
• command-line streaming is visible at http://linux.itcollege.ee:3000/r/roomname after running mentioned command, where instead of roomname there is chosen name
• streamed commands online can be copied, history is reviewable by scrolling up (do not clear the screen in command-line)

Also streaming simultaneously from multiple terminal to same address is supported. You can stream from classroom computer, virtual machine, etc to the same session - in that way all information is on the same place. The information should be copied to permanent place because after stopping the streaming and closing the window also history will be gone.

Fast usage

There can be an alias created (see also .bash_aliases), script etc to start quickly streaming command-line with appropriate settings.

Stop streaming

To stop command-line streaming: exit+Enter, usually also CTRL+D works.

Special thanks

Special thanks goes to TUT IT College Linux administrator Veiko Tuul to set up server side and offering such a great opportunity!

Links

• https://shellshare.net/
• https://github.com/vitorbaptista/shellshare/