This reverts commit 21f0f5c22fb97d283db183e2970cc8f05fbfb475

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

diff --git a/doc/tips/DreamHost.mdwn b/doc/tips/DreamHost.mdwn
index 5af894d160359285acbd2a538b2ecc527b3cc196..86eb28cd5a2ebe888ac2d748376926b53a9c9f93 100644 (file)
--- a/doc/tips/DreamHost.mdwn
+++ b/doc/tips/DreamHost.mdwn
@@ -1,6 +1,6 @@
 # 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.

-
+[Baby Pink](http://www.grosir-kosmetik.com/6-baby-pink-cream-pemutih-kulit) | [Rumah Dijual](http://www.propertykita.com/rumah.html) | [Jasa SEO](http://www.optimaweb.co.id/jasa-seo) | [Aksesoris Mobil](http://www.detikauto.com)

 **Note: CPAN seems to die without warning, or die after successfully install modules.  It appears to just like dying.  If you encounter this, retry the last command after restarting CPAN.** Unfortunately, this doc can't cover how to fix any other problems with CPAN beyond what you find here.
 
 # Fixing CPAN
 **Note: CPAN seems to die without warning, or die after successfully install modules.  It appears to just like dying.  If you encounter this, retry the last command after restarting CPAN.** Unfortunately, this doc can't cover how to fix any other problems with CPAN beyond what you find here.
 
 # Fixing CPAN


@@ -10,7 +10,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 +142,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 +150,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 +176,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.