GAS 3.21 upgrade guide
These topics describe product changes you must be aware of when upgrading to version 3.21.
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 3.21 new features.
Previous upgrade guide: GAS 3.20 upgrade guide
Argument added to gasadmin gar --list-archives command
Starting from GAS 3.21.02, GAS 4.01.07, and GAS 5.00.02, the gasadmin gar --list-archives command is enhanced to take an argument with options to display information for the deployed archives you specify. Previous to this, the command displayed information for all archives deployed on the GAS.
For more information see gasadmin.
Argument added to gasadmin gar --clean-archives command
Starting from GAS 3.21.02, GAS 4.01.07, and GAS 5.00.02, the gasadmin gar --clean-archives command is enhanced to take an argument with options to specify the undeployed archives you want removed. Previous to this, the command cleaned/removed all undeployed archives on the GAS.
For more information see gasadmin.
Changes to gasadmin gar --list-archives command output
Starting from GAS 3.21.02, GAS 4.01.07, and GAS 5.00.02, the gasadmin gar --list-archives command has enhancements to the output listing applications and services available in the GAS. The layout of the display has been improved for better readability.
For more information, go to List deployed archives.
Changes to the OpenIDConnect service configuration
Starting from GAS and FGLGWS versions 3.21.02, 4.01.07, and 5.00.02, two parameters of the Genero OpenIDConnect service configuration ($FGLDIR\web_utilities\services\openid-connect\res\configuration) have changes:
- The
oidc.logout.id_token_hint
parameter, used in the logout request sent to the provider, has been replaced byoidc.logout.identifier
. The new parameter supports the values "id_token_hint
", "client_id
", or anempty
(" ") value. The default value is "id_token_hint
". - The
oidc.logout.post_redirect
parameter, used to send the post redirect uri in the logout request, now needs a string value instead of the boolean value true/false on previous versions. The default value is now "post_logout_redirect_uri
".
No action needs to be taken on your part, but if you have previously used a custom OpenIDConnect configuration file and you want to use it when upgrading FGLGWS version, ensure that you review your configuration for these parameters.
For more information on OpenID Connect Single sign-on, go to OpenID Connect/OAuth2 SSO.
New option to list session ids in the gasadmin session command
Starting from GAS 3.21.02, GAS 4.01.07, and GAS 5.00.02, the gasadmin session command has been
enhanced with an option, --list-session-ids
, to output just a list of identifiers
of the active sessions. No proxy details are output, such as the names of the applications or
services, as in the output from the gasadmin session --list-sessions
command.
For more information on gasadmin session commands and examples, go to gasadmin.
New option to count sessions in the gasadmin session command
Starting from GAS 3.21.02, GAS 4.01.07, and GAS 5.00.02, the gasadmin session command has been
enhanced with an option, --count-sessions
, to return a count of the number of
active sessions (applications and services).
For more information on gasadmin session commands and examples, go to gasadmin.
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 3.20 upgrade guide.