README.md in cloud-toaster-1.1.2 vs README.md in cloud-toaster-1.1.3
- old
+ new
@@ -9,11 +9,11 @@
* Important note: We highly recommend to install ToASTER only on dedicated machines,
e.g., a clean virtual machine from Amazon EC2. Do not install toaster on any
production servers or your own development machine! The reasons are twofold: first,
toaster requires a high amount of disk space for creating LXC containers, storing
test data etc; second, toaster relies on a comprehensive third-party software stack
- (docker.io, LXC, Squid, MongoDB, Ruby, Ruby gems, etc), which might interfere with
+ (docker.io, LXC, Squid, MySQL, Ruby, Ruby gems, etc), which might interfere with
and pollute the working environment of production machines.
* Target platform: Ubuntu 13.04
```
@@ -30,24 +30,34 @@
gem install --no-ri --no-rdoc toaster-1.0.0.gem
# (OR: install directly using rubygems.org: gem install cloud-toaster)
# toaster setup:
-toaster setup # (setup testing host / utility host. Enter 192.168.100.2 as "mongodb.host" parameter)
+toaster setup # (setup testing host / utility host. Enter 192.168.100.2 as "db.host" parameter)
toaster proto ubuntu1 ubuntu # (initialize prototype container)
```
The code listing above illustrates the single-node installation. For multiple testing hosts,
-set the mongodb.host configuration to the public IP/hostname of a central MongoDB server to be
+set the db.host configuration to the public IP/hostname of a central MySQL DB server to be
shared among all hosts.
## User Commands
```
toaster web -d # (run the Web UI in a screen session in the background; web port 8080)
toaster agent # (start test agent in the background; web port 8385)
-toaster spawn lxc1 ubuntu1 # (create container)
+toaster spawn lxc1 ubuntu1 # (create container)
toaster clean # (clean containers)
+```
+
+## Notes and Known Issues
+
+* If the command "toaster web" does not work for you (i.e., hangs), try the following:
+
+```
+cd /usr/local/rvm/gems/ruby-2.1.2/gems/cloud-toaster-1.1.2/webapp/ && bundle install
+/usr/local/rvm/gems/ruby-2.1.2/gems/cloud-toaster-1.1.2/webapp/bin/rails server thin
+# (assuming your gems directory is /usr/local/rvm/gems/ruby-2.1.2/gems)
```
## License
ToASTER is published under the Apache License version 2.0. See LICENSE.txt for details.