Documentation and license headers for new systemvm testing tools.

tools/appliance/README.md

@@ -101,7 +101,7 @@ the systemvmtemplate:
     cp -r definitions/systemvmtemplate definitions/systemvm64template
     veewee vbox build 'systemvm64template'
 
-Trobuleshooting
+Troubleshooting
 ===============
 If you see following line in the screen, then veewee is failing 
 extracting vboxmanage version.
@@ -115,3 +115,9 @@ You would be able to check it manually by typing:
 If you're using Fedora for example, you'll need to install `kernel-devel`
 package and run `/etc/init.d/vboxdrv setup` to get veewee working.
 
+Testing
+=======
+The ./test.sh script tries out a few different default ways to invoke build.sh.
+
+See ../vagrant/systemvm for a test setup that uses vagrant+serverspec to
+provide actual integration tests that verify the built systemvm is up to spec.

tools/vagrant/systemvm/.gitignore

@@ -49,3 +49,4 @@ systemvm.iso
 iso/*
 
 rspec.xml
+vendor/

tools/vagrant/systemvm/Gemfile

@@ -1,3 +1,20 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 source 'https://rubygems.org'
 
 gem 'rake'

tools/vagrant/systemvm/README.md

@@ -1,2 +1,30 @@
-systemvm-vagrant
-================
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+
+===========================================================
+
+Allows spinning up the systemvm appliance from ../../appliance inside
+vagrant, and then running tests against it with serverspec.
+
+To use, install vagrant, rvm, ruby, and bundler. Then run ./test.sh.
+
+To write tests, create files underneath spec/ whose names end in
+_spec.rb. These tests are [RSpec](http://rspec.info/) tests that use
+[Serverspec](http://serverspec.org/) matchers. Basically, they log
+in using SSH and then inspect files and processes. See the list of
+[Serverspec matchers](http://serverspec.org/resource_types.html)
+for inspiration.

tools/vagrant/systemvm/Rakefile

@@ -1,3 +1,20 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 require 'rake'
 require 'rspec/core/rake_task'
 

tools/vagrant/systemvm/VBoxManage

@@ -1,4 +1,20 @@
 #!/bin/bash
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 
 # In some cases, while booting a virtual machine, an IDE controller
 # will be created for it. It seems that the VirtualBox GUI likes doing

tools/vagrant/systemvm/Vagrantfile

@@ -1,5 +1,23 @@
 #-*- mode: ruby -*-
 # vi: set ft=ruby :
+
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 include RbConfig
 
 VAGRANTFILE_API_VERSION = '2'

tools/vagrant/systemvm/spec/spec_helper.rb

@@ -1,3 +1,20 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 require 'serverspec'
 require 'pathname'
 require 'net/ssh'

tools/vagrant/systemvm/spec/test_cloudstack_metadata_spec.rb

@@ -1,3 +1,20 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 require 'spec_helper'
 
 describe file('/etc/cloudstack-release') do