Netbeans Setup
If you don't have Netbeans on your machine already, download and install it.
Next, install the Netbeans Maven plugin.
Under Tools -> Plugins -> Available Plugins, check the box next to Maven. Click Install.
Now open LCSim by selecting Open Project and clicking on the LCSim root directory.
You should see LCSim in your Netbeans project window now.
Setup the Profiler
The profiler needs to be calibrated before it can be used. Select Profiler -> Advanced Commands -> Run Profiler Calibration.
Some information is required to connect the profiler to our application.
Select Profiler -> Attach Profiler to pull up the Attach Profiler window.
Click on the Change link at the bottom of the window to bring up the Attach Wizard.
Make sure Local and Direct are selected. Click the Next button twice.
Copy and paste the entire string beginning with "-agentpath" to a local scratch file. This will be needed to connect the running code to the profiler.
Setup LCSim
Right click on LCSim and select Set as Main Project.
Right click on LCSim again and select Properties -> Run.
Paste the string you saved earlier into the VM Options field.
The Run settings should now look similar to this.
Now Netbeans will wait for a profiler connection before running your main.
Create a Main
The profiler will only run on classes that have a main routine.
I created a class called ProfilingTest in the package org.lcsim. Technically, this class could be called anything and could be located anywhere under the src directory in lcsim.
Add a main routine to this class with some test code. Here is my version of ProfilingTest.java.
package org.lcsim;
public class ProfilingTest
{
public static void main(String args[])
{
System.out.println("hello profiler");
}
}
This class needs to be designated as the project's main run class. Right-click on the LCSim project, select Properties and go to the Run window. Enter the fully qualified name of your class in the Main Class field.
Put the profiler connection string into Arguments and VM Options.
Connecting to the Profiler
Run the test code by right clicking on the LCSim project and selecting Run.
If all was setup correctly, you should see something like the following in your log window.
Profiler Agent: Initializing... Profiler Agent: Options: >/Home/apps/netbeans-6.0.1/profiler2/lib,5140< Profiler Agent: Initialized succesfully Profiler Agent: JNI On Load Initializing... Profiler Agent: JNI OnLoad Initialized succesfully Profiler Agent: Waiting for connection on port 5140 (Protocol version: 8)
This means that you can now launch the profiler using Profile -> Attach Profiler, and your main routine will be executed and profiled according to your selections.