GAS 3.00 (Maintenance Releases) upgrade guide

Complete these tasks when migrating to Genero Application Server 3.00 Maintenance Releases (MRs) of the GAS from version 3.00. If you are migrating from an earlier version of Genero Application Server, first complete the migration tasks for all versions between your existing version and the target version.

Genero Report Viewer URLs

Starting with GAS version 3.00.12, the report viewer URL prefix /ua/grv that was provided to the Genero Report Engine (GRE) is no longer used.

New URL prefixes provide access to the HTML report viewer implementation and its applications' public and private resources. Different URLs are provided for when the Genero Report Engine is operating in local mode, on the same server as the GAS, or in distributed mode on another server.

The URLs are very similar in structure in each case.

Local /Local Server Mode: /ua/report/viewer; /ua/report/public; /ua/report/private/$(session.id)/reports

Distributed Mode: /ua/report-r/viewer; /ua/report-r/public; /ua/report-r/private/$(session.id)/reports

These URLs are used for the same purpose in local mode as distributed mode, where:

viewer loads the HTML report viewer implementation.
public provides access to shared resources.
private provides access to resources that are private to the application.

For more information see Application URIs and REPORT_VIEWER_DIRECTORY.

Debug mode

Support of "gwc-js.debug" in a GAS configuration file has been dropped. If you have previously used gwc-js.debug to launch GBC applications in debug mode, you must now use an alternate method. See GWC-JS application in debug mode.

HTTP cookie definition

Starting with GAS version 3.00.44, the HTTP_COOKIE element includes the SameSite attribute.

If you are migrating HTTP_COOKIE elements, you may need to set the SameSite attribute. Typically, to avoid cross-site domain errors, you set attribute SameSite=None and ensure all requests are secured and in HTTPS.

For more information see HTTP_COOKIE.

HTTP security header: X-Content-Type-Options="nosniff"

Since GAS versions 3.00.35, for security reasons the default header "X-Content-Type-Options" needs to be set to the value "nosniff". This is the default use in the GAS configuration file (as.xcf):

<HEADER Name="X-Content-Type-Options">nosniff</HEADER>

Use of this header blocks browsers sniffing file types, which is guessing the correct Multipurpose Internet Mail Extensions (MIME) type by looking at the file. The header blocks sniffing of script and style type files.

Warning: On Internet Explorer 11, use of this header may cause images not to be displayed if the image files do not have extensions. To work around this, if your applications need to serve images through Genero Application Server (GAS)JGAS, make sure your image files have extensions.

For more information, see HEADER.

Changes to Apache 2.4 configurations

The Alias directive no longer needs to be set in fastCGI configurations using the mod_proxy_fcgi module. This applies to Apache 2.4 Web server. Lines, such as the following, can be removed from server and virtual host configurations.

Alias /gas /opt/gas/bin/fastcgidispatch

Starting with Apache 2.4.11:

To ensure application URLs with spaces are decoded correctly, proxy-fcgi-pathinfo must be set to unescape.
The enablereuse=on directive can be used in the ProxyPass configuration to recycle connections to the fastcgi dispatcher.

For more information on Apache 2.4 Web server configuration, see Apache 2.4: mod_proxy_fcgi.

Note: For more information on the Apache modules and directives, refer to the Apache documentation.

REQUEST_RESULT default now 45 seconds

Starting with GAS 3.00.46, the default value for REQUEST_RESULT changed from 60 seconds to 45 seconds. For more details, see REQUEST_RESULT (for an application).