Visible Systems Corporation Razor Users Forum March 1st, 2nd 2007 Courtyard by Marriott

1. Visible Systems Corporation Razor Users Forum March 1st, 2nd 2007 Courtyard by Marriott Cocoa Beach, Florida

2. Razor Users Forum Agenda • Thursday, March 1 • Afternoon Session – Part I • 13:00 Arrival and Welcome • 13:15 Review of Razor Releases ... • 5.0, 5.1, 5.2 • Guiffy 8.0 • 14:30 Break

3. Razor Users Forum Agenda • Thursday, March 1 • Afternoon Session – Part II • 14:45 Razor Tips and Workarounds • Issue Attachments Flag • Issue Weaver Rules File • Transferring an Issue • Relocating a Database • Deleting from the Versions GUI • Using the Databases File • Reference to Prior Productivity Tips • 17:00 Adjourn

4. Razor Users Forum Agenda • Friday, March 2 • 09:00 National Data Buoy Center (NOAA) Razor Implementation • 11:00 Integration of SCRUM in Razor • Agile Project Management Practices • 12:00 Lunch Session • User Presentations • 1:00 Question and Answers • 14:00 Adjourn

5. Visible Systems Overview • Founded in 1981 • Corporate headquarters located in Lexington, Mass. • Major products include: • Visible Analyst (modeling and database design) • Visible Developer (application code generator) • Polaris (issue tracking and workflow management) • Razor (integrated SCM) • LCSIS (integrated hardware CM) • More than 100,000 customers • Internet address: www.visible.com

6. Visible Product Lines • Model Driven and Component based Development • Visible Developer • Enterprise Change Management • Visible Polaris • Visible Razor • Enterprise Lifecycle Management • Visible LCSIS • Enterprise Architecture Suite • Visible Enterprise Workbench • Business Templates • Visible Universal Model • Enterprise Architecture Planning • Visible Advantage • Enterprise Frameworks • Visible Analyst

7. Razor Releases 5.0, 5.1, 5.2Presentation

8. Razor • Product Evolution over Latest Releases Attachments Issue Weaver Live Links Issues Versions Weaver Remote Command Line Reporting Versions Threads Branching Apache Third Party Software GUIFFY POSIX Red Hat Enterprise, Macintosh OS SSH

9. Razor 5.0 Review • New Operating Systems supported by Razor • Red Hat Enterprise Linux • Windows Advance Server • Windows XP Service Pack 2 • Razor no longer includes support for the following platforms: • Microsoft Windows 95 • SCO Open Server • DEC OSF • Linux (2.0.x kernel) • SunOS 4.1.x

10. Razor 5.0 Review • General Release Changes • Updated the Razor executable to install easier on laptops. • Corrected password message inconsistencies with Razor and IW. • Web-based System Administration (Monitoring) • Added functionality for "Live Links" between versions and issues. • Requirements-based SCM via Issues with Attachments

11. Razor 5.1 Review • Issues Numbers • 2-860 • 2-878 • 2-883 • 2-885 • 2-886 • 2-889 • Issues Numbers • 2-529 • 2-809 • 2-835 • 2-842 • 2-853 • 2-854 • 2-855

12. Razor 5.1 Review • Enhancements • 2-529 - Windows Install - Add print button for Release Notes • 2-842 - Charting: Update Object Planet's EasyCharts chart.jar • 2-860 - Integrate Razor with Guiffy diff/merge tools • 2-883 - Windows: Updated Razor Server installer for POSIX 3.5 • 2-854 - Scripts for NUWC that provided capability for synchronization of parent / child import-export. Those scripts are being placed in the examples directory for the build. Bugs----2-809 - Parent/Child: Bug in 5.0 with Objects Button2-835 - Threads: Cancel of thread extract from Project causes seg fault2-853 - fix copy_release build script2-885 - Fix Access_list file typos2-886 - rz_utils sort_thread_commands formatting2-878 - Internal Issue2-855 - Internal Issue2-889 - Internal Issue

