iPlanetTM Application Server Integration Tool

Integration with WebGainStudioTM Version 4.1

Release Notes

iPlanet Application Server Developer Pack Enterprise Edition Version 6.0

Updated May 8, 2001

Contents

What's New

The iPlanetTM Application Server Developer Pack Integration Tool for WebGain Studio solution enables you to develop iPlanet Application Server applications with WebGain Studio Standard Edition Version 4.1.

The iPlanet Third Party Integration solution enables you to:

Issues and Limitations

The following issues have been addressed in this release and a workaround is provided.

Bug Id

Short Description

Workaround

Configure iPlanet Web Application
81037 When clicking <edit method> in the Security tab, the caption and information of the popup dialog is about roles.  
81038 If you enter a collection name of a collection name that has been previously remove you will get duplicate name message Close and reopen the dialog to avoid this issue
81039 After adding a role in the SecRoles tab, the role does not appear in the Security tab when performing an <Edit Roles>. Close and reopen dialog before <Edit Roles> at security tab
81702 For a drop-down column field, there is focus problem when you click on a row then click on another row in this column field Please click one the other column field to select a row if you want to remove row
EJB Wizard/Configure Deployment Descriptor (EJB)
532155 When you create an EJB reference in an EJB project, a default value is given for the JNDI name of the bean. Since beans could be in any EJB module, you should verify that the JNDI name is correct for the bean you wish to reference. To view and edit the JNDI name for a bean reference:
  1. Select the Configure Deployment Descriptor item on the Project menu.
  2. Select the bean that uses the reference from the list on the left of the dialog.
  3. Select the Target tab.
  4. Select the EJB-Ref tab.
  5. The table that appears on the tab has both the name of the EJB reference and the JNDI name. The JNDI name may be edited, but the reference name is NOT editable.

    The correct JNDI name for Bean from the EJB module ModuleOne is ejb/ModuleOneEnterpriseBean/Bean.

    The name that is created by default is based on the reference name. For example, if you create a reference to the bean mentioned above and gave that reference the name Foo, the default value of the JNDI name will be: ejb/FooEnterpriseBean/Foo.

    This clearly incorrect, but there is no way to determine the correct value for the JNDI name based on data available in the project.
81294 For Option C: the default value for <free-pool-maxsize> is 0 based on iPlanet's dtd file  
80896 There is no UI to configure <is-thread-safe> within the deployment descriptor configurator dialog In order to update, please manually modify the value in XML file
80897 For an entity bean, users can either select Option B or Option C, but both option's elements appear in same ias-ejb-jar.xml file  
80907 If you create a CMP bean without using Persistence Builder ( i.e. insert existing EJB code to EJB project) the created {bean}-ias-cmp.xml file is empty. Please use the EJB wizard and select "Map database fields into entity bean". Use Persistence Builder. Load the table and then create CMP bean.
80937 An extra <factory-class-name> element is placed in the <pool-manager> tag of the ias-ejb-jar.xml for the CMP bean  
80951 ".DEFAULT" is set as a table name inside the bean-ias-cmp.xml file if you create a cmp using ejb wizard and you do not use the "Map database fields into entity bean" option. Please see 80907
80905 The ejb resource name is not updated at resource-ref tab if you rename resource at environment | resource tab and do not press the <Enter> key  
81686 If you rename an EJB in the deployment descriptor configurator's EJB info tab for a CMP bean two {bean}-ias.cmp.xml files are listed for this bean in the project window  
81693 When creating a BMP bean, it should not have {bean}-ias-cmp.xml file. The <persistence-manager> tag should also not be in ias-ejb-jar.xml.  
Environment / Project Options
80854 Within the datasource of XML file, there are two "/" in datasource jndi names  
81005 There needs to be a way to allow the user to update and define datasources in the "iPlanet Application Server 6.0" dialog's Data Sources tab  
81006 There needs to be a way to let the user to update the registered servers in the "iPlanet Application Server 6.0" dialog's Servers tab  
81030 For a web app, there needs to be a way to deploy the war file without executing the web app Execute the web app project even when creating WAR file
Deploy/Execute
80878 The number of the created DD files displayed in the message window during EJB deployment is incorrect  
80901 When creating an iPlanet web application project with the new name, the name is not shown in the project window After project is created, please save the project. The name will appear in the project window.
80978 Receive the following error: cannot logon to localhost:10817 when executing an EJB project when server has been stopped Please make sure that the server is running before executing an EJB project
81224 When doing Project | Execute in iPlanet Server to redeploy an updated web app, redeploys don't take effect. As a result it leads the user to believe the the latest source code is not being used. The first deploy of a module (ejb or war) will work, redeploys will not take effect until the kjs engine is restarted. The kjs engine is restarted if you use the Project | Execute command, but not if you use the Project | Deploy or Project | Execute in iPlanet Server commands.

