Search: 
 
View
  By section
  As outline
  Fully expanded

FAQ sections
  Getting started
  Effective use
  General questions
  Authoring & Posting
  Forums and FAQs
  Rocket science
  Info for admins
  Mail admin
  Infrastructure
  Calendars
  Intellectual Property

Questions
  Broken pages
  Remote subsites
  Customize HTML
  CVS authoring
  CVS update
  CVS info
  Finding Bad Links
  Download Logging
 
Gigascale Systems Research Center
FAQ
Editing group pages, and other forms of rocket science
Previous section  |  This section  |  Next section
Previous question  |  This question  |  Next question

How do I edit pages in a group with the "CVS Authoring" option?
John Reekie, 4 Aug 1999
Last updated: 20 Dec 2002

First, bear in mind that CVS authoring is generally useful for software projects, in which case we assume that you know the basics of CVS and can use SSH. For further information about CVS, see the GSRC CVS FAQ

  1. If you are a group administrator check that your group has cvs authoring turned on by going to your group pages and then clicking on the Admin link and then Configure Group link and verifying that CVS Module and CVS Checkin are selected.
    If these two choices are not selected, then select them and hit the Change Group Configuration button at the bottom. This will send email to webmaster, who will then set up your cvs repository and send email back to you. While you are waiting, you can proceed with the steps below.
  2. If you don't yet have a CVS account on gigasource.eecs.berkeley.edu, get one. You can request a CVS account.
  3. If ssh and cvs are not yet installed, then install the SSH client and CVS
  4. For Unix, download from ftp://ftp.cs.hut.fi/pub/ssh/
    Build and install. Note that you need not install the server side, you will only be logging out of your machine, not logging into your local machine.
    Download, build and install CVS. To download CVS, see: http://www.cyclic.com/cyclic-pages/howget.html
  5. For Windows, you can download cvs and OpenSSH as part of Cygwin. There are two methods of installing Cygwin: Downloading from the Ptolemy II website or downloading directly from the Cygwin website.
    The advantage of downloading Cygwin from the Ptolemy II website is that the download is somewhat smaller since only essential parts of Cygwin are included - hence this download would be useful if you are dialed in over a slow modem.
    The advantage of downloading from the Cygwin website is that you will get the most recent versions of the software.
    Download from the Ptolemy II Website You can download the version of Cygwin that is included with the most recent Ptolemy II distribution from http://ptolemy.eecs.berkeley.edu/ptolemyII/ptIIlatest/cygwin.htm
    OR
    Download from the Cygwin website Install the Cygwin toolkit from http://sources.redhat.com/cygwin/

    Complete installation instructions can be found at http://sources.redhat.com/cygwin/faq,

    The Cygwin installer tends to change over time, but below is a summary of the steps necessary:

    1. Create an empty directory
    2. Download http://sources.redhat.com/cygwin/setup.exe and save it in the empty directory
    3. Click on setup, then Next
    4. Select Install from Internet, then click on Next
    5. Use the default install root directory, which should be c:/cygwin
    6. Select 'Default Text File Type' of DOS.
      If you select Unix instead of DOS, then you will likely have Cygwin CR/NL problems.
    7. Hit the Next button.
    8. Use the default Local Package Directory, which should be the directory you created above.
    9. If you are not behind a firewall, click on direct connection, then click Next
    10. Select a nearby mirror, then click Next
    11. You will be presented with a list of packages to install.
      A complete installation takes at least 75Mb.

      At the minimum, select the packages below, which is roughly a 3Mb download that expands into an 8.7Mb installation.

      • Base Category
        • ash - For /bin/sh
        • bash
        • cygwin
        • diff - Configure uses cmp
        • fileutils - For ls
        • grep - Used by configure
        • sed - Needed by config.status, which is created by configure
        • sh-utils - For basename
        • textutils - For cat and tr
      • Devel Category
        • cvs
        • make
      • Net Category
        • openssh

      If you are serious about development you may also want:

      • Devel Category: autoconf - requires gawk and m4 from the Interepreters Category
      • Base Category
        • findutils
        • gzip
        • tar
      • Text Category: less
  6. Make sure that CVS_RSH is set to use ssh.
    To check under Windows, start up a Bash shell (Start->Programs->Cygnus Solutions->Cygwin Bash Shell) and type echo $CVS_RSH. If it is not set, then set it using Start->Settings->Control Panel->System->Advanced->Environment Variables CVS_RSH should be added and set to ssh.
    You may want to check that your path has been set to include Cygwin, which is located at c:\cygwin\bin

    To check under Unix, start a shell and type echo $CVS_RSH. If CVS_RSH is not set, then edit your shell startup files to set it automatically. If you run C-shell (csh), or some variant like tcsh, edit ~/.cshrc and add

    setenv CVS_RSH ssh
    
    If you run the Bourne shell (sh) or some variant like bash, edit ~/.profile and add
    CVS_RSH=ssh
    export CVS_RSH
    
  7. Create a file in your home directory called .cvsrc that contains:
    update -P -d
    
    This is necessary so that when you run cvs update, then the -P and -d flags are automatically appended. cvs update -P -d will prune any directories that contain no files and create any new directories that someone else has checked in.
    If you do not create a ~/.cvsrc file, then you will need to run cvs update -P -d instead of cvs update
  8. Once you have received email stating that your cvs account is setup, log on to the cvs server with ssh gigasource:

    ssh gigasource.eecs.berkeley.edu

    If your gigasource login is different from your local login then you should -l <i>username</i>:

    ssh -l username gigascale.eecs.berkeley.edu

    Once successfully logged in change your password with the passwd command to something more reasonable
    ptolemy@maury 67% ssh gigasource
    ptolemy@gigasource's password:
    
    Last login: Fri Aug 27 17:50:34 1999 from maury.eecs.berke^M
    No mail.
    $ passwd
    passwd:  Changing password for ptolemy
    Enter login password:
    
    New password:
    
    Re-enter new password:
    
    passwd (SYSTEM): passwd successfully changed for ptolemy
    $ exit
    Connection to gigasource closed.
    ptolemy@maury 68%
    
    
  9. If your group is called foo, then check out the foo (for example) module from CVS with:
        cvs -d :ext:gigasource.eecs.berkeley.edu:/home/cvs co foo
    
  10. The CVS repository for each workgroup has a web subdirectory that contains the website. There may also be adjacent directories that contain software projects.
    To change the website, cd into the foo/web directory and edit a file
  11. Commit your changes with
    cvs commit -m "message about your change" fileyouedited
    
    You will then be prompted for your password, and the change will be committed.
  12. Go to a page in that workspace. You will see an "CVS Update" link in the toolbar at the bottom of the page. Click on it.
  13. Press on the "Go back" link and make sure that the pages are what you expect.
 
Previous section  |  This section  |  Next section
Previous question  |  This question  |  Next question
You are not logged in
©1998-2008 GSRC