ptexternal

Below is a example of how one can check out the tree using the subversion in read only

CVS fixme

For further information, see How does anonymous password authentication work? CVS fixme

Read/write named ssh access accounts

If you have been invited to have read/write access to the ptII tree, then follow the procedure below:

1. Get a ssh account on source.eecs.berkeley.edu To do this:
   If necessary, get a Chess Website account: by going to http://chess.eecs.berkeley.edu/login/?subpage=Request and click on the Member radio button in the ptexternal section.
   Once your account has been enabled, request a "CVS" account by going to https://chess.eecs.berkeley.edu/options/request/cvsacct Note that the website says "CVS account", but this account is really a ssh account that can also be used for Subversion.
   If you would like to get email about version control changes, they should go to Options -> Membership and request a Developer account for ptexternal.
2. Install SSH
   You will be using ssh to connect to our machines, so you will need to install SSH 2.
   Even if you are using Eclipse, you may need to have ssh set up so that you can connect to source.eecs.berkeley.edu and change your password
   Pick one of the methods below.
   If you are going to be using Eclipse, and if you have a UCB EECS department laptop, then a SSH client is probably installed on your laptop. If you do not have a client, and if you are going to be using Eclipse, and you work for an educational institution, you could try installing ssh from http://www.ssh.com.
   If, you will be building using the configure/make method under Windows, install the most recent version of Subversion, Cygwin and SSH from the Ptolemy project, see http://ptolemy.eecs.berkeley.edu/ptolemyII/ptIIlatest/cygwin.htm
   If you already have Cygwin installed, Subversion for Windows and OpenSSH is available as part of Cygwin,
   Note that any recent version of Subversion and Cygwin should work fine.
   Or go to the Subversion web site and download subversion
   For Unix: http://www.openssh.org/portable.html
   To test ssh, try

   ssh source.eecs.berkeley.edu
   

   You should see something like:

   cxh@maury 57% ssh source.eecs.berkeley.edu
   cxh@source.eecs.berkeley.edu's password:
   
   Last login: Fri Mar 24 09:15:45 2000 from maury.eecs.berke^M^M
   No mail.
   $
   
   

   Then use the passwd command to change your password.

   If your login on our machines is different than the login on the account you are connecting on, then use:

   ssh -l remotelogin source.eecs.berkeley.edu
   

   For further information about account names, see: Why is my CVS account name different from my website account name?
3. Exit the ssh section and return to the local machine
4. See also: How do I use CVS without typing my password each time?
5. At this point, you can either follow the Ptolemy II Eclipse Instructions and set up svn to use a svn+ssh connection or you can proceed with the next steps that use Cygwin.
6. If you plan on building using Cygwin, be sure that svn is installed locally.
   If you installed Cygwin, then chances are that you already have SSH installed.
   If the svn command is not present, then
   Pick one of the methods below
   Under Windows, install the most recent version of svn and Cygwin from the Ptolemy project, see http://ptolemy.eecs.berkeley.edu/ptolemyII/ptIIlatest/cygwin.htm
   Note that any recent version of Subversion and Cygwin should work fine.
   Under Windows, Install TortoiseSVN
   Or go to the Subversion web site and download subversion
   For more information about svn, see the ptexternal Subversion Wiki

   You must use ssh to connect to source.eecs.berkeley.edu.

7. Locally, most users place the Ptolemy II tree in ~/ptII so that other local users can easily find it.
   Check out the tree by running the following command on their local machine:

   cd ~
   svn co svn+ssh://source.eecs.berkeley.edu/chess/ptII/trunk ptII
   

   (svn uses ssh to connect from the local machine to source)
8. The source code is now checked out, now follow the Install Java instructions below

Install Java

The quick Java installation instructions:

1. Install JDK 1.6 from http://java.sun.com/javase/downloads/index.jsp
   Sun calls JDK 1.6 by various names: JDK 6 or Java SE 6.
   The installation should end up in a directory like c:/Program Files/Java/jdk1.6.0

Build instructions

You have now checked out the source code! But it still needs to be compiled. First you will need to set some environment variables. These may be set locally in the shell, or globally via a Windows dialog box.

To set the environment variables in a C shell, first cd to the directory (such as your home directory) where your ptII directory lives. Then use the following commands:

setenv HOME `pwd`
setenv PTII `pwd`/ptII

export HOME=c:/directoryOfYourChoice
export PTII=c:/directoryOfYourChoice/ptII

