To capture the execution of a program to BugJail, the only thing you need to do is start Java Virtual Machine with one additional option.
This article links to two alternative ways how to construct the BugJail Agent option string and then shows how to use the option to enable BugJail capturing from Eclipse.
Step 1: Construct BugJail Agent option & copy to clipboard
Alternative A: construct BugJail Agent option string by using Capturing Assistant (easy user-interface, but supports only the two most common configuration options currently).
Alternative B: construct BugJail Agent option string manually (more effort, but allows using additional options).
Step 2: Paste the BugJail Agent option to Eclipse 'run configuration'
- In Eclipse, open "Run" menu.
- Select "Run Configurations..." menu item.
- Select the 'run configuration' you want to use with BugJail capturing.
- Select the "Arguments" tab
- Paste clipboard contents to "VM arguments" text area
- Note: if you have existing VM arguments, just append the BugJail Agent option string from clipboard to the beginning or end.
- Click "Close" to save the changes to the configuration you just edited.
Step 3: Run or Debug the Eclipse 'run configuration'
- In Eclipse, Run or Debug the run configuration you just edited
Step 4: Verify that capturing worked
- In Eclipse console output, you should see extra logging from BugJail Agent
- In BugJail, the "Welcome to BugJail" or "Capturing Assistant" -dialog should disappear within 1-2 seconds, if it was visible, revealing a list of captures.
- In BugJail "Captures" -panel, you should see a new capture row within 1-2 seconds.