Page History

...

1) From NetBeans' main menu select "Versioning->Subversion->Checkout" as shown in Figure 1.

2) Now we need to fill in the checkout dialog box. For this dialog box all we need to do is fill in the "Repository URL" (See below for what this should be). Once you have set the Repository URL you can press the "Next" button. See Figure 2 for what the dialog should look like when you are done.

3) In the next panel of the checkout dialog box we need to set where we want to put the source code as well as some parameters that will get passed to the subversion client.

...

Once you have filled in the second panel of the checkout dialog press the "Finish" button at the bottom of the dialog. See Figure 3 for how the dialog should look.

4) It may take a while for the checkout to complete. If you want to see what is happening, take a look at the output window at the bottom of the NetBeans window. If you don't see it select "Window->Output->Output" to make it display. You should see something like what is shown in Figure 4.

5) If you left the "Scan for NetBeans Projects after checkout" check box checked you will see the dialog in Figure 5 when Subversion finishes checking out Felix. For now just press the "Cancel" button.

6) This concludes the section on checking out the Felix source code.

...

Before we can build Felix, we need to set up NetBeans so that it can use our external Maven instead of the one bundled with the Maven plugin. You do this in the NetBeans options dialog ("Tools->Options"). Select the "Miscellaneous" icon at the top of the dialog. Then select the "Maven 2" tab. What we want to do here is tell NetBeans where we installed Maven. You can press the "Browse" button to browse to the directory where you installed Maven. You can leave the rest of the options as they are. See Figure 6 for how this dialog looks and how to set it up.

2) Open the Felix project folder

Now we need to open the Felix build project folder. This will be the "pom" project. It is located in the directory where you checked out the source code. When you locate it select the project and press the Open Project button. See Figure 7 for how this looks.

When the project is opened your "Projects" pane should look something like Figure 8.

3) Configure the project

We now need to change one aspect of the project configuration. So right click on the project and select the "Properties" menu item, then select the "Actions" category. What we need to do here is check the "Use external Maven for build execution" checkbox. Once you have done this you can press the "OK" Button. See Figure 9 for how this should look.

4) Select a build profile

Felix is built in two phases. These two phases are controlled by Maven profiles so we want to set the profile that we want to build. You do this by right clicking on the project then select "Profiles->packaging-plugins" to select the profile, see Figure 10.

5) Build Felix plugins

Now that we have selected the correct profile all we have to do is build it. Right click on the project and select the "Clean and Build" menu item. You should see something like Figure 11 when the build is complete. NOTE: If you have not done this before it may take a little while, since Maven needs to download a bunch of plugins.

6) Build Felix bundle

Now that we have built the plugins it is time to build the Felix bundle. Like in step 4, we right click on the project and select "Profiles->packaging-plugins" (to unselect it), then do it again but this time select "Profiles->packaging-bundle". Once you have done that you can "Clean and Build" the project. See Figure 12 for what you should see in the output window when the build completes.

Conclusion

If every thing went as expected then you should have a built and ready to run Felix installation in the "main" directory under the directory where you checked out Felix. You can now run Felix from the command line by changing to that directory and running this command:

...