FeaturesPluginsDocs & SupportCommunityPartners

Module installation test Test Specification

Author: Jaromir Uhrik
Version: 1.0.0
Last update: 31.05.2005
Introduction: It is necessary to test module installation into IDE before it is placed on any NetBeans Update Center and made available to whole NetBeans community. It is module author responsibility to make sure the module does not break IDE or affects badly other modules. This test-specification describes basic steps how the module should be tested before it may be included on Update Center.
Comment: The version related to NetBeans 6.0 and newer can be found at http://wiki.netbeans.org/TS_61_PluginInstallation

Table of Contents

Test suite 1: Install from local .NBM file

Purpose: The Update Ceter wizard provides installation of a module from local .nbm file. This way of installation should be tested before the module goes to any Update Center.
Setup:

#Test caseDescription
1Prepare .NBM
1. Run NetBeans IDE with clear userdir.
2. Start Update Center wizard (Tools|Update Center).
3. Select radiobutton Install Manually Downloaded Modules (.nbm files).
4. Press Next button.
5. Press Add... button and browse the desired module .nbm file. Press filechooser's OK button.
6. Press Next button.
7. Module is on the right side so press Next button.
8. Accept the license agreement.
9. Press Next button.
RESULT: The last (4th) panel of the Wizard will have the module in the table.
2Install .NBM
1. Press View Certificate... button and if the module is rejected press Accept else Close button.
2. Press Finish button.
3. If the module needs restart then "Restart the IDE" dialog appears. Restart the IDE button is selected by default so press OK button.
RESULT: The updater splash window appears and the module is installed. If the restart is required then the IDE restarts.
3Check module functionality
1. Check that the module is contained in Tools|Options under node IDE Configuration|System|Modules and is enabled.
2. Try at least to create new project and use the functionality of new module. Then compile and run project.
3. Disable the module.
4. Enable the module again.
RESULT: No problem should appear while working with NetBeans. Try as much ad hoc testing as possible.
4Restart_IDE
1. Select main menu File|Exit.
2. Wait for IDE exit and run it again (with the same userdir).
RESULT: The installed module is enabled, works fine and other modules have not corrupted functionality. All modules that have been disabled/enabled stay disabled/enabled after the restart. Track carefully any breaks of IDE functionality.
5Test Help
1. Test online help invocation if your module provides the one.
RESULT: The Help dialog appears with the correct content.
Teardown:



Test suite 2: install from staging and any production Update Center

Purpose: It is highly recommended to test the module installation from a staging Update Center before it is available on any production Update Center.
Setup: It is assumed that the module is available on any Staging Update Center. You can read how the update center can be created in the article http://qa.netbeans.org/processes/create-update-center.html.

#Test caseDescription
1Module Install
1. Run NetBeans IDE with clear userdir.
2. Start Update Center wizard (Tools|Update Center).
3. Select the update center where the module resides (Staging or any your own update center).
4. Configure proxy.
5. Press Next button.
6. Select the desired module on the left and add it to the right (to the "Modules to install" list) by pressing ">".
7. Accept the license agreement and press Next button.
8. After the module is downloaded press Next button again.
9. Press Finish button.
10.
RESULT:
2Restart IDE
1. If the module needs restart then Restart the IDE dialog appears. Restart the IDE button is selected by default so press OK button.
RESULT: The updater splash window appears and the module is installed. If the restart is required then the IDE restarts. Otherwise exit IDE by File|Exit menu and start it again.
3Test help
1. Test online help invocation if your module provides the one.
RESULT: The Help dialog appears with the correct content.
4Disable Module
1. Disable the installed module (select the proper module in Tools|Options node IDE Configuration|System|Modules and set Enabled property checkbox to false).
RESULT: Wait until the module is disabled (check the progress in status line). The functionality of module disappears then.
5Enable Module
1. Enable the module (toggle the Enable property to true) and restart IDE.
RESULT: The installed module is enabled, works fine and other modules have not corrupted functionality. All modules that have been disabled/enabled stay disabled/enabled after the restart. Track carefully any breaks of IDE functionality. The best is to follow by executing complete test specification of the installed module.
Teardown:




Generated: Fri Jun 03 14:47:52 CEST 2005
Companion
Projects:
MySQL Database Server   Open JDK: an Open SourceJDK   GlassFish Community: an Open Source Application Server    Mobile & Embedded Community    Open Solaris   java.net - The Source for Java Technology Collaboration   Virtual Box - full virtualizer  Open ESB - The Open Enterprise Service Bus Powered by