MindTouch Community Portal
Logged in: Logged in as: Log in
Register
Search:
Page last modified 22:00, 20 Jul 2007 by AaronF
MindTouch Community Portal > MindTouch Community Portal > Documentation > MindTouch > Release Notes > Hayes (1.8.1) > Beta 1
Page Notifications Off
Was this page helpful?

Beta 1

    README: DekiWiki Pre-Release Hayes BETA

    Thank you for your interest in MindTouch DekiWiki. You can find out more about MindTouch by visiting http://www.MindTouch.com or http://www.OpenGarden.org . OpenGarden.org is a MindTouch sponsored and community supported open source project.

    ______________________________________________________________________________

    TABLE OF CONTENTS:

    1. 1. Proem
    2. 2. What's New
    3. 3. Downloading
    4. 4. Package Payload
    5. 5. Compatibility Concerns
    6. 6. Enhancements and Bugfixes
    7. 7. DekiWiki Hayes Installation Guide
      1. 7.1. Prerequisites
      2. 7.2. Download Hayes Beta Bits
      3. 7.3. Edit Configuration Files
      4. 7.4. Run Installation Script
      5. 7.5. Configure Apache
      6. 7.6. Configure Apache for deki-api
        1. 7.6.1. Option 1: mod_proxy setup
        2. 7.6.2. Option 2: mod_mono setup
      7. 7.7. Configure Lucene Indexing
      8. 7.8. Verification
    8. 8. Upgrade Guide
      1. 8.1. Prerequisites
      2. 8.2. Perform a Full Backup
      3. 8.3. Download Hayes Beta Bits
      4. 8.4. Setup a New Wiki Database
      5. 8.5. Edit Configuration Files
      6. 8.6. Configure Apache
      7. 8.7. Database Migration
      8. 8.8. Configure Apache for deki-api
        1. 8.8.1. Option 1: mod_proxy setup
        2. 8.8.2. Option 2: mod_mono setup
      9. 8.9. Restore Attachments
      10. 8.10. Configure Lucene Indexing
      11. 8.11. Verification
    9. 9. What is MindTouch DekiWiki?
    10. 10. What is MindTouch Dream?
    11. 11. Additional Resources
    12. 12. Licenses


    ______________________________________________________________________________

    Proem

    Thank you for evaluating DekiWiki pre-release Hayes BETA. We are very interested in your input and feedback. As you evaluate the beta you should be aware of a few key points. First, this is not a production release and it should not be used as such. That said we are especially interested in feedback on:

    1. Upgrade script.
    2. Installation guide and just general installation feedback. Did you have any significant problems with dependencies? Anything?
    3. LDAP. See the release notes for documentation on this and as always you may or review/update/edit: http://doc.opengarden.org/DekiWiki/I...ting_with_LDAP .  Tell us if you have any problems with LDAP and if the documentation on this topic makes sense.

    The control panel still has significant work left before we officially release Hayes; therefore, before making any recommendations on the control panel please first review http://doc.opengarden.org/DekiWiki/S...Panel_Redesign . The services manager in the control panel is especially early in development; so, don't waste any time with this view.

    There are some known issues and a security bug related to input validation with tagging and another known security bug with input validation when embedding RSS feeds.

    What's New

    • New redesigned navigation pane
    • Tagging, chrono-tagging, tag definitions
      • Tagging. Organize and sort pages by user-defined tags.
      • Tag definitions are when a user may define a page as the parent of a tag. For example. If one were to tag a page "define:foo" all pages tagged with "foo" would be presented on said page.
      • Chrono-tagging is when a page may be tagged with a specific date. This can be achieved with prefixing "date:" to a date or time. For example, a user can tag a page with "date:May 31", "date:today", or "date:5/31/2007" and each tag will yield the same outcome.
    • New image gallery
      • New controls for sorting attached images.
      • Lightbox for presenting attached images in page context.
      • Image slide show.
      • Improved user experience for image versions.
    • Significant improvements to the editor.
    • LDAP integration
    • Please review http://doc.opengarden.org/DekiWiki/I...ting_with_LDAP .
    • Easily extensible arch for authentication providers
      • Note: this is not complete in the beta release. The control panel's services manager allows admins to enlist in external authentication providers.
    • Group-based permissioning
      • Groups provided by authentication providers.
    • Complete rewrite of users, permissions, and grants
    • New Page revisions comparison
      • This was a complete rewrite. In the past the tool that performed the comparison between two page version was easily confused and the presentation was not especially desirable. This has been dramatically improved
    • Multiple templating support
    • Multiple skinning support
    • New control panel user interface
      • Note: this is not complete in the beta release. Usability improvements. For example, better user management tools.
    • Services manager
    • Note: this is not complete in the beta release.
      • Print pages
    • Dramatic improvements to the print pages dialog and print output.
    • Bi-directional API
    • Create, Read, Update and Delete operations.
    • Complete rewrite of the page parser
      • In the Hayes release this is primarily manifested in the form of bug fixes.
    • Rich media support.
    • Multiple video types, flash, etc.
    • HTML to PS
    • More than a hundreds of bug-fixes and enhancements.

    Downloading

     If you wish to download the source code of MindTouch DekiWiki or Dream:

    See Section 10. Additional Resources for more information and physical address.

    If you are interested in MindTouch Deki, the commercial enterprise collaboration wiki that installs in minutes and receives support as well as automatic updates:

    Package Payload

      deki-hayes

     |

     +---README - (you're reading this now)

     |

     +---/config - all configuration that require editing for deployment

     |

     +---/src - all source code, including API source code

     |

     +---/web - all files (php and deki api binaries) that are required to install DekiWiki.

    Compatibility Concerns

    When upgrading from previous versions of DekiWiki:


    MySQL 5.0.X - NOTE: DekiWiki Hayes uses stored procedures and is therefore incompatible with MySQL 4.x

    PHP 5.X - NOTE: DekiWiki Hayes uses the PHP5 object model and is therefore incompatible with PHP4

    Enhancements and Bugfixes

    Various improvements to search and bugfixes including numerical data support

    Fixed integer parsing bugs in 'gmap()' and 'chat()' live content extensions

    Table handling in editor improved

    Provided a patch to MySQL bug http://bugs.mysql.com/bug.php?id=28167

    New error and warning messaging

    Bugs: 1846, 1845, 1845, 1844, 1842, 1825, 1814, 1805, 1788, 1780, 1779, 1775, 1767, 1764, 1763, 1728, 1726, 1723, 1715, 1704, 1689, 1686, 1682, 1679, 1678, 1670, 1669, 1668, 1665, 1649, 1644, 1642, 1641, 1637, 1632, 1631, 1617, 1611, 1610, 1606, 1604, 1599, 1591, 1588, 1582, 1581, 1580, 1578, 1575, 1573, 1564, 1563, 1559, 1558, 1555, 1550, 1549, 1547, 1545, 1544, 1538, 1536, 1529, 1528, 1523, 1510, 1509, 1508, 1503, 1497, 1495, 1480, 1477, 1473, 1472, 1470, 1461, 1458, 1454, 1450, 1444, 1442, 1439, 1437, 1426, 1423, 1422, 1421, 1420, 1407, 1401, 1399, 1398, 1381, 1372, 1367, 1365, 1364, 1350, 1349, 1346, 1329, 1327, 1323, 1300, 1299, 1287, 1285, 1278, 1274, 1273, 1268, 1267, 1263, 1256, 1254, 1241, 1238, 1227, 1223, 1211, 1209, 1204, 1201, 1183, 1165, 1165, 1149, 1142, 1125, 1119, 1096, 1095, 1087, 1075, 1069, 1060, 1051, 1031, 1029, 1012, 1007, 1006, 988, 952, 817, 758, 758, 737, 716, 712, 695, 693, 323, and 307

    Visit http://bugs.opengarden.org for more information. NOTE: You must be a registered user of http://www.opengarden.org to browse the bug tracker.

    DekiWiki Hayes Installation Guide

    Steps to install DekiWiki Hayes Beta.  NOTE: many of the steps below have Debian-specific characteristics.

    Prerequisites

    Apache 2.x

    MySQL 5.0.X - NOTE: DekiWiki Hayes uses stored procedures and is therefore incompatible with MySQL 4.x

    PHP 5.X - NOTE: DekiWiki Hayes uses the PHP5 object model and is therefore incompatible with PHP4

    Mono 1.2.X

    Install the prerequisites using apt-get (Debian)

    apt-get install apache2 php5 php5-cli php5-mysql libapache2-mod-php5
php5-mcrypt php5-mhash php5-gd php5-curl imagemagick wv pdftohtml html2text htmldoc aspell links php-pear curl mysql-server-5.0

    Install mono

    apt-get install mono-gmcs mono-mcs libmono-sqlite2.0-cil libmono-sqlite2.0-cil

    install pear libraries

    pear install XML_RPC Cache_Lite

    Download Hayes Beta Bits

    Download Hayes-Beta build from one of the following sources.

        * http://www.opengarden.org/source_code (includes SVN enlistment info)

        * http://sourceforge.net/projects/dekiwiki (tarballs)

    Extract the archive to your home directory:

    cd ~/
tar xfvz deki-hayes-beta1.tar.gz 
 cd deki-hayes

    Copy web files to your apache directory

    mkdir /var/www/deki-hayes 
cp -r web/*  /var/www/deki-hayes

    Edit Configuration Files

    Copy the deki-api configuration file to /etc/dekiwiki/ since it contains sensitive information such as passwords and/or keys

    cd config
mkdir /etc/dekiwiki
cp mindtouch.deki.startup.xml /etc/dekiwiki/

    Edit the deki-api configuration file: mindtouch.deki.startup.xml and change the following values:

    //deki-path => /var/www/deki-hayes 
//deki-resources-path =>  /var/www/deki-hayes/resources
//storage-provider/path => /var/www/deki-hayes/attachments
//deki-db-server => localhost
//deki-db-port => 3306
//deki-db-catalog => wikidb_hayes
//deki-db-user => wikiuser
//deki-db-password => your_password

    Run Installation Script

    cd /var/www/deki-hayes/config
./installWiki.sh --wikiName MyWiki --dbRootUser root --dbRootPwd mysql_root_password --dbWikiUser wikiuser --dbWikiUserPwd wikiuser_password --dbHost localhost --sysopPwd sysop_password --dbName wikidb_hayes --serverName deki-hayes

    --wikiName:  The title of your wiki

    --dbRootUser: the mysql user with privileges to create databases, tables, stored procedures, etc

    --dbRootPwd: password for the --dbRootUser

    --dbWikiUser: an unprivileged account the wiki will use to connect to MySQL (if the user doesn't exist, it will be created, otherwise the appropriate GRANTS will be applied)

    --dbWikiUserPwd: password for the --dbWikiUser

    --dbHost: MySQL host to create the database on

    --sysopPwd: The password for the wiki's built-in "Sysop" account

    --dbName: The name of the database to be created

    --serverName:  The fully qualified domain name that your wiki will use.  This should match your Apache ServerName directive in your <VirtualHost>configuration.  See Configure Apache section for more details. Note, deki-api uses this value to generate links to file attachments, images, etc

    Configure Apache

    cd ~/deki-hayes/

    Edit the deki-apache.conf file

    Change the following values according to your setup:

    ServerName deki-hayes
DocumentRoot "/var/www/deki-hayes"

    Copy the apache config file (for example, in Debian do:)

    cp config/deki-apache.conf /etc/apache2/sites-available/deki
ln -s /etc/apache2/sites-available/deki /etc/apache2/sites-enabled/001-deki

    Enable the mod_rewrite module

    a2enmod rewrite

    Configure Apache for deki-api

    The deki-api is a .NET application which runs under the mono runtime.  There are two options for integrating deki-api with Apache:

    1) mod_proxy - deki-api runs as a standalone executable which uses MindTouch Dream's built-in webserver.  mod_proxy proxies requests from apache to deki-api

    2) mod_mono - deki-api (and Dream runtime) is started by the apache process and requests are handled by an HttpHandler and sent into the Dream runtime

    Option 1: mod_proxy setup

    Enable mod_proxy_http module

    a2enmod proxy_http

    Edit the mod_proxy config file (/etc/apache2/mods-available/proxy.conf on Debian) and make sure you have the following:

    <Proxy *>
    AddDefaultCharset off
    Order deny,allow
    Deny from all
    Allow from all
</Proxy>

    Edit your deki apache config file /etc/apache2/sites-available/deki and make sure the following lines are uncommented

    # mod_proxy rules
ProxyPass /@api http://localhost:8081
ProxyPassReverse /@api http://localhost:8081
SetEnv force-proxy-request-1.0 1
SetEnv proxy-nokeepalive 1

    Restart apache to enable the module and apply the new settings

    /etc/init.d/apache2 restart

    Edit the dekiapi startup script (config/mindtouch.host.sh) and make sure your HOSTNAME is set properly

    HOSTNAME=deki-hayes

    NOTE: the value of HOSTNAME should be the same as your ServerName directive in your apache config above

    Copy the deki-api startup script to the dekiapi bin directory

    cp mindtouch.host.sh /var/www/deki-hayes/bin/

    Start deki-api

    touch /var/log/deki-api.log
chown www-data /var/log/deki-api.log
su www-data /var/www/deki-hayes/bin/mindtouch.host.sh start

    Verify that the deki-api is running by nagivating to the following URI in a browser:

    http://deki-hayes/@api/deki/@about

    Troubleshooting

    If deki-api failed to load try the following:

    * make sure the mono process is running

    ps ax|grep mindtouch.host

    You should see two processes like:

    17333 pts/1    S      0:00 /bin/sh ./mindtouch.host.sh
17334 pts/1    S      0:01 mono mindtouch.host.exe apikey 12345 script mindtouch.deki.startup.xml root-uri http://deki-hayes/@api notty

    If you don't see the process above, check the dekiapi error logs (/var/www/deki-hayes/bin/logs/trace.log) for more details

    NOTE!! Make sure you have the following:

    Create the mono .wapi directory (Note: the mono .wapi directory needs to exist in the home directory for your apache user.  In debian the www-data user's home dir is: /var/www/  but this location may be different for different linux distros.)

    mkdir /var/www/.wapi
chown www-data /var/www/.wapi

    Option 2: mod_mono setup

    Install mod_mono

    apt-get install mono-apache-server2 libapache2-mod-mono mono-apache-server

    Edit your deki apache config file /etc/apache2/sites-available/deki and make sure the following lines are uncommented

    Alias /@api "/var/www/deki-hayes"
MonoServerPath default /usr/lib/mono/2.0/mod-mono-server2.exe
AddMonoApplications default "/@api:/var/www/deki-hayes"
<Location /@api>
    SetHandler mono
</Location>

    Copy web.config

    cp ~/deki-hayes/src/web.config /var/www/deki-hayes/

    Edit /var/www/deki-hayes/web.config and change the following:

    <add key="root-uri" value="http://deki-hayes/@api" />

    NOTE: The host portion of your root-uri should be the same as your ServerName directive in your apache config above

    Create a log directory owned by your apache user so the mono process can write logs:

    mkdir /var/www/deki-hayes/logs

    Make sure the www-data user can write to the /var/www/deki-hayes directory

    chown -R www-data /var/www/deki-hayes

    Restart apache2

    /etc/init.d/apache2 restart

    Verify that the deki-api is running by nagivating to the following URI in a browser:

    http://deki-hayes/@api/deki/@about

    Troubleshooting

    If deki-api failed to load try the following:

    * make sure the mono process started

    ps ax|grep mod-mono-server2

    You should see a process like:

    /usr/bin/cli /usr/lib/mono/2.0/mod-mono-server2.exe --filename /tmp/mod_mono_server_default --applications /@api:/var/www/deki-hayes --nonstop

    If you don't see the process above, check the apache error logs for error messages

    cat /var/www/deki-hayes/logs/trace.log

    Configure Lucene Indexing

    Indexing has changed slightly in DekiWiki Hayes.  The path to the lucene binaries has been changed to /var/www/deki-hayes/bin/mwsearch in order to keep things more self-contained.

    Beta Note:  indexing/search may not be functioning properly in the Beta release of Hayes

    Edit the mwsearch.conf.deki file and make sure you've defined the following:

    databases=wikidb_hayes
attachmentpaths=/var/www/deki-hayes/attachments
username=root
password=mysql_root_password

    Copy mwsearch.conf 

    cp ~/deki-hayes/config/mwsearch.conf.deki /etc/mwsearch.conf
mkdir /var/run/mwsearch
cp ~/deki-hayes/config/mwlucene /etc/init.d/mwlucene
chmod +x /etc/init.d/mwlucene
ln -s /etc/init.d/mwlucene /etc/rc2.d/S20mwlucene

    Rebuild your lucene index:

    cd /var/www/deki-hayes/bin/mwsearch
./MWUpdater --rebuild

    Start lucene

    /etc/init.d/mwlucene start

    Verification

    Verify your new DekiWiki Hayes installation by launching a browser and going to the following URI:

    http://deki-hayes/

    Upgrade Guide

    Steps to install DekiWiki Hayes Beta.  NOTE: many of the steps below have Debian-specific characteristics.

    Prerequisites

    Apache 2.x

    MySQL 5.0.X - NOTE: DekiWiki Hayes uses stored procedures and is therefore incompatible with MySQL 4.x

    PHP 5.X - NOTE: DekiWiki Hayes uses the PHP5 object model and is therefore incompatible with PHP4

    Mono 1.2.X

    Install the prerequisites using apt-get (Debian)

    apt-get install apache2 php5 php5-cli php5-mysql libapache2-mod-php5 php5-mcrypt php5-mhash php5-gd php5-curl imagemagick wv pdftohtml html2text htmldoc aspell links php-pear curl mysql-server-5.0

    Install mono

    apt-get install mono-gmcs mono-mcs libmono-sqlite2.0-cil libmono-sqlite2.0-cil

    install pear libraries

    pear install XML_RPC Cache_Lite

    Perform a Full Backup

    First backup your mysql database:

    mysqldump -u your_username -pyour_password your_wikidb  > wikidb-backup.sql

    Next backup your attached files

    cd /var/www/mks-wiki
tar cvzf ~/attachments-backup.tar.gz attachments

    Download Hayes Beta Bits

    Download Hayes-Beta build from one of the following sources.

        * http://www.opengarden.org/source_code (includes SVN enlistment info)

        * http://sourceforge.net/projects/dekiwiki (tarballs)

    Extract the archive to your home directory:

    cd ~/
tar xfvz deki-hayes-beta1.tar.gz 
cd deki-hayes

    Copy web files to your apache directory

    mkdir /var/www/deki-hayes 
cp -r web/*  /var/www/deki-hayes

    Setup a New Wiki Database

    Create a new database for your wiki (ex: wikidb_hayes)

    mysql -u root -pyour_password -e "create database wikidb_hayes"

    Populate the database with your old data 

    mysql -u root -pyour_password wikidb_hayes < wikidb-backup.sql

    Createa a wikiuser to connect to the DB as: 

    mysql -u root -pmysql_root_password -e "GRANT SELECT,INSERT,UPDATE,DELETE,EXECUTE on wikidb_hayes.* to wikiuser@'%' IDENTIFIED BY 'your_password';"

    Make sure the root user has permissions to create/alter stored procedures

    mysql -u root -pmysql_root_password -e "GRANT CREATE ROUTINE, ALTER ROUTINE ON *.* TO root@'%' IDENTIFIED BY 'mysql_root_password';"
mysql -u root -pmysql_root_password -e "GRANT ALL ON wikidb_hayes.* TO root@'%'; FLUSH PRIVILEGES;"

    Edit Configuration Files

    All the relevent configuration files are in:  ~/deki-hayes/config

    cd ~/deki-hayes/config

    Edit LocalSettings.php and change the following values:

    $IP = "/var/www/deki-hayes";
$wgDBserver = "localhost";
$wgDBname = "wikidb_hayes";
$wgDBuser = "wikiuser";
$wgDBpassword = "your_password";

    Copy LocalSettings.php to your wiki's root directory:

    cp LocalSettings.php /var/www/deki-hayes/

    Edit AdminSettings.php in your config/ directory and change the following values to match your setup:

    $wgDBadminuser = 'root';
$wgDBadminpassword = 'mysql_root_passoword';

    Copy AdminSettings.php to yoru wiki's root directory:

    cp AdminSettings.php /var/www/deki-hayes/

    Copy the deki-api configuration file to /etc/dekiwiki/ since it contains sensitive information such as passwords and/or keys

    mkdir /etc/dekiwiki
cp mindtouch.deki.startup.xml /etc/dekiwiki/

    Edit the deki-api configuration file: mindtouch.deki.startup.xml and change the following values:

    //deki-path => /var/www/deki-hayes 
//deki-resources-path =>  /var/www/deki-hayes/resources
//storage-provider/path => /var/www/deki-hayes/attachments
//deki-db-server => localhost
//deki-db-port => 3306
//deki-db-catalog => wikidb_hayes
//deki-db-user => wikiuser
//deki-db-password => your_password

    Configure Apache

    Edit the config/deki-apache.conf file

    Change the following values according to your setup:

    ServerName deki-hayes 
DocumentRoot "/var/www/deki-hayes"

    Copy the apache config file (for example, in Debian do:)

    cp config/deki-apache.conf /etc/apache2/sites-available/deki
ln -s /etc/apache2/sites-available/deki /etc/apache2/sites-enabled/001-deki

    Enable the mod_rewrite module

    a2enmod rewrite

    Database Migration

    The database schema changed significantly between the Gooseberry and Hayes releases.  Many names changed and most inline SQL queries were moved into stored procedures.

    Run the one-time conversion script to migrate Gooseberry to Hayes:

    cd /var/www/deki-hayes/maintenance
php update-db-df2hayes.php

    If there were any errors in the upgrade script it's best do drop the wikidb_hayes database and start over to ensure that you don't have a corrupted database schema

    Configure Apache for deki-api

    The deki-api is a .NET application which runs under the mono runtime.  There are two options for integrating deki-api with Apache:

    1) mod_proxy - deki-api runs as a standalone executable which uses MindTouch Dream's built-in webserver.  mod_proxy proxies requests from apache to deki-api

    2) mod_mono - deki-api (and Dream runtime) is started by the apache process and requests are handled by an HttpHandler and sent into the Dream runtime

    Option 1: mod_proxy setup

    Enable mod_proxy_http module

    a2enmod proxy_http

    Edit the mod_proxy config file (/etc/apache2/mods-available/proxy.conf on Debian) and make sure you have the following:

    <Proxy *>
    AddDefaultCharset off
    Order deny,allow
    Deny from all
    Allow from all
</Proxy>

    Edit your deki apache config file /etc/apache2/sites-available/deki and make sure the following lines are uncommented

    # mod_proxy rules
ProxyPass /@api http://localhost:8081
ProxyPassReverse /@api http://localhost:8081
SetEnv force-proxy-request-1.0 1
SetEnv proxy-nokeepalive 1

    Restart apache to enable the module and apply the new settings

    /etc/init.d/apache2 restart

    Edit the dekiapi startup script (config/mindtouch.host.sh) and make sure your HOSTNAME is set properly

    HOSTNAME=deki-hayes

    NOTE: the value of HOSTNAME should be the same as your ServerName directive in your apache config above

    Copy the deki-api startup script to the dekiapi bin directory

    cp mindtouch.host.sh /var/www/deki-hayes/bin/

    Start deki-api

    touch /var/log/deki-api.log
chown www-data /var/log/deki-api.log
su www-data /var/www/deki-hayes/bin/mindtouch.host.sh start

    Verify that the deki-api is running by nagivating to the following URI in a browser:

    http://deki-hayes/@api/deki/@about

    Troubleshooting

    If deki-api failed to load try the following:

    * make sure the mono process is running

    ps ax|grep mindtouch.host

    You should see two processes like:

    17333 pts/1    S      0:00 /bin/sh ./mindtouch.host.sh
17334 pts/1    S      0:01 mono mindtouch.host.exe apikey 12345 script mindtouch.deki.startup.xml root-uri http://deki-hayes/@api notty

    If you don't see the process above, check the dekiapi error logs (/var/www/deki-hayes/bin/logs/trace.log) for more details

    Option 2: mod_mono setup

    Install mod_mono

    apt-get install mono-apache-server2 libapache2-mod-mono mono-apache-server

    Edit your deki apache config file /etc/apache2/sites-available/deki and make sure the following lines are uncommented

    Alias /@api "/var/www/deki-hayes"
MonoServerPath default /usr/lib/mono/2.0/mod-mono-server2.exe
AddMonoApplications default "/@api:/var/www/deki-hayes"
<Location /@api>
    SetHandler mono
</Location>

    Copy web.config

    cp ~/deki-hayes/src/web.config /var/www/deki-hayes/

    Edit /var/www/deki-hayes/web.config and change the following:

    <add key="root-uri" value="http://deki-hayes/@api" />

    NOTE: The host portion of your root-uri should be the same as your ServerName directive in your apache config above

    Create a log directory owned by your apache user so the mono process can write logs:

    mkdir /var/www/deki-hayes/logs

    Make sure the www-data user can write to the /var/www/deki-hayes directory

    chown -R www-data /var/www/deki-hayes

    Restart apache2

    /etc/init.d/apache2 restart

    Verify that the deki-api is running by nagivating to the following URI in a browser:

    http://deki-hayes/@api/deki/@about

    Troubleshooting

    If deki-api failed to load try the following:

    * make sure the mono process started

    ps ax|grep mod-mono-server2

    You should see a process like:

    /usr/bin/cli /usr/lib/mono/2.0/mod-mono-server2.exe --filename /tmp/mod_mono_server_default --applications /@api:/var/www/deki-hayes --nonstop

    If you don't see the process above, check the apache error logs for error messages

    cat /var/www/deki-hayes/logs/trace.log

    Restore Attachments

    tar xfvz ~/attachments.tar.gz  -C /var/www/deki-hayes/

    Configure Lucene Indexing

    Indexing has changed slightly in DekiWiki Hayes.  The path to the lucene binaries has been changed to /var/www/deki-hayes/bin/mwsearch in order to keep things more self-contained.

    Edit the mwsearch.conf.deki file and make sure you've defined the following:

    databases=wikidb_hayes
attachmentpaths=/var/www/deki-hayes/attachments
username=root
password=mysql_root_password

    Copy mwsearch.conf 

    cp ~/deki-hayes/config/mwsearch.conf.deki /etc/mwsearch.conf
mkdir /var/run/mwsearch
cp ~/deki-hayes/config/mwlucene /etc/init.d/mwlucene
chmod +x /etc/init.d/mwlucene
ln -s /etc/init.d/mwlucene /etc/rc2.d/S20mwlucene

    Rebuild your lucene index:

    cd /var/www/deki-hayes/bin/mwsearch
./MWUpdater --rebuild

    Start lucene

    /etc/init.d/mwlucene start

    Verification

    Verify your new DekiWiki Hayes installation by launching a browser and going to the following URI:

    http://deki-hayes/

    What is MindTouch DekiWiki?

    MindTouch DekiWiki is the first and only OSI-approved commercial open source wiki.

    Deki means smart in Japanese. Combine that with the Hawaiian wikiwiki, meaning fast and quick, and you get DekiWiki in a nutshell: The smartest, fastest, most sophisticated and advanced open-source wiki application available today.

    DekiWiki was developed with an emphasis on open standards, extensibility, and performance. It began as a MediaWiki fork and has since become something significantly more than just another Wiki. It facilitates information sharing in a contextually rich environment, has a very polished WYSIWYG Editor, allows the capture and sharing of files, which are indexed and searchable, and stores in XHTML. Indexing is done with Lucene, AJAX is employed where appropriate, and data is portable.

    Learn more about DekiWiki: http://opengarden.org/dekiwiki

    Additional documentation: http://doc.opengarden.org/Dekiwiki

    What is MindTouch Dream?

    MindTouch Dream is a RESTfull distributed application framework developed in Mono/.NET. With Dream, a Web service is similar to an object, and features interact through standard HTTP verbs. This design allows the developer to assume an "idealized" world where everything a service comes into contact with is accessed through Web requests. The Dream service library addresses common problems, and the Dream runtime orchestrates all interactions without requiring a Web server to be pre-installed on a target machine. Dream avoids unnecessary abstractions and overhead for services by providing direct access to the rich, distributed application capabilities of HTTP. It can be embedded into existing web-application frameworks or operate independently.

    MindTouch Dream manages all the complex aspects of interactive web services, such as providing storage locations, database connections, event notifications, automatic data conversion from XML to JSON and short-circuit communication for co-hosted services. The platform enables developers to create enterprise-ready service architectures with exceptional speed and ease.

    Learn more about Dream: http://opengarden.org/dream

    Additional documentation: http://doc.opengarden.org/dream

    Additional Resources

            MindTouch, Inc

                    555 West Beech Street Suite 501

                    San Diego, CA 92101

    Was this page helpful?
    Tag page
    What links here

    Files 2

    Attach file or image
    FileVersionSizeModified 
    You must login to post a comment.
    MindTouch Social Knowledge Base

    Copyright © 2011 MindTouch, Inc. Powered by