Troubleshooting a Bug for an Environment

References

http://www.mosaic.arizona.edu/Environment_urls

Application Information

• Build information on top right
  • KITTxxxx-yy
    • KITT = our build
    • xxxx = foundation build number
    • yy = our build number

Steps To Tackle A Bug

1. Try to reproduce it in appropriate environment.
2. Try to reproduce it UA DEMO environment.
   • DEMO environment just has foundation code.
   • TST environment will generally have same build as DEMO, but includes UA modifications.
3. Get access to source code so you can manipulate data and examine code.
   • use a different workspace so you avoid confusion (see Setting Up Alternate Workspace)
   • svn.uits.arizona.edu/kitt/kitt/financial-system/kfs
     • contains branches, tags, trunk
     • check out code for the build you want from the tags folder
     • check out appropriate rice code as needed (see Browsing Foundation Code)
     • never check code back in
   • Consult build steps in KFS 3.0 Troubleshooting Guide#Application Start Exceptions if your server is not starting the application correctly.
4. Use local oracle instance of database if you think that it is a data problem.
   • Load new database.
5. Modify kfs-build.properties
   • Change environment.
   • Change database properties.
   • Follow the application build steps in KFS 3.0 Troubleshooting Guide#Application Start Exceptions.

Browsing Foundation Code

• http://test.kuali.org/fisheye
• Go to tags in Rice.
  • KFS build number is different than the Rice build number (i.e. Rice is behind)
  • Have to follow the date that the KFS build was created and then get the Rice build that was from that date.
    • work/web-root/WEB-INF/lib has the .jar files, which includes which version of Rice it uses (clicking on the rice jar file will take you to more info, including creation dates)

Setting Up Alternate Workspace

1. Choose File -> Switch Workspace -> Other
2. Name a new workspace.
3. Under Copy Settings, check "Workbench Layout" and "Working Sets" options.
4. Set up local Tomcat server.
   • Choose "Tomcat v5.5 Server" under the Apache folder.
   • Browse for your Tomcat server folder (e.g. C:\java\servers\apache-tomcat-5.5.16).
   • Click Next, then Finish.
   • Double-click on the Tomcat server (to change additional settings).
     • Make sure "Use Tomcat installation" is selected under the "Server Locations" tab.
     • Make sure the seconds in the "Timeouts" tab is larger than the default (e.g. 300 seconds for Start and 120 seconds for Stop).
     • Save the new selections.