]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blob - doc/setup/discussion.mdwn
(no commit message)
[git.ikiwiki.info.git] / doc / setup / discussion.mdwn
1 Getting 500 error after new install in localhost/~home dir. Have ExecCGI/mod_cgi, setuid exec and owner is apache user, apache is running.
3 Apache log doesn't say anything more than the html reply:
5 "Error message:
6 End of script output before headers: ikiwiki.cgi"
8 ---
11 I have copied over the ikiwiki.setup file from /usr/share/doc/ikiwiki/ to /etc/ikiwiki/ and run it after editing. My site gets built but when I click on the 'edit' button, firefox and google chrome download the cgi file instead of creating a way to edit it. The permissions on my ikiwiki.cgi script look like this: -rwsr-sr-x  1 root root 13359 2009-10-13 19:21 ikiwiki.cgi. Is there something I should do, i.e. change permissions, so I can get it to run correctly? (jeremiah)
13 > Have a look [[here|tips/dot_cgi]]. --[[Jogo]]
15 I just went through the standard procedure described for setup, copied the blog directory from examples into my source directory, ran ikiwiki, and everything seems to have worked, except that none of the 
16 [[!meta ... ]] tags get converted. They simply show up in the html files unformatted, with no exclamation point, and with p tags around them. Any ideas? using ikiwiki version 2.40 on freebsd --mjg
18 > The meta plugin is not enabled by default. It's pulled in by the
19 > goodstuff plugin, so add one or the other to the add_plugins line in your
20 > config file. --[[Joey]]
22 Can the instructions for using `ikiwiki-makerepo` be clarified. This
23 command wants to create folders in the directory it is run in. Which
24 directory should that be - `$SRCDIR?` --Andy
26 > No, `ikiwiki-makerepo` does not create directories in the current
27 > directory. You specify the directory you want it to create and it creates
28 > the directory and makes it into a repository. The setup instuctions have
29 > examples of doing this. I don't see anything unclear. --[[Joey]]
31 Sorry, was not precise enough. It does if you are using the git option. I
32 believe this is partially explained on the rcs/git/ page. However I'm still
33 not totally clear where I should run the command when using git. If I
34 should be in $SRCDIR then updating the instructions to something like
36     REPOSITORY=~/wiki.git
37     cd $SRCDIR
38     ikiwiki-makerepo git $SCDIR $REPOSITORY
40 might clear things up a little. Apologies if I'm being a bit dim, learning
41 ikiwiki and git at same time :) 
43 Have tried 3 options
45 1. mkdir $REP cd $REP run command (says $REP already exists so won't run)
46 2. rm -rf $REP cd $SRC run command (creates a repository in $SRC, does not create $REP ends with "remote origin already exists"
47 3. mkdir $TMP cd $TMP run command (creates a repository in $SRC/.git creates a repository in $TMP, does nothing to $REP, ends with "remote origin already exists".
49 Version of ikiwiki installed is package from Ubuntu/Hardy 2.19
50 Git version is 1.5.2.5
52 n.b. svn version of command worked fine :)
54 --Andy
56 >       Initialized empty shared Git repository in /home/deploy/tmp/
57 >       Initialized empty Git repository in .git/
58 >       fatal: '/home/deploy/tmp/repo': unable to chdir or not a git archive
60 Looks like your git does not support GIT_DIR being used with git-init. I
61 see some mentions of changes in git's changelog for 1.5.3 that look
62 relevant. I've changed ikiwiki-makerepo to use a method more portable to
63 older versions of git. --[[Joey]]
65 Many thanks Joey, upgraded my git, and now have working iki :) -- Andy
67 ----
69 It isn't intended that .ikiwiki be versioned, is it? Do you have a svn:ignore set? 
70 Is there some magic way you can make the svn commands (and presumably commands for 
71 the other VCSs here) ignore the .ikiwiki directory during step 8, when they import it?
72 If not, maybe a note should be made that the user should delete this file before 
73 they import. --Ethan
75 > No, .ikiwiki should not be versioned, and a svn:ignore of it is reasonable,
76 > although probably too much noise for the setup instructions.
77 > I've switched to a different method that preserves .ikiwiki, w/o checking
78 > it in. --[[Joey]]
80 ----
82 These instructions should probably show how to use a bare Git repository
83 (`GIT_DIR=somewhere.git git-init-db`) rather than a repository with a full
84 working copy. You can always clone the repository if you want your own local
85 working copy. Furthermore, this allows you to make multiple commits to your
86 working copy before pushing them to the repository and causing the wiki to
87 update. --[[JoshTriplett]]
89 > I'm currently testing and running such a setup. --[[tschwinge]]
91 Furthermore the git instructions should be changed to move the *.ikiwiki*
92 directory back into the wiki's working copy directory, isn't it? --[[tschwinge]]
94 > Yes, I think so.  I will clean these instructions up unless somebody tells me we're missing something fundamental. --[[BartMassey]]
96 >> Either you do it or I'll do it somewhen soon.  --[[tschwinge]]
98 ----
100 Curious as to why support for CVS is not built in. --[[Luther]]
102 > See [[todo/CVS_backend|todo/CVS_backend]], but you might consider switching to a better version control system. --[[JoshTriplett]]
104 ----
106 What is the syntax for specifying the adminuser as an openid user?  I've tried a couple things but I'm missing something.   Thanks for any pointers.  -- [[AdamShand]]
108 > Just put the openid url in there. It has to be the full url with
109 > "http://". --[[Joey]]
111 ----
113 I apologize if this is the incorrect forum for this question, but I am
114 trying to get ikiwiki set up and running with git.  I followed all the
115 directions and all seems to work until I go back and try to make changes.
116 The steps I am performing:
118     cd $SRCDIR  (e.g. ~/ikisrc)
119     vim index.mdwn (add a couple lines)
120     git commit -a -m 'test'
121     git push
123 I then get a long error message which reads in part "You asked me to pull
124 without telling me which branch you want to merge with, and
125 'branch.master.merge' in your configuration file does not tell me either."
126 From that point on, I get:
128     sws@odin:~/dev/ikisrc$ git push
129     To /home/git/repos/myikiwiki.git
130      ! [rejected]        master -> master (non-fast forward)
131     error: failed to push to '/home/git/repos/myikiwiki.git'
133 If I do a git clone ssh://odin/path/to/$REPOSITORY from another machine and
134 try to edit I get the same error sequence.  What am I doing wrong?
136 > I don't know. The only time I have seen this message is when
137 > the master git repository was not bare. All current instructions and
138 > `ikiwiki-makerepo` have a proper bare repo used for the master
139 > repository, but perhaps you followed some old, broken instructions, or 
140 > forgot to make it bare? --[[Joey]] 
142 -----
144 I follow every steps of the setup procedure, change some templates and
145 tried to modify some page through the web but was not able to do so. Every
146 page seems to be locked by the adminuser user. When I remove the adminuser
147 in the setup file, every ran fine. Did I miss something ? What is exactly
148 the adminuser supposed to be allowed to ? Is he the only user allowed to
149 modify pages ?
151 > This was a bug in ikwiki that was fixed in version 2.44. --[[Joey]]
153 -----
155 pI hope you guys can put up with an absolute newbie. I am fairly new to linux and completely new to Perl. I have just installed MoinMoin locally in my PC, running ubuntu 8.4 and was about to use it until I ran into your ikiwiki. I thought ikiwiki is a better fit for what I want to do, so am seriously considering installing it as well in ubuntu. Except that the install seems way beyond my understanding.
157 Do i need to install git first? Which git -- the git-core? Ubuntu's instructions on installing the git-core is: "sudo apt-get install git-core". Is that it? Do I need to do a git-init as well, or will the ikiwiki-makerepo handle that? If I have to do a git-init as well, what --share values should I specify?
159 It seems I will have to install the ikiwiki from the tar.gz file. I have downloaded it, but do I need to install CPAN or CPAN++ first? That doesn't sound right. I am totally confused already. Does anyone have some install documents pitched to someone as ignorant as I am? -- [[WillDioneda]]
161 > Ubuntu includes ikiwiki (in universe, I assume), so you should just be
162 > able to use apt or synaptic to install the package, as documented on the
163 > [[download]] page. Install git-core also to get git.
164
165 > You do not need to use git-init if you use ikiwiki-makrepo. --[[Joey]]
168 Thanks for your response. You're right. Ubuntu does have ikiwiki, except that it is an older version. I tried installing it; saw some error messages from the install, and decided against it. Plus the documentation here in ikiwiki.info seems slightly different. I made an executive/beginner decision: to go for the latest tarball. And found myself in deep water, ...
170 Anyway, I think I might be able to install it from the tarball I downloaded. I've been reading the discussions, had a look at your screencasts, etc. I will give it another bash. -- [[WillDioneda]]
172 ----
174 How do I set up cgi editing?  In setup I have:
176  * cgiurl => 'http://wiki.had.co.nz/edit.cgi'
177  * cgi_wrapper => 'edit.cgi'
179 But I don't get an edit link on my pages?  What am I doing wrong?
181 > Assuming you don't have the editpage plugin disabled, all you should need
182 > to so is re-run `ikiwiki -setup` with the above config and it should
183 > rebuild your wiki and add the edit links to pages. --[[Joey]]
185 ----
187 I setup ikiwiki on a fedora 10 machine and I am using apache as my http server. Faced a few difficulties while setting it up as the default setup program left some suid files and group writeable directories on the system. It took some time to get it working and documented what I did at http://flyingtux.blogspot.com/2009/03/installing-ikiwiki.html. Thought it might be useful to someone here. (The version installed is 2.72)
189 > ikiwiki makes wrappers suid by default, because this ensures that when
190 > the ikiwiki.cgi is run by your web server, it runs as the user who owns
191 > your wiki, and can thus write to it. ikiwiki is designed to run securely
192 > suid. If your webserver uses some
193 > mechanism to run the ikiwiki.cgi as the user who owns it, without the
194 > suid bit being set, you *could* modify `cgi_wrappermode` in your setup
195 > file to drop the suid bit. 
196
197 > ikiwiki respects the umask, so if your umask is one that causes things to
198 > be group writable, they will by. If you want to override that, there is
199 > also a `umask ` setting in your setup file. --[[Joey]] 
201 ----
203 /etc/ikiwiki/auto.setup tries to get abs_path of a non-existent
204 "repository" path (in ikiwiki-makerepo), and that doesn't work in my perl:
206 <pre>
207 [mort@localhost ~]$ perl -e 'use Cwd q{abs_path}; print abs_path("/var")'
208 /var[mort@localhost ~]$ perl -e 'use Cwd q{abs_path}; print abs_path("/abcde")'
209 [mort@localhost ~]$ 
210 </pre>
212 Because of this, /etc/ikiwiki/auto.setup fails: 
214 <pre>
215 $ ikiwiki -setup /etc/ikiwiki/auto.setup
216 What will the wiki be named? wiki
217 What revision control system to use? git
218 What wiki user (or openid) will be admin? mort
221 Setting up wiki ...
222 internal error finding repository abs_path
223 /etc/ikiwiki/auto.setup: failed to set up the repository with ikiwiki-makerepo
225 usage: ikiwiki [options] source dest
226        ikiwiki --setup configfile
227 $ perl -v
229 This is perl, v5.8.8 built for i386-linux-thread-multi
230 (with 2 registered patches, see perl -V for more detail)
232 Copyright 1987-2007, Larry Wall
234 Perl may be copied only under the terms of either the Artistic License or the
235 GNU General Public License, which may be found in the Perl 5 source kit.
237 Complete documentation for Perl, including FAQ lists, should be found on
238 this system using "man perl" or "perldoc perl".  If you have access to the
239 Internet, point your browser at http://www.perl.org/, the Perl Home Page.
241
242 </pre>
244 Can't ikiwiki's "make test" perhaps test for this, so that one knows something will go wrong?
245 -- Ivan Z.
247 > FWIW, I tried the same thing with perl 5.8.8 from Debian etch, and its
248 > Cwd does not have the problem. But I've modified `ikiwiki-makerepo` to
249 > avoid using `abs_path` this way anyhow. --[[Joey]] 
251 Thank you! I'm not a Perl programmer, so what's your opinion: is this behavior a violation of the specification of abs_path and I should report it to [ALTLinux](http://bugs.altlinux.org) (the distro)? --Ivan Z.
253 > That is not entirely clear to me from the documentation. It doesn't
254 > say the path has to exist, but doesn't say it cannot either. --[[Joey]]
256 I am experiencing the same problem "/etc/ikiwiki/custom: failed to set up the repository with ikiwiki-makerepo
257 " on Debian squeeze with perl5.10.0. Upgrading to ikiwiki 3.10 fixes it. -- [Albert](http://www.docunext.com/)
259 ----
261 Just a note, perl 5.10 isn't packaged as part of RHEL or thus CentOS nor EPEL,
262 so it's not especially trivial to satisfy that requirement for ikiwiki on
263 those platforms, without backporting it from Fedora or building from source.
264 However, I have an ikiwiki 3.20100403 running on RHEL-4 supplied 5.8.8 without
265 (seemingly too much) complaint.  How strong is the 5.10 requirement? what
266 precicely breaks without it? -- [[Jon]]
268 > I don't remember what was the specific problem with perl 5.8.8. All I can
269 > find is some taint checking bugs, which are currently worked around by
270 > taint checking being disabled. --[[Joey]]
272 ---
274 Did anyone tried to install ikiwiki under a vhost setup ? 
275 ikiwiki is installed under a debian lenny system. but without write acces to /etc/ikiwiki (obvious) i am coming not far.
276 Or do i miss something which is probably hidden deeper in the documentation ?
278 Well it should be similar to shared hosting [or a remote server in general](http://ikiwiki.info/forum/how_to_setup_ikiwiki_on_a_remote_host/)
280 ----
281 Perhaps it's worth noting that when installing ikiwiki with apt on Debian stable, you need to use the backports version in order to follow the setup instructions.
283 ---
284 The mentioned docker image does not seem to be supported anymore. For those interested I've setup another docker image here on [[github|https://github.com/dgsb/docker-ikiwiki]] and here on [[docker hub|https://hub.docker.com/r/dgsb/ikiwiki/]]. It has the advantage of not being sandboxed and using a local repository through a volume to setup the content of the wiki. A ssh server is also started in order to push/pull to/from the container -- David