What is TWiki?

A leading open source enterprise wiki and Web 2.0 application platform used by 50,000 small businesses, many Fortune 500 companies, and millions of people.
Learn more.

Download & Install TWiki-VM-5.1.1-1 - VMware Virtual Machine

Easy installation on Windows! ...and other platforms VMware supports.

First time visiting? Start learning about TWiki by browsing the TWiki front page at http://TWiki.org/! You can also try TWiki now by registering and editing Sandbox pages.

Overview

The TWiki VMware Virtual Machine (TWiki-VM) enables you to quickly and easily install a pre-configured TWiki 5.1 'software appliance' on Windows, Mac OS-X or any other x86 based platform VMware supports. VMware Player or VMware Server for Windows are free downloads. This CentOS 5.7 based TWiki-VM generally performs better than a native TWiki installation on Windows. Although running TWiki on Linux on top of Windows may seem complicated, it's actually much simpler than installing TWikiOnWindows - no TWiki or Linux knowledge is needed to get a working TWiki installation!

Download and Installation

• Install one of the VMware products from http://www.vmware.com/products/
  • VMware offers free downloads for Windows platforms
• Download TWiki-VM:
  • In the Download TWiki page, select "TWiki-VM-5.1.1-1.zip" in "Download TWiki Community Release" form
  • Copy the package to the server where VMware is installed
• Add the TWiki-VM image to VMware:
  • Unzip the package, move content into a TWiki-VM-5.1 folder
  • If you have a VMware ESX product you need to convert the TWiki-VM image to the ESX format using the vmkfstools tool. Consult the VMware vmkfstools documentation.
  • Move the TWiki-VM-5.1 image into the folder where VMware stores all virtual images
  • In VMware, open the .vmx file located in the TWiki-VM-5.1 folder
  • Boot the TWiki-VM-5.1 image
• Change the root password:
  • In the TWiki-VM console screen, login as root with password changeme
  • At the prompt, type passwd and enter a new (strong) password twice:
    # passwd
Changing password for user root.
New UNIX password:
Retype new UNIX password:
    
• Set networking:
  • The TWiki-VM is configured for DHCP. This is OK for home use and for testing. In a production environment it should be changed to a static IP address.
  • Network configuration for DHCP: Login as root, edit /etc/sysconfig/network-scripts/ifcfg-eth0 and set its content to the following:
    DEVICE=eth0
ONBOOT=yes
BOOTPROTO=dhcp
    
  • Network configuration for static IP address: Login as root, edit /etc/sysconfig/network-scripts/ifcfg-eth0 and set its content to the following: (tweak the IP address, net mask and gateway as needed)
    DEVICE=eth0
ONBOOT=yes
BOOTPROTO=none
TYPE=Ethernet
USERCTL=no
IPV6INIT=no
PEERDNS=yes
IPADDR=10.1.10.129
NETMASK=255.255.255.0
GATEWAY=10.1.10.1
    
  • Restart the network after each configuration change: Login as root and enter this command:
    /etc/init.d/network restart 2
  • Confirm (or find out) the IP address of the TWiki-VM: Login as root and enter the ifconfig command. In this sample output, look for the inet addr in the second line (in eth0 section) :
    eth0 Link encap:Ethernet HWaddr 00:0C:29:89:8C:47
inet addr:192.168.1.79 Bcast:192.168.1.255 Mask:255.255.255.0
inet6 addr: fe80::20c:29ff:fe89:8c47/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
...
    
• Configure TWiki for proper use:
  • Ask your IT to to add a DNS entry for your TWiki server, such as twiki.example.com pointing to the IP address of the TWiki-VM.
  • Run the TWiki configuration utility: Using a web browser, go to your TWiki by IP address, appending /do/configure, such as http://192.168.1.79/do/configure
  • The first time you run configure you are asked to set the configuration password. Enter it twice, and proceed to the configuration screen
  • In the "General path settings" section,
    • set the {DefaultUrlHost} to the TWiki domain name, such as http://twiki.example.com
    • set the {PermittedRedirectHostUrls} to the TWiki domain name and IP address, such as http://twiki.example.com, http://192.168.1.79
  • In the "Mail and Proxies" section,
    • set {SMTP}{MAILHOST}
    • set {SMTP}{Username} and {SMTP}{Password} in case your mail server requires an authenticated user to send mail
  • Save the configuration changes
