Manual add instructions for plugins that support it:
- log into RHQ and select an imported/available platform from the left nav tree
- click on Inventory -> Child Resources tab
- you will see an 'Import' drop down list from which you can choose "Tomcat Server". 
- Fill out the details to manually add the new "Tomcat Server" to the platform.

Created attachment 736803 [details]
where to go to repriduce the problem.

Inventory + All resources + click on the box + inventory (in the box frame).

it looks fixed in master... Need to find the fix :-(

After looking to the issue it doesn't seem to be a problem of the plugin.

So after looking into this some more with one of the other developers here, we are proposing that we handle BZ 883825 in the following ways:
1) Update the test instructions to ONLY test Manual Import in the following way:
  - "You should not test this BZ by attempting to manually add a Tomcat/EWS resource that shows up in the 'Discovery Queue'." 
    WHY: Manual Import is meant to be used to add the following types of servers to RHQ inventory 
          i)offline resources with no current running processes OR
          ii)servers that CANNOT be successfully auto discovered. 
         Once Tomcat/EWS servers have been successfully discovered(i.e showing up in 'Discovery Queue'), then RHQ now knows about these resources, and subsequent 'Manual Import' requests for running servers will instead be treated as attempt to update an existing resource.  This is not the intent of this BZ, but instead to exercise the Manual Import which cannot be done if those same Tomcat/EWS instances are being automatically marked as discovered/available for import.

2) Before retesting BZ 883825, if you have any Tomcat instances in your 'Discovery Queue' you should:
   i)From Inventory-> Resources -> Discovery Queue, import all Tomcat/EWS instances that show up.
   ii)Then shutdown all Tomcat/EWS instances, such that there are no processes available for them.
   iii)Navigate to root platform -> Inventory -> Child Resources to select all resources of type "Tomcat Server" and uninventorying them. 
   iv)Now attempt to 'Manual Import' one of the Tomcat/EWS instances as described before.  If successful you should see the Tomcat/EWS instance show up as a child of the root platform.  You should also be able to start this instance by navigating to the {Manually Imported instance} -> Operations tab.  *This is necessary to clear out auto-discovered instances before testing Manual Import so that they are not incorrectly detected by RHQ as an attempt to update discovered but NOT inventoried instances of Tomcat/EWS.*   

3) While the erroneous state and error message is reliably reproducible with JON 3.1.x and in master with supported browser configurations, it also represents an uncommon edge case not likely to be encountered by many customers.  With greater digging it was discovered that this specific code path, i.e one where the customer is trying to Manually Import instances that are ALREADY available for import from the Discovery Queue, is not and should not be supported by RHQ for the following reasons:
   i) goes counter to one of the stated goals(see 1.ii above) of Manual Import
   ii) although there is code within the plugin container to attempt to support a Manual Import for a resource already indexed by RHQ, it a)does not work and b) should not be allowed because it would add support for non-standard way of altering the configuration of detected resources which is already fully supported by the UI and CLI with well understood semantics.
   iii) it is also semantically unclear what should be the behavior for a Manual Import that maps to an existing RHQ instance in the IGNORED state.  Again allowing an update of a previously indexed Resource via Manual Import is not the right/support path to update Resource configuration or Resource inventory state.

4) Given that Manual Import can be used to inadvertently attempt to update an already indexed Resource(configuration and inventory status), the following changes will be made to the RHQ:
   i) modify the InventoryManager(Plugin Container) to remove logic that attempts to support updates to already indexed RHQ resources. Log informative errors when this occurs.
   ii) modify the release notes to include a caution for users attempting to Manually Import resources that already show up in the 'Discovery Queue' with the workaround described in 2) above.
   iii) modify the RHQ/JON remote api documentation to more clearly describe what happens with unintentional updates.
   iv) have this BZ and 'Discovery Queue' clean out(2 above) mechanism described/recorded as knowledge base entries in case customers do run into this issue.
   v) improve server side handling of such request via Manual Import that translate into Resource update requests such that it is prevented and appropriately logged.       

5) This BZ should be modified so that it does not block either JON or EWS releases since it represents a remote edge case that is to be discouraged anyway.

I encountered another problem during manual import of Tomcat.
Steps to reproduce:
1. Don't start Tomcat (Tomcat is not in discovery queue)
2. Manually add Tomcat - import is successfully done
3. wait few secs
4. then start Tomcat from opeartion tab
5. Tomcat starts successfully but you will see this error in agent.log
2013-04-25 00:23:02,556 ERROR [ResourceContainer.invoker.nonDaemon-1] (jboss.on.plugins.tomcat.TomcatServerOperationsDelegate)- Script returned error or non-zero exit code while starting the Tomcat instance - exitCode=[UNKNOWN], output=[Using CATALINA_BASE:   "c:\qa\lfuka\workspace\jboss-ews-2.0\share\tomcat7"
Using CATALINA_HOME:   "c:\qa\lfuka\workspace\jboss-ews-2.0\share\tomcat7"
Using CATALINA_TMPDIR: "c:\qa\lfuka\workspace\jboss-ews-2.0\share\tomcat7\temp"
Using JRE_HOME:        "C:\Program Files\jdk_noeTS_locally\jre"
Using CLASSPATH:       "c:\qa\lfuka\workspace\jboss-ews-2.0\share\tomcat7\bin\bootstrap.jar;c:\qa\lfuka\workspace\jboss-ews-2.0\share\tomcat7\bin\tomcat-juli.jar"
].
6. You will see failed of start operation in Operation tab - History, but Tomcat starts on managed host OK

This is RFE for EWS JON Plugin Doc. We don't have any JON EWS plugin guide yet. We should create this new guide in future EWS releases, if not already exists in JON documentation.

Tested with JON 3.2.0.ER7 + EWS 2.0.1 and VERIFIED on RHLE5, RHEL6 (32bits, x86_64), MS Windows 2008 and 2008R2, Solaris 10, 11 (32bit, 64bit, SPARC)