Virtual machine image / software appliance

Introduction

A software appliance in the form of a VMware image is available to allow novices to easily set up a Foswiki installation without knowing anything about it or the operating system it runs on. The virtual machine image is preconfigured and ready to run. It can be accessed with your browser. This VM dynamically acquires an IP address. Please follow the instructions at the end of the boot screen. Point your browser to the address shown there.

Installation

Virtual machine software

You need one of these virtual machine applications to run the VMware image. All of them are free; you must register to use the VMware applications.:

• VMware player running on Windows / Linux
• VMware server running on Windows / Linux
• VirtualBox running on Windows / Linux / OSX (installation instructions)

Virtual Machine Images

Download a virtual machine image from the download page.

Using the virtual machine image: Ready, Steady, Go!

Now just fire up your VirtualMachine and use it!

Configuration notes

Network: If you used the VM settings file shipped with the Foswiki image, your network is configured for NAT. This ensures that your host OS provides a DHCP server. The downside of this setting is that you cannot access Foswiki from any other host in your local network other than from your local machine. If you want to access your Foswiki from others hosts, please use the bridged mode provided by your virtual machine player. In that case, you are responsible for setting up a DHCP server (or for reconfiguring your VM operating system with a static IP address).

Accessing Foswiki Installation

The following Foswiki users have been preconfigured:

user role	User	Password
configure-save-password	-	foswiki
admin user for Foswiki	admin	foswiki
test user for Foswiki	TestUser	foswiki

Accessing the virtual machine's OS

You can login at the virtual machines login prompt. SSH is not installed by default. If you need root access on your VM, you can use sudo.

User	Password
foswiki	foswiki

Getting the IP of the virtual machine OS

To find out the IP address, start your virtual machine, and when prompted for a username and password, enter foswiki and the password listed in the section "Accessing the virtual machine's OS". To show your current IP, type:

/usr/sbin/foswiki-ip

Localization of keyboard and character set

If you are using the installation in a non-English environment, the OS needs to be told about the localization needs.

To switch the character set, you need to install/select the character sets by this shell command and follow the dialog:

sudo dpkg-reconfigure console-data

To switch the keyboard layout (for easier use of non-qwerty keyboards in the shell), you need to install/select the keymap for the console by this shell command and follow the dialog.

---

This topic: Support > VirtualMachineImages
Topic revision: 13 Apr 2012, OliverKrueger

---