Installation Guide -------------------------
1) Install CVS. You can find it at www.cvshome.org. Confirm that your installed version is 1.10 or more.
1B) First create your CVS command (CVS -D path init) to confirm that this warehouse directory can be read and blind in DAEMON in Apache HTTP. One way to achieve it is to let Apache Server run as a CVS group (such as Group1). Add this server's User ID to this group (for example: Nobody) I want CVS asking you to install RCS You can find it on Gun's mirror site. Note that cvswebread.cgi-script needs access to the warehouse (or its copy), so RSH / SSH or PSERVER access is still not working.
1C) Install Perl. You can install Perl5 or later at www.sunfreeware.com or www.activestate.com. Under Win2000, I am using Perl5.6.0 (Build 618), I am using Perl5.005_03 in Solaris 2.7. Other versions are also possible.
1D) Install RCS. You can find it at www.sunfreeware.com. You need to use it to make the 'ident', 'rlog' and 'rcsdiff'. The version I use is Version 5.7.
1E) Install Apache. You can find it at www.apache.org. Using IBM Version 1.3.6.2 under Solaris I use Apache 1.3.9.
1F) Install GNU's Tar Package. You can find it at www.sunfreeware.com.
1G) If you want to use CVS-Annotate (CVS Note) to ensure the CVS process of cvswebread.cgi (web server, usually run with 'httpd' or 'Nobody') to cvsroot / history (if there is this directory ) And other directories that store controlled files under your warehouse have write permissions. I think the HTTPD-User joins the CVS-Group group (however, due to safety, add 'Nobody' to this group may not be a good note). Make sure the cvs-bin directory is in your PATH environment variable. Note: CVS 1.10 The above version supports the LockDir option, allows you to move the controlled file to another separate directory, select this option CVSWeb does not require any write permissions to the CVS repository. 2) Unpack the CVS-Web into your machine. File can be placed in any directory, for example, you can put it on the / usr / local / cvswebclient / directory on UNIX, you can put it on the c: / cvsWebClient directory on Winnt
Command on UNIX: CD / USR / local gzip -d cvswebclient-v2.0.tar.gz tar xf cvswebclient-v2.0.tar If you use the Gun Tar package, the command is CD / USR / Local Tar -zxvf cvswebclient-v2.0.tar.gz
Under Windows: Using Winzip, you can download at www.winzip.com, or you can use other software that can unwind .tar.gz.
2b) These files are Windows files. That is, one of the reasons why the Files Have CRLF Rather Than Just Cr is is for Windows users, UNIX users easier to change the file type. Under UNIX, the limbs need to be entered: cd cd cvswebclient find. -Type f -exec dos2unix {} {} /; 3a) Configuring HTTP Server configuration files, srm.conf or if you use an updated version of Apache (> = 1.3.9 The most important thing to change files in httpd.conf is that the tag / cvs-web directory is the CGI bin directory and tells the server, and the specific content can be found in the path you decompressed (for example, USR / LOCAL) / cvswebclient). There is a more detailed introduction below.
Additionally: 1) Use the CVS-web directory shadow. The default, .htaccess file provides security and specifying CGI execution permissions. All files that need to run through the web server need .cgi suffix. 2) CVSWebadmin can display the log via CVSWebClient, you want to implement this feature, you need to shoot the temporary directory (in the hostname-cvswebconfig.pl file) to an URL. 3) Use the Scriptlog tab to tell Apache where to output the debug information.
Here is the steps:
Srm.conf (or httpd.conf): #Clominate or add 'addHandler cgi-script .cgi' to allow .cgi execution. AddHandler CGI-script .cgi
# 影射 安装 目. Scriptalias / CVS-web / "/ usr / local / cvswebclient / cvs-web /" # or (win32) scriptalias / cvs-web / "c: / cvswebclient / cvs-web /"
# Set override permissions with .htaccess Files # UNIX:
# Map the log file Directory, Use any url just as long asse it matches # The in YourShortname-cvswebconfig.pl alias / cve / "/ usr / tmp/" # or "c: / temp / "# ScriptLog for debugging. # This is not strictly necessary, and in any case should be switched off # when you are sure that everything works. ScriptLog /usr/local/cvswebclient/cvs-web/tmp/script.out # or ( Win32) Scriptlog C: /cvswebclient/cvs-web/temp/script.out3b) Under Windows you need to let your machine know the host name, specified in the servername in the httpd.conf file.
3C) If you want the speed of the Later Optimise system, there is a thing you need to consider using the access.conf file instead .htaccess file (I have never worried about this)
3D) Erik Osthols made a modification of CvsWebClient as a plugin for his company's certification system, this code ends at the end of the CVSWebread file, but is not used.
4) Copy the etc / template-filename file to etc / yourshorthostname-filename. Under UNIX, your short hostname should be defined as 'basename `Hostname`', such as host: my.yahoo.com, use my-cvswebconfig.pl File name
5A) Modify ETC / YourShostname-cvswebconfig.pl Set $ Administrator $ TEMPDIR $ DISTDIR $ INSTALLURL $ CVSROOT $ cvswebedit_dbg_URL Set a CVS-root (or multiple) of a warehouse (or multiple) you need to browse. If your RCS Utilities does not specify it in the 'Misc' section in the 'Misc' section in the $ PATH environment variable of the CGI execution environment.
Other settings do not have to change. Check your ETC / YourShostName - *. Pl to compile! The following command can pick up etc / yourshosthostname-cvswebconfig.pl and cgi-style.pl perl cvswebconfig.pl
Nb. When you are finished, the variable $ INSTALLDIR must match the Scriptalias tag in the httpd.conf file.
5B) In addition, you may need to build two directory called 'cvswebcreate' and 'cvsweb_upload' under $ Tempdir, so that WebServer User has writes permission: CD CVSWebClient Mkdir Temp Mkdir Temp / CVSWebcreate Mkdir Temp / CvsWeb_UPLOAD CD TEMP CHMOD A RWX *. 5c) Put your username and password in the ETC / htpasswd file in UNIX command: cd apache / bin ./htpasswd -b / usr / local / cvswebclient / cvs-web / etc / htpasswd username password Put the group name in the ETC / HTGroup file, typically, each directory specifies a record. The reason is to put the script in different directories, and the permissions are more prone to allocation. Because there is a directory permission Group; Specify your own script to write .htaccess files Under UNIX you need to use the Apache's password program to generate an encrypted password. Under Windows, the password is saved in the form of / etc / passwd in a clear text.
The default has a 'Test' user password to 'test' has been configured.
Don't forget to delete this account and password when deploying! !
5D) Edit UserDb.txt file. Here is the username that allows CVSWebClient. The format is username: full name. Ideal, this list should be associated with ETC / htpasswd, but until you write this document you still need you to copy this information.
5E) Copy ICons under the CVS-Web / Icons directory, to your $ documentroot and edit the% icons-hashtable in the cvswebconfig.pl file. This product is deployed on the public domain. If you think the default ICons is too big Using the corresponding small icon under ICons-Directory, cvsWebconfig.pl change the% icons-hashtable in the CVSWebconfig.PL. You can follow your way You can use the CVS-web / icons directory HTTP Server is not affected.
5f) If you like you can join some comments, it will appear next to each directory or module name to read from the CVSROOT / Descriptions file.
- Pick up a copy of your cvsroot - Edit CheckoutList and join such a line of Descriptions - Edit Descriptions. Give each directory you need to comment Add to a line You can use the HTML tag in the comment. You can use the HTML tag to tag these lines $ CVSROOT. Related, for example:: Jvote / An Application To Assist with
6) Run the ETC / WRITE_CONFIGS.PL script in the command line it will generate .htaccess files in all directories under CVS-Web
CD cd cvswebclient / cds-web / etc perl write_configs.pl # unix btw: I want to use a .htaccess file on the top of the tree but Apache 1.3.1 Syntax Guide, I need to use the
7) [Under UINX] Confirm that all .cgi files have execution permissions You can run the following command in / cvs-web root directory: Find. -Name /*.cgi -exec chmod a rx {} /;
8) Revision * .cgi is the first line (#! / Usr / local / bin / perl -s) pointing to your local Perl location in Unix I tend to use a symbolic connection from / usr / local / bin / perl Go to the different Perl directories of each UNIX.
If you need to know all the locations that need to be changed, run this command: CD CVS-web Find. -Name /*.cgi -exec grep '#!' / Dev / null {} /; and to edit them: CD CVS- Web vi * / *. cgi
9) Confirm that you have installed all the required Perl modules (see the information under 'External Library USAGE'). You can also use the cvswebclient itself in the CVS-web / lib directory (and subdirectory). Only in deployment Some modules (cgilog.pm and auditlog.pm) can be valid, and the program needs to find in CVS-web / lib
10) Under UNIX, confirm that WebServer runs users (such as Nobody) have a valid login directory (in some files, he is set in / non-existent!). CVS program itself (not CvsWebClient will try to check out a file for this directory party (although the file will be placed in the current working directory) if he is not a valid login directory, it will prompt the error!
11) Under UNIX, The Web Server must have read and write access to the files in the CVS warehouse. This can be resolved (eg CVS) as a warehouse file by establishing a group, and puts the web server user (such as nobody) in / etc. Add this group in this group to the / group file.
12) You can download the entire directory, confirm that you have installed the GNU Compatible Tar file, use to access the Gzip program, this is specified in YourShostname-cvswebconfig.pl.
13) This version should run normally on Win95, but it seems that we rarely use it.
14) Run Apache CD Apache Bin / Apachectl Start
15) View your cvsweb: http://localhost/cvs-web/read/cvswebread.cgi
16) Now return http://sourceforge.net/projects/cvswebclient to view errors, tasks and patches and other information.
17) If you find a solution to solve the problem, send a letter to the project owner to join the development group. Test - please see the test document
I have tested after I installed it, I found a problem, that is, the warehouse files can be seen, only the directory structure. I don't know where it is! ! ! ! If everyone can solve, please tell me! ! Abaw2003@msn.com
