test

Sun GlassFish Web Space Server 10.0 Release Notes

Chapter 3 Sun GlassFish Web Space Server 10.0 Known Issues and Limitations

This chapter describes known issues and limitations for the Sun GlassFish Web Space Server 10.0 software.

Installation Issues


The Sun GlassFish Web Space Server does not get installed when you use Application Server 9.1.1 Enterprise Edition as the web container.

Description:

When you install Application Server 9.1.1 Enterprise Edition and run the install.xml file from websynergy-for-gfv2.zip, you will get the following exception.


install:
   [mkdir] Created dir: /var/tmp/root/websynergyinstall

update-glassfish:
    [exec] CLI168 Could not delete the following jvm options. Options do not exist:
    [exec] -client
    [exec] CLI137 Command delete-jvm-options failed.
    [exec] Result: 1
    [exec] CLI167 Could not create the following jvm options. Options exist:
    [exec] -server
    [exec] CLI137 Command create-jvm-options failed.
    [exec] Result: 1
    [exec] server.log-service.module-log-levels.property.debug.com.sun.portal.
		portletcontainer = WARNING
    [echo] Stopping GlassFish...
    [echo] Execute /opt/SUNWappserver/bin/asadmin stop-domain if install hangs.
    [exec] Domain domain1 stopped.
Solution:

Perform the following steps to install Sun GlassFish Web Space Server on Application Server 9.1.1 Enterprise Edition.

  1. Install the Application Server 9.1.1 Enterprise Edition.

  2. Download webspace-for-gfv2.zip and unzip the bundle.

  3. Add the following code to the server.policy file.


    grant codeBase "file:${com.sun.aas.instanceRoot}/lib/-" {
   permission java.security.AllPermission;
};
// permissions for WebSynergy
grant codeBase "file:${com.sun.aas.instanceRoot}/applications
/j2ee-modules/webspace/-" {
permission java.security.AllPermission;
};

grant codeBase "file:${com.sun.aas.instanceRoot}/applications
/j2ee-modules/saw-web/-" {
permission java.security.AllPermission;
}; 
// Basic set of required permissions granted to all remaining code
grant {
...............
...............
permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
};

  4. Update the portal-ext.properties file (available at webspace-for-gfv2/webspace/application/distribution/deploy/webspace/WEB-INF/classes/) with the following code.


    auto.deploy.glassfish-tomcat.jee.dm.id=deployer:Sun:
AppServer::localhost:4848:https
    Note –

    You need to add the above code in the portal-ext.properties file, only if the value of the security-enabled property is “true”.

  5. Run the ant -f install.xml command from the webspace-for-gfv2/webspace/application directory.


Harmless warning messages appear when you run install Sun GlassFish Web Space Server on Application Server 9.1.1 Enterprise Edition.

Description:

When you run the install.xml file from Sun GlassFish Web Space Server core bundle on Application Server 9.1.1 Enterprise Edition, you will get the following warning messages, which are not harmful to your installation.


update-glassfish:
     [exec] CLI168 Could not delete the following jvm options. Options do not exist:
     [exec] -client
     [exec] CLI137 Command delete-jvm-options failed.
     [exec] Result: 1
     [exec] CLI167 Could not create the following jvm options. Options exist:
     [exec] -server
     [exec] CLI137 Command create-jvm-options failed.
     [exec] Result: 1
     [exec] server.log-service.module-log-levels.property.debug.com.sun.portal.
		 portletcontainer = WARNING
     [echo] Stopping GlassFish...
     [echo] Execute /opt/SUNWappserver//bin/asadmin stop-domain if install hangs.
     [exec] Domain domain1 stopped.

The reason for these harmless warning messages is that when the installer tries to update the JVM options in GlassFish, asadmin may output warnings about JVM options that it cannot change. For example, the installer tries to replace -client with -server. However, on Application Server 9.2 Enterprise Edition, -client has already been replaced with -server. So asadmin will output warning that it cannot find -client to remove and that it cannot add -server since it is already present.


Using the Apache Ant that ships with the GlassFish web container causes error while you run the asadmin start-domain command.

Description:

If the version of the Apache Ant that ships with the GlassFish web container is in your installation path, then the ./asdamin start-domain command will fail to execute and you cannot deploy the Sun GlassFish Web Space Server.

Solution:

Download the Apache Ant 1.7 or later version and place it in the installation path. Moreover, you need to set ANT_HOME to the directory where you have placed the downloaded Apache Ant 1.7 or later version.


All the Sun GlassFish Web Space Server WAR files failed to deploy on Red Hat Enterprise Linux (RHEL)and SUSE Linux versions.

Description:

When you install the Sun GlassFish Web Space Server with GlassFish web container on the RHEL and SUSE Linux operating system versions, all the WAR files are not deployed. This issue occurs when the maximum limit for open files is not sufficient to deploy the WAR files.

Solution:

To increase the maximum limit for open files on the RHEL and SUSE Linux versions:

  1. Add the following two lines to the /etc/security/limits.conf file.

    • * soft nofile 5000

    • * hard nofile 5000

  2. Restart the system.


The existing parameters in the input.properties file prevents the installation of Sun GlassFish Web Space Server on a second web container instance.

Description:

When you install the Sun GlassFish Web Space Server on the GlassFish web container and try to install again on another web container, you will not be prompted to enter new parameters for the second instance. The installation procedure in the second instance considers the parameters that are already provided in the first instance. This issue prevents the installation of Sun GlassFish Web Space Server on a second web container instance.

Solution:

Remove the input.properties file from the ../etc/webspace/application/ directory and install the Sun GlassFish Web Space Server on a second web container instance.

GlassFishRegistration Portlet Issue


The GlassFishRegistration portlet in Sun GlassFish Web Space Server does not work with JDK1.6

Description:

When you register for a new account in the GlassFishRegistration portlet in the Sun GlassFish Web Space Server, you will get the following error message.


An error has occured while processing your request
Error Details : java.security.cert.CertificateException:
The certificate chain from the server is not trusted
Solution:

Restart the GlassFish server for the registration to work.

Localization Issues


Multi Lingual version of GlassFish V2 needs to be shipped with the Sun GlassFish Web Space Server.

Description:

The Image Packaging System (IPS) needs to be updated with the Multi Lingual package of GlassFish V2, which can be picked up by the Sun GlassFish Web Space Server. This allows a user to use the Administration console and other features in GlassFish V2 in the native language.

Solution:

These are the two options to solve this issue.

  • When the Multi Lingual packages are available in the GlassFish Update Centre, you can use the IPS update to update the GlassFish install with Multi Lingual features.

  • You can download and install the Multi Lingual version of GlassFish V2 and then install Sun GlassFish Web Space Server.


Multi Lingual labels of Tag name and Search option are corrupted in the WebContent, Wiki, and Blog portlets.

Description:

The Multi Lingual labels of Tag name and Categories that are available in the WebContent, Wiki, and Blog portlets are corrupted.

Solution:

Create the Tag name and Categories in English language.

Other Issue


To enable the Map and IPGeocoder portlets, you need to install MaxmindGeoIP city or GeoLite City.

Description:

When you add the Map and IPGeocoder portlets to a portal page, a message appears in both the portlets to install and configure MaxmindGeoIP city or GeoLite City.

For More Information About Sun GlassFish Web Space Server

Thanks for evaluating Sun GlassFish Web Space Server 10.0. For the most recent updates on this project, see the Sun GlassFish Web Space Server home page. Visit the following web sites for more information about products that might be useful while you evaluate Sun GlassFish Web Space Server.