Concise user's Manual for Wincvs and cvsnt

Concise user's Manual for Wincvs and cvsnt

1. Preface:

CVS is a powerful source of version control, and currently has different versions under Linux and Windows, but most of the domestic applications are based on open-source software organizations such as Linux, and the explanations are not systematic, making people feel confused. , the introduction of CVS under Windows is very few.
This article is an introduction to using CVS in a LAN environment for Windows, step-by-step to show you how to configure and use the server side and client for CVS. At the same time, this article only uses the most basic things in CVS, there are many more advanced things, this article is not involved. Here is another connection map of this article, you are welcome to discuss the use of common progress.
Article Connecting http://www.kuihua.net/book/list.asp?id=66
Forum Connection http://www.kuihua.net/bbs/dispbbs.asp?boardid=1&; rootid=670&id=670

2. Installation version:

2.1, server-side (CVSNT)

1. This article uses CVSNT-2.0.4, this is a relatively stable version, do not use the latest CVSNT-2.1.1, I found in the use of more serious bugs.
2. Download Connection http://www.cvsnt.org Currently, it offers 2.0.6 and 2.1.1 versions of the download.
3. The above connection also provides source code, interested friends can also download down to study carefully:).
4. A thoughtful friend, careful observation will find that http://www.cvsnt.org does not provide any client download, it is because CVS.exe can be used both on the server side and can be used for the client, Wincvs is for the client to use the convenient and customized shell. (On this point, I have not received any confirmation, but I am in the process of the use of a kind of experience, welcome to discuss.) ）

2.2. Client (WINCVS)

1. This article uses the WINCVS-1.3B13, this should be a latest version:), I in the use of the process did not find any serious bug.
2. Download Connection http://sourceforge.net/projects/cvsgui/
3. This web site also provides rich CVS documentation and related source code, as well as several OS-related documentation and code; A favorite friend is blessed:).
4. The version of cvsnt used by Wincvs-1.3b13 is CVSNT-2.0.2, and when used in conjunction with the CVSNT-2.0.4 version on the server side, no incompatibilities or conflicts are found.
5. The results shown in my system with the CVS version command are as follows:
Client:concurrent Versions System (CVSNT) 2.0.2 (client/server)
Server:concurrent Versions System (CVSNT) 2.0.4 (client/server)

3, the server side (CVSNT) Installation and configuration:

3.1. Server-side machine and environment configuration:

1. Operating system: Windows Professional SP2 Chinese version
2. Machine Name: Server
3. Machine Address: 192.168.0.6 (internal IP)
4. Network environment: 100 Gigabit switched LAN
5. Hard disk partition format: Both FAT32 and NTFS are available.
6. Prepare a working directory of 2 CVSNT:
F:\KHRoot (the root directory where you store your source code)
F:\KHTemp (directory where CVS error messages are stored)
7. List of users present on the machine: (created by NT or native user)
Administrator (System administrator)
Jackey (normal user)
Goury (normal user)
Riolee (normal user)

3.2, Installation cvsnt:

1. Download CVSNT-2.0.4; Log on to the server machine using administrator.
2. Double-click the self-extracting EXE file, select Full install, the other is installed by default; After installation, you can find 2 more services in the service controller: CVSNT and Cvslocking
3. Send the service Control panel to the desktop to form a shortcut.
4. The Setup program automatically sets the CVS installation path to the system's path environment variable, so the user can execute Cvs.exe anywhere in the console (CMD), which is important for the configuration below!!

3.3. Configure the CVSNT server:

1. Double-click the Service Control panel shortcut, and on the Service Status page, confirm that 2 services are running correctly and stably.
2. Select the Repository page, click the Add button, select the F:\KHRoot this directory is ready, confirm, Ok,yes, then the Cvsroot directory is established under F:\KHRoot, which is the default directory for CVS (default module). If there is an error, the system path path is not set correctly.
3. Select the Advanced page, tick the use Local Users for pserver ..., (why?). I don ' t know! J), in the temporary bar select the Ready F:\KHTemp, confirm, OK.
4. Click the "Apply" button, confirm, exit, OK, done!!

3.4, Summary:

