Hello Huw,
I hope you don't mind I'm cc'ing my answer to the connotea-code-devel
list to get the text out on the web, as some of your questions have just
been brought to my attention by another user as points that need
updating in the docs from a prior version.
Huw Jones wrote:
> 9.Added a Bibliotech webdirectory to /usr/local/apach2/htdocs/.
You'd be better off making this a symlink to site/default that came in
the source code tarball.
> 10.Added the config file provided from the source download
> as /etc/bibliotech.cnf .
Good, but make sure it is .conf not .cnf.
Make sure you change the secrets and setup basic info like your site
name, email, etc. The comments are helpful.
A couple more fixes to the 1.8-beta example config:
- Remove the block that starts "CITATION {" - it is the one citation
block lacking a name before the opening brace.
- Add this CLICKS block somewhere, and edit with a user and password for
the clicks database:
CLICKS {
# options regarding click tracking
# database connection details
DBI_CONNECT = 'dbi:mysql:clicks'
DBI_USERNAME = 'user'
DBI_PASSWORD = 'secret'
}
> (a) It isn't apparent nor clear to me where to insert the lines:
>
> PerlOptions +Parent
> PerlSwitches -I/usr/local/apache2/htdocs/perl/...
> PerlModule Bibliotech::Apache
> PerlModule Bibliotech::AuthCookie
> <Location /bibliotech>
> SetHandler perl-script
> PerlHandler Bibliotech::Apache
> PerlAuthenHandler Bibliotech::AuthCookie::authen_handler
> AuthName Bibliotech
> AuthType basic
> require valid-user
> #ErrorDocument 503 /paused.html
> ErrorDocument 503 /unavailable.html
> </Location>
>
> in my httpd.conf file (apache 2.2.6 has a slightly different httpd.conf
> file compared to apache 2.0.x) and attempts to insert the lines anywhere
> result in being unable to restart the http daemon.
If you have a conf.d directory you can add a file called
connotea-code.conf and put it in there.
If you still have problems, tell me the error message.
> (b) "Everything under the html subdirectory should be placed or linked
> into an Apache-accessible location". If I set up an html subdirectory
> such as /usr/local/apache2/htdocs/Bibliotech/ what am I meant to put in
> there? Am I meant to put the contents of the Bibliotech directory
> supplied in the download in there?
Yes, sorry about this, as I mentioned above, this has changed and the
docs were not updated in time. We now have to manage a couple web site
designs so we needed another layer of depth, so the "html" folder is now
the "site/default" folder in the tarball.
> (c) "Remember to populate the COMPONENT WIKI block of your configuration
> file with the wiki database details" This would be /etc/my.cnf
> or /etc/bibliotech.cnf?
/etc/bibliotech.conf
> (d) The other files/directories provided with the download:
>
> admin_util/
> Bibliotech.pm
> CGI-Wiki-0.63/
> CGI-Wiki-0.63.tar.gz
> deploy/
> doc_util/
> LICENSE
> site/
> t/
> test_util/
>
> these are meant to go where? I can find no installation script or
> makefile so I presume that I need to put some/all of the
> files/directories in the source download in areas where they can be
> accessed by the rest of the modules/software I downloaded and installed?
The PerlSwitches -I line in the Apache configuration block will instruct
Apache's Perl instance as to the path where it can load Bibliotech.pm
and see the Bibliotech folder at the same level.
> (e)If I wish to add a link to the locally installed connotea web
> application which perl module/script do I call to generate the frontpage
> or do I go about doing this some other way?
When properly setup, Apache will call the Perl handler for any URL under
the Connotea-handled namespace. So if you put the namespace at
/bibliotech on your domain then any link that starts with
/bibliotech.... will be handed to Bibliotech::Apache::handler() to take
care of.
This might sum up the steps more succinctly:
Untar the files to /var/www/perl/connotea_code.
In /etc/bibliotech.conf use these lines:
DOCROOT = '/var/www/perl/connotea_code/site/default'
LOCATION = 'http://mydomain.com/bibliotech/'
PREPATH = '/bibliotech'
TEMPLATE_ROOT = ''
BIBUTILS_PATH = '/var/www/perl/connotea_code/bibutils/'
Add this to Apache's configuration:
PerlOptions +Parent
PerlSwitches -I/var/www/perl/connotea_code
PerlModule Bibliotech::Apache
PerlModule Bibliotech::AuthCookie
<Location /bibliotech>
SetHandler perl-script
PerlHandler Bibliotech::Apache
PerlAuthenHandler Bibliotech::AuthCookie::authen_handler
AuthName Bibliotech
AuthType basic
require valid-user
#ErrorDocument 503 /paused.html
ErrorDocument 503 /unavailable.html
</Location>
Now, go in whatever folder is the DocumentRoot for this domain in
Apache, go and make a symbolic link called "bibliotech" that links to
/var/www/perl/connotea_code/site/default.
Remember to restart Apache after all this. (You have to restart Apache
for any changes to Apache or Connotea configurations.)
If you have any errors from this, post a message to connotea-code-devel
and we'll answer there so others can follow later.
https://lists.sourceforge.net/lists/listinfo/connotea-code-devel
Regards,
Martin Flack
-------------------------------------------------------------------------
SF.Net email is sponsored by: The Future of Linux Business White Paper
from Novell. From the desktop to the data center, Linux is going
mainstream. Let it simplify your IT future.
http://altfarm.mediaplex.com/ad/ck/8857-50307-18918-4
_______________________________________________
Connotea-code-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/connotea-code-devel
