Cinnamon server VM
Introduction to the Cinnamon server VM
The Cinnamon server VM is a Ubuntu Linux Server 10.04 VMware VM and is available for free as a 32 bit version.
Cinnamon also runs on 64 bit systems (of course!) - but as the 32 bit versions runs everywhere, we have decided to just keep the 32 bit version current for download.
Technical data for 2.0.2
| OS |
Ubuntu Linux 10.04 |
| RAM |
1024 MB |
| Processors |
2 |
| HD space required |
<5 GByte |
| GUI |
none (CLI only) |
| Username |
cinnamon |
| Password |
cinnamon |
| Database |
Postgresql 8.4 |
| ServletContainer |
Tomcat 6 |
| Java |
OpenJDK 6 |
| Dandelion (Admin Tool) |
$ip:8080/dandelion User: admin / admin |
| Illicium (experimental Webclient) |
$ip:8080/illicium User: admin / admin |
| SSH |
port 22 |
| Cinnamon Server HTTP |
$ip:8080/cinnamon/cinnamon (displays XML list of repositories) Client-User: admin / admin |
| PostgreSQL port |
5432 |
Configure keyboard
Keyboard layout on the console is currently German, you can change it via
sudo dpkg-reconfigure console-setup
Configuring the network
After unpacking the VM, you will probably have to configure the network. This is easy and takes just 2-4 minutes:
- login as user 'cinnamon' with password 'cinnamon'
- enter: ifconfig -a <return>
You should see something like:
If ethX has a valid IP address, you are done here - just update CinnamonDesktopClient.config.xml to point to this IP. - In the case that only the local "lo"-Interface is shown, you have to enable ethernet networking.
Type: sudo nano /etc/network/interfaces
And replace ethY with ethX. For example, if ifconfig showed you that there is an unconfigured eth5, and interfaces contains two lines which have eth4, you should replace eth4 with eth5 and save the interfaces file. - Afterwards, restart the network with
sudo /etc/init.d/networking restart
- and take another look at the network (with "ifconfig"). Now you should be able to find the IP address of your Cinnamon VM and add it to the CinnamonDesktop Client's configuration file.
File System Layout
| File |
Location |
|---|---|
| Cinnamon configuration file |
/home/cinnamon/cinnamon_config.xml |
| Dandelion configuration file |
/home/cinnamon/dandelion_config.groovy |
| File storage | /home/cinnamon/cinnamon-data |
| Lucene index |
/home/cinnamon/cinnamon-data/index |
| Lucene configuration |
/home/cinnamon/lucene.properties |
| Log files |
/home/cinnamon/cinnamon-system/global/log/cinnamon.log |
| Log settings |
/home/cinnamon/logback.xml |
| Tomcat Webapps Dir |
/var/lib/tomcat6/webapps |
Security
The Cinnamon VM is configured for easy access during development. For this purpose, it has simple passwords and may have pre-installed SSH public keys in the user's and root's SSH directory. This is ok for testing, but not for production use or if you are going to install this VM as a public (Internet-facing) service. If you enable direct access to the VM from the Internet, you must secure the VM first, otherwise every yahoo from the Intarnets is going to p0wn your machine.
# remove SSH authorized_keys: rm -f /home/cinnamon/.ssh/authorized_keys sudo rm -f /root/.ssh/authorized_keys # change password: passwd # change postgresql password psql postgres \password $newpassword \q # do not forget to update the database password in cinnamon_config.xml! nano cinnamon_config.xml # change the passwords for tomcat6 admin: sudo nano /etc/tomcat6/tomcat-users.xml
If you need help securing your Cinnamon Ubuntu VM or other parts of your Cinnamon installation, please contact us.

