GAS 5.00 upgrade guide

These topics describe product changes you must be aware of when upgrading to version 4.01.

Important:

This incremental upgrade guide covers only topics related to the Genero Application Server (GAS) version specified in the page title. Check prior upgrade guides if you migrate from an earlier version, and complete the migration tasks for all versions between your existing version and the target version, in order. Make sure to also read about the new features for this version.

Corresponding new features page: GAS 5.00 new features.

Previous upgrade guide: GAS 4.01 upgrade guide

New GAS server port resource: res.ic.server.port

Previously, the res.ic.base.port and res.ic.port.offset resources were used to set the GAS server port:
<TCP_BASE_PORT>$(res.ic.base.port)</TCP_BASE_PORT>
<TCP_PORT_OFFSET>$(res.ic.port.offset)</TCP_PORT_OFFSET>
These resources are no longer available in the GAS configuration file (as.xcf). The GAS server port configuration is now set by the res.ic.server.port resource. 
<TCP_SERVER_PORT>$(res.ic.server.port)</TCP_SERVER_PORT>

The res.ic.server.port is set to 6394 by default. No action needs to be taken on your part, but if you have previously used res.ic.base.port and res.ic.port.offset to set the port or to override the GAS default server port, you will need to change to using res.ic.server.port.

Desupported GAS resources

The following two resources used in combination to set the GAS server port, are now desupported:
  • res.ic.base.port
  • res.ic.port.offset
In new development, use res.ic.server.port in place of these.

New GAS configuration element: TCP_SERVER_PORT

The GAS server port configuration is now configured by the TCP_SERVER_PORT element, replacing the TCP_BASE_PORT and TCP_PORT_OFFSET elements, which are no longer available.

Desupported GAS configuration elements

The following two elements used in combination to set the GAS server port, are now desupported:
  • TCP_BASE_PORT
  • TCP_PORT_OFFSET
In new development, use TCP_SERVER_PORT in place of these.

URL parameter argument key "arg" changes

Previously, in order to provide parameters in the application URL, you needed to provide the query string key-value pair using the key "Arg" with first letter in uppercase. Now the key can start with either an uppercase or a lowercase first letter; either "arg" or "Arg" is acceptable. This change allows consistency with other query string keys used for Genero Browser Client, such as "debugMode", "recordGdcLog", and "gbc".

For examples of use, see PARAMETERS and Running applications with arguments set in the URL.

Simplified log categories

The log categories, as defined in the CATEGORIES_FILTER element, which specify the type of message written to the log, are simplified down to the following categories: ERROR, WARNING, INFO, DEBUG

If you have previously used categories such as MUTEX, SESSION, GAS, LOG, CONFIGURATION, DEPRECATED, PROCESS, VM, FT, ACCESS, HTTP, SOCKET, TASK, TEMPLATE, TIMER, or WA, these categories are no longer available and the following changes apply:
  • ACCESS and GAS categories are now logged as INFO
  • MUTEX, SESSION, LOG, CONFIGURATION, DEPRECATED, PROCESS, VM, FT, HTTP, SOCKET, TASK, TEMPLATE, TIMER, WA are now logged to DEBUG.

The ALL category acts as a pseudo category to enable ERROR, WARNING, INFO, DEBUG.

In the log messages, the columns or field identifiers "category" and "component", previously defined in the FORMAT element, have been removed. For more information, see CATEGORIES_FILTER and FORMAT.

Demos application Id change

In the GAS configuration file, the demos application's Id has changed from "gwc-demo" to "demo". To view the change and understand its impact, go to Access demo applications with the Genero Browser Client.

Single sign-on (SSO) now has its own manual

Single Sign-on topics are no longer included in the Genero Application Server User Guide. SSO is now documented in the Single Sign-On User Guide.

Changes in earlier versions

Make sure to check the upgrade notes of earlier versions, to not miss changes introduced in maintenance releases. For more details, see GAS 4.01 upgrade guide.