1. At this point, the CVSNT server-side basic configuration is complete, the following WINCVS use and management.
2. Since CVS supports remote management, which is the client-server integration feature, we will add users, permissions control, module maintenance and other management work to the remote (WINCVS) to manage, the server can then ctrl+atl+del into the lock state, All the work below is given to the remote Wincvs for management.

4 installation and configuration of the client (WINCVS) :

4.1 client machine and environment configuration:

1. Operating system: Windows Professional SP2 Chinese version
2. Machine Name: YCW2000
3. Machine Address: 192.168.0.2 (internal IP)
4. Network environment: 100 Gigabit switched LAN, direct access to server
5. Hard disk partition format: Both FAT32 and NTFS are available.

4.2 Installing the Wincvs:

1. Download Wincvs 1.3b13, all according to the default installation.
2. Start Wincvs and start using. Special Note: All of the following operations are done remotely on the YCW2000 (192.168.0.2) machine, at which point the server (192.168.0.6) host has entered a locked state.

5 Administrators use Wincvs for remote administration:

5.1 Configure WINCVS to Administrator status:

1. Prepare the Administrator working directory: (on YCW2000 machine)
E:\CVSClient\Admin (Administrator working directory)
E:\CVSTemp (Wincvs temp directory)
2. The first boot Wincvs will automatically eject the Preferences configuration page, you can also enter through the Admin=>preference menu, the first time you need to configure the following 3 pages:
General Page settings:
Note: As shown in the diagram, it is important to note that the format of the path section is the UNIX path format, which refers to the working root directory of the cvsnt-side settings.
CVS page settings: Note: Home path is to set the password and other files storage location, must be specified, otherwise, when landing, Wincvs also want to pop up the settings box. This home path requires Python.exe This plug-in to be effective. Here you choose the path you have prepared: e\cvstemp
Wincvs page settings:
Note: This page is set up Wincvs's external editing program, usually using UltraEdit is more convenient.
3. Set the administrator's working path: You can click the icon, or View=>browse location=>change ... menu to set, select the path that is already ready: E:\CVSClient\Admin, confirm, OK, this directory will appear in Wincvs's left navigation bar "Workspace".
4. At this point, WINCVS is configured as a remote administrator usage status, below the general administrator needs basic Operation walkthrough. The walkthrough is: Administrator needs to manage Jackey,goury,riolee three users, set up a working directory for each of the 3 users, and everyone can only access their working directory. At the same time, only Administrator is able to assign permissions, others do not have any administrative privileges.

5.2 Administrators for Management walkthroughs:

1. Log in to remote cvsnt:
◇ Select Admin=>login menu, default setting, OK.
◇ Pop-up password input box, confirm, OK. Notice the return result of the output box "output".
2. Checkout default module: (Cvsroot management module)
◇ in the left navigation bar "Workspace", select "Admin" right click, select "Checkout
Modules ... ", enter Cvsroot in" Checkout settings ", OK, OK. Such as:
◇ If successful, a "cvsroot" directory will be added under the "Admin" column. Indicates that you have "
Cvsroot "This management module has been downloaded to local.

3. Introduction to directory Permissions in CVS:

◇ List of directory permissions supported by the system:
R (Read permission)
W (Write permission)
C (Create and delete permissions)
N (without any permissions)
◇ By default, any user has all permissions for any directory.
◇ in any case only the owner of the directory and administrator have the right to change the directory's use rights. The following describes how to modify directory permissions and the owner of the directory.

4. Modify Cvsroot Permissions: Only let administrator have all of the RCW three permissions.

◇ Select the "cvsroot" module that you just downloaded, "ctrl+l" or Admin=>command line ..., and the Command Line Settings dialog box is displayed to execute the CVS command directly.
◇ Remove default permissions for all users: CVS chacl default:n Enter, OK, complete.
◇ Set administrator has all rights: CVS Chacl ADMINISTRATOR:RCW Enter, OK, complete.
◇ Change the owner of "Cvsroot": CVS chown Administrator Enter, OK, complete.
◇ Check the "cvsroot" permission status: CVs Lsacl Enter, OK, in "Output" display:
Owner:administrator
Default:n
Administrator:rwc
◇ "Cvsroot" permission configuration is complete.

