====== Plan 9 on SDF VPS ======

===== Contents =====

  * [[#Basics]]
  * [[#Networking]]
  * [[#Drawterm on Plan 9]]
  * [[#Getting started with drawterm]]
  * [[#Adding a User]]
  * [[#Links]]

===== Basics =====

When your Plan 9 system boots, it will ask you where root is from (via the network, or a local disk). Just hit "[ENTER]" to select local (the default):

  root is from (tcp, local)[local!#S/sd00/fossil]:

Next you will be prompted to log in. Log in as the default user, "glenda":

<code>
  user[none]: glenda
  time...
  fossil(#S/sd00/fossil)...version...time...

  init: starting /bin/rc
  #m/mousectl: rc: can't open: unknown device in # filename
  init: rc exit status: rc 24: error

  init: starting /bin/rc
  %
</code>

You will now be sitting at a "rc" prompt, Plan 9's shell.

===== Networking =====

==== Configuring Your IP Address ====

In your control panel at vps.sdf.org, note YOUR_IP (e.g. 192.94.73.x) on the top line.

Start your server, and log in via the console. (default=glenda)

At the "rc" prompt (%), enter:

  % ip/ipconfig -g 192.94.73.1 ether /net/ether0 YOUR_IP 255.255.255.0

This configuration lasts until you reboot Plan 9.

===== Drawterm on Plan 9 =====

Configure your IP address first.

At the "rc" prompt (%), enter these two lines. Replace PASSWORD by the password you want.

  % echo 'key proto=p9sk1 dom=plan9 user=glenda !password=PASSWORD' >/mnt/factotum/ctl
  % aux/listen1 -t tcp!*!ncpu /bin/cpu -R &

This password lasts until you reboot Plan 9.

===== Getting started with drawterm =====

{{http://sdf.org/tutorials/images/drawterm.png}} Now on your local computer download and install [[http://swtch.com/drawterm/|drawterm]] and start it by typing:

  ./drawterm -a YOUR_IP -c YOUR_IP -u glenda

YOUR_IP must match the IP address described in [[#networking|Networking]].\\  After typing your password, press the right button of your mouse. A menu should appear. Then release the button over New. \\  Now press again the right button near the up left corner of drawterm and drag the mouse to the lower right before releasing the button, drawing a rectangle.\\  You should now have a terminal window. The first thing you should probably do is to type "cat readme.rio" (or read it from [[http://sdf.org/tutorials/misc/readme.rio|here]])

===== Adding a User =====

You may wish to add a user to your system once you get the hang of things. There is really no need to create a new user when you are first starting out. To create a new user you will have to connect to the file server console by typing:

% con -l /srv/fscons

Now at the file server prompt create a new user. Replace USER with what you want your new user to be named:

  prompt: uname USER USER

Now you will need to add that user to the "sys" group if you want it to be able to change system configuration files. Again, change USER to what your new user name is:

  prompt: uname sys +USER

Now exit the file server console byi typing: "ctrl+\". You will now be at a ">>>" prompt; type "q" to quit.""

===== Links =====

=== Tutorials ===

  * [[http://sdf.org/?tutorials/VPS_Plan9|Plan 9 on SDF VPS]]
  * [[http://jgw.tx0.org/howto/building_drawterm.html|Building Drawterm on NetBSD-5.x/i386]]
  * [[http://www.quanstro.net/newbie-guide.pdf|A Plan 9 Newbie's Guide [PDF]]]
  * [[http://www.9gridchan.org/plan_9_basics|Plan 9 basics]]
  * [[http://doc.cat-v.org/plan_9/misc/rit-intro|RIT Plan 9 introduction]]
  * [[http://plan9.bell-labs.com/wiki/plan9/UNIX_to_Plan_9_command_translation/index.html|Plan9 commands for UNIX users]]

=== Utilities ===

  * [[http://cm.bell-labs.com/sys/man/|Manual pages]]
  * [[http://citeseer.ist.psu.edu/viewdoc/download?doi=10.1.1.41.3287&rep=rep1&type=pdf|Rc -- A Shell for Plan 9 and UNIX Systems [PDF]]]
  * 
=== Videos ===

  * [[http://www.youtube.com/watch?v=SoGLU1l7LwY|Narrated Plan 9]]
  * [[http://www.youtube.com/watch?v=dopu3ZtdCsg|Plan9 Acme Intro - Part 1]]
  * [[http://www.youtube.com/watch?v=2vjD_B__SbQ|Plan9 Acme Intro - Part 2]]
  * [[http://www.youtube.com/watch?v=cR96WQ6OR00|Plan9 Acme Intro - Part 3]]
  * [[http://www.youtube.com/watch?v=byoznMe8ab4|Acme Mail Demo]]
  * [[http://www.youtube.com/watch?v=Pydckb9ZU8Y|Acme Editor Demo]]
  * 
=== Books ===

  * [[http://lsub.org/who/nemo/9.intro.pdf|Introduction to Operating Systems Abstractions Using Plan 9 from Bell Labs [PDF]]]