13. Razor 5.1 Review • Enhancements • 2-529 - Windows Install - Add print button for Release Notes • 2-842 - Charting: Update Object Planet's EasyCharts chart.jar • Recently renewed the support with Object Planet for their EasyCharts package. • Currently Issues, Versions, Threads, and Issue Weaver use the chart.jar provided by ObjectPlanet for creating pie and bar charts via an applet. • Version 3.0 of EasyCharts is now available. Need to incorporate this into the release. All of the pie and bar chart functionality needs to be covered in release testing.

14. Razor 5.1 Review • Enhancements • 2-860 - Integrate Razor with Guiffy diff/merge tools • Add hooks to integrate Razor with the Guiffy (www.guiffy.com) diff/merge tools. • The Xdefaults, Wdefaults have been updated for new options. The RUM should be updated to reflect the new option.

15. Razor 5.1 Review • Enhancements • Versions Folder Diff File Transfer Threshold • Versions provides the ability to perform a (recursive) folder diff between a folder specified on the user's local filesystem with a folder managed by the Razor DB. Performing the folder diff requires that temporary, read-only copies of the DB managed folder's files be transfered to the local file system. This parameter specifies the threshold above which Versions will prompt the user to continue the (potentially lengthy) file transfer operation. • NOTE: The value "-1" is considered a special threshold value. It indicates that Versions should never prompt the user for confirmation.

16. Razor 5.1 Review • Enhancements • 2-883 - Windows: Updated Razor Server installer for POSIX 3.5 • During teleconference discussed suggestions for simplying installation of Razor Server and POSIX 3.5 for Windows users. • Would like to update the current Razor Server installer to also install POSIX 3.5. Specifically would like the following done:1) Determine if a compact, subset of POSIX 3.5 is sufficient.2) Capture the (compact) POSIX 3.5 in PROG_DB3) Update the InstallShield installer to:a) Warn users that previous versions of Razor will not work once Razor 5.1/POSIX 3.5 is installedb) Backup existing registryc) Remove all remnants (including registry) of Interix 2.2d) Install (compact) POSIX 3.5e) Update all findings (e.g. was Interix installed/uninstalled, was POSIX 3.5installed, ...) to the $RAZOR_HOME/rz_installation.log logfile

17. Razor 5.1 Review • Enhancements • 2-854 - Scripts that provide some capability / synchronization of parent / child import-export • Placed in the examples directory for the build.

18. Razor 5.1 Review • Bug Fixes • 2-809 - Parent/Child: Bug in 5.0 with Objects Button • 2-835 - Threads: Cancel of thread extract from Project causes segment fault • 2-853 - Fixed copy_release build script • 2-885 - Fixed Access_list file typos • 2-886 - Addressed rz_utils sort_thread_commands formatting

19. Razor 5.2 Review • Feature Issues • 2-940 • 2-943 • 2-945 • 2-947 • 2-952 • 2-953 • 2-954 • 2-955 • 2-959 • 2-960 • 2-963 • Enhanced Issues • 2-867 • 2-887 • 2-949 • 2-950 • 2-956 • 2-964 • 2-965 • Fixed Issues • 2-935 • 2-937 • 2-939 • 2-941 • 2-944 • 2-946 • 2-951 • 2-958 • 2-961 • 2-962

20. Razor 5.2 Review • 2-953 • 2-955 • 2-956 • 2-958 • 2-959 • 2-960 • 2-961 • 2-962 • 2-963 • 2-964 • 2-965 • Security Issues • 2-867 • 2-952 • 2-954 • Application Issues • 2-887 • 2-935 • 2-937 • 2-939 • 2-943 • 2-944 • 2-945 • 2-946 • 2-947 • 2-950 • 2-951 • 2-958 • 2-961 • Platform Issues • 2-940 • 2-941 • 2-949

21. Razor 5.2Build for next release of Razor • Extend rz_create_remote_distribution to include needed components for Guiffy. • Build support for the MAC OS version in Razor. • include the use of SSH encription of username and password • Incorporate the use of SSH for improved security of remote client authentication. • Update Razor server application software for Versions Weaver specific messages and protocol. • Address the problem of using the timestamp sort in the Issues Activity window. This is only a problem with the Windows platform.

22. Razor 5.2Build for next release of Razor • Address issues with Guiffy and remote UNIX/Linux clients. • Address issues when Razor can't terminate branch when sub-branch is terminated. • Address issues when terminating a branch that has another branch. • Address issues for the text field Xwidget warnings when starting clients on Linux and Solaris • Address issues for (UNIX) File Chooser GUI rendering problem. The Chooser's current directory text field is partially obstructed by the pair of radio buttons above it.

