Installing on Ubuntu

Hardware Minimum Requirements

The server requirements listed below are minimum requirements to run MindTouch.

• 512 MB of RAM
• Pentium 4 2GHZ processor
• 3 GB of Disk Space

Note: Hardware requirements can vary depending on how active the users are, the content being loaded (i.e. a lot of extensions, images, videos), number of contributors vs anonymous users, external users vs local users, and more.  When you start getting into concurrent users over 500 then consult with a MindTouch representative about the best way to deploy as to ensure scaling, clusters will need to be setup and configured with possible load balancing and separate application and database servers.  

Required Software Dependencies

Windows

• .Net 3.5 (SP1 required for MindTouch 10.0.8 and above)
• IIS 6 or 7
• MySQL 5.1
• Adobe Reader (used for indexing PDFs)
• PHP is included in MSI installer

Linux

• PHP 5.2
• Mono 2.10.1
• MySQL 5.0
• Apache 2

Browser Support

• FireFox 3.0.x
• FireFox 3.5.x
• Opera 10.0.x
• Internet Explorer 8
• Internet Explorer 7
• Internet Explorer 6
• Safari 4.0.x
• Google Chrome Latest Stable

Note that the .x release needs to be certified as stable by the browser vendor

Known Incompatibilities

Versions of MindTouch before 9.12.2 aren't supported to run on PHP 5.3

Mindtouch 9.12.x isn't compatible on Windows Server 2003 where the CPU has 4 Cores.  To work around this error install Mindtouch 9.08.3 or Olympic 

MindTouch MSI can't be installed on a 64bit Windows Server 2003 

Add the MindTouch repository

The following commands should be run as "root" (or as a user with root privileges).

Edit the "/etc/apt/sources.list" file to add the following line (select the version of Ubuntu you are running): 

deb http://repo.mindtouch.com xUbuntu_9.04/

deb http://repo.mindtouch.com xUbuntu_9.10/

deb http://repo.mindtouch.com xUbuntu_10.04/

Update Repositories

 Type the following command to update your package indexes:

 apt-get update

apt-get update
apt-get install gcc libtool bison pkg-config libglib2.0-dev gettext make bzip2 g++

wget http://ftp.novell.com/pub/mono/sources/mono/mono-2.10.2.tar.bz2
tar xvjf mono-2.10.2.tar.bz2
cd mono-2.10.2
./configure --prefix=/opt/mono-2.10

# this might take 30-60 minutes
make
make install

cd /usr/bin
mv mono mono.old
mv gmcs gmcs.old
ln -s /opt/mono-2.10/bin/mono /usr/bin/mono
ln -s /opt/mono-2.10/bin/gmcs  /usr/bin/gmcs

Verify:

mindtouch:~# mono --version
Mono JIT compiler version 2.10.2 (tarball Wed Jun  15 04:40:15 PST 2011)
Copyright (C) 2002-2011 Novell, Inc and Contributors. www.mono-project.com
        TLS:           __thread
        SIGSEGV:       altstack
        Notifications: epoll
        Architecture:  x86
        Disabled:      none
        Misc:          softdebug
        LLVM:          supported, not enabled.
        GC:            Included Boehm (with typed GC and Parallel Mark)

32 bit install

 wget http://www.princexml.com/download/prince_7.1-1_i386.deb
 dpkg -i prince_7.1-1_i386.deb

64 bit install 

 wget http://www.princexml.com/download/prince-7.1-linux.tar.gz
 tar -xzvf prince-7.1-linux.tar.gz
 cd /prince-7.1-linux
 sudo ./install.sh

Hit Enter when asked for the install directory location

 apt-get install mindtouch

Web Installer

When you load the IP address for the MindTouch install it will present you with the following web installer where you can click INSTALL next to the MindTouch product you want to install. In this documentation we will be selecting the MindTouch 2010 installation.

Clicking INSTALL next to MindTouch 2010 will then present you with the following screen where you need to fill out the highlighted fields. Once you have filled out the form then click NEXT at the bottom of the screen.

You will now see the configuration screen where you will need to specify the database settings along with the location of specific programs on the server. Once you have confirmed/changed then click NEXT

You will now see the following page where you can fill out details about your install as follows. Once you have made the appropriate selections please select NEXT to proceed.

This will then present you with an overview of your configuration. If anything needs to be changed you can click Edit next to the section. Otherwise continue by clicking INSTALL MINDTOUCH.

This will then take you to the following page which confirms that a license has been sent to you in an email. When you receive the email, save the .xml file that is attached to a location on your computer that you can easily access for the next step. Run the commands listed in the black box in the server console. Then click CONTINUE TO MINDTOUCH to then apply your license to your installation.

This will then bring you to your Product Activation page in the Control panel where you will select Choose File to upload the xml license file that was emailed you.

Then click Activate License which will then show you the following screen:

You have now successfully installed MindTouch. Continue with our Setup and Configuration guide to get your MindTouch install ready for production.