Vmware playground for plan9
0 - WHAT WILL YOU GET
- a standalone fs/auth/fileserver
- a couple of cpu servers booted from network
- a couple of terminal booted from network or a drawterm :)
With that i will practice distributed programming with plan9 using one computer connected to internet.
It would be better if you try to install a terminal and play a bit with it, to get used to use the plan9 environment properly.
And even better if you have a couple of supported machines to see the real thing :=)
1 - INSTALL YOUR VMWARE_LIKE SOFTWARE
The following considerations must be done prior to select a virtual machine software:
- Boot from PXE support
- Multiple concurrent instances
- Supportfor bridget network with the host
I choosed vmware 4.5.2 as its support all of the above and it is supported by Plan9 graphics system.
The vmware 5.0 machine can be used but the install process must be done using text only, so if you're not proficent with ed, you better choose 4.5.2.
qemu can be used as well but i know nothing about it, so may be someone wants to make this brief more complete.
2 - INSTALLING THE FIRST VIRTUAL MACHINE
- Task: configfs
Here we select fossil+venti as we first will set up a standalone plan9 auth/cpu/file server.
Later we split that in different machines
I suggest you to use the default partition layout and default slices layout.
- Follow the in screen instructions and finish the installation.
You should be able to do it without more indications as the installation program is intuitive enough.
3 - BOOT AND INITIAL SET UP
- Log in as glenda
At this moment fossil will start the first snapshot to venti so disk will be crazy for a little while.
Take a coffe in the mean while, and later follow with the configuration instructions.
- Add glenda to sys and adm groups
% con /srv/fscons prompt: fsys main main: uname sys +glenda main: uname adm + glenda
- Configure minimal NDB
ipnet=devel.net ip=192.168.1.1 ipmask=255.255.255.0 ipgw=192.168.1.1 dns=130.206.1.3 fs=kenshin auth=kenshin authdom=lloth.net sys=kenshin ip=192.168.1.200 ether=000c29a15062 dom=kenshin.devel.net bootf=/386/9pccpuf proto=il
- Set up the internet connection through your gateway
% ip/ipconfig -g 192.168.1.1 ether /net/ether0 192.168.1.200 255.255.255.0 % echo refresh > /net/cs % echo refresh > /net/dns % ip/ping www.google.com
If you can't reach google look through the wiki and 9fans archives to configure your network.
- Update your plan9 installation from sources
% pull -v
- Compile the cpu/auth/fileserver standalone kernel and install it
% cd /sys/src/9/pc % mk 'CONF=pccpuf' install % 9fat: % cp 9pccpuf.gz /n/9fat/ % acme /n/9fat/plan9.ini set the bootfile to 9pccpuf.gz
- Set up boot process for a cpu
% acme /rc/bin/cpurc
Put the ip/ipconfig line to boot with network configured before the ndb/cs line and uncomment the lines marked as needed for booting other systems and for auth servers
- Add bootes user and add it to the groups sys and adm and remove user glenda
- Initialize nvram storage
% echo blah > /dev/sdC0/nvram
- Set up your timezone
% cp /adm/timezone/CET /adm/timezone/local
- Edit /lib/ndb/auth and uncomment the lines
% con /srv/fscons prompt: fsys main main: uname bootes bootes main: uname sys +bootes main: uname adm +bootes main: uname sys -glenda main: uname adm -glenda
4. FIRST BOOT
- Set up the nvram
authid: bootes authdom: devel.net secstore: invent_a_secstore_password password: invent_a_bootes_password
- Initialize user
% /sys/lib/newuserThis will not bring you to rio
% auth/changeuser bootesPut the same password you invented in the last step, you can enter the other data as you want
- First Drawterm
c:\> drawterm-windows -a 192.168.1.200 -c 192.168.1.200 user[none]: bootes password: you know what to put here :)
This will give you a rio environment.
5. Set up the multiboot environment
- Set up the /cfg directory
% con /srv/fscons prompt: fsys main main: create /active/cfg sys sys d775 main: % mkdir /cfg/pxe % mkdir /cfg/kenshin
- Set up multiboot cpurc as jmk posted on 9fans (save the old one):
#!/bin/rc boottime=`{date} boottime=$"boottime # parallelism for mk NPROC=`{wc -l /dev/sysstat} NPROC=`{echo $NPROC|sed 's/ .*//'} # get rid of need for dirs in /n mntgen -s slashn && chmod 666 /srv/slashn # cs sets /dev/sysname ndb/cs sysname=`{cat /dev/sysname} prompt=($sysname^'# ' ' ') # site specific startup if(test -e /rc/bin/cpurc.local) . /rc/bin/cpurc.local # cpu specific startup if(test -e /cfg/$sysname/cpurc) . /cfg/$sysname/cpurc # if we're not a server, start a dns resolver if(! test -e /srv/dns) ndb/dns -r # reboot if we lose the file server aux/reboot # turn on dong's tcp port hog defense if( test -e /net/tcp/clone) echo -n tcpporthogdefense on > /net/tcp/0/ctl # keep other bootes processes from creating capabilities rm '#ยค/caphash' > /dev/null >[2=1] # start up internet if we don't already have an address if(! grep u /net/ipselftab | grep -sv 127.0.0.1) ip/ipconfig if(! grep -s 127.0.0.1 /net/ipselftab) ip/ipconfig loopback /dev/null 127.1 # start listeners if it hasn't already been done (dicey check) if(! netstat -n | grep -s 'tcp.*Listen.* (7|9|21|22|23|25|110|113|565|993|17007|17009|17010) .*') aux/listen -q tcp if(! netstat -n | grep -v 17008 | grep -s il.*Listen) aux/listen -q il if(! ps|grep -s timesync) aux/timesync -s /net -nl -d /sys/log/timesync.d oncore achille # cpu specific startup if(test -e /cfg/$sysname/cpustart) . /cfg/$sysname/cpustart exit 0
- Now use the old cpurc to generate what we need for the standalone server /cfg/kenshin/cpurc
#!/bin/rc ip/ipconfig -g 192.168.1.1 ether /net/ether0 192.168.1.200 255.255.255.0 ndb/dns -r prompt=($sysname^'# ' ' ') aux/timesync hora.rediris.es ip/dhcpd ip/tftpd auth/keyfs -wp -m /mnt/keys /adm/keys >/dev/null >[2=1] auth/cron >>/sys/log/cron >[2=1] & aux/listen -q -t /rc/bin/service.auth -d /rc/bin/service il aux/listen -q -t /rc/bin/service.auth -d /rc/bin/service tcp
- Make fossil listen for network connections. Generate a flproto file like:
cpu% cat flproto fsys main config /dev/sdC0/fossil fsys main open -c 3000 fsys main snaptime -s 60 -a 0500 -t 2880 listen tcp!*!564 cpu% cat flproto | fossil/conf -w /dev/sdC0/fossil
6. Test the new cpurc files, so reboot the machine
If something fails, i hope the error message would be enought to let you fix the problem :)
7. Now create other virtual machine.
- This one will need only a very small disk to store nvram. Will be enough with 1Kb but vmware will only let you choose 0.1GB, that is 100Mb.
8. Add a new machine
- Set up the NDB
sys=ant ip=192.168.1.201 ether=000c29a15062 dom=ant.lloth.net bootf=/386/9pxeload proto=il
You will need to put the mac of the virtual machine so check it on your virtual machine ( in vmware set up to boot from network and copy the mac address )
- Set up the /cfg entry
Create a file ith the mac address as name
% acme /cfg/pxe/mac
That file must contain a plan9.ini file
bootfile=ether0!/386/9pccpu bootargs=tcp!192.168.1.200!564 *nomp=1 *nodumpstack=1 partition=new
- Create the cpurc for this machine under /cfg/ant/cpurc
#!/bin/rc prompt=($sysname^'# ' ' ') aux/timesync hora.rediris.es aux/listen -q -t /rc/bin/service.auth -d /rc/bin/service il aux/listen -q -t /rc/bin/service.auth -d /rc/bin/service tcp
9. Boot the new cpu machine
- It will ask you for the nvram data, but this time you haven't created the partition, so it will fail to store it.
- Create the nvram partition as follows:
% disk/mbr /dev/sdC0/data % disk/fdisk /dev/sdC0/data >>> a p0 start cylinder: 0 end [0..208] 208 >>> w >>> q % disk/prep /dev/sdC0/plan9 >>> a 9fat start sector: 0 end [0..209715] 200000 >>> a nvram start sector: 200000 end [200000..209715] 209715 >>> w >>> q % disk/fdisk -p /dev/sdC0/data > /dev/sdC0/ctl
- Reboot the cpu server and put the hostid info again
Now we got the first machine booted from network up and running
10. Testing auth
cpu% cpu -h ant -c rc
Adding key: dom=lloth.net proto=p9sk1 user[bootes]: bootes password: cpu% cat /dev/sysname antcpu%
- We can log to the cpu server and run tasks there
Now that we have two machines, we can configure our prompt to show us where we are. Put this on /usr/bootes/lib/profile
fn cd { builtin cd $1;awd; prompt=(`{cat /dev/sysname}^' '^`{pwd}^'%' ' ') } cpu% fn cd { builtin cd $1;awd; prompt=(`{cat /dev/sysname}^' '^`{pwd}^'% ' ' ') } cpu% cd kenshin /usr/bootes% acme lib/profile kenshin /usr/bootes% cpu -h ant -c rc ant /usr/bootes% ant /usr/bootes% ant /usr/bootes%
Usually the path is too fancy.
11. Clone a machine and start up a new cpu server
vmware 5 will let you clone machines, so i upgraded to it. I will not explain how to clone vmware machines as may be you just used other virtualization software (or even the real hardware)
To start up a new server, when we have the machine ready, and its MAC address written somewhere is:
- Set up the NDB file with the new machine
- Set up the /cfg environment for that machine
/cfg/pxe/mac file /cfg/system_name/cpurc
- and boot it from the network
I created 5 machines with 64MB of ram each one.
As terminal i will use drawterm, as i upgraded to vmware 5, and vga is not supported and there are problems with cut&paste. . .
12. Adding users to the playground
In the console of kenshin our main file server/auth/cpu we can add users as described in the wiki.
% auth/changeuser gdiaz % con/srv/fscons prompt: fsys main main: uname gdiaz gdiaz %
Now i can drawterm with the new user
And make my first distributed application with plan9 :)
#!/bin/rc servers=(kenshin ant shrek niki connor kirk) timezones=(CET EDT Canada_Pacific Japan US_Hawaii Singapore) minx=0 miny=0 maxx=100 maxy=100 i=1 for (s in $servers) { echo vars: $timezones($i), $i, $minx , $maxx script=''''^'cat /adm/timezone/'^$timezones($i)^' > /env/timezone; clock'^'''' window -r $minx $miny $maxx $maxy cpu -h $s -c $script i = `{ echo $i+1 | bc } minx = `{echo $i^'*100' | bc } maxx = `{echo $minx^'+'^100 | bc } }