23. Razor 5.2Build for next release of Razor • Update the handling of ONE_OF_MANY_LIST to display the selected item when an issue is opened. • Address the problem that occurs when promoting several sources at once to something other than the next state. Currently, only the first file is promoted properly. • Address the issue that occurs on a Windows 2003 server where the Razor Administrator will not start a Razor database which was created on a drive that sits on a different machine. • Address the problem which causes Issues to crash when switching from one Razor database to another and then switching Razor groups. • Add the option to terminate a branch from the "razor" command line.

24. Razor 5.2Build for next release of Razor • Add the capability of a Remote Razor Command Line. • Add "remote" capabilities to the 'razor command line'. • User may need to login to the Razor server and "razor command line" may need to store the login information in $HOME (similar to how CVS works). • Initially will be UNIX-ONLY. Windows will be visited in a later release. • Update the Razor Desktop so that it starts as a small box at the top right corner of the user's desktop. It may be moved and resized by the user and will remember the user's setting. • Fix the Razor date wizard in Razor Issues. For example, when user changes to a 30 or 28 day month, it stays this way for all other months

25. Razor 5.2Build for next release of Razor • Address Razor's update password or create user feature so a user's password cannot be blank. For example, prevent cases where zero-length password can be issued. • Update the File Attachments feature in Issues so that it remembers the last directory accessed within the current session. The default directory should be $HOME. • Update the File Attachments feature in Issues so that the user can attach more than one file at a time. • Add a checkbox to the GUI logins so that it remembers the user's password (possibly saved in $HOME as a binary) when requested.

26. Razor 5.2Build for next release of Razor • Add the capability to delete a Razor database in Windows Razor Admin GUI. • This feature will require that the registry be updated and the operating system be restarted. • All Razor databases along with the Razor license manager must be down. • Add Guiffy 7.4 and possibly 8.0 to the Windows Razor installer file. • Address the problem where the Razor reports wizard shows empty dates as Dec 31, 1969. Dates should be shows as empty or <UNDEF> or something similar.

27. Razor 5.2Build for next release of Razor • Address the problem where the view/filter option cannot search for issues with an empty date field even though they are stored with 12/31/1969. • Update the Razor up/down and razor_lm start down messages so that the user is returned to the command prompt. • Fix the bug in razor -c modify_issue, which adds 2 extra lines to 1st text pane after each update. • A line should only be added if pane is updated. Multiple updates leave a large set of blanks in text pane. • Update the razor command line to include a "razor lm_start" command. Should be the same as "razor_lm&".

