netbeans 5.5 version control: cvs, svn configuration for auv workbench & various x3d, xmsf...

Netbeans 5.5 version control: cvs, svn configuration

for AUV Workbench & various X3D, XMSF projects

Don Brutzman

brutzman@nps.edu

1 December 2007

Netbeans setup 1

• Install latest Java 1.6, Netbeans 5.5– Bundled version works well

– http://java.sun.com or http://java.sun.com/javase/downloads/index.jsp

– http://www.netbeans.org

• Further Java setup checks– Ensure no other versions of Java or Netbeans installed– Ensure JAVA_HOME properly set– Netbeans Tools -> Update Center for updates– http://wiki.netbeans.org/wiki/view/FaqHowToSetUpSSHAuth

Netbeans setup 2

• Netbeans – Tools – Update Center• Update all modules for latest greatest

Netbeans cvs project setup 3

• Enable updated version control

• Don’t enable old versioning VCS

Netbeans cvs project setup 4

• Suggested target locations– C:\auv\AuvWorkbench– C:\CvsProjects\DisJavaProject– C:\CvsProjects\DisXmlProject– C:\CvsProjects\SavageStudioProject– C:\CvsProjects\ViskitProject– C:\CvsProjects\XsbcProject

• CVS module names AuvWorkbench disjava disxml SavageStudio Viskit+Diskit xsbc

• Create meaningful target directories– Having common parent directory is helpful

• Select or enter module name – during initial CVS checkout

Netbeans cvs project setup 5

• Basic setup procedure simpler than 4.0– No more ‘Versioning’ panel to fool with

• Simple two-part process– Check out via cvs– Click to Create Project

• Avoid importing 4.1 settings, they may fail• Follow-on directions show type-in values

blocked out in red– Other values are usually found automatically

Netbeans cvs project setup 6

• Server-side authentication keys must be cached prior to initial cvs checkout

• Use the PuTTy tool to secure-shell (ssh) into the cvs server– Example: xmsf.cvs.sourceforge.net

• Log in using checkout account name

• Screen snapshots follow

Subversion -> checkout

Checking out X3D example archives (Basic, ConformanceNist, Vrml2.0Sourcebook,

X3dForWebAuthors) from Sourceforge

==[IDE]== Aug 31, 2006 2:51:31 PM Checking out...co -r HEAD https://svn.sourceforge.net/svnroot/x3d/examples C:\www.web3d.org\x3d\content\examples\examples

--username brutzman --password ******* --non-interactive --config-dir C:\Documents and Settings\brutzman\.netbeans\5.5beta2\config\svn\config

Command line use of svn$ export SVN_EDITOR=notepad

$ svn delete https://svn.sourceforge.net/svnroot/x3d/examples/Basic/StudentProj

ects/Chess8Levels.x3d.'$$$'Error validating server certificate for 'https://svn.sourceforge.net:443': - The certificate is not issued by a trusted authority. Use the fingerprint to validate the certificate manually!Certificate information: - Hostname: *.sourceforge.net - Valid: from Dec 8 13:40:07 2005 GMT until Feb 7 13:40:07 2007 GMT - Issuer: Equifax Secure Certificate Authority, Equifax, US - Fingerprint: 49:b8:cb:87:04:8c:49:39:45:83:dd:4c:cf:c7:54:57:b0:9e:84:5d(R)eject, accept (t)emporarily or accept (p)ermanently? pAuthentication realm: <https://svn.sourceforge.net:443> SourceForge

Subversion areaPassword for 'brutzman': **************Committed revision 20.

PuTTY ssh initialization of cvs key

1

2 3

4

Necessary step for softwaredevelopers prior to cvs checkout

PuTTY ssh initialization of svn key

1

2 3

4

Necessary step for softwaredevelopers prior to subversion checkout

for XMSF

PuTTY ssh initialization of svn key

1

2 3

4

Necessary step for softwaredevelopers prior to subversion checkout

for X3D

Internal netbeans acceptance of subversion key

Additional developers setup 1

• Developers making and committing source changes into one of the cvs archives need to first install putty tools, then get account

• Putty security tools:– http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

• Requesting a developer account: – Don McGregor (xmsf) mcgredo@nps.navy.mil – Arnie Buss (Simkit) abuss@nps.navy.mil

Additional developers setup 2

• wincvs is separate alternative, usually not needed– http://www.wincvs.org/download.html

Configure Netbeans defaults to support greater memory

• C:\Program Files\netbeans-5.0\etc

• Edit file netbeans.conf– netbeans_default_options="-J-Xms32m -J-Xmx128m (etc.) changed to

– netbeans_default_options="-J-Xms32m -J-Xmx1024m

New Netbeans 5.0 cvs features

• Top-level CVS menu

• Can update all projects at once

• Can show CVS committers by name and versions by number in text editor

