Appendix D. Using CVS with an OpenACS Site

Prev	Part III. For OpenACS Package Developers	Next

OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff.

Add the Service to CVS - OPTIONAL. These steps take an existing OpenACS directory and add it to a CVS repository.

Create and set permissions on a subdirectory in the local cvs repository.

[root root]# mkdir /cvsroot/service0
[root root]# chown service0.service0 /cvsroot/service0
[root root]#
mkdir /cvsroot/service0
chown service0.service0 /cvsroot/service0

Add the repository location to the user environment. On some systems, you may get better results with .bash_profile instead of .bashrc.
```
[root root]# su - service0
[service0 service0]$ emacs .bashrc
```
Put this string into /home/service0/.bashrc:
```
export CVSROOT=/cvsroot
```
```
[service0 service0]$ exit
logout

[root root]#
```

Import all files into cvs. In order to work on files with source control, the files must be checked out from cvs. So we will import, move aside, and then check out all of the files. In the cvs import command, service0 refers to the cvs repository to use; it uses the CVSROOT plus this string, i.e. /cvsroot/service0. "OpenACS" is the vendor tag, and "oacs-5-0-1" is the release tag. These tags will be useful in upgrading and branching. -m sets the version comment.

[root root]# su - service0
[service0 service0]$ cd /var/lib/aolserver/service0
[service0 service0]$ cvs import -m "initial install" service0 OpenACS oacs-5-0-1
N service0/license.txt
N service0/readme.txt
(many lines omitted)
N service0/www/SYSTEM/flush-memoized-statement.tcl

No conflicts created by this import

[service0 service0]$ exit
[root root]#
su - service0
cd /var/lib/aolserver/service0
cvs import -m "initial install" service0 OpenACS oacs-5-0-1
exit

Move the original directory to a temporary location, and check out the cvs repository in its place.

[root root]# mv /var/lib/aolserver/service0 /var/tmp
[root root]# mkdir /var/lib/aolserver/service0
[root root]# chown service0.service0 /var/lib/aolserver/service0
[root root]# su - service0
[service0 service0]$ cd /var/lib/aolserver
[service0 aolserver]$ cvs checkout service0
cvs checkout: Updating service0
U service0/license.txt
(many lines omitted)
U service0/www/SYSTEM/dbtest.tcl
U service0/www/SYSTEM/flush-memoized-statement.tcl
[service0 aolserver]$ exit
logout

[root root]#

mv /var/lib/aolserver/service0 /var/tmp
mkdir /var/lib/aolserver/service0
chown service0.service0 /var/lib/aolserver/service0
su - service0
cd /var/lib/aolserver
cvs checkout service0
exit

If the service starts correctly, come back and remove the temporary copy of the uploaded files.

Prev	Home	Next
System/Application Requirements Template	Up	Appendix E. How to package and release OpenACS