5. Write the module files in the code base, which is convenient for multiple users to download.

l need to write the module file format as follows: (implement basic function)
"Description of Module One" "N Spaces or parameters" relative to directory path One (dira) "
"Description of Module two" n spaces or parameters "relative to directory path two (DIRB)"
......
"Description of Module X" "N Spaces or parameters" relative to directory path X (DirX)
◇ "Descriptive information" and "relative path" are literally inconsistent, you need to use the-a parameter.
◇ "relative path" means that CVS will automatically take the root path, here is F:\KHRoot, so the full path to the above example is: F:\KHRoot\DirA
◇ understand the module file structure, now to actually operate a: double-click the "Cvsroot" module under the modules file, with UltraEdit open for editing.
◇ Assign working directory and complete other module description for Jackey,goury,riolee three users.
Cvsroot Cvsroot
Jackey working Directory-a Jackey
Goury working Directory-a Goury
Riolee working Directory-a Riolee
◇ Edit finished, save disk. Back to Wincvs, select modules this file "Ctlr+m" or right-click "Commit selection ...", default setting, "Confirm", OK, complete the upload.

6. Upload a working directory for three users:

◇ on the YCW2000 machine, the E:\CVSClient\Admin respectively established three directories named: Jackey,goury,riolee, as a temporary Exchange directory.
◇ in each newly created directory with UltraEdit or copy a Readme.txt as the primer file!! ：）
◇ then, back to Wincvs, in the "Workspace" column under the "Admin" directory to form the following directory structure:
◇ Select Goury,jackey,riolee, right button, click "Import Module", select "Continue", all other Use default value, "OK", OK, complete the upload work.
◇ carefully observe the "Output" window and confirm that it has been uploaded successfully.
◇ transfer to the system's explore program, delete the Jackey,goury,riolee three directories under the E:\CVSClient\Admin directory. And then go back to Wincvs. (Be sure to delete!!!) ：)
◇ at this point, completed the work directory upload work.

7. "Checkout" Download the working directory of 3 users to the "Admin" directory:

◇ in the "Workspace" column, select "Admin" directory, right click "Checkout Module ...", such as:
◇ Select "..." To get the latest module configuration on cvsnt, pop up the following message box:
◇ This structure diagram is the module file format information that was just written in modules. Select "Jackey working directory" and download to the E:\CVSClient\Admin directory of the YCW2000 machine.
◇ According to the above, download "Goury working directory" and "Riolee working directory" respectively. The following states are formed:

8. set the access rights for each directory for three users. (Only yourself can access your working directory)

◇ Select "Goury" directory, "Ctrl+l" or Admin=>command line ..., the Command Line Settings dialog box, execute the CVS command directly.
◇ Remove default permissions for all users: CVS chacl default:n Enter, OK, complete.
◇ Set Goury has all rights: CVS Chacl GOURY:RCW Enter, OK, complete.
◇ Check the "cvsroot" permission status: CVs Lsacl Enter, OK, in "Output" display:
Owner:administrator
Default:n
Goury:rwc
◇ According to the above method, respectively set the "Jackey" and "Riolee" working Directory access rights.
◇ At this point, we have completed 3 user's directory permission assignment. Note that although administrator does not have the power to "Checkout" the working directory of the 3 users again, it is the owner of those directories and administrator, so only it has the power to change access permissions for those directories.

9. User management principles in the CVSNT system:

The ◇cvsnt user is associated with the NT user on this machine (here is the server machine), that is, the cvsnt is full of existing users on the local computer, so by default you can not set any user name, as long as the use of the existing user name on this computer can be logged in Wincvs.
◇ only with administrator identity login to the CVSNT system, only the right to create and delete new users.
◇ The new user created with CVS must be bound to the NT user on the server side of the machine in order to take effect; Therefore, the new user is actually a surrogate for the NT user who binds it, and is called an alias in the CVS system.
◇ An NT user can have more than one ' alias ' or ' aliases ', acting as multiple CVS users.

10. Use Wincvs to add and delete new users. (Make sure to log in using administrator)

