Was this page helpful?

Upgrade MindTouch on CentOS/Red Hat

    Table of contents
    1. 1. Overview
    2. 2. Goal
      1. 2.1. Confirm Environment
        1. 2.1.1. Mono
      2. 2.2. Upgrade
      3. 2.3. Search index
    3. 3. What's Next
    4. 4. Related

    Overview

    Upgrade your MindTouch installation if it is running on Red Hat/CentOS.

    Goal

    After completing this tutorial you will be running the current stable version of MindTouch. 

    Steps

    Backup your current install

    Backup your MindTouch directory by running the following command:

    cp -rf /var/www/dekiwiki /root/

    Backup your database

    mysqldump -uroot -p wikidb > wikidb-backup.sql

    Backup configuration files

    cp -rf /etc/dekiwiki /root/etc/

    Check with Support

    If you have a MindTouch commercial installation and are upgrading to a Major release, i.e. upgrading from 9.12.3 to 10.0.0, please contact MindTouch support before upgrading to confirm if you need a new license.  

    Confirm Environment

    Before starting the backup please confirm that your VMware environment is up to date.  Confirm the following areas:

    Mono

    Confirm the version of Mono that is running on your system by running the following command from command line:

    mono --version

    If this returns 2.10.1 or higher then it is running a stable and compatible version.  If it returns any other version then you'll need to upgrade following the instructions here.  

    NOTE:  Mono 2.10.1 is required for MindTouch 10.1 and higher.  Mono 2.4.3 was required for MindTouch 10.0.x

    Source Changes

    If you have made any changes to the MindTouch source files, back them up as you'll need to merge them in after the upgrade.  Also if you have any custom extension .dlls on the server, move those out of the directory as you'll need to recompile them in order to be compatible with the current stable version.

    Upgrade

    BEFORE PROCEEDING, ensure you have obtained a backup of your installation from the instructions above.  

    Next, you ensure your package is updated by running the following commands below:

    rpm -qa | grep deki-enterprise
    rpm -qa | grep dekiwiki

     

    If "deki-enterprise" is listed, then run the following command:

    yum remove deki-enterprise

     

    If "dekiwiki" is listed, then run the following command:

    yum remove dekiwiki

     

     

    Proceed with the upgrade now by running the following command from the command line:

    yum install mindtouch

     

    This will then run through and upgrade your MindTouch installation.  When you receive a command line prompt again then your site has been upgraded.  Load it in a browser and confirm when you go to the Control Panel that it says you are running the latest version. 

    Search index

    Some upgrades may require you to rebuild the search index.  First confirm if you need to rebuild by searching for some common terms in your MindTouch install.  If you receive results then you shouldn't need to rebuild the search index.  If it doesn't return results then go to Control Panel -> Cache Management -> Rebuild Search Index 

    You can click on Cache Management to refresh the page and see the status of the rebuild

    What's Next

     

    If you have any questions at all and are a MindTouch Commercial Support customer, please contact support before proceeding with the upgrade.   

     
    Was this page helpful?
    Tag page
    Viewing 1 of 1 comments: view all
    I think the command to backup the MySQL database should be "mysqldump" rather than "mysql".
    Posted 05:41, 5 Oct 2010
    Viewing 1 of 1 comments: view all
    You must login to post a comment.

    Copyright © 2011 MindTouch, Inc. Powered by