first draft of updated INSTALL instructions -- comments/spelling fixed
probably needed git-svn-id: http://viewvc.tigris.org/svn/viewvc/trunk@114 8cb11bc2-c004-0410-86c3-e597b4017df7remotes/tags/V0_5
parent
ee6c5f5da3
commit
a19338dd0a
98
INSTALL
98
INSTALL
|
@ -13,16 +13,18 @@ INSTALLING VIEWCVS
|
||||||
access to the repository (or a copy of it). Therefore, rsh/ssh or
|
access to the repository (or a copy of it). Therefore, rsh/ssh or
|
||||||
pserver access doesn't work yet.
|
pserver access doesn't work yet.
|
||||||
|
|
||||||
2) Copy viewcvs.cgi to the cgi-script location of your web server.
|
For the checkin database to work, you will need MySQL >= 3.22,
|
||||||
|
and the Python DBI 2.0 module, MySQLdb. This was tested with
|
||||||
|
MySQLdb 1.12.
|
||||||
|
|
||||||
If Python is not located in /usr/local/bin, then you'll need to
|
2) Installation is handled by the ./viewcvs-install script. Run this
|
||||||
edit the first line of viewcvs.cgi.
|
script and you will be prompted for a installation root path.
|
||||||
|
The default is /usr/local/viewcvs. The installer sets the install
|
||||||
|
path in some of the files, and ViewCVS cannot be moved to a
|
||||||
|
different path after the install.
|
||||||
|
|
||||||
3) Copy viewcvs.conf.dist to the same directory and RENAME it to
|
3) Edit <install-root>viewcvs.conf for your specific configuration.
|
||||||
viewcvs.conf
|
In particular, examine the following configuration options:
|
||||||
|
|
||||||
4) Edit viewcvs.conf for your specific configuration. In particular,
|
|
||||||
examine the following configuration options:
|
|
||||||
|
|
||||||
cvs_roots
|
cvs_roots
|
||||||
default_root
|
default_root
|
||||||
|
@ -32,12 +34,90 @@ INSTALLING VIEWCVS
|
||||||
There are some other options that are usually nice to change. See
|
There are some other options that are usually nice to change. See
|
||||||
viewcvs.conf for more information.
|
viewcvs.conf for more information.
|
||||||
|
|
||||||
5) That's it. Try it out.
|
4) The CGI programs are in <install-root>/cgi. You can symlink to this
|
||||||
|
directory from somewhere in your published HTTP server path if your
|
||||||
|
webserver is configured to follow symbolic links. You can also copy
|
||||||
|
the installed <install-root>/cgi/*.cgi scripts after the install.
|
||||||
|
|
||||||
|
5) That's it for repository browsing. Instructions for getting the
|
||||||
|
SQL checkin database working are below.
|
||||||
|
|
||||||
Warning: ViewCVS has not been tested on web servers operating on the
|
Warning: ViewCVS has not been tested on web servers operating on the
|
||||||
Win32 platform.
|
Win32 platform.
|
||||||
|
|
||||||
|
|
||||||
|
SQL Checkin Database
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
This feature is a clone of the Mozilla Project's Bonsai database. It
|
||||||
|
catalogs every commit in the CVS repository into a SQL database. In fact,
|
||||||
|
the databases are 100% compatible.
|
||||||
|
|
||||||
|
Various queries can be preformed on the database. After installing ViewCVS,
|
||||||
|
there are some additional steps required to get the database working.
|
||||||
|
|
||||||
|
1) You need MySQL >= 3.22, and the Python module MySQLdb >= 1.12 installed.
|
||||||
|
|
||||||
|
2) You need to create a MySQL user who has permission to create databases.
|
||||||
|
Optionally, you can create a second user with read-only access to the
|
||||||
|
database.
|
||||||
|
|
||||||
|
3) Run the <install-root>/make-database script. It will prompt you for
|
||||||
|
your MySQL user, password, and the name of database you want to
|
||||||
|
create. The database name defaults to "ViewCVS". This script creates
|
||||||
|
the database and sets up the empty tables. If you run this on a
|
||||||
|
existing ViewCVS database, you will loose all your data!
|
||||||
|
|
||||||
|
4) Edit your <install-root>/viewcvs.conf file. There is a [cvsdb]
|
||||||
|
section. You will need to set:
|
||||||
|
|
||||||
|
|
||||||
|
host = # MySQL database server host
|
||||||
|
database_name = # the name of the database you created with
|
||||||
|
# make-database
|
||||||
|
user = # the read/write database user
|
||||||
|
passwd = # password for read/write database user
|
||||||
|
readonly_user = # the readonly database user -- it's pretty
|
||||||
|
# use safe to use the read/write user here
|
||||||
|
readonly_passwd = # password for the readonly user
|
||||||
|
|
||||||
|
5) Two programs are provided for updating the checkin database,
|
||||||
|
cvsdbadmin and loginfo-handler. They serve two different purposes.
|
||||||
|
The cvsdbadmin program walks through your CVS repository and adds
|
||||||
|
every commit in every file. This is commonly used for initalizing
|
||||||
|
the database from a repository which has been in use. The
|
||||||
|
loginfo-handler script is executed by the CVS server's CVSROOT/loginfo
|
||||||
|
system upon each commit. It makes real-time updates to the checkin
|
||||||
|
database as commits are made to the repository.
|
||||||
|
|
||||||
|
To build a database of all the commits in the CVS repository /home/cvs,
|
||||||
|
invoke: "./cvsdbadmin rebuild /home/cvs". If you want to update
|
||||||
|
the checkin database, invoke: "./cvsdbadmin update /home/cvs". The
|
||||||
|
update mode checks to see if a commit is already in the database,
|
||||||
|
and only adds it if it is abscent.
|
||||||
|
|
||||||
|
To get real-time updates, you'll want to checkout the CVSROOT module
|
||||||
|
from your CVS repository and edit CVSROOT/loginfo. Add the line:
|
||||||
|
|
||||||
|
ALL (echo %{sVv}; cat) | <install-root>/loginfo-handler
|
||||||
|
|
||||||
|
If you have other scripts invoked by CVSROOT/loginfo, you will want
|
||||||
|
to make sure to change any running under the "DEFAULT" keyword to
|
||||||
|
"ALL" like the loginfo handler, and probably carefully read the
|
||||||
|
execution rules for CVSROOT/loginfo from the CVS manual.
|
||||||
|
|
||||||
|
6) You may want to modify the HTML template files:
|
||||||
|
|
||||||
|
<install-root>/html-templates/queryformtemplate.html
|
||||||
|
<install-root>/html-templates/querytemplate.html
|
||||||
|
|
||||||
|
They're used by the queryform.cgi and query.cgi scripts generate
|
||||||
|
HTML output. At some point, viewcvs.cgi, query.cgi, and queryform.cgi
|
||||||
|
will use the same mechanism for HTML generation, but not yet.
|
||||||
|
|
||||||
|
7) You should be ready to go. Load up the query.cgi script and give it a
|
||||||
|
try.
|
||||||
|
|
||||||
|
|
||||||
IF YOU HAVE PROBLEMS ...
|
IF YOU HAVE PROBLEMS ...
|
||||||
------------------------
|
------------------------
|
||||||
|
|
Loading…
Reference in New Issue