Tags:
deployment1Add my vote for this tag easy_install24Remove my vote on this tag installation4Add my vote for this tag windows2Add my vote for this tag create new tag
, view all tags
What is TWiki?
A leading open source enterprise wiki and web application platform used by 50,000 small businesses, many Fortune 500 companies, and millions of people.
MOVED TO... Learn more.

Download & Install TWiki-VM-6.0.1-1 - OVF Virtual Machine (VMware, Oracle VM...)

Easy installation on Windows! ...and other platforms VMware, VirtualBox and Oracle VM supports.

TIP 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 Virtual Machine (TWiki-VM) enables you to quickly and easily install a pre-configured TWiki 6.0 'software appliance' on Windows, Mac OS-X or any other x86 based platform that supports Open Virtualization Format (OVF), such as VMware ESX, VMware Workstation, VMware Player, VMware Fusion, VirtualBox, Red Hat Enterprise Virtualization, IBM POWER server AIX, IBM SmartCloud, OpenNode Cloud Platform, Oracle VM, rPath and SUSE Studio. This CentOS 6.5 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

This uses VMware as an example. Other virtualization software are similar to use.

  • Install one of the VMware products from http://www.vmware.com/products/
    • VMware offers free downloads for Windows platforms
  • Download Download TWiki-VM:
    • In the Download TWiki page, select "TWiki-VM-6.0.1-1.ova" in "Download TWiki Community Release" form
    • Copy the package to the server where VMware is installed
  • Import the TWiki-VM OVF image into VMware:
    • Select "Import" in the File menu, and select "Choose File..."
    • Browse to and select TWiki-VM-6.0.1-1.ova, continue, set the location where the image should be saved
    • Boot the TWiki-VM-6.0 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
      • If you get this error:
        Bringing up interface eth0: Device eth0 does not seem to be present, delaying initialization.
        you have a MAC address mismatch. This can happen when you "copy" (vs. "move") a virtual machine the first time you start it. On copy, VMware assigns a new MAC address to the network interfaces, but may fail to update the Linux configuration files to mirror these changes, resulting in a dead eth0 network interface.
      • Fix:
        • Edit /etc/udev/rules.d/70-persistent-net.rules, delete the first SUBSYSTEM setting containing NAME="eth0", and change the NAME in the second SUBSYSTEM setting from "eth1" to NAME="eth0". Example:
          SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:0c:29:56:26:13", ATTR{type}=="1", KERNEL=="eth*", NAME="eth0"
        • Edit /etc/sysconfig/network-scripts/ifcfg-eth0, remove also the UUID setting, and set the HWADDR setting to the new MAC address. Example:
          HWADDR=00:0C:29:56:26:13
        • Reboot the machine:
          reboot
    • 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} - in many environments localhost is sufficient
      • 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
    • TIP 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

Release Date Software versions Known issues
TWiki-VM-6.0.1-1 2014-10-05 TWiki-6.0.1, CentOS 6.5 (none)
TWiki-VM-6.0.0-1 2013-10-27 TWiki-6.0.0, CentOS 6.4 (none)
TWiki-VM-5.1.4-1 2013-02-16 TWiki-5.1.4, CentOS 5.9 (none)
TWiki-VM-5.1.3-1 2012-12-16 TWiki-5.1.3, CentOS 5.8 (none)
TWiki-VM-5.1.2-1 2012-10-23 TWiki-5.1.2, CentOS 5.8 (none)
TWiki-VM-5.1.1-1 2012-01-15 TWiki-5.1.1, CentOS 5.7 (none)
TWiki-VM-5.1.0-2 2011-11-15 TWiki-5.1.0, CentOS 5.7 (none)
TWiki-VM-5.1.0-1 2011-08-30 TWiki-5.1.0, CentOS 5.6 Extension install via configure does not work, perl-libwww-perl is missing

How to build the TWiki VM

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

  • Starting at http://wiki.centos.org/Download, download CentOS-6.4-x86_64-minimal.iso CD image from a mirror site
    • The CentOS-6.4-x86_64-minimal is a bare bone minimal OS without GUI.
  • Create a new VMware image with CentOS:
    • Create custom virtual machine
    • Linux OS => CentOS 64 bit
    • Create new virtual disk
    • Name: CentOS-6.4-64-bit-min-httpd.vmwarevm
    • Set root password: changeme
  • Configure networking for DHCP and set host name:
    • vi /etc/sysconfig/network-scripts/ifcfg-eth0 :
      DEVICE=eth0
      TYPE=Ethernet
      HWADDR=xx:xx:xx:xx:xx:xx (leave default)
      UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (leave default)
      BOOTPROTO=dhcp
      NM_CONTROLLED=no
      ONBOOT=yes
    • vi /etc/sysconfig/network :
      NETWORKING=yes
      NETWORKING_IPV6=no
      HOSTNAME=twiki
    • reboot
    • ping google.com
  • Update OS:
    • yum update
    • reboot
  • Install VMware tools:
    • In Virtual Machine Library Window, select menu: Virtual Machine => Insatll VMware tools
  • Install libraries:
    • yum install gcc kernel-devel perl make openssh-clients httpd mod_ssl wget ntp crontabs vim-enhanced rcs tcpdump time patch zip unzip gd
  • Start httpd and crond on reboot:
    • chkconfig httpd on
    • chkconfig crond on
    • chkconfig --list|egrep 'http|cron' returns:
      crond       0:off  1:off  2:on  3:on  4:on  5:on  6:off
      httpd       0:off  1:off  2:on  3:on  4:on  5:on  6:off
  • Disable Selinux:
    • vi /etc/selinux/config :
      SELINUX=disabled
  • Configure firewall to allow http:
    • vi /etc/sysconfig/iptables :
      before COMMIT add this:
      -I RH-Firewall-1-INPUT -p tcp --dport 80 -j ACCEPT
  • Restart network:
    /etc/init.d/network restart 2
  • Install Perl libraries:
    yum install perl-CGI perl-CGI-Session perl-HTML-Parser perl-Archive-Tar perl-Authen-SASL perl-GD perl-libwww-perl
  • Power down VM:
    shutdown -h 0
  • Zip up the VM as CentOS-6.4-64-bit-min-httpd.vmwarevm.zip - this is a minimal CentOS-6.4 with apache & cron installed, ready for server use.
  • Rename VMware image to TWiki-6.0:
    • On Mac, open terminal and change to directory where all VMware images are.
    • mv CentOS-6.4-64-bit-min-httpd.vmwarevm TWiki-6.0
    • cd TWiki-6.0
    • mv CentOS-6.3-64-bit-min-httpd.nvram TWiki-6.0.nvram
    • mv CentOS-6.3-64-bit-min-httpd.plist TWiki-6.0.plist
    • mv CentOS-6.3-64-bit-min-httpd.vmsd TWiki-6.0.vmsd
    • mv CentOS-6.3-64-bit-min-httpd.vmx TWiki-6.0.vmx
    • mv CentOS-6.3-64-bit-min-httpd.vmxf TWiki-6.0.vmxf
    • vi TWiki-6.0.vmx and set displayName = "TWiki-6.0.0-1", and change all other CentOS-6.* strings to TWiki-6.0
    • vi TWiki-6.0.vmxf and change CentOS-6.* string to TWiki-6.0
    • vi TWiki-6.0.plist and change CentOS-6.* string to TWiki-6.0.0-1
    • Power up TWiki-6.0.0-1 VM image
  • Install TWiki-6.0.0 in /var/www/twiki
  • Create /var/www/html/index.html with content:
      <html>
      <head>
      <title>Redirecting to TWiki home</title>
      <meta http-equiv="refresh" content="0;url=/do/view/Main/WebHome">
      </head>
      <body>
      Redirecting to <a href="/do/view/Main/WebHome">TWiki home</a>.
      </body>
      </html>
         
  • Copy favicon.ico to html doc root:
    cp -p /var/www/twiki/pub/TWiki/TWikiLogos/favicon.ico /var/www/html/
  • Restart apache:
    /sbin/service httpd restart
  • Install apache cron job: # crontab -u apache -e and add this:
    58 23 * * * (cd /var/www/twiki/bin; ./statistics >/var/www/twiki/data/statistics-log.txt 2>&1)
    5 0 * * * (cd /var/www/twiki;perl -I bin tools/watchlistnotify -q >/var/www/twiki/data/watchlistnotify-log.txt 2>&1)
    35 0 * * * (cd /var/www/twiki;perl -I bin tools/mailnotify -q >/var/www/twiki/data/mailnotify-log.txt 2>&1)
    30 0 * * * (cd /var/www/twiki;perl -I bin tools/tick_twiki.pl  >/dev/null 2>&1)
  • Test TWiki
  • Fix lib/LocalSite.cfg:
    $TWiki::cfg{DefaultUrlHost} = 'http://twiki.example.com';
    $TWiki::cfg{PermittedRedirectHostUrls} = 'http://twiki.example.com, http://192.168.1.89';
    $TWiki::cfg{Password} = '';
    $TWiki::cfg{WebMasterEmail} = 'twiki@example.com';
    $TWiki::cfg{SMTP}{MAILHOST} = 'localhost';
  • Remove TWiki log files, twiki/working/tmp/cgi*, Apache log files, bash history
  • Prepare VM so that the networking is initialized properly on first boot:
    • Edit /etc/udev/rules.d/70-persistent-net.rules, delete all SUBSYSTEM settings
    • Edit /etc/sysconfig/network-scripts/ifcfg-eth0 and delete the HWADDR line
  • Power down VM:
    shutdown -h 0
  • Delete vmware*.log files
  • Zip image:
    zip TWiki-VM-6.0.0-1.zip TWiki-VM-6.0/*

-- Contributors: PeterThoeny, JensGuenther - 2014-10-05

Discussion

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

vm-stats1s.png

-- 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

I cannot find the directory "/etc/sysconfig/network-scripts/ifcfg-eth0". It goes up to "/etc/sysconfig/network-scripts/" and it does not have the "ifcfg-eth0". Im testing at home using DHCP

-- ClydeMenzi - 2012-10-14

I restarted it and tried again and I'm getting permission denied

-- ClydeMenzi - 2012-10-14

Please ask support questions in the Support web.

-- PeterThoeny - 2012-10-15

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

  • CentOS is now update to 5.8.
  • The VM contains an updated File::Temp Perl module so that statistics works as expected.

-- PeterThoeny - 2012-10-23

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

-- PeterThoeny - 2012-12-16

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

-- Peter Thoeny - 2013-02-18

I tried to login using id: root pw: changeme But it doesn't work, please help, I even tried 'passwd'

-- Rahul Sharma - 2013-05-28

You need to login as root on the shell.

-- Peter Thoeny - 2013-05-28

If you need to run the TWiki-VM on ESXi, you'll need to convert the VM before you can start it up. Use the VMware vCenter Converter (I used the standalone product, which is a free download (you'll need to register with vmware.com first, which is also free)). Easy process. Download and extract the TWiki-VM file to the server where you've installed the Converter. Launch the Converter application, and Click "Convert Machine." When prompted to select a source type, choose VMware Workstation or other VMware virtual machine. You'll need credentials on the ESXi host that will run the TWiki-VM. Enter those, accept the defaults (unless you need to change them per your environment), and the converter will import the VM into a format that ESXi can understand. Now you can Power On the VM without errors.

-- Michael Stump - 2013-06-19

Thank you Michael for sharing this with the TWiki community!

-- Peter Thoeny - 2013-06-19

Hi People. I have installed Twiki VM and all works fine, but my question is:

The VM come with 6 GB local disk, I have expanded the local disk from 6 GB to 15 GB thru the Gparted tool, and all see good at the process end. But when I restart the Twiki vm, I have run the df -h and I still see the same used space.

/ = size 3.8 - used 1.3G - free 2.4 G /boot= size 99M - 30M - free 57M

Any link that can help me?

I'm newbie about the linux world. Thank in advanced! (I hope I explained well)

I use Twiki like Knowledge base in my department. smile

-- gabriel morgan - 2013-10-12

Gabriel, please ask support questions in the Support web, thank you.

-- Peter Thoeny - 2013-10-12

I just downloaded VM-6 and the VMWare Player today (4.0.6 build-1035888)

I get the error -

The configuration file "C:\TWiki-VM\TWiki-VM-6.0\TWiki-6.0.vmx" was created by a VMware product that is incompatible with this version of VMware Player and cannot be used. Cannot open the configuration file C:\TWiki-VM\TWiki-VM-6.0\TWiki-6.0.vmx.

Am i doing something wrong?

-- Rohit Mathur - 2014-05-07

Please ask support questions in the Support web. See also https://communities.vmware.com/message/2324895

-- Peter Thoeny - 2014-05-07

I'm running the latest version of the TWiki-VM on VMware Workstation 11.0.0 (TWiki-VM-6.0.1-1 2014-10-05 TWiki-6.0.1, CentOS 6.5 ). Changing either network configuration file per the directions doesn't seem to work (using dhcp because I have to for now), and the network restart fails without an error. The ifconfig command shows an ipv6 address, but no ipv4 address. I'm unable to get an ipv4 address and the weird thing is that ipv6 disabled in /etc/sysconfig/network

Also, I think I was able to install vmware tools successfully, but they don't seem to be working. The screen resolution is at it's smallest, and I can't change it. I tried to follow the directions to change it here: http://serverquestions.com/questions/f1yx/how-to-change-resolution-of-centos-6-5-resolution-on-virtualbox-host-win7 but the /etc/X11/xorg.conf file wasn't there to begin with.

-- Shane Lancaster - 2015-06-04

Shane: Not sure. Your VirtualBox host apparently operates in an IPv6 environment? Best to open a Support question to track this.

-- Peter Thoeny - 2015-06-04

Please ask support questions in the Support web.
Edit | Attach | Watch | Print version | History: r61 < r60 < r59 < r58 < r57 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r61 - 2015-06-04 - PeterThoeny
 
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2015 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.