28. Razor 5.2Build for next release of Razor • Add new capability to Razor Issues and Issue Weaver to insert a delimiter (timestamp followed by username), e.g. "------------------ [02/14/07 08:15:30] [username] -----------", into the text panes each time the issue is modified. • Provide new Option file entry for enabling/disabling new feature. • Default would disable this feature. • Add provision to make sure java/lib/*.jar files are copied into BASELINE_BUILDS Summary. • Fix windows server so it will validate a LOCAL password. Currently user must set to "auto-login". • Update revision files for 5.2.

29. Platforms Supported • Support for IBM eSeries Servers • Support for Red Hat Linux Enterprise • Support for Windows XP SP2 • Support for Apache 2.x and Microsoft IIS • Macintosh OS

30. Razor Branching and Merging OperationsPresentation

31. Razor Branching and MergingNew Features • Razor Release 5.2- Includes Guiffy 8.0 software version • Named Saved Settings • Auto Encoding • Auto EOL • Show Ignored differences • Performance Improvements • Windows Vista Support • Java 6 Support • Additional DragNDrop support • Improved browser launcher • Compare Report (HTML) Preview/Print launches the browser

32. Guiffy Version 8.0 • Named Saved Settings: • Adds the capability to Save Settings as named file • And then, Load a named Saved Settings file. • Save Settings keeps current Named Settings updated. • Save As and Load dialogs include a history combo choicelist. • Named Settings added in Guiffy CLI and API.

33. Guiffy Version 8.0 • Auto Encoding: • New optional mode for Encoding options. • Detects Encoding format of 1st, 2nd, and parent files. • Then, uses the detected Encoding format when saving 1st or 2nd file. • 1st file's Encoding format used for all other file saves. • Detection based on: Byte Order Marks, XML Declaration encoding= attribute, or HTML meta charset= attribute. • User specified Encoding formats used when auto detection isn't possible. • Encoding options dialog shows detections. • Auto Encoding added in Guiffy CLI and API.

34. Guiffy Version 8.0 • Show Ignored differences: • New option for file compare in Ignore options. • Shows ignored differences in 2nd file compare view. • Preserves 2nd file content while making an edited variant. • Show Ignored differences added in Guiffy CLI and API

35. Guiffy Version 8.0 • Performance Improvements: • Streamlined GUI startup --- 52% faster. • Consolidated install down to 2 jars --- Guiffy.jar and JavaHelp (jh.jar). • 8.0 on Java 6, file compares performed from command line - 2X F-A-S-T-E-R !! • Windows Vista Support: • With latest InstallAnywhere (8.0) install packaging. • With updated shell extension for Explorer context menus. • With 1.6 or 1.5 JREs.

36. Guiffy Version 8.0 • Auto EOL: • New optional mode for Write EOL options. • Detects EOL format of 1st and 2nd files. • Then, uses the detected EOL format when saving 1st or 2nd file. • 1st file's EOL format used for all other file saves. • EOL options dialog shows detections. • Auto EOL added in Guiffy CLI and API.

37. Guiffy Version 8.0 • Java 6 Support: • Tested Guiffy 7.x and 8.0 on Java 1.6.0 for months (ever since 1.6.0 was available for beta testing) - NO PROBLEM. Java 6 is faster and it supports Windows Vista. • Download packages for Windows and Linux with a JRE include the international 1.6 JRE. • Additional DragNDrop support: • Files can be dragged and dropped onto the file compare view text areas. • Drop selects the file in the Open Files Panel. Then, either click on Compare, or drag and drop another file onto its field in the Open Files Panel.

38. Guiffy Version 8.0 • Compare Report (HTML) Preview/Print launches the browser • Eliminated usage of WebWindow component. • Faster, lighter, less memory required, etc. • Updated U.I. Translations • Bugs 360-363 fixed (Refer to BugReports on Guiffy's web site for details)

42. Character Sets Supported A few of the supported languages include… • Germany • Norway • Spanish • Netherlands • Portugal • Greek • Ukraine • Japanese -- see example  • Korean • Turkish • Arabic • Pakistan • Brazil • French

43. New Tool Bars Operations ToolBar Edit ToolBar Options ToolBar Style ToolBar Views ToolBar Navigation ToolBar ComparEdit ToolBar

44. A Trustworthy 3-way Merge New Merge Result Line a Line 1 Line b.2 Version 1: Add Line 1 After Line a Version 2: Change Line b to Line b.2 Original: Line a Line b SCM systems supporting concurrent development models have existed for a long time. Concurrent development is crucial to productivity and depends upon a trustworthy 3-way merge. Most merge tools produce untrustworthy 3-way merge results • This results in development environments with: • a) concurrency being forbidden • b) "gotta-do-a-merge" blues, and/or • c) additional CM staff to manually review all merge results. All of these alternatives are productivity killers and feed the black hole where all theoretical ROI goes.

45. Merge/View 2 and 3-way The diff/merge view has 3 views, the 2 diff views plus the merge result window (which can be edited). Merges can be be performed with the 2 compare files interactively, or as a 3-way auto merge with the 3rd (parent) file specified.

46. CompareEdit: Edit and Save Compares If you need to replace several change blocks, just keep repeating the locate and replace steps above. You can also make all sorts of other editing changes. To remove lines, Select the lines and then click on the Mark as Removed button.    Once a line has been removed, it will be displayed with a strikethru and look like this…

47. Folder Compare The Folder Compare Tree view. Guiffy's directory compare also be performed recursively to do a file tree compare.

48. File Compare HTML Reports

49. Show Differences Folded Compare/Merge Views improve the compare viewing response time and reduces the memory requirements (especially for large files with just a few differences).

50. Razor Productivity Tips and TechniquesPresentation