• Run TWiki:
  • Using a web browser, enter the domain name or IP address of the TWiki-VM
  • Register yourself and other users: See Register link in the Account pulldown menu
  • Congratulation, you have a fully functional TWiki installation!

Install on a VirtualBox (Oracle VM)

• Install the VirtualBox from http://www.virtualbox.org/wiki/Downloads and install it on your server
• Download TWiki-VM as described above
• Unzip the package and move content into a folder of choice -- you only need the .vmdk files, the configurations files are not needed.
• Start the Virtual Box, create a new Machine:
  • Name it TWiki-VM-5.1 or the like
  • Set the Guest OS to "Linux" and the Version to "Red Hat"
  • Set RAM to something over or equal 256 MBytes.
  • DON'T create a new Hard Disk, use the vmdk-Image in the preferred folder. Set it for boot. (It is not really necessary, but you can't skip it in this part. Later you have to change the Harddisk-Controller for a clean Bootup)
• After finish, click on the storage section, delete the SATA-Controller (with the mounted vmdk-image) and mount the image to the IDE-Controller
• Usually the network card is set to NAT, but most of the cases you will need a network bridge to get a real IP-Address for the VM from your router or DHCP server
• After this you can proceed with above install-steps in "Download and Installation"
• Set networking:
  • The TWiki-VM is configured for DHCP. This is OK for home use and for testing. In a production environment it should be changed to a static IP address.
  • Network configuration for DHCP: Login as root, edit /etc/sysconfig/network-scripts/ifcfg-eth0 and set its content to the following:
    DEVICE=eth0
ONBOOT=yes
BOOTPROTO=dhcp
  • Network configuration for static IP address: Login as root, edit /etc/sysconfig/network-scripts/ifcfg-eth0 and set its content to the following: (tweak the IP address, net mask and gateway as needed)
    DEVICE=eth0
ONBOOT=yes
BOOTPROTO=none
TYPE=Ethernet
USERCTL=no
IPV6INIT=no
PEERDNS=yes
IPADDR=10.1.10.129
NETMASK=255.255.255.0
GATEWAY=10.1.10.1
  • Restart the network after each configuration change: Login as root and enter this command:
    /etc/init.d/network restart 2
  • Confirm (or find out) the IP address of the TWiki-VM: Login as root and enter the ifconfig command. In this sample output, look for the inet addr in the second line (in eth0 section) :
    eth0 Link encap:Ethernet HWaddr 00:0C:29:89:8C:47
  inet addr:192.168.1.79 Bcast:192.168.1.255 Mask:255.255.255.0
inet6 addr: fe80::20c:29ff:fe89:8c47/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
...
• Configure TWiki for proper use:
  • Ask your IT to to add a DNS entry for your TWiki server, such as twiki.example.com pointing to the IP address of the TWiki-VM.
  • Run the TWiki configuration utility: Using a web browser, go to your TWiki by IP address, appending /do/configure, such as http://192.168.1.79/do/configure
  • The first time you run configure you are asked to set the configuration password. Enter it twice, and proceed to the configuration screen
  • In the "General path settings" section,
    • set the {DefaultUrlHost} to the TWiki domain name, such as http://twiki.example.com
    • set the {PermittedRedirectHostUrls} to the TWiki domain name and IP address, such as http://twiki.example.com, http://192.168.1.79
  • In the "Mail and Proxies" section,
    • set {SMTP}{MAILHOST}
    • set {SMTP}{Username} and {SMTP}{Password} in case your mail server requires an authenticated user to send mail
  • Save the configuration changes
• Run TWiki:
  • Using a web browser, enter the domain name or IP address of the TWiki-VM
  • Register yourself and other users: See Register link in the Account pulldown menu
  • Congratulation, you have a fully functional TWiki installation!

Increase Disk Size

If your users add many attachments it is likely that you need to allocate more disk space to the TWiki VM. This is possible without destroying existing data. Follow the excellent instructions at http://mattiasgeniar.be/2010/08/27/increase-a-vmware-disk-size-vmdk-formatted-as-linux-lvm/

