MindTouch Community Portal
Logged in: Logged in as: Log in
Register
Search:
Page last modified 15:58, 21 Jun 2012 by jamesv
MindTouch Community Portal > MindTouch Community Portal > Documentation > MindTouch Setup and Configuration Guide > Installation > Installing on Red Hat
Page Notifications Off
Was this page helpful?

Installing on Red Hat

    Overview

    Install MindTouch on Red Hat using pre-configured package

    Goal

    After completing this tutorial you will have a MindTouch installation running natively on Red Hat

    System Requirements (Click to Expand)

     

     

    Install Mono

    Mono is a dependency of MindTouch and needs to be installed first. 

    Install/Upgrade Mono (Click to Expand)

    Install dependencies packages

    Type the following command to install packages that will allow full functionality in MindTouch:

     yum install links pdftohtml wv tidy html2ps html2text mysql-server

    Note: Installation of some dependencies may require interaction. Answer "yes" to all authentication/verification and download questions.

    Install PrinceXML

    To enable HTML-to-PDF printing, the static library version of PrinceXML must be installed by entering the following commands:

    32 bit install

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

    64 bit install 

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

    Hit Enter when asked for the install directory location

    Set up MindTouch's YUM repository

    Create the file "/etc/yum.repos.d/mindtouch.repo", and add the following content :

    [home_mindtouch]
name=mindtouch's Home Project (RHEL_5)
type=rpm-md
baseurl=http://repo.mindtouch.com/RHEL_5/
gpgcheck=1
gpgkey=http://repo.mindtouch.com/RHEL_5/repodata/repomd.xml.key
enabled=1

    Install MindTouch

     

    Install MindTouch using the following command : 
     yum install mindtouch
    Note: Installation of some dependencies may require interaction. Answer "yes" to all authentication/verification questions.
     
    Install Trusted Roots Certificates

    Install the trusted roots certificates from the Mozilla LXR website into the Mono certificate store by entering the following:

     su dekiwiki
$ /opt/mono-2.10.2/bin/mozroots --import --sync
$ exit

    Configure Apache

    After the install has finished, move /etc/httpd/conf.d/deki-apache.conf.disabled to deki-apache.conf and change the ServerName in that file to match the URL that you will be entering into the web browser to arrive at your wiki:

    mv deki-apache.conf.disabled deki-apache.conf

    This will allow the Apache virtual host to direct traffic to MindTouch.

    Then, restart Apache by entering the following command:

     service httpd restart

    Note: SELinux, if installed, must be set to either "permissive" or "disabled"; if SELinux is set to "enforcing" the API will be unreachable.

    Start MySQL by entering the following:

     service mysqld start

    Go to "http://your_server/config/index.php" to complete the configuration.

     

    Note that mysqld and httpd are not configured automatically to start; this can be changed by entering:

     chkconfig mysqld on

 chkconfig httpd on
     

    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.

    =media_1284492446307.png

    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.

    =media_1284492518459.png

    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

    =media_1284496027969.png

    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.

    =media_1284493151546.png

    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.

    =media_1284496113475.png

    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.

    =media_1284496325877.png

    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.

    =media_1284491455897.png

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

    =media_1284491533790.png

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

     

    What's Next

    This is what was achieved and what was omitted in this tutorial.

    Was this page helpful?
    Tag page
    What links here

    Files 0

    Attach file or image
     
    Viewing 3 of 3 comments: view all
    #1
    mikeborschow says:
    If fails this part --- make change to:

    su dekiwiki
    /opt/mono-2.10.2/bin/mozroots --import --sync
    exit

    instead, do this

    su dekiwiki
    /opt/novell/mono/bin/mozroots --import --sync
    exit edited 16:18, 4 Oct 2011
    Posted 16:17, 4 Oct 2011
    #2
    cnoffsin says:
    I put Centos/Rhel/Scientific 6.x install instructions here:

    http://developer.mindtouch.com/index.php?title=User:cnoffsin/RHEL%2F%2FCentos%2F%2FScientific_6.x_64bit_Mindtouch_Installation_Instructions
    Posted 19:08, 28 Feb 2012
    #3
    jnewmaster says:
    Issues found in document.

    In the Mono dependencies section, g++ is not a package in the Red Hat repositories. The option would be "yum install gcc-c++".

    In the Mono first run section,
    "ln -s /opt/novell/mono/bin/mono/usr/bin/mono" should be "ln -s /opt/mono-2.10/bin/mono/usr/bin/mono"
    and all other lines with that should be updated also.

    The following packages are not in the Red Hat Repositories. You must add an unofficial repository such as RepoForge (http://repoforge.org/use/) to get these.
    wv tidy html2ps html2text

    an example of how to do this would be the following. (these are the steps for the latest version for RHEL5 as of 9/13/2012)
    cd /tmp
    wget http://pkgs.repoforge.org/rpmforge-release/rpmforge-release-0.5.2-2.el5.rf.x86_64.rpm
    rpm --import http://apt.sw.be/RPM-GPG-KEY.dag.txt
    yum install rpmforge-release-0.5.2-2.el5.rf.x86_64.rpm
    yum install wv tidy html2ps html2text

    The midntouch GPG key must be installed before attempting to install mindtouch with "yum install mindtouch". This can be done by entering "rpm --import http://repo.mindtouch.com/RHEL_5/repodata/repomd.xml.key" edited 07:54, 13 Sep 2012
    Posted 06:20, 13 Sep 2012
    Viewing 3 of 3 comments: view all
    You must login to post a comment.
    MindTouch Social Knowledge Base

    Copyright © 2011 MindTouch, Inc. Powered by