Cygwin directory mapping Note that Cygwin remaps directories, so d:\tmp may appear as /cygdrive/d/tmp. Unfortunately, the java command does not understand the Cygwin /cygdrive notation, so java may not find the files it needs. For example, pwd returns /cygrive/d/tmp/ptII, which will not work with java: cxh@MOWAT-171 /cygdrive/d/tmp/ptII $ PTII=d:\\tmp\\ptII cxh@MOWAT-171 /cygdrive/d/tmp/ptII $ echo $PTII d:\tmp\ptII cxh@MOWAT-171 /cygdrive/d/tmp/ptII $ cd $PTII cxh@MOWAT-171 /cygdrive/d/tmp/ptII $ pwd /cygdrive/d/tmp/ptII So, under Cygwin, it is best to avoid using pwd when setting variables. Avoid: PTII=`pwd`/ptII and use PTII=d:\\tmp\\ptII instead. Note that the configure script checks for this sort of thing.

To set environment variables in Windows, do Start -> Settings -> Control Panel -> System. Click the Advanced tab and then the Environment Variables button. Set up the following under the heading User variables for yourlogin

Variable    Value
HOME        c:\directoryofyourchoice
PTII        c:\directoryofyourchoice\ptII

Under System Variables, augment your Path variable. Edit it, and add c:\directoryofyourchoice\ptII\bin; in front of the existing text in the Variable Value window. You may also wish to add something like c:\Program Files\Java\jdk1.6.0\bin; to point to the java installation you want Ptolemy II to use. Otherwise, the one in your WINNT/System32 directory may be used.

If you have used the Windows dialog to set the environment variables, you will need to open a new shell in order to have them take effect. On the other hand, if you have set them from within the shell, do not open a new one. New shells will not have the variables set.

You are now ready to compile Ptolemy II! First you configure. To use the default java instalation on your system, simply type the following command:

./configure

./configure --with-java=c:/Program\ Files/Java/jdk1.6.0

Which ever form you use, it grinds briefly. Some warnings or errors are normal. Mostly they indicate optional adjuncts to Ptolemy II which were not installed.

The next step is to run make:

make fast all

You're done!! You can type now vergil (or $PTII/bin/vergil if you did not set your path) in the C shell or cygwin Bash window and it should start up!

Note that if your $PTII path includes spaces, then try

"$PTII/bin/vergil"

Subversion Hints

To update your tree and get any updates, do:

cd $PTII
svn update
make fast all

To check out a copy of the tree for a particular date, see the Subversion docs, which say

$ svn checkout -r {2006-02-17}
$ svn checkout -r {15:30}
$ svn checkout -r {15:30:00.200000}
$ svn checkout -r {"2006-02-17 15:30"}
$ svn checkout -r {"2006-02-17 15:30 +0230"}
$ svn checkout -r {2006-02-17T15:30}
$ svn checkout -r {2006-02-17T15:30Z}
$ svn checkout -r {2006-02-17T15:30-04:00}
$ svn checkout -r {20060217T1530}
$ svn checkout -r {20060217T1530Z}
$ svn checkout -r {20060217T1530-0500}

Updating This Page

This page is under CVS not svn (the ptII repository is under svn).

For more information, see How do I edit pages in a group with the "CVS Authoring" option?

• The command to check out this website is:

     cvs -d :ext:source.eecs.berkeley.edu:/home/cvs_chess co ptexternal
     enter your password
  

  Note that the ptexternal repository is in /home/cvs_chess, not /home/cvs.
  The cvs command will create a directory "ptexternal" with a subdirectory "web" with at least one file, "index.html". After this directory is created, you never need to do this again.
• Next time you want edit files on the website, just go to this ptexternal directory and type: cvs update enter your password It will update your local copies of the files
• You can edit the index.html file.
• You can add a new file by putting it in the same directory and doing:

     cvs add filename.html  (if it's a text file)
     cvs add -kb filename.doc (for example, if it's a binary file)
  

  It's critical to remember the -kb for binary files (Word, PDF, etc.), or else CVS corrupts the file.
• To commit your changes do

     cvs commit -m "explanation of changes"
     enter your password
  

• Once you have committed the changes, you can make them visible on the website by going to the website and clicking on "CVS update" at the bottom of any page.

For more information, see How do I edit pages in a group with the "CVS Authoring" option?

The general CVS faq is at http://www.gigascale.org/softdevel/faq/1/

Version: $Id: index.html,v 1.69 2009/01/22 23:38:56 cxh Exp $