#----------------------------------------------------------------------------------------------------
#
#	Howto Install and using CVS
#	written by Henry Saptono
#	henry@nurulfikri.com or henry@openware.or.id
#	March 2003 Margonda-Depok
#
#----------------------------------------------------------------------------------------------------

CVS is  Concurrent Versions System.



INSTALL CVS
-----------

	1. Ekstrak Source cvs (sebaiknya di direktori "/usr/local/src")
		
		#cd /usr/local/src
		#tar -xjvf /path/to/cvs-1.11.5.tar.bz2
		
	2. Pindah ke direktori hasil Ekstraksi
	
		#cd cvs-1.11.5
	
	3. Sebaiknya baca dulu File README dan INSTALL (mungkin ada info yg anda perlukan di file tsb)

	4. Lakukan konfigurasi dan kompilasi

		#./configure --prefix=/opt/cvs
		
		# make

		catatan:

			Direktori /opt/cvs harus exist..!

	5. Lakukan proses Instalasi

		#make install


CONFIGURE CVS Server
--------------------


	1. Buat User "cvs" sebagai user system linux 

		#adduser cvs
		
		atau jika ingin mendefinisikan option lainnya pada perintah pembuatan user bisa sbb:

		#adduser -d /var/cvs cvs

	2. Buat File "cvspserver" di dalam direktori "/etc/xinetd.d"

	   sbb:
		service cvspserver
  		{
    			socket_type  = stream
    			protocol     = tcp
    			wait         = no
    			user         = root
    			server       = /opt/cvs/bin/cvs
    			server_args  = --allow-root=/opt/cvsroot -f pserver
    			log_type    = FILE /var/cvs/cvs.log
    			disable     = no
  		}

		
		catatan:

			Direktori "/opt/cvsroot" dan "/var/cvs/cvs.log" harus exist..!

	3. Restart service "xinetd"

		#service xinetd restart
		
		or

		#/etc/init.d/xinetd restart

	4. Berikan password utk user "cvs"
		
		#passwd cvs
		

	5. Login ke account user cvs

		$ su - cvs

	6. Lakukan proses Inisialisasi cvs "repository"

		$ /opt/cvs/bin/cvs -d /opt/cvsroot  init


			catatan:

				-Sebaiknya direktori "/opt/cvs/bin" di masukkan dalam PATH variabel.
				-Direktori /opt/cvsroot adalah direktori yang exist dan akan
				 menjadi direktori "repository" (direktori project kita !!)
				 direktori ini dibuat terlebih dahulu dan perlu dirubah 
				 kepemilikan groupnya dgn group "cvs"  sbb:
				
					#mkdir /opt/cvsroot
					#chgrp cvs /opt/cvsroot
					#chmod 2775 /opt/cvsroot


	7. Buat File Password utk login ke cvs server dgn script perl dibawah ini (copy dan paste saja lalu
	   simpan sebagai file "crypt.pl"):


		--------------------------------------------------------------------------------

		#!/usr/bin/perl

		srand( time() );

		my $randLetter = "(int(rand( 26 )) + (int(rand( 1 ) + 0.5) % 2 ? 65 : 97))";

		my $salt = sprintf( "%c%c", eval $randLetter, eval $randLetter );

		my $plainText = shift;

		my $cryptText = crypt( $plainText, $salt );
		printf "${cryptText}\n";

		--------------------------------------------------------------------------------

		Setelah membuat File script perl diatas lakukan langkah dibawah ini:

		#chmod 755 crypt.pl
		#mv crypt.pl /usr/bin


	    Lalu mulai generate password yang terenkripsi 

		#cd /opt/cvsroot/CVSROOT
		#crypt.pl "xxxxxxxx" > passwd
  
	   Jangan lupa mengedit lagi file "password" tadi sbb:

		#vi passwd

			odeAzM.xccfR2

		Edit file tsb menjadi sbb:

			henry:odeAzM.xccfR2:cvs

		
			catatn:

				"henry" adalah user cvs yg berhak mengakses.
				"cvs"	adalah user sistem linux
				"odeAzM.xccfR2" adalah password yg terenkripsi


TESTING CVS
-----------


	Cobalah anda test sekarang cvs server dari client  dengan perintah sbb:

	$cvs -d :pserver:henry@yourserver.com:/opt/cvsroot login


	Jika tidak ada pesan error  maka sukses !


USING CVS
---------

1. Mengimport project :

	Login dahulu ke server cvs untuk pertamakali!!

	$cvs -d :pserver:henry@192.168.1.191:/opt/cvsroot login
	
	atau 

	$cvs -d :pserver:henry@192.168.1.191:2401/opt/cvsroot login


	Setelah perintah diatas maka pada current direktori akan terdapat file ".cvspass" yg
	berisi sbb:

	1 :pserver:henry@192.168.1.191:2401/opt/cvsroot Ah<Z:yRR

        
	Misalkan anda baru menggunakan cvs dan akan membuat direktori project baru
	di repository cvs maka lakukan sbb:

	Pindahlah ke direktori project, lalu lakukan "import" sbb:


	$export CVSROOT=:pserver:henry@192.168.1.191:/opt/cvsroot
	
	

	$cvs import testcvs henry start


	catatan:

		sebaiknya perintah export tersebut di tarus dalam file ".bashrc"
		agar tidak perlu melakukan perintah export tiap kali kita ingin
		mengakses cvs server.


2. Mendownload project :

	Jika sudah pernah login ke cvs server dan Env Variabel CVSROOT sudah diset(export)
	langsung saja lakukan sbb:

 	$cvs co testcvs	

	atau

	$cvs checkout testcvs

	setelah perintah diatas maka pada current direktori akan ada direktori "testcvs"  hasil download dari cvs server


3. Menambah file baru ke direktori project di repository:

	Masuk ke direktori hasil download :

	$cd testcvs

	buat File baru misal bernama "test.lagi"
	Lalu tambahkan ke repository sbb:

	$cvs add test.lagi testcvs

	Agar hasil penambahan file baru ke repository disimpan permanent lakukan "commit" sbb:

	$cvs commit


4. Menghapus Sebuah File yg ada pada direktori project di repository:

	Pindahlah ke direktori project pada komputer client, misal nama direktorinya "testcvs" sbb:
	
	$cd testcvs
	$ls testcvs
	CVS  tes.html test.ahh  tes.txty

	lalu cobalah hapus suatu file yang ingin anda hapus yang ada pada direktori project 
	di komputer client!

	$rm tes.html

	Lalu agar hasil penghapusan juga menghapus file yang sama di direktoti project pada server cvs
	lakukan perintah sbb:

	$cvs remove tes.html

	Lalu agar dihapus secara permanent file "tes.html" tsb di cvs server !! lakukan sbb:

	$cvs commit