Release History

How to build the TWiki VM

Ignore this unless you are interested in learning how to build a TWiki Virtual Machine.

-- Contributors: PeterThoeny, JensGuenther - 2011-08-30

Discussion

Nice uptake of the new virtual machine TWiki-VM-5.1.0-1 as seen on sourceforge.net statistics:

-- PeterThoeny - 2011-09-09

Hi all, I installed the TwikiVM using VMware Player in a Windows 7 PC. It perfectly works, but now I would like to backup my twiki. I read that it is possible to access the twikiVM through Internet Explorer or through Windows Explorer giving file://twiki-vm, but it doesn't work at all. I went to the VM installation to check the samba configuration, and I saw that samba is not running, and that /etc/samba/smb.conf doesn't even exits. Is there anything wrong with the installation I did? How can I access and backup my files? Thanks

-- MassimilianoChiorboli - 2011-10-24

Massimiliano, please do not cross-post the same question on multiple locations. Let's handle this at Support.SID-01303

-- PeterThoeny - 2011-10-24

Btw, I didn't have still any answer in the support, so I'm still stuck with this problem. Many thanks.

-- MassimilianoChiorboli - 2011-10-25

I am getting the following error when I try to find new extensions from the configure page within this VM installation:

Error accessing TWiki.org: Incomplete headers This is most likely because the LWP CPAN module isn't installed.

I found an entry on the TurnKey Linux forums about this and it recommended removing the "T" parameter from the first line of the configure file. I did that, restarted the whole VM, and I am still getting the same error. Is there anything else that I could try?

Thanks!

-- MattLamoureux - 2011-11-11

In regards to issue of not finding new extensions from the configure page: libwww-perl needs to be installed, see Support.SID-01331.

-- PeterThoeny - 2011-11-15

New version TWiki-VM-5.1.0-2 released, it can be downloaded from DownloadTWiki. It fixes the issue of not finding new extensions from the configure page. It also has the latest CentOS 5.7, upgraded from 5.6.

-- PeterThoeny - 2011-11-16

New version TWiki-VM-5.1.1-1 released, it can be downloaded from DownloadTWiki. It incorporates the latest TWiki-5.1.1 release.

-- PeterThoeny - 2012-01-15

TWiki-VM-5.1.1-1 crashes VMware Server 2.0.2 during import. Deleting the two serial0 lines in the .vmx file solved the problem. Googling reveals VMware Server does not support "thinprint".

-- GeoffJohnston - 2012-04-04

Thanks Geoff for sharing this. Who uses serial interface anyway? Needs to be removed in the next release.

-- PeterThoeny - 2012-04-04

File::Temp needs to be updated in the latest VM for statistics to work.

-- PeterThoeny - 2012-04-12

How do I install twiki on window 7? Please give me the step to step breatdown of how to do that. Thanks.

-- KehindeAdeoya - 2012-04-26

Download VMware from http://www.vmware.com/products/ and follow above instructions.

-- PeterThoeny - 2012-04-26

where will i locate the twiki vm image?

-- KehindeAdeoya - 2012-04-27

I search the Twiki 5-1-1VM folder but o not see any image how do I go about this? this is my second ay on trying to use twiki. Thanks. God bless you in Jesus name.

-- KehindeAdeoya - 2012-04-27

The content of the unzipped file you downloaded is the VMware image. The VMware image consists of the TWiki-VM-5.1.vm* files.

-- PeterThoeny - 2012-04-27

Thanks. Highly grateful! After this, am I to unzip the folder into the installed folder of VMWARE SERVER? To narrow down a bit to my installation progress, after installing Vmware SERVER, I clicked the icon the desktop and it opened up on the browser asking me to configure a new virtual machine, am i really on the right step? Please, kindly bear with me, communicate with me in a layman's language . If you have a pictorial tutorial, I think that will better aid my understanding. Thanks.

-- KehindeAdeoya - 2012-04-29

It seems I'm getting along, how do I boot the Twiki image? Kindly bear with my childish question. Thanks

-- KehindeAdeoya - 2012-04-29