Contents

ptexternal

How to get Ptolemy II source code

For the impatient

svn co https://source.eecs.berkeley.edu/svn/chess/ptII/trunk ptII

Or, see the Ant instructions.

Summary of ways to get ptII

svn co https://source.eecs.berkeley.edu/svn/chess/ptII/trunk ptII

svn co svn://source.eecs.berkeley.edu/chess/ptII/trunk ptII
   

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

SVN Read Only Access: Summary

Note: You do not need access to the ptexternal workgroup to get read-only access to the ptII tree.

See also the Nightly Build Page, which includes nightly snapshot tar files.

   svn co svn://source.eecs.berkeley.edu/chess/ptII/trunk ptII
   

   svn co https://source.eecs.berkeley.edu/svn/chess/ptII/trunk ptII
   

cxh@carson 44% svn co https://source.eecs.berkeley.edu/svn/chess/ptII/trunk ptII
Error validating server certificate for 'https://source.eecs.berkeley.edu:443':
 - The certificate is not issued by a trusted authority. Use the
   fingerprint to validate the certificate manually!
Certificate information:
 - Hostname: source.eecs.berkeley.edu
 - Valid: from Jul 15 00:00:00 2008 GMT until Jul 15 23:59:59 2010 GMT
 - Issuer: Terms of use at https://www.verisign.com/rpa (c)05, VeriSign Trust N\
etwork, VeriSign, Inc., US
 - Fingerprint: da:ff:45:c9:df:6f:b5:73:ec:9c:f8:a7:cc:93:08:84:22:a8:78:3d
(R)eject, accept (t)emporarily or accept (p)ermanently? p

SVN Read/Write and Read Only Access: Details

Locally, the Ptolemy II svn repository is on source.eecs.berkeley.edu in /home/svn There are two ways to access the repository

Getting a Chess Website account and a SSH Account

Once you have a SSH account for read-only or read/write access, there are two ways to build Ptolemy II from source:

Read-only anonymous access accounts

1. Follow the Ptolemy II Eclipse Instructions and set up Subversion to use a svn:// connection or you can proceed with the next steps that use the standard configure/make method
2. If you have chosen to install using the standard configure/make method, using a shell such as Cygwin bash, follow the steps below:
3. Install Subversion and other tools
   Pick one of the methods below:
   Under Windows, follow the Ptolemy II Eclipse Instructions.
   Under Windows, install the most recent version of Subversion and Cygwin from the Ptolemy project, see http://ptolemy.eecs.berkeley.edu/ptolemyII/ptIIlatest/cygwin.htm
   Under Windows, Install TortoiseSVN
   For more information about svn, see the ptexternal Subversion Wiki
4. Select the directory into which you wish to install Ptolemy II. cd to that directory. Installation will create a new subdirectory named ptII within your chosen directory. All of Ptolemy II will be installed inside this subdirectory. (In case you are using the Cygwin Bash shell, and may later wish to upgrade Cygwin, you may wish to choose a directory outside of the Cygwin directory tree.

   The cd and initial svn commands are shown below:

      svn co svn://source.eecs.berkeley.edu/chess/ptII/trunk ptII
   

   In the latter command, the co stands for checkout, and svn://source.eecs.berkeley.edu/chess/ptII/trunk ptII specifies that the ptII repository should be checked out, trunk specifies that the development trunk, not the branches should be checked out. The final ptII specifies that the trunk should be placed in a ptII/ directory. If you did it right, it will grind for a few minutes.
5. The source code is now checked out, now follow the Install Java instructions below

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. An alternative is to use the cygpath command. export PTII=`cygpath -m ${PWD}` This results in a path that has forward slashes. Formerly, under Windows, Java would not work well with forward slashes, but that problem seems to be fixed in Java 1.7.

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}

File name length problems with Subversion and Windows

For details, see Long file name on windows.

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://chess.eecs.berkeley.edu/softdevel/faq/1/

Version: $Id: index.html,v 1.81 2012/08/30 05:03:53 cxh Exp $