GAS 3.00 upgrade guide

Complete these tasks when migrating to Genero Application Server 3.00 from version 2.50. 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.

Client scope (protocols)

The FGLGWS package includes both Genero Business Development Language and Genero Web Services.

Table 1 shows the protocols and front-ends that are supported with FGLGWS 3.00.
Table 1. FGLGWS 3.00 and client protocols
Protocol Clients
ua GDC 3.00, GWC-JS, GMA, GMI
ws GWS
Table 2 shows the protocols and front-ends that are supported with FGLGWS 2.50.
Table 2. FGLGWS 2.50 and client protocols
Protocol Clients
ja GDC 2.50
wa GWC-HTML5
Important: Web services (ws) with GAS 3.00 are supported with FGLGWS 3.00 DVM only.
Important: If you wish to use GWC-HTML5 or GDC 2.50 with GAS 3.00, you must work with FGLGWS DVM 2.50.

What does this mean for your upgrade to 3.00? Links that previously used "wa" should now use "ua" instead. See Application URIs for more information on including the scope in a URI.

IIS configuration no longer automatic

The IIS automatic configuration has been removed from the installation process. Manual configuration is required.

Genero Web Client

Genero Web Client for JavaScript (GWC-JS) will be the default rendering for Genero Web Client applications, replacing Genero Web Client for HTML5 (GWC-HTML5 ). New development should use GWC-JS.

Document your existing customization under GWC-HTML5, and determine what needs to be reimplemented with GWC-JS.

Genero Desktop Client ActiveX (GDCAX) is desupported

For new development, use GWC-JS.

Single Sign-On Authentication

The Kerberos authentication mechanism for Single Sign-on authentication is deprecated. Any new development requiring Single Sign-on should plan to use OpenID Connect, SAML or OpenID. See How to implement Single sign-on (SSO). For alternative solutions, please contact your Four Js support center.

Java Dispatcher

Note: The Java dispatcher is no longer used. Please see Java Servlet Installation and Web Server Configuration topics in the Genero Application Server 3.00 User Guide.
For Genero 3.0, the Java Dispatcher, requires at least version 3.0 of the Java servlet API. This is supported on the following Java web servers:

Web Server side Resources

In GAS 2.50, using gwcproxy and html5proxy proxies, the path to the image directory is configured to fetch resources on the Web server side in the PATH element, see PATH with Type WEBSERVER.
<PICTURE>
    <PATH type="WEBSERVER">a_uri</PATH>
</PICTURE>
This is usually configured to improve performance. The Web server delivers static files or images instead of the GAS.
With GAS 3.00, for uaproxy, all the resources are delivered by the GAS. By default the application's public directory is defined by the PUBLIC_IMAGEPATH in FGLASDIR/etc/as.xcf configuration file:
<PUBLIC_IMAGEPATH>$(res.public.resources)</PUBLIC_IMAGEPATH>
Note: $(res.public.resources) defaults to the path appdata/public/common, see PUBLIC_IMAGEPATH.

If you use Genero Archive you can specify public resources for your applications by adding a RESOURCES element in the Genero Archive manifest. Then the resources are copied in FGLASDIR/appdata/public/deployment/deployappname, where "deployappname" is the name given to the deployed application directory by the Genero Archive. See Resource deployment overview.

Web Components

In GAS 2.50, web components are deployed under $FGLASDIR/web/components directory, see WEB_COMPONENT_DIRECTORY.

Starting from GAS 3.00, with uaproxy, the default path for a web component is appdir/webcomponents, where "appdir" is the application directory. See the WEB_COMPONENT_DIRECTORY element in your FGLASDIR/etc/as.xcf configuration file:
<WEB_APPLICATION_EXECUTION_COMPONENT Id="cpn.wa.execution.local">
   […]
   <DVM>$(res.dvm.wa)</DVM>
   <WEB_COMPONENT_DIRECTORY>$(application.path)/webcomponents</WEB_COMPONENT_DIRECTORY>
</WEB_APPLICATION_EXECUTION_COMPONENT>
You can change the default web components location by configuring a WEB_COMPONENT_DIRECTORY element in your application's configuration. In this example, the web component is no longer located in appdir/webcomponents but in appdir/mycomponents.
<APPLICATION Parent="defaultgwc" …>
  <EXECUTION>
    <PATH>/home/myapp</PATH>
    <MODULE>myapp</MODULE>
   <WEB_COMPONENT_DIRECTORY>/home/myapp/mycomponents</WEB_COMPONENT_DIRECTORY>
  </EXECUTION>
</APPLICATION>

For more details on Web component usage, see the Genero Business Development Language User Guide.

Genero Web Client hybrid mode (deprecated)

The GWC hybrid mode feature has been deprecated. Applications for Android™ or iOS mobile platforms which used the GWC hybrid mode will need to use the more-featured GMA or GMI instead. If you do not have equivalent features in GM, contact your local Four Js support center.

GWC-JS LOOKUP PATH

The GWC_JS_LOOKUP_PATH is a new mandatory element in as.xcf. If you are upgrading to GAS versions 3.00.11 or later and wish to keep your existing as.xcf configuration file, you need to add this element to the INTERFACE_TO_CONNECTOR element. Otherwise, you will see the following error message at GAS startup:
Application Server startup . ........................................... httpdispatch
"Configuration ERROR" Code:1871 Message:Element 'TEMPORARY_DIRECTORY': This element is not expected. 
 Expected is ( GWC_JS_LOOKUP_PATH ).
[fail]  httpdispatch "Main Configuration"
Cannot build main configuration 
To find your GAS version, at the command line run:
gasadmin -V
For more information on the gasadmin tool, see The gasadmin command topic.