Sun SPARC Solaris 8 (Itasca)

Download Itasca Bits

Download Itasca build from one of the following sources.

• RECOMMENDED: http://sourceforge.net/projects/dekiwiki (tarballs)
  
• http://wiki.opengarden.org/Source_Code (includes SVN enlistment info)

Extract the archive to your home directory:

cd $HOME
wget http://jaist.dl.sourceforge.net/sourceforge/dekiwiki/Deki_Wiki_1.9.0b_Itasca_source.tar.gz
gtar xfvz Deki_Wiki_1.9.0b_Itasca_source.tar.gz
cd Deki_Wiki_1.9.0b_Itasca_source

Copy web files to your apache share directory.

NOTE:
The Blastwave.com 's Apache package configured to use "/opt/csw/apache2/share/htdocs" as DocumentRoot, but I choose "/opt/csw/apache2/share/dekiwiki" to DocumentRoot for Deiki Wiki's exclusive use.

mkdir /opt/csw/apache2/share/dekiwiki/
cp -pir web/* /opt/csw/apache2/share/dekiwiki/
chown -R nobody:nogroup /opt/csw/apache2/share/dekiwiki/

(OPTIONAL)
If you use Internet Explorer 6.0 browser, I recommend to do next ops to avoid link error for Deiki Wiki 1.9.0b.

cd /opt/csw/apache2/share/dekiwiki/skins/

cp -pi common/icons/icon-lock.gif ace/neutral/icon_lock.gif
cp -pi common/icons/icon-mail.gif ace/neutral/icon_mail.gif
cp -pi common/icons/icon-file.gif ace/neutral/icon_file.gif
cp -pi common/icons/icon-discuss.gif ace/neutral/icon_discuss.gif
cp -pi common/icons/anim-save.gif ace/neutral/anim-save.gif

cp -pi common/icons/icon-lock.gif ace/blue/icon_lock.gif
cp -pi common/icons/icon-mail.gif ace/blue/icon_mail.gif
cp -pi common/icons/icon-file.gif ace/blue/icon_file.gif
cp -pi common/icons/icon-discuss.gif ace/blue/icon_discuss.gif
cp -pi common/icons/anim-save.gif ace/blue/anim-save.gif

Configure Apache server for Deki Wiki

Deki Wiki contains a Apache configuration file named "deki-apache.conf".
I include this file (deki-apache.conf) into the Apache bundled configuration file (httpd.conf).

Copy the "deki-apache.conf" file from source onto Apache configuration direcory.

cd $HOME/Deki_Wiki_1.9.0b_Itasca_source
cp -pi ./config/deki-apache.conf /opt/csw/apache2/etc/deki-apache.conf.orig
cp -pi ./config/deki-apache.conf /opt/csw/apache2/etc/deki-apache.conf

Edit and Change the "deki-apache.conf"file according to your setup:

• ServerName :
  hostname (or FQDN) for your Solaris box
• ErrorLog :
  error reporting file for Apache server
  
• CustomLog :
  access reporting file for Apache server
• DocumentRoot :
  pathname of subdirectory which containing the Deki Wiki web files.

vi /opt/csw/apache2/etc/deki-apache.conf
diff /opt/csw/apache2/etc/deki-apache.conf.orig /opt/csw/apache2/etc/deki-apache.conf
2c2
<       ServerName dekiwiki
---
>       ServerName hostname.mydomain.com
4,5c4,5
<       ErrorLog /var/log/apache2/error.log
<       CustomLog /var/log/apache2/access.log common
---
>       ErrorLog /opt/csw/apache2/var/log/error_log
>       CustomLog /opt/csw/apache2/var/log/access_log common
7c7
<       DocumentRoot "/var/www/dekiwiki"
---
>       DocumentRoot "/opt/csw/apache2/share/dekiwiki"

Add the Proxy definition to end of "deki-apache.conf"file.

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

As a result, "deki-apache.conf"seems to like this.

cat /opt/csw/apache2/etc/deki-apache.conf
<VirtualHost *>
	ServerName hostname.mydomain.com

	ErrorLog /opt/csw/apache2/var/log/error_log
	CustomLog /opt/csw/apache2/var/log/access_log common

	DocumentRoot "/opt/csw/apache2/share/dekiwiki"

	RewriteEngine On
	RewriteCond %{REQUEST_URI} ^/$
	RewriteRule ^/$ /index.php?title= [L,NE]

	RewriteCond %{REQUEST_URI} ^/@gui/[^.]+$
	RewriteRule ^/@gui/(.*)$ /proxy.php?path=$1 [L,QSA,NE] 

	RewriteCond %{REQUEST_URI} !^/(@api|editor|skins|config|@gui)/
	RewriteCond %{REQUEST_URI} !^/index\.php
	RewriteCond %{REQUEST_URI} !^/favicon\.ico$
	RewriteCond %{REQUEST_URI} !^/robots\.txt$
	RewriteCond %{QUERY_STRING} ^$ [OR] %{REQUEST_URI} ^/Special:Search
	RewriteRule ^/(.*)$ /index.php?title=$1 [L,QSA,NE]

	# deki-api uses encoded slashes in query parameters so AllowEncodedSlashes must be On
	AllowEncodedSlashes On   

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

</VirtualHost>

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

Configure Apache Server for deki-api application

The deki-api is a .NET application which runs under the Mono runtime.  deki-api runs as a standalone mono application which uses MindTouch Dream's built-in webserver.  mod_proxy proxy is used to proxy requests from apache to deki-api.

cp -pi /opt/csw/apache2/etc/httpd.conf /opt/csw/apache2/etc/httpd.conf.orig
vi /opt/csw/apache2/etc/httpd.conf

(1) add next two lines to this file near end of the file.
# Deki Wiki settings
Include etc/deki-apache.conf

(2) enable next three lines
LoadModule proxy_module libexec/mod_proxy.so
LoadModule proxy_http_module libexec/mod_proxy_http.so
LoadModule rewrite_module libexec/mod_rewrite.so

(3) change DocumentRoot and the web root Directory to point directory Deki Wiki web files.
DocumentRoot "/opt/csw/apache2/share/dekiwiki"
<Directory "/opt/csw/apache2/share/dekiwiki">

(4) So that diffential between original file and edited file is:
diff /opt/csw/apache2/etc/httpd.conf.orig /opt/csw/apache2/etc/httpd.conf
95c95
< #LoadModule proxy_module libexec/mod_proxy.so
---
> LoadModule proxy_module libexec/mod_proxy.so
98c98
< #LoadModule proxy_http_module libexec/mod_proxy_http.so
---
> LoadModule proxy_http_module libexec/mod_proxy_http.so
173c173,174
< DocumentRoot "/opt/csw/apache2/share/htdocs"
---
> # DocumentRoot "/opt/csw/apache2/share/htdocs"
> DocumentRoot "/opt/csw/apache2/share/dekiwiki"
200c201,202
< <Directory "/opt/csw/apache2/share/htdocs">
---
> # <Directory "/opt/csw/apache2/share/htdocs">
> <Directory "/opt/csw/apache2/share/dekiwiki">
472a475,477
> # Deki Wiki settings
> Include etc/deki-apache.conf
>

Restart Apache to enable the module and apply the new settings

/etc/rc3.d/S50cswapache2 graceful

At this time, Apache's error_log file should not report any errors.

# tail -f /opt/csw/apache2/var/log/error_log
[Sat Mar 29 20:22:13 2008] [notice] Digest: generating secret for digest authentication ...
[Sat Mar 29 20:22:13 2008] [notice] Digest: done
[Sat Mar 29 20:22:13 2008] [notice] Apache/2.2.6 (Unix) PHP/5.2.4 configured
 -- resuming normal operations

NOTE :
To run syntax check for Apache configuration file, use options of Apache server.

(1) to run syntax check for config files
# /opt/csw/apache2/sbin/httpd -t
Syntax OK

(2) to show parsed settings
# /opt/csw/apache2/sbin/httpd -S
VirtualHost configuration:
wildcard NameVirtualHosts and _default_ servers:
*:*                    hostname.mydomain.com (/opt/csw/apache2/etc/deki-apache.conf:1)
Syntax OK

(3) to show all loaded modules
# /opt/csw/apache2/sbin/httpd -M
 (snip)

Configure deki-api application

Create the deki-api logfile with null contents which writable to Apache user.

# mkdir /var/log/dekiwiki/
# touch /var/log/dekiwiki/deki-api.log
# chown nobody:nogroup /var/log/dekiwiki/deki-api.log
# chmod 644 /var/log/dekiwiki/deki-api.log
# ls -la /var/log/dekiwiki/
total 46
drwxr-xr-x   2 root     other        512 Mar 29 13:05 .
drwxr-xr-x   3 root     sys          512 Mar 29 13:05 ..
-rw-r--r--   1 nobody   nogroup        0 Mar 29 13:03 deki-api.log

Create the Mono's ".wapi" directory, then change the owner to Apache user.

NOTE:

• The Mono ".wapi" directory needs to exist in the home directory for your Apache user. In this guide the nobody user's home directory is "/" (root directory).
• Note that Apache user and home directory depend on Apache configuration.

# mkdir /.wapi
# chown nobody:nogroup /.wapi
# ls -la /.wapi
total 100
drwxr-xr-x   2 nobody   nogroup      512 Mar 29 17:22 .
drwxr-xr-x  31 root     root        1536 Mar 29 17:21 ..

Copy and Edit the config/dekiwiki-init.debian init script. This script can be used to test the status of the deki-api or start/stop the "mindtouch.host.exe" (deki-api) process.

Change the following to match your configuration:

• PATH :
  comented out, this variable are assigned in /.bash_profile script
• setenv to run Mono
  add ". /.bash_profile" line to configure environment variables to run Mono
  
• DEKIWIKI_USER :
  effective user of Apache HTTP server, which described "User/Group" parameter in the /opt/csw/apache2/etc/httpd.conf file.
  
• ps command :
  In Solaris "ps" command has argument(s) different from Linux
  
• su command:
  In Solaris "su" command substitutable of the "start-stop-daemon" command on Linux

NOTE:
It is generally used that "nobody" on Solaris, but "nobody" has no shell definition at /etc/password file for security reason, so that default shell (/usr/bin/sh) is used.
And then "nobody" has the "/" (root directory) as home directory, therefor "nobody" sharing dot-files like "/.bash_profile", "/.bashrc", "/.profile" with super-user ("root").

# cd $HOME/Deki_Wiki_1.9.0b_Itasca_source/
# cp -pi config/dekiwiki-init.debian /etc/init.d/dekiwiki
# chown root:root /etc/init.d/dekiwiki
# chmod 744 /etc/init.d/dekiwiki
# ln -s /etc/init.d/dekiwiki /etc/rc3.d/S92dekiwiki
# ls -l /etc/rc3.d/S92dekiwiki /etc/init.d/dekiwiki
-rwxr--r--   1 root     root        3187 Mar 30 13:29 /etc/init.d/dekiwiki
lrwxrwxrwx   1 root     other         20 Mar 30 12:49 /etc/rc3.d/S92dekiwiki -> /etc/init.d/dekiwiki
# vi /etc/init.d/dekiwiki
# diff config/dekiwiki-init.debian /etc/init.d/dekiwiki
4c4
< PATH=/bin:/sbin:/usr/bin:/usr/sbin
---
> # PATH=/bin:/sbin:/usr/bin:/usr/sbin
5a6,8
> # setenv to run Mono
> . /.bash_profile
>
7c10,11
< DEKIWIKI_USER="www-data"
---
> # DEKIWIKI_USER="www-data"
> DEKIWIKI_USER="nobody"
71c75,77
<     echo $(ps -U $DEKIWIKI_USER -o pid,cmd | grep mindtouch.host.exe | grep $HTTP_PORT |awk '{print $1}')
---
>     # echo $(ps -U $DEKIWIKI_USER -o pid,cmd | grep mindtouch.host.exe | grep $HTTP_PORT |awk '{print $1}')
>     echo $(/bin/ps -f -u $DEKIWIKI_USER -o pid,args | \
>         grep mindtouch.host.exe | grep -v -- "-su -c" | awk '{print $1}')
109c115,116
<     start-stop-daemon --start --quiet --chuid $DEKIWIKI_USER --exec $MONO -- $MONO_ARGS 2>&1 >> $LOGFILE &
---
>     # start-stop-daemon --start --quiet --chuid $DEKIWIKI_USER --exec $MONO -- $MONO_ARGS 2>&1 >> $LOGFILE &
>     su - $DEKIWIKI_USER -c "$MONO $MONO_ARGS" 2>&1 >> $LOGFILE &

Then /etc/init.d/dekiwiki will be:

#!/bin/bash

prog="MindTouch Deki Host Service"
# PATH=/bin:/sbin:/usr/bin:/usr/sbin

# setenv to run Mono
. /.bash_profile

DEKIHOST_CONF="/etc/dekiwiki/mindtouch.host.conf"
# DEKIWIKI_USER="www-data"
DEKIWIKI_USER="nobody"

if [ ! -f $DEKIHOST_CONF ]; then
    echo "$DEKIHOST_CONF does not exist"
    exit 1
fi

. $DEKIHOST_CONF

# set default values if not specified in $DEKIHOST_CONF

if [ ! -f "$MONO" ]; then
    echo "Please specify the full path to your mono binary"
    exit 1
fi

if [ ! -d "$BIN_DIR" ]; then
    echo "Please specify the path to your DekiWiki bin directory"
    exit 1
fi

if [ -z "$APIKEY" ]; then
    echo "Please specify your APIKEY"
    exit 1
fi

if [ -z "$PATH_PREFIX" ]; then
    PATH_PREFIX="@api"
fi

if [ -z "$HTTP_PORT" ]; then
    HTTP_PORT="8081"
fi

if [ -z "$IP" ]; then
    IP="localhost"
fi

if [ -z "$HOST_EXE" ]; then
    HOST_EXE="$BIN_DIR/mindtouch.host.exe"
fi

if [ -z "$SCRIPT" ]; then
    SCRIPT="/etc/dekiwiki/mindtouch.deki.startup.xml"
fi

if [ -z "$NOTTY" ]; then
    NOTTY="notty"
fi

if [ -z "$CONNECT_LIMIT" ]; then
    CONNECT_LIMIT="-5"
fi

if [ -z "$LOGDIR" ]; then
    LOGDIR="/var/www/dekiwiki"
fi

if [ -z "$LOGFILE" ]; then
    LOGFILE="$LOGDIR/deki-api.log"
fi

pidof_dekiwiki() {
    # we grep on assembly name and port in case multiple mono processes are running
    # echo $(ps -U $DEKIWIKI_USER -o pid,cmd | grep mindtouch.host.exe | grep $HTTP_PORT |awk '{print $1}')
    echo $(/bin/ps -f -u $DEKIWIKI_USER -o pid,args | \
        grep mindtouch.host.exe | grep -v -- "-su -c" | awk '{print $1}')
}

stop() {
    PID=$(pidof_dekiwiki)
    echo -n "Stopping MindTouch Deki API: mindtouch.host.exe"
    if [ -z "$PID" ]; then
        echo 
        echo "dekiwiki is not running"
    else 

        # attempt to shut down gracefully using curl
        curl -m 10 -s -d "" "http://$IP:$HTTP_PORT/host/?apikey=$APIKEY&dream.in.verb=DELETE"
        sleep 3

        # if the host didn't shut down properly then kill it
        PID=$(pidof_dekiwiki)
        if [ -n "$PID" ]; then
            kill $PID
        fi
        echo .
    fi
}

start() {
    if [ ! -d $LOGDIR ]; then 
        mkdir $LOGDIR
        chown $DEKIWIKI_USER $LOGDIR
    fi

    PID=$(pidof_dekiwiki)
    if [ -n "$PID" ]; then
        echo "dekiwiki is already running: $PID"
        exit 1;
    fi
    # see if the process is already running
    MONO_ARGS="$HOST_EXE apikey $APIKEY script $SCRIPT path-prefix $PATH_PREFIX http-port $HTTP_PORT ip $IP connect-limit $CONNECT_LIMIT $NOTTY"
    echo -n "Starting MindTouch Deki API: mindtouch.host.exe"
    # start-stop-daemon --start --quiet --chuid $DEKIWIKI_USER --exec $MONO -- $MONO_ARGS 2>&1 >> $LOGFILE &
    su - $DEKIWIKI_USER -c "$MONO $MONO_ARGS" 2>&1 >> $LOGFILE &
    echo .
}


case "$1" in
  start)
    start
    ;;
  stop)
    stop
    ;;
  status)
    PID=$(pidof_dekiwiki)
    if [ -n "$PID" ]; then
        echo "dekiwiki is running: $PID"
    else
        echo "dekiwiki is stopped"
    fi
    ;;
  restart|force-reload)
    stop
    start
    ;;
  force-reload)
    stop
    start
    ;;
  *)
    echo "Usage: $0 {start|stop|force-reload|restart|status}"
    exit 1
esac

exit 0

Setup Lucene Index

Create a empty folder to store search index file.

mkdir -p /opt/csw/apache2/share/dekiwiki/bin/cache/luceneindex/
chown -R nobody:nogroup /opt/csw/apache2/share/dekiwiki/bin/cache/luceneindex/
chmod -R 775 /opt/csw/apache2/share/dekiwiki/bin/cache/luceneindex/

Deki Wiki site configuration using the web-installer

Launch a browser and go to the installer:

http://<hostname>/config/index.php

"DEKI WIKI Installation" page will be shown in your browser.

Environmental checking are all well and fine. Enter required information for Deki Wiki as below:

Deki Wiki Installation

Checking environment...

If you run into installation problems, please include the following lines.

Environment checked. You can install Deki Wiki.


All fields are required, unless otherwise noted.

Deki Wiki Setup
Site localization: English - United States
Site name: Deki Wiki
System e-mail: your e-mail
  Emails, such as password reminders, will be sent from this email address. 

Deki Wiki Administrator Account Setup
Admin username:  Admin
Admin password:  *****
Confirm password:  *****
Admin e-mail:  your e-mail
Your Name:  (optional) 
Your Phone:  (optional) 
Country: None
[X] Receive updates and notifications from MindTouch about Deki Wiki 

Database Configuration
Database host:  localhost
  If your database server isn't on your web server, enter the name or IP address here. 
Database name:  wikidb
  The database must not exist. 
Database user:  wikiuser
  The database user must not exist. 

Existing MySQL credentials
In order to complete the Deki Wiki installation, we require a MySQL user
 who can create database, stored procedures, and MySQL users. Usually this user is root.

Superuser name:  root
Superuser password:  ****

Advanced Configuration
Deki Wiki API Key:  ********************************
ImageMagick convert:  /opt/csw/bin/convert
  The path to the ImageMagick convert binary 
ImageMagick identify:  /opt/csw/bin/identify
  The path to the ImageMagick identify binary 
Mono:  /opt/csw/bin/mono
  The path to the mono binary 
html2ps:  /opt/csw/bin/html2ps
  The path to the html2ps binary 
ps2pdf:  /opt/csw/bin/ps2pdf
  The path to the ps2pdf binary 

[Install Deki Wiki!]

OK !
Fill in the required information and click "Install Deki Wiki !"

Deki Wiki Installation

Checking environment...
If you run into installation problems, please include the following lines.

Environment checked. You can install Deki Wiki.


Performing installation...
Success: Connected to installation database.
Success: Created database wikidb.
Creating tables...done.Granting user permissions to wikiuser on wikidb...done.
Success: Created Deki Wiki administrator account admin
Success: Generated API key and stored it in database.
Success: Site language set to en-us.
Success: Saved attachments path as /opt/csw/apache2/share/dekiwiki/attachments/
Success: Set your Deki Wiki site name as Deki Wiki
Creating stored procedures...done.
Success: Wrote LocalSettings.php to disk successfully.
Success: Wrote mindtouch.deki.startup.xml to disk successfully.
Success: Wrote mindtouch.host.conf to disk successfully.

Installation successful!


But wait, you're not done yet!
Please run the following commands manually from the command line to complete your installation:

cd /opt/csw/apache2/share/dekiwiki/config
mkdir /etc/dekiwiki
cp -p mindtouch.host.conf /etc/dekiwiki
cp -p mindtouch.deki.startup.xml /etc/dekiwiki
cp -p LocalSettings.php /opt/csw/apache2/share/dekiwiki/
/etc/init.d/dekiwiki start


Additionally, you might want to clean up your configuration files:

cd /opt/csw/apache2/share/dekiwiki
rm config/mindtouch.host.conf
rm config/mindtouch.deki.startup.xml
rm config/LocalSettings.php

Visit your Deki Wiki! (http://<hostname>/index.php)

Subscribe to the MindTouch Deki Wiki updates and notifications mailing list.

Complete the installation by running the additional commands as instructed by the installer.

NOTE:
Don't run commands shown by browser, they are for Linux distribution and not for Solaris.

Install derived files into suitable directory.

cd /opt/csw/apache2/share/dekiwiki/config/

mkdir /etc/dekiwiki
chown nobody:nogroup /etc/dekiwiki
chmod 755 /etc/dekiwiki

cp -pi mindtouch.host.conf /etc/dekiwiki/
cp -pi mindtouch.deki.startup.xml /etc/dekiwiki/
cp -pi LocalSettings.php /opt/csw/apache2/share/dekiwiki/

chmod 644 /etc/dekiwiki/mindtouch.host.conf
chmod 644 /etc/dekiwiki/mindtouch.deki.startup.xml
chmod 644 /opt/csw/apache2/share/dekiwiki/LocalSettings.php

Start the deki-api daemon.

# /etc/rc3.d/S92dekiwiki start
Starting MindTouch Deki API: mindtouch.host.exe.

# /etc/rc3.d/S92dekiwiki status
dekiwiki is running: 16323
16322

# ps -ef | grep mono | grep -v -- -su
  nobody 16323 16322  4 21:32:39 pts/3    0:05
 /opt/csw/bin/mono /opt/csw/apache2/share/dekiwiki/bin/mindtouch.host.exe apikey

# ls -l /var/log/dekiwiki/deki-api.log
-rw-r--r--   1 nobody   nogroup      122 Mar 29 21:32 /var/log/dekiwiki/deki-api.log

deki-api's Log file is here:

# tail -f /var/log/dekiwiki/deki-api.log
-------------------- initializing
-------------------- initialized 1.638825 secs
-------------------- ready 1.588045 secs

At this point you can talk to the deki-api daemon via the HTTP request.

deki-api daemon test:

# curl -i http://localhost:8081/deki/@about
HTTP/1.1 200 OK
Server: Dream-HTTPAPI/1.5.1.3404
Content-Type: text/html; charset=utf-8
Date: Sat, 29 Mar 2008 12:35:05 GMT
Content-Length: 50940
Connection: close

<html xmlns="http://www.w3.org/1999/xhtml"><head><title>MindTouch Deki Wiki Service</title>
<meta http-equiv="content-type" content="text/html;charset=utf-8" />
  (snip long HTML code)
</body></html>

Verification Deki Wiki

Verify your new Deki Wiki Itasca installation by launching a browser and going to the following URI:

http://<hostname>/index.php

/etc/init.d/dekihost stop
/etc/rc3.d/S50cswapache2 stop
ps -ef | egrep 'httpd|apache|mono'

mkdir $HOME/deki_backup
cd /opt/csw/apache2/share/deki-hayes/
gtar cvzpf /deki_backup/attachments.tar.gz attachments

cp -pi LocalSettings.php AdminSettings.php $HOME/deki_backup

cp -pi ./bin/mindtouch.host.sh $HOME/deki_backup
cp -pi ./config/mindtouch.deki.startup.xml $HOME/deki_backup

mysqldump -u<user> -p<password> <dbname> > $HOME/deki_backup/wikidb.sql

For example:
mysqldump -uroot -psecret wikidb > $HOME/deki_backup/wikidb.sql

cd /opt/csw/apache2/share/

(OPTIONAL) Backup all web objects to archive if you need
gtar cvzpf $HOME/deki_backup/deki-hayes.tar.gz deki-hayes

rm -rf deki-hayes

cp -pi /etc/init.d/dekihost $HOME/deki_backup/
rm /etc/init.d/dekihost
rm /etc/rc3.d/S92dekihost

cd $HOME
wget http://jaist.dl.sourceforge.net/sourceforge/dekiwiki/Deki_Wiki_1.9.0b_Itasca_source.tar.gz
gtar xfvz Deki_Wiki_1.9.0b_Itasca_source.tar.gz
cd Deki_Wiki_1.9.0b_Itasca_source/
mkdir /opt/csw/apache2/share/dekiwiki/
cp -pir web/* /opt/csw/apache2/share/dekiwiki/
chown -R nobody:nogroup /opt/csw/apache2/share/dekiwiki/

cd /opt/csw/apache2/share/dekiwiki/skins/

cp -pi common/icons/icon-lock.gif ace/neutral/icon_lock.gif
cp -pi common/icons/icon-mail.gif ace/neutral/icon_mail.gif
cp -pi common/icons/icon-file.gif ace/neutral/icon_file.gif
cp -pi common/icons/icon-discuss.gif ace/neutral/icon_discuss.gif
cp -pi common/icons/anim-save.gif ace/neutral/anim-save.gif

cp -pi common/icons/icon-lock.gif ace/blue/icon_lock.gif
cp -pi common/icons/icon-mail.gif ace/blue/icon_mail.gif
cp -pi common/icons/icon-file.gif ace/blue/icon_file.gif
cp -pi common/icons/icon-discuss.gif ace/blue/icon_discuss.gif
cp -pi common/icons/anim-save.gif ace/blue/anim-save.gif 

mkdir /var/log/dekiwiki/
touch /var/log/dekiwiki/deki-api.log
chown nobody:nogroup /var/log/dekiwiki/deki-api.log
chmod 644 /var/log/dekiwiki/deki-api.log

(Optional)
Move old ("Hayes") logfile to corresponsive location if you need.

mv -i /var/log/deki-api.log /var/log/dekiwiki/deki-api.log.hayes
ls -la /var/log/dekiwiki/
total 46
drwxr-xr-x   2 root     other        512 Mar 29 13:05 .
drwxr-xr-x   3 root     sys          512 Mar 29 13:05 ..
-rw-r--r--   1 nobody   nogroup        0 Mar 29 13:03 deki-api.log
-rw-r--r--   1 nobody   nogroup    21363 Mar 14 12:03 deki-api.log.hayes

(1) Determine current global apikey ("APIKEY") from backup file
# grep "<apikey>" $HOME/deki_backup/mindtouch.deki.startup.xml
      <apikey>zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz</apikey>

(2) Create the Deki Wiki host configuration file from scratch

# touch /etc/dekiwiki/mindtouch.host.conf
# chown nobody:nogroup /etc/dekiwiki/mindtouch.host.conf
# chmod 644 /etc/dekiwiki/mindtouch.host.conf
# vi /etc/dekiwiki/mindtouch.host.conf

(3) Contents of /etc/dekiwiki/mindtouch.host.conf are mentioned below.
    Where right side of "APIKEY=" are equality of the apikey value determined at step (1).

# cat /etc/dekiwiki/mindtouch.host.conf
-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----
# MindTouch Deki Wiki host configuration file

# The full path to your mono executable
MONO="/opt/csw/bin/mono"

# The location of your wiki's bin directory
BIN_DIR="/opt/csw/apache2/share/dekiwiki/bin"

# The ApiKey for the dream host
APIKEY="zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz"

PATH_PREFIX="@api"

# Port the API listens on
HTTP_PORT="8081"

# hostname to listen on
IP="localhost"

# location of the mindtouch.host.exe assembly
HOST_EXE="$BIN_DIR/mindtouch.host.exe"

# path to the Deki Wiki configuration xml file
SCRIPT="/etc/dekiwiki/mindtouch.deki.startup.xml"

# don't require a tty (non-interactive mode)
NOTTY="notty"

# The numbe of threads to reserve for internal use
CONNECT_LIMIT="-5"

# directory to store dekiwiki log files
LOGDIR="/var/log/dekiwiki"

# location of the dekiwiki API log file
LOGFILE="$LOGDIR/deki-api.log"

-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----

(1) Create the dekihost init script
# touch /etc/init.d/dekiwiki
# chown root:root /etc/init.d/dekiwiki
# chmod 744 /etc/init.d/dekiwiki
# vi /etc/init.d/dekiwiki

(2) Contents of init script here
# cat /etc/init.d/dekiwiki
-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----
#!/bin/bash

prog="MindTouch Deki Host Service"
# PATH=/bin:/sbin:/usr/bin:/usr/sbin

# setenv to run Mono
. /.bash_profile

DEKIHOST_CONF="/etc/dekiwiki/mindtouch.host.conf"
# DEKIWIKI_USER="www-data"
DEKIWIKI_USER="nobody"

if [ ! -f $DEKIHOST_CONF ]; then
    echo "$DEKIHOST_CONF does not exist"
    exit 1
fi

. $DEKIHOST_CONF

# set default values if not specified in $DEKIHOST_CONF

if [ ! -f "$MONO" ]; then
    echo "Please specify the full path to your mono binary"
    exit 1
fi

if [ ! -d "$BIN_DIR" ]; then
    echo "Please specify the path to your DekiWiki bin directory"
    exit 1
fi

if [ -z "$APIKEY" ]; then
    echo "Please specify your APIKEY"
    exit 1
fi

if [ -z "$PATH_PREFIX" ]; then
    PATH_PREFIX="@api"
fi

if [ -z "$HTTP_PORT" ]; then
    HTTP_PORT="8081"
fi

if [ -z "$IP" ]; then
    IP="localhost"
fi

if [ -z "$HOST_EXE" ]; then
    HOST_EXE="$BIN_DIR/mindtouch.host.exe"
fi

if [ -z "$SCRIPT" ]; then
    SCRIPT="/etc/dekiwiki/mindtouch.deki.startup.xml"
fi

if [ -z "$NOTTY" ]; then
    NOTTY="notty"
fi

if [ -z "$CONNECT_LIMIT" ]; then
    CONNECT_LIMIT="-5"
fi

if [ -z "$LOGDIR" ]; then
    LOGDIR="/var/www/dekiwiki"
fi

if [ -z "$LOGFILE" ]; then
    LOGFILE="$LOGDIR/deki-api.log"
fi

pidof_dekiwiki() {
    # we grep on assembly name and port in case multiple mono processes are running
    # echo $(ps -U $DEKIWIKI_USER -o pid,cmd | grep mindtouch.host.exe | grep $HTTP_PORT |awk '{print $1}')
    echo $(/bin/ps -f -u $DEKIWIKI_USER -o pid,args | \
        grep mindtouch.host.exe | grep -v -- "-su -c" | awk '{print $1}')
}

stop() {
    PID=$(pidof_dekiwiki)
    echo -n "Stopping MindTouch Deki API: mindtouch.host.exe"
    if [ -z "$PID" ]; then
        echo 
        echo "dekiwiki is not running"
    else 

        # attempt to shut down gracefully using curl
        curl -m 10 -s -d "" "http://$IP:$HTTP_PORT/host/?apikey=$APIKEY&dream.in.verb=DELETE"
        sleep 3

        # if the host didn't shut down properly then kill it
        PID=$(pidof_dekiwiki)
        if [ -n "$PID" ]; then
            kill $PID
        fi
        echo .
    fi
}

start() {
    if [ ! -d $LOGDIR ]; then 
        mkdir $LOGDIR
        chown $DEKIWIKI_USER $LOGDIR
    fi

    PID=$(pidof_dekiwiki)
    if [ -n "$PID" ]; then
        echo "dekiwiki is already running: $PID"
        exit 1;
    fi
    # see if the process is already running
    MONO_ARGS="$HOST_EXE apikey $APIKEY script $SCRIPT path-prefix $PATH_PREFIX http-port $HTTP_PORT ip $IP connect-limit $CONNECT_LIMIT $NOTTY"
    echo -n "Starting MindTouch Deki API: mindtouch.host.exe"
    # start-stop-daemon --start --quiet --chuid $DEKIWIKI_USER --exec $MONO -- $MONO_ARGS 2>&1 >> $LOGFILE &
    su - $DEKIWIKI_USER -c "$MONO $MONO_ARGS" 2>&1 >> $LOGFILE &
    echo .
}


case "$1" in
  start)
    start
    ;;
  stop)
    stop
    ;;
  status)
    PID=$(pidof_dekiwiki)
    if [ -n "$PID" ]; then
        echo "dekiwiki is running: $PID"
    else
        echo "dekiwiki is stopped"
    fi
    ;;
  restart|force-reload)
    stop
    start
    ;;
  force-reload)
    stop
    start
    ;;
  *)
    echo "Usage: $0 {start|stop|force-reload|restart|status}"
    exit 1
esac

exit 0

-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----


(3) Create an symbolic link to automatic start when Solaris goes "init state 3"
# ln -s /etc/init.d/dekiwiki /etc/rc3.d/S92dekiwiki
# ls -l /etc/rc3.d/S92dekiwiki /etc/init.d/dekiwiki
-rwxr--r--   1 root     root        3187 Mar 30 13:29 /etc/init.d/dekiwiki
lrwxrwxrwx   1 root     other         20 Mar 30 12:49 /etc/rc3.d/S92dekiwiki -> /etc/init.d/dekiwiki

cd $HOME/deki_backup
cp -pi LocalSettings.php AdminSettings.php /opt/csw/apache2/share/dekiwiki/
gtar xvzpf attachments.tar.gz -C /opt/csw/apache2/share/dekiwiki/
cp -pi mindtouch.host.sh /opt/csw/apache2/share/dekiwiki/bin/
cp -pi mindtouch.deki.startup.xml /etc/dekiwiki/

From: /opt/csw/apache2/share/deki-hayes
To:   /opt/csw/apache2/share/dekiwiki

# vi /opt/csw/apache2/share/dekiwiki/LocalSettings.php

# diff $HOME/deki_backup/LocalSettings.php /opt/csw/apache2/share/dekiwiki/LocalSettings.php
11,12c11,12
< $IP = "/opt/csw/apache2/share/deki-hayes";
< ini_set( "include_path", ".:/opt/csw/apache2/share/deki-hayes:/opt/csw/apache2/share/deki-hayes/includes:/opt/csw/apache2/share/deki-hayes/languages" );
---
> $IP = "/opt/csw/apache2/share/dekiwiki";
> ini_set( "include_path", ".:/opt/csw/apache2/share/dekiwiki:/opt/csw/apache2/share/dekiwiki/includes:/opt/csw/apache2/share/dekiwiki/languages" );

# vi /etc/dekiwiki/mindtouch.deki.startup.xml

# diff $HOME/deki_backup/mindtouch.deki.startup.xml /etc/dekiwiki/mindtouch.deki.startup.xml
27c27
<       <deki-path>/opt/csw/apache2/share/deki-hayes</deki-path>
---
>       <deki-path>/opt/csw/apache2/share/dekiwiki</deki-path>
70,81c70,81
<         <path.store>/opt/csw/apache2/share/deki-hayes/bin/cache/luceneindex/$1</path.store>
<         <filter-path extension="doc">/opt/csw/apache2/share/deki-hayes/bin/filters/wvText</filter-path>
<         <filter-path extension="pdf">/opt/csw/apache2/share/deki-hayes/bin/filters/pdf2text</filter-path>
<         <filter-path extension="xhtml">/opt/csw/apache2/share/deki-hayes/filters/html2text</filter-path>
<         <filter-path extension="html">/opt/csw/apache2/share/deki-hayes/bin/filters/html2text</filter-path>
<         <filter-path extension="htm">/opt/csw/apache2/share/deki-hayes/bin/filters/html2text</filter-path>
<         <filter-path extension="docx">/opt/csw/apache2/share/deki-hayes/bin/filters/docx2txt</filter-path>
<         <filter-path extension="odt">/opt/csw/apache2/share/deki-hayes/bin/filters/odt2txt</filter-path>
<         <filter-path extension="odp">/opt/csw/apache2/share/deki-hayes/bin/filters/odp2txt</filter-path>
<         <filter-path extension="ppt">/opt/csw/apache2/share/deki-hayes/bin/filters/ppt2txt</filter-path>
<         <filter-path extension="pptx">/opt/csw/apache2/share/deki-hayes/bin/filters/pptx2txt</filter-path>
<         <filter-path extension="xls">/opt/csw/apache2/share/deki-hayes/bin/filters/xls2txt</filter-path>
---
>         <path.store>/opt/csw/apache2/share/dekiwiki/bin/cache/luceneindex/$1</path.store>
>         <filter-path extension="doc">/opt/csw/apache2/share/dekiwiki/bin/filters/wvText</filter-path>
>         <filter-path extension="pdf">/opt/csw/apache2/share/dekiwiki/bin/filters/pdf2text</filter-path>
>         <filter-path extension="xhtml">/opt/csw/apache2/share/dekiwiki/filters/html2text</filter-path>
>         <filter-path extension="html">/opt/csw/apache2/share/dekiwiki/bin/filters/html2text</filter-path>
>         <filter-path extension="htm">/opt/csw/apache2/share/dekiwiki/bin/filters/html2text</filter-path>
>         <filter-path extension="docx">/opt/csw/apache2/share/dekiwiki/bin/filters/docx2txt</filter-path>
>         <filter-path extension="odt">/opt/csw/apache2/share/dekiwiki/bin/filters/odt2txt</filter-path>
>         <filter-path extension="odp">/opt/csw/apache2/share/dekiwiki/bin/filters/odp2txt</filter-path>
>         <filter-path extension="ppt">/opt/csw/apache2/share/dekiwiki/bin/filters/ppt2txt</filter-path>
>         <filter-path extension="pptx">/opt/csw/apache2/share/dekiwiki/bin/filters/pptx2txt</filter-path>
>         <filter-path extension="xls">/opt/csw/apache2/share/dekiwiki/bin/filters/xls2txt</filter-path>

# cp  -pi /opt/csw/apache2/etc/httpd.conf /opt/csw/apache2/etc/httpd.conf.02
# vi /opt/csw/apache2/etc/httpd.conf
# diff /opt/csw/apache2/etc/httpd.conf.02 /opt/csw/apache2/etc/httpd.conf
174c174
< DocumentRoot "/opt/csw/apache2/share/deki-hayes"
---
> DocumentRoot "/opt/csw/apache2/share/dekiwiki"
202c202
< <Directory "/opt/csw/apache2/share/deki-hayes">
---
> <Directory "/opt/csw/apache2/share/dekiwiki">

# cp -pi /opt/csw/apache2/etc/deki-apache.conf /opt/csw/apache2/etc/deki-apache.conf.02
# vi /opt/csw/apache2/etc/deki-apache.conf
# diff /opt/csw/apache2/etc/deki-apache.conf.02 /opt/csw/apache2/etc/de
ki-apache.conf
7c7
<       DocumentRoot "/opt/csw/apache2/share/deki-hayes"
---
>       DocumentRoot "/opt/csw/apache2/share/dekiwiki"

# cd /opt/csw/apache2/share/dekiwiki/maintenance

# php update-db.php

Updating wikidb on localhost
permission system DB upgrade has already been performed.
sprocs update complete
Applying misc database updates...done
adding role_hidden to roles table
cleanup up special pages
anonymous user updated for all tables
removed browse from private restriction
Updated `roles`: dropped unused column role_hidden
added page_template_id column to pages table
Done.

# mysql -uwikiuser -p<secret> wikidb
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 148
Server version: 5.0.51 Source distribution

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> desc config;
+--------------+------------------+------+-----+---------+----------------+
| Field        | Type             | Null | Key | Default | Extra          |
+--------------+------------------+------+-----+---------+----------------+
| config_id    | int(10) unsigned | NO   | PRI | NULL    | auto_increment |
| config_key   | varchar(255)     | NO   | MUL | NULL    |                |
| config_value | text             | NO   |     | NULL    |                |
+--------------+------------------+------+-----+---------+----------------+
3 rows in set (0.02 sec)

mysql> select * from config where config_key = 'storage/fs/path';
+-----------+-----------------+-----------------------------------------------+
| config_id | config_key      | config_value                                  |
+-----------+-----------------+-----------------------------------------------+
|        26 | storage/fs/path | /opt/csw/apache2/share/deki-hayes/attachments |
+-----------+-----------------+-----------------------------------------------+
1 row in set (0.00 sec)

mysql> update config set config_value = '/opt/csw/apache2/share/dekiwiki/attachments'
where config_key = 'storage/fs/path';
Query OK, 1 row affected (0.00 sec)
Rows matched: 1  Changed: 1  Warnings: 0

mysql> commit;
Query OK, 0 rows affected (0.00 sec)

mysql> exit;
Bye

# chown -R nobody:nogroup /opt/csw/apache2/share/dekiwiki/skins/common/cache/
# rm -rf /opt/csw/apache2/share/dekiwiki/skins/common/cache/cache-*
# ls -la /opt/csw/apache2/share/dekiwiki/skins/common/cache/
total 6
drwxr-xr-x   2 nobody   nogroup      512 Mar 16 15:21 .
drwxr-xr-x  11 nobody   nogroup     1536 Mar 16 15:21 ..

(1) Confirm options of deki-api init script

# /etc/init.d/dekiwiki
Usage: /etc/init.d/dekiwiki {start|stop|force-reload|restart|status}

(2) Show status deki-api daemon

# /etc/init.d/dekiwiki status
dekiwiki is stopped

(3) Start the deki-api daemon

# /etc/init.d/dekiwiki start
Starting MindTouch Deki API: mindtouch.host.exe.

(4) Confirm pid of the daemon

# ps -ef | grep mono | grep -v -- -su
  nobody 16700 16699  0 13:17:29 pts/3    0:05 /opt/csw/bin/mono \
/opt/csw/apache2/share/dekiwiki/bin/mindtouch.host.exe apikey

# /etc/init.d/dekiwiki status
dekiwiki is running: 16700

(5) Show contents of thedeki-api.log
# ls -l /var/log/dekiwiki/deki-api.log
-rw-r--r--   1 nobody   nogroup      121 Mar 29 16:03 /var/log/dekiwiki/deki-api.log

# tail -f /var/log/dekiwiki/deki-api.log
-------------------- initializing
-------------------- initialized 1.635871 secs
-------------------- ready 1.66142 secs
^C (Press [Ctrl]+[C] to terminate)

(6) Talk to the deki-api daemon via the HTTP request
# curl -i http://localhost:8081/deki/@about
HTTP/1.1 200 OK
Server: Dream-HTTPAPI/1.5.1.3404
Content-Type: text/html; charset=utf-8
Date: Sat, 29 Mar 2008 07:09:51 GMT
Content-Length: 50940
Connection: close

<html xmlns="http://www.w3.org/1999/xhtml"><head><title>MindTouch Deki Wiki Service</title>
<meta http-equiv="content-type" content="text/html;charset=utf-8" />
  (snip long HTML code)
</body></html>

# /etc/rc3.d/S50cswapache2 start

# ps -ef | grep httpd
  nobody 11693 11692  0 16:38:30 ?        0:00 /opt/csw/apache2/sbin/httpd -k start
    root 11692     1  1 16:38:30 ?        0:00 /opt/csw/apache2/sbin/httpd -k start
  nobody 11694 11692  0 16:38:30 ?        0:00 /opt/csw/apache2/sbin/httpd -k start
  nobody 11696 11692  0 16:38:30 ?        0:00 /opt/csw/apache2/sbin/httpd -k start
  nobody 11697 11692  0 16:38:30 ?        0:00 /opt/csw/apache2/sbin/httpd -k start
  nobody 11695 11692  0 16:38:30 ?        0:00 /opt/csw/apache2/sbin/httpd -k start

http://<hostname>/index.php

(Appendix) Troubleshooting

If deki-api failed to load try the following:

• if you get "no default auth service" make sure your proxy settings are correct and that your firewall isn't blocking port 8081.
  
  
  
• if your database name has an underscore, you have get an "execute command denied" error.
  If so, create a new database user, grant them the right perms (CRUD), and set them as the database user in LocalSettings.php
  
  
  
• make sure the mono process is running

# ps -ef | grep mindtouch.host | grep -v -- -su

You should see a process like:

  nobody 11806 11805  0 17:22:47 pts/2    0:17 /opt/csw/bin/mono \
/opt/csw/apache2/share/dekiwiki/bin/mindtouch.host.exe apikey

If you don't see the process above, check the dekiapi error logs (/opt/csw/apache2/share/dekiwiki/bin/logs/trace.log) for more details

You can restart the deki-api process by:

/etc/init.d/dekiwiki restart

(Appendix) Known issue of Deki Wiki Itasca running on Solaris

• [Printing]
  PDF conversion does not work.. I have no identifiable cause of this issue yet.
  
  
• [Special:About]
  Incorrect OS name displays on "About" page as below. :-)
  You are using MindTouch Deki Wiki 1.9.0b (rev. ) running on: Linux 5.8, PHP 5.2.4, mySQL 14.12 distribution 5.0.51, and Mono 20080223.
  
  

(Appendix) Default file/directory location changes on Itasca

(Appendix) Basic file layout of Deki Wiki Itasca

/.bash_profile - personal initialization file for bash (shared by root and nobody)
/.wgetrc - personal initialization file for wget
/etc
	/dekiwiki
		mindtouch.deki.startup.xml - deki-api server configuration file
		mindtouch.host.conf - deki-api server configuration file, which called in /etc/init.d/dekiwiki (NOTE: Added on Itasca)
	/init.d
		dekihost - startup for deki-api (NOTE: Obsoleted on Itasca)
		dekiwiki - startup for deki-api (NOTE: New on Itasca)
	/rc3.d
		S40cswmysql5 - startup for MySQL server
		S50cswapache2 -> ../init.d/cswapache2 - startup Apache server
		S92dekihost -> /etc/init.d/dekiwiki - startup for deki-api (NOTE: Changed on Itasca, old link was /etc/init.d/dekihost)
/opt
	/csw
		/apache2
			/etc
				deki-apache.conf - Apache config file for Deki Wiki
				httpd.conf - Apache "main" config file (includes deki-apache.conf)
			/share
				/deki-hayes - DocumentRoot for Deki Wiki "Hayes release"
				/dekiwiki - DocumentRoot for the Deki Wiki "Itasca release" (NOTE: New on Itasca, old name was "deki-hayes")
					/bin
						/cache
							/luceneindex - Lucene index directory
						mindtouch.host.exe - deki-api daemon executable
						mindtouch.host.sh - deki-api startup script (NOTE: Obsolated on Itasca)
						/logs
							info.log
							trace.log
							warning.log
						LocalSettings.php
						AdminSettings.php
				/htdocs - DocumentRoot of Apache2 original (Not used)
			/var
				/log
					access_log - Apache access log file
					error_log - Apache error log file
		/bin
			wget - network utility to retrieve files from the Web
			mono - .NET runtime
			gmcs - C# compiler
		/etc
			pkg-get.conf - pkg-get configuration file
		/mysql
			my.cnf - configuration file for MySQL server
		/php5
			/lib
				php.ini - configuration for PHP5
/var
	/log
		deki-api.log - deki-api log file (NOTE: This is for Hayes)
		/dekiwiki
			deki-api.log - deki-api log file (NOTE: New on Itasca)
/.wapi - Mono shared directory

END OF GUIDE