For the servlets and jsps, there is a flag you can set in the server that changes the server behavior to always load the latest deployed servlet class. The flag is documented in the iAS 6.0 SP2 release notes:
http://docs.iplanet.com/docs/manuals/ias/60/sp2/releasenotes/ias60sp2_rn.htm
81242 Sometimes when executing a web application the browser does not come up. Please open the browser manually before executing the web app
81320 Several menu functions are duplicated in the Project menu:
"Start Application Server" with "Start EJB Server"
"Shut Down Application Server" with "Shut Down EJB Server"		  
81822 The Cancel button on the progress panel that appears while delivering an EJB to the server has no effect. Wait a few minutes and it will be active.
81825 It is not possible to create a WAR or EJB JAR file without deploying to a server. Deploy or execute in the iPlanet Application Server, then use the WAR or JAR file from the Project area.
81827 Servlet name and package name consistency problems. Once a servlet is registered with the application server and a GUID is generated the registered name cannot be changed. You can find the registered name by using kregedit to look at the server configuration and compare the GUID with the GUID from the iPlanet Application Server tab of the Configure Servlets dialog. The registered name is the name that must be used in the Configure iPlanet Web Application dialog and Welcome Files fields. This ensures that the execution opens the browser to the right location. If the names don't match you will see a GX Error (GX2GX)
Miscelleaneous
81823 In CMP implementation, there are problems when the primary key class is used; wherein a primary key class is created with a primary key field Use the patch provided; see the patchreadme.html file located on your CD.
81824 Inner classes do not work correctly in servlets or EJBs in the iPlanet Application Server.  
81828 Cache not refreshed when changing the descriptor in a Web Application or EJB. If you change the descriptor in a Web Application or EJB and redeploy you must restart the kjs process. This is done for you if you use the Execute or Run in Debugger commands, but not if you use the Execute in iPlanet Server command. Changes to your code do not require a restart.
81829 If the directory server is not up on the local machine, VisualCafé does not start up correctly. Make sure the directory server is running and then restart VisualCafé.

Troubleshooting Tips

Remote Debugging: On remote server machine, add the code you want to run into the CLASSPATH, verify that DDServices and debugvm start, kill the kjs process. Please see the <VC>\IASVCPlugin\install.html for instruction of installing the Remote Debugging Services and <VC>\IASVCPlugin\tutorial.html for the detailed steps about how to do Remote Debugging.

Fine tuning of descriptors: Use the iPlanet Deployment Tool for access to more descriptor fields such as security settings.

GX error: Encountered when the servlet is not on the server or is referenced using the wrong name. Check the names and verify that it was actually deployed.

Bind error: Encountered if a servlet is accessed when kjs is not ready or not running. Reboot your application server to eliminate this problem.

More server-side feedback: Instead of starting the server as a service, use the command kas -debug. This runs the server in a command window where more detailed error messages are displayed allowing you to verify the activity of the server. The stop server menus will not be able to stop the server if you start it this way.

More information: To get more messages from VisualCafé Enterprise Edition, add JAVA_COMPCMD=STACKTRACE at the end of your sc.ini file.

Reporting Problems

Online and telephone Technical support can be found at: http://iplanet.com/support/online/

For More Information

For all iPlanet Developer Pack documentation, including updated release notes for the integration for WebGain Studio, refer to: http://docs.iplanet.com/docs/manuals/ide/

Copyright © 2001, Sun Microsystems Inc. All rights reserved.
Copyright © 2001, Netscape Communications Corporation. All rights reserved.

Sun, Sun Microsystems, the Sun logo, Java, iPlanet, and the Sun, Java, and iPlanet-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

Netscape and the Netscape N logo are registered trademarks of Netscape Communications Corporation in the U.S. and other countries. Other Netscape logos, product names, and service names are also trademarks of Netscape Communications Corporation, which may be registered to other countries.