update for rename of ikiwikiusers.mdwn to jasatamanjogja.mdwn

[git.ikiwiki.info.git] / doc / tips / DreamHost.mdwn

diff --git a/doc/tips/DreamHost.mdwn b/doc/tips/DreamHost.mdwn
index 5af894d160359285acbd2a538b2ecc527b3cc196..95b46a68d8af78031dd74b0e053747baa6d25c3d 100644 (file)
--- a/doc/tips/DreamHost.mdwn
+++ b/doc/tips/DreamHost.mdwn
@@ -1,3 +1,5 @@
+[[!meta date="2008-05-05 14:14:08 -0400"]]
+

 # Introduction
 I had some trouble installing ikiwiki on to a shared hosting service (DreamHost) and figured I'd post the results, since it was pretty rough to get installed.  These instructions should work for Perl generally (some of the docs are borrowed from Catalyst's docs), but are tailored for Ikiwiki.  There are a few items I'll file as bugs, as well, to aid future installation, but frankly the problems appear to be with installing perl as a non-root user, not anything specific to iki.
 
 # Introduction
 I had some trouble installing ikiwiki on to a shared hosting service (DreamHost) and figured I'd post the results, since it was pretty rough to get installed.  These instructions should work for Perl generally (some of the docs are borrowed from Catalyst's docs), but are tailored for Ikiwiki.  There are a few items I'll file as bugs, as well, to aid future installation, but frankly the problems appear to be with installing perl as a non-root user, not anything specific to iki.
 


@@ -10,7 +12,11 @@ We're going to assume that you're installing CPAN and other Perl modules into ~/
 
 In your .bashrc/.bash_profile/.profile, add:
 
 
 In your .bashrc/.bash_profile/.profile, add:
 

-    export PERL5LIB=~/site/perl/share/perl/5.8:~/site/perl/share/perl/5.8.4:~/site/perl/lib/perl5:~/site/perl/lib/perl/5.8.4
+    export PERL5LIB="$HOME/site/perl/share/perl/5.8:$HOME/site/perl/share/perl/5.8.4:$HOME/site/perl/lib/perl5:$HOME/site/perl/lib/perl/5.8.4"
+
+These locations may be different on your computer. For example, I use:
+
+    export PERL5LIB="$HOME/site/perl/lib/perl5:$HOME/site/perl/lib/perl5/site_perl/5.8.8:$PERL5LIB"

 
 You probably want to add *~/site/perl/bin/* to your path, as well, since Ikiwiki's scripts are put in there.
 
 
 You probably want to add *~/site/perl/bin/* to your path, as well, since Ikiwiki's scripts are put in there.
 


@@ -138,7 +144,7 @@ In ikiwiki.setup, you have to make your source and destination folders have your
     [good]$ ls -la ~
     lrwxrwxrwx  1 root staff 25 2007-08-03 16:44 /home/user -> /home/.server/user
 
     [good]$ ls -la ~
     lrwxrwxrwx  1 root staff 25 2007-08-03 16:44 /home/user -> /home/.server/user
 

-So far, it looks like only the source and destination parameters require this unsymlinked path, but for paranoia reasons, you may want to put them everywhere.  [[news/version_2.14]] explains why this happens.
+So far, it looks like only the source and destination parameters require this unsymlinked path, but for paranoia reasons, you may want to put them everywhere. The changelog for version 2.14 explains why this happens.

 
 Next, add your installed Perl module directory to the *libdir* parameter.  It should look something like :
 
 
 Next, add your installed Perl module directory to the *libdir* parameter.  It should look something like :
 


@@ -146,6 +152,8 @@ Next, add your installed Perl module directory to the *libdir* parameter.  It sh
         libdir => "/home/.server/user/site/perl/lib/perl5/",
 
 # CGI Wrapper
         libdir => "/home/.server/user/site/perl/lib/perl5/",
 
 # CGI Wrapper

+The CGI wrapper file will be created automatically by "ikiwiki --setup path/to/setup", as long as you have inserted a valid filename to be created into the setup file.  On DreamHost, be careful not to put the ikiwiki.cgi file in a directory that has different owner/group than the file itself (such as the main site.domain.tld/ directory): this will cause suexec to fail.
+

 The wrapper mode of "06755" doesn't seem to work.  "755" appears to.  However, this may be completely insecure and/or buggy, so if you know better than I, edit this doc and add it here.
 
 # Pre-created SVN repository
 The wrapper mode of "06755" doesn't seem to work.  "755" appears to.  However, this may be completely insecure and/or buggy, so if you know better than I, edit this doc and add it here.
 
 # Pre-created SVN repository


@@ -170,6 +178,7 @@ Then you'll have to add a few variables to your path [referenced by your compile
 
     export C_INCLUDE_PATH=YOUR_INSTALL_PATH_HERE/include/
     export LIBRARY_PATH=YOUR_INSTALL_PATH_HERE/lib/
 
     export C_INCLUDE_PATH=YOUR_INSTALL_PATH_HERE/include/
     export LIBRARY_PATH=YOUR_INSTALL_PATH_HERE/lib/

+    export LD_LIBRARY_PATH=YOUR_INSTALL_PATH_HERE/lib/

 
 Then you should be able to install the module, and it'll be faster.
 
 
 Then you should be able to install the module, and it'll be faster.