◇ "Ctrl+l" or Admin=>command line ..., Popup command line Settings dialog, execute the CVS commands directly.
◇ Add new User "Killer": CVs passwd-a Killer Enter, set password, OK, finish.
◇ bind "Killer" to "Jackey": CVs passwd-r jackey Killer Enter, set password, OK, complete.
◇ two times the password can be different, but the password entered in the second time is the final password.
◇ Delete User "Killer": CVs passwd-x Killer Enter, OK, complete.
◇ Other special functions view the help of the passwd command.

Once the use is complete, be sure to "Logout", because the Wincvs exit does not automatically log off their remote session; This is done to prevent others from continuing to open Wincvs , you can do all the things you can do without logging in.

6 Special Operations common in Wincvs:

6.1 How to delete a downloaded file or directory:

1. Select one or more files to download and execute the "Remove" command.
2. Select the files again and execute the "Commit" command to complete the delete file operation.
3. In essence, CVS does not delete any files and directories, even if the above operation, delete some files, the remote CVS actually do is to put the files submitted to delete in a directory called "Attic", so the deleted files can be recovered by some means.

6.2 How to recover files or directories that have been deleted:

1.  recover the file after executing the "Remove" command. &NBSP
◇  "Ctrl+l" directly into the command cvs add xxxxx, or perform a "add selection" interface operation.  
◇  This allows you to directly recover deleted files that have not yet been committed.  
2.  recovers files after executing the "Commit" command.  
◇  can only enter the command cvs add xxxxx with "Ctrl+l", and an empty file is obtained.  
◇  Select this empty file and perform an "Update" operation to get the entity of this file.  
◇  Select the file again and perform a "Commit" operation to get the latest version of the file.  
3.  because the CVS system does not delete any directories in nature, so there is no restoration of the directory, but the CVS system by default is to delete the empty directory on the user's native (such as: YCW2000), because   You can use the following method to get the empty directory that has been deleted: cvs checkout -p xxx, or you can set it on the Admin=>preference "Globals" page.  
4.  can be seen, the CVS system can guarantee: As long as the file uploaded to the server, no matter how you do in the remote operation, normal or abnormal operation, are able to use the administrator landing up, through the above method to find lost files. Unless the user goes to the remote server and deletes the file manually, there is no way:)  

6.3 How to get the previous version of the file:

1. Sometimes we need to get a previous version of the file, and the Wincvs default way is to only pass the latest version.
2. Select a file, "Ctrl+g" or right-click, click "Graph Selection ...", use the default settings, you can get the file so the version of the graphical structure of the description.
3. Select a version, right-click, click "Retrieve revision", you can get the corresponding old version of the file. Of course you can also get the latest version of the file:)

6.4 sometimes Wincvs will become unusually slow, how to do?

1. Verify that the CVSNT server side is not installed on the machine on which the WINCVS is installed because they may be using a inconsistent version.
2. Wincvs is installed only, but other versions of Wincvs have been installed before, what should I do?
3. Uninstall all WINCVS systems First and remove any remaining files from the installation directory.
4. Open Registry Editor, find the CVS keyword, find a delete, until you can find it!! ：）
5. Reinstall Wincvs, this problem basically can solve, I just so solve, do not know how you there? ：）

7 Other Instructions:

1. This article focuses on how to let users build Cvsnt+wincvs this system, so focus on the administrator's common operation, as for the general user to use the operation, relatively simple and single, the use of Wincvs more times, will soon be familiar with it.
2. This document is just a glimpse of CVs, there are many advanced usage of CVS, as well as hundreds of commands, there are many new ways to manage the source code, such as: Tag,branch, etc., so warmly welcome everyone to actively explore, continue to share, continuous progress ...
3. In addition, cvs.html this help, the information is also very rich, but many places are not clear enough, need constant speculation and practice to know how, this article is a lot of experience is to see this help, and so on, using this stupid way to get ...
4. Finally, I wish to see this article of the people, get help, improve and other benefits greater than or equal to the wasted time, instead of the disadvantage of regression!!

From:http://www.kuihua.net/wendang/win1.asp

Concise user's Manual for Wincvs and cvsnt