This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 136069 - No details in documentation for manual deployment of "Java Applications" with "Enable Web Start"
Summary: No details in documentation for manual deployment of "Java Applications" with...
Status: RESOLVED FIXED
Alias: None
Product: usersguide
Classification: Unclassified
Component: Code (show other bugs)
Version: 6.x
Hardware: PC Linux
: P4 blocker with 1 vote (vote)
Assignee: Irina Filippova
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-05-29 11:06 UTC by bugbridge
Modified: 2009-11-08 21:50 UTC (History)
2 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description bugbridge 2008-05-29 11:06:04 UTC 
Original status: 1-Dispatched; Suggested Status: NEW


Description:
The following behaviour is not clearly documented in netbeans

Running NB 6.1 on java 6u6 "Enable Web Start" in a project. The project
compiles. The project will run from within the IDE (using Local Execution)

If the project is built for deployment (Web Application Deployment) and
subsequently deployed, it will not run and throw an exception

BadFieldException[ The field <jnlp>codebase has an invalid value:
$$codebase,$$codebase]
    at com.sun.javaws.jnl.XMLUtils.getAttributeURL(Unknown Source)
    at com.sun.javaws.jnl.XMLUtils.getAttributeURL(Unknown Source)
    at com.sun.javaws.jnl.XMLFormat.parse(Unknown Source)
    at com.sun.javaws.jnl.LaunchDescFactory.buildDescriptor(Unknown Source)
    at com.sun.javaws.jnl.LaunchDescFactory.buildDescriptor(Unknown Source)
    at com.sun.javaws.jnl.LaunchDescFactory.buildDescriptor(Unknown Source)
    at com.sun.javaws.Main.launchApp(Unknown Source)
    at com.sun.javaws.Main.continueInSecureThread(Unknown Source)
    at com.sun.javaws.Main$1.run(Unknown Source)
    at java.lang.Thread.run(Unknown Source)

If a WEB-INF directory is manually added to the deployment directory, containing
a web.xml and a lib/jnlp-servlet.jar, the application runs.

Instead of adding a WEB-INF with the jnlp-server.jar, the three jnlp jar files
(jardiff.jar, jnlp.jar, and jnlp-servlet.jar) can be added as a library to the
project, build it, create a WAR, and it will deploy and run.

Suggested Fix:
Suggestions from netbeans sustaining engineer:

For "Local Execution" and "User Defined" options, documents are not wrong and
they do mention that only jnlp artifacts are created; but perhaps they should be
clearer about manual deployment to a server and possibly document the steps needed

For "Web Deployment" option, either the option should be removed or manual steps
documented as to how to make a war from the generated artifacts.
Comment 1 Karthikeyan Rajeswaran 2008-06-23 04:09:56 UTC 
- Online help does clearly state that only artificats are generated. But I think online docs should be more explicit and
inform the users that the deployment to a server needs to be done manually.

- Ref: http://blogs.sun.com/NetBeansSupport/entry/java_web_start_for_standard

- http://javawebstart.netbeans.org/ still points to the tutorial meant for web start module that was made available on
the development center for NetBeans 5.0. The tutorial is misleading for users of NetBeans 5.5 and later. The page
http://javawebstart.netbeans.org/ needs to be updated.
Comment 2 Patrick Keegan 2008-07-22 20:45:29 UTC 
I'll take this one
Comment 3 Patrick Keegan 2008-11-21 18:21:23 UTC 
Brad, could you take a look at this issue as part of your future work on our WebStart support?
Comment 4 Irina Filippova 2009-11-08 21:50:22 UTC 
The tutorial on netbeans.org explains how to enable Java Web Start for a Java application within the IDE.
http://netbeans.org/kb/docs/java/javase-jws.html
Closing as fixed and resolved. If you have other comments about what needs to be documented related to JWS, please open a separate issue.

Irina