Download & Install TWiki-VM-6.0.2-1 (latest)
This uses VMware as an example. Other virtualization software are similar to use.
- If needed, get a virtualization environment such as VMware or VirtualBox:
-
Buy and download the TWiki-VM:
- Purchase the latest TWiki-VM-6.0.2-1 for US$15.00 - this makes you feel good, and helps us cover the cost of running the TWiki.org website:
-
Important: After purchasing the TWiki-VM at PayPal, follow the "Return to TWiki.org" link, where you can download the package
- 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.2-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.
- Test default network:
- Enter:
# ip addr
- You should see a "lo" and a "eth0" entry
- 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
- If you run configure for the first time:
- Enter a secure configuration password twice, and proceed to the configuration screen
- Save (even though you have not done any changes)
- Return to configuration
- 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
- Define administrators:
- Visit Home >> Main web >> Groups (pulldown menu) >> TWikiAdminGroup
- Login as "admin" with your configure password
- Hit "Edit Preferences"
- In GROUP setting, add a comma-space list of registered users who should have admin rights, such as:
JimmyNeutron, BigDude
-
Congratulation, you have a fully functional TWiki installation!
Download & Install TWiki-VM-6.0.1-1 (older, free)
This uses VMware as an example. Other virtualization software are similar to use.
- If needed, get a virtualization environment such as VMware or VirtualBox:
-
Download the TWiki-VM:
- Consider purchasing the latest TWiki-VM-6.0.2-1 for US$15.00 - this makes you feel good, and helps us cover the cost of running the TWiki.org website
- Alternatively, download the older TWiki-VM-6.0.1-1
- 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
- If you run configure for the first time:
- Enter a secure configuration password twice, and proceed to the configuration screen
- Save (even though you have not done any changes)
- Return to configuration
- 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
- Define administrators:
- Visit Home >> Main web >> Groups (pulldown menu) >> TWikiAdminGroup
- Login as "admin" with your configure password
- Hit "Edit Preferences"
- In GROUP setting, add a comma-space list of registered users who should have admin rights, such as:
JimmyNeutron, BigDude
-
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.2-1 |
2015-12-04 |
TWiki-6.0.2, CentOS 7.1 |
(none) |
| 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.
--
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:
--
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.
--
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
I tried the latest version of the TWiki-VM on VMware. Its running successfully and comfortably. I want to know about process and how easy it would be to upgrade to the future TWiki-VM(whenever released)?
--
Saurabh Maheshwari - 2015-08-09
Saurabh: If you have not done any changes to the core engine or skins you can simply create a backup using the
BackupRestorePlugin, then restore that to a new VM.
--
Peter Thoeny - 2015-08-09
In manually configuring eth0 you also have to update the HWADDR setting so that it matches the MAC address assigned to the VM.
--
Christopher Bobbitt - 2016-01-14
Paypal link not working
--
John Jakubowski - 2020-09-23
Paypal link is not working
--
John Jakubowski - 2020-09-23
I need to investigate. I'll contact you separately to get you covered.
--
Peter Thoeny - 2020-09-24
Interesting. I'm not very familiar with virtual machines, and I just came across this page today -- I'm wondering if there is a (somewhat similar) virtual machine that could easily be installed on a (ideally free) web hosting service even if the web hosting service doesn't support TWiki?
(Aside: I'd expect that most web hosting services run Linux.)
--
Randy Kramer - 2020-09-24
Paypal link doesnt seem to be working.
--
Cameron Matteson - 2023-03-20
Please ask support questions in the Support web.