More info on installing Moonshot and on running tests with the vm images

diff --git a/index.mdwn b/index.mdwn
index 08c5595..6f99a2a 100644 (file)
--- a/index.mdwn
+++ b/index.mdwn
@@ -3,4 +3,6 @@
 This is a wiki for those working on or using the Moonshot code base.
 
 * [[Building]] Moonshot
+* [[Prepare]] to use the system once built
 * [[Design]] Discussions
+* Information on [[VM Images|vmdk]]

diff --git a/prepare.mdwn b/prepare.mdwn
index a239733..e5146d7 100644 (file)
--- a/prepare.mdwn
+++ b/prepare.mdwn
@@ -1,8 +1,15 @@
 # Preparing to use Moonshot
 
-First, look at the mech file in the mech_eap directory of the source
-tree. Copy this file to /etc/gss/mech and change the location of
-mech_eap.so to be correct for your installation.
+First, look at the mech file in the mech_eap directory of the source tree. Copy this file to /etc/gss/mech (or on Debian/Ubuntu systems /usr/etc/gss/mech). The Debian path is a bug that will be fixed; this page will be updated after.
+
+Then, create a symlink from /usr/lib/gss/mech_eap.so to the installed mech_eap.so. Are you getting the feeling you're running down some untested code paths here yet?
+
+On Debian systems make sure /usr/lib/freeradius is in your default linker search path. Perhaps edit /etc/ld.so.conf and run ldconfig. Yes, that too is a bug.
+
+Create a radsec.conf in $prefix/etc/radsec.conf.
+
+Create a valid freeradius dictionary in $prefix/share/freeradius/dictionary. This may be a bug as well.
+
 
 Todo:
 * configure libradsec

diff --git a/vmdk.mdwn b/vmdk.mdwn
new file mode 100644 (file)
index 0000000..868c9d5
--- /dev/null
+++ b/vmdk.mdwn
@@ -0,0 +1,37 @@
+[[!meta title="VM images"]]
+
+There is a Moonshot test VM image that contains a complete development environment for Moonshot. In particular it contains:
+
+* compiler, debugger
+* Sources for moonshot, Shibboleth, libradsec and the like
+* All dependencies mentioned [[here|building]]
+* A build of the [MIT Kerberos](http://web.mit.edu/kerberos/) gss-sample applications
+* A configured freeradius server
+
+The image is based off Debian squeeze Until a reasonable mechanism to
+distribute Debian source media to comply with the GPL is made, contact
+Sam Hartman for a copy of the image. It is around 1.7G in size.
+
+## What it works with
+
+The Image should work with:
+* xen (tested)
+* Virtualbox (tested)
+* qemu (tested)
+* Vmware
+
+
+## Consoles
+
+Consoles are available on hvc0 (virt_ops console for xen), ttyS0 (serial console) and on the monitor and keyboard.
+
+## Logging in
+
+There is one account; user moonshot with password moonshot.
+
+## testing Moonshot
+
+ *        cd krb5-1.9/src/appl/gss-sample
+*         ./gss-server  host@moonshot-test.project-moonshot.org
+*         ./gss-client  -mech "{1 3 6 1 4 1 5322 22 1 18}" \
+              -user steve@local -pass testing  127.0.0.1 host@localhost  bar