• Features presentation: http://www.javalobby.org/eps/netbeans5

Note committer names, line by line

Further resources

• Tutorial by Arnie Buss on Netbeans use provides further background and details http://diana.cs.nps.navy.mil/~ahbuss/CVSNetbeans

• Don McGregor's slideset guides to Concurrent Version System (CVS),

Using CVS with SSH Tunnels and Ant available online

• XMSF Bugtracker http://xchat.movesinstitute.org/bugzilla

cvs checkout + project setup

AuvWorkbench disjava disxml

SavageStudio Viskit+Diskit xsbc

configuration troubleshooting

AuvWorkbench project

https://www.movesinstitute.org/xmsf/xmsf.html#Projects-AUV

project index

CVS Root::ext:anonymous@xmsf.cvs.sourceforge.net:/cvsroot/xmsf

Be sure to enter ext: (rather than default pserver:)

Module to checkout: AuvWorkbenchLocal folder: c:\auv

Create a new netbeans project

Location: c:\auv\AuvWorkbench

Build and Run Actions are found automatically from build.xml

Source package folder: C:\auv\AuvWorkbench\src

Java sources classpath:c:\auv\AuvWorkbench\launchwb.jar

dis-java project

project index

Distributed Interactive Simulation (DIS) protocol

http://www.sourceforge.net/projects/xmsf

CVS Root::ext:anonymous@xmsf.cvs.sourceforge.net:/cvsroot/xmsf

Module to checkout: disjavaLocal folder: C:\CvsProjects\DisJavaProject

Build and Run Actions are found automatically from build.xml

dis-xml project

project index

Distributed Interactive Simulation (DIS) protocol

http://www.sourceforge.net/projects/xmsf

CVS Root::ext:anonymous@xmsf.cvs.sourceforge.net:/cvsroot/xmsf

Module to checkout: disxmlLocal folder: C:\CvsProjects\DisXmlProject

Location: C:\CvsProjects\DisXmlProject\disxmlProject Name: disxml

Build and Run Actions are found automatically from build.xml

SavageStudio project

project index

Savage X3D scenario authoring tool

http://www.sourceforge.net/projects/xmsf

CVS Root::ext:anonymous@xmsf.cvs.sourceforge.net:/cvsroot/xmsf

Module: SavageStudioLocal Folder: C:\CvsProjects\SavageStudioProject

Location: C:\CvsProjects\SavageStudioProject\SavageStudio

Build and Run Actions are found automatically from build.xml

Source package folders

Savage and SavageDefense

X3D Model Archives

Savage is an open distribution

SavageDefense is under controlled access, For Official Use Only (FOUO)

project index

ssh to savage.nps.edu to accept key

ssh to SavageDefense.nps.navy.mil to accept key

SVN Root: :ext:anonymous@savage.nps.edu:/…

Modules: DISKIT,ViskitLocal Folder: C:\CvsProjects\ViskitProject

...

Build and Run Actions are found automatically from build.xml

Simkit/Viskit/Diskit/Gridkit

Discrete-event simulation (DES)

project index

ssh to eos.nps.edu to accept key

CVS Root: :ext:anonymous@eos.nps.edu:/usr/local/cvs/wcm

Modules: DISKIT,ViskitLocal Folder: C:\CvsProjects\ViskitProject

Note that only Viskit needs to be built. Diskit is updated & rebuilt automatically.

Build and Run Actions are found automatically from build.xml

x3d project

Extensible 3D (X3D) Graphics Examples, Tools

http://www.sourceforge.net/projects/x3d

project index

Subversion Root:https://x3d.svn.sourceforge.net/svnroot/x3d

Module to checkout: xsbcLocal folder: C:\CvsProjects\XsbcProject

Location: C:\CvsProjects\XsbcProject\xsbc

Build and Run Actions are found automatically from build.xml

xsbc project

XML Schema-based Binary Compression

http://www.sourceforge.net/projects/xmsf

project index

CVS Root::ext:anonymous@xmsf.cvs.sourceforge.net:/cvsroot/xmsf

Module to checkout: xsbcLocal folder: C:\CvsProjects\XsbcProject

Location: C:\CvsProjects\XsbcProject\xsbc

Build and Run Actions are found automatically from build.xml

Configuration Troubleshooting

project index

Setting main project preference

• Main project selection governs assignment of toolbar buttons at top

• Select Projects tab

• Right-click desired main project

• Set main project preference

Build

cvs update problem: use external shellSSH command: c:\Program Files\PuTTY\plink.exe

CVS update problem:

can’t reset “sticky bits”

Repeat cvs update, check Reset box

check this box to reset

Not yet ready…

TOPTIVA

C:\CvsProjects\ToptivaProject

project index

• CVS archive on surfaris

• Need ssh script to connect

• Site may change due to server reconfigurations