GAM applications deployment (X Evolution 3)

The purpose of this document is to explain how to take the binaries to production, of an application that uses GeneXus Access Manager (GAM). To import the data of the GAM database into production, refer to GAM Deploy Tool.

Java applications

• Use WAR deployment wizard and follow steps in Deployment of Java Applications.
• After having created new Repository Connections in the production database, update connection.gam file using Deploy Tool.
• Add connection.gam and application.gam file to the WEB-INF folder. You can do it from the WAR deployment wizard, or manually, by editing the war file. 
• Edit the web.xml in the WEB-INF and add the following lines if they are not already there:

                              <servlet>
                              <servlet-name>GAMOAuthSignIn</servlet-name>
                              <servlet-class>artech.security.api.agamextauthinput</servlet-class>                                                                        
                              </servlet>
                              <servlet>
                              <servlet-name>GAMOAuthCallback</servlet-name>
                              <servlet-class>artech.security.api.agamextauthinput</servlet-class>                                                                         
                              </servlet> 
                              <servlet>
                              <servlet-name>GAMOAuthAccessToken</servlet-name>
                              <servlet-class>artech.security.api.agamoauth20getaccesstoken</servlet-class>                                                                         
                              </servlet>
                              <servlet>
                              <servlet-name>GAMOAuthUserInfo</servlet-name>
                              <servlet-class>artech.security.api.agamoauth20getuserinfo</servlet-class>                                                                         
                              </servlet>
                              <servlet>
                              <servlet-name>GAMOAuthSignOut</servlet-name>
                              <servlet-class>artech.security.api.agamextauthinput</servlet-class>                                                                         
                              </servlet>
                              <servlet-mapping>
                              <servlet-name>GAMOAuthSignIn</servlet-name>
                              <url-pattern>/oauth/gam/signin</url-pattern>
                              </servlet-mapping>
                              <servlet-mapping>
                              <servlet-name>GAMOAuthCallback</servlet-name>
                              <url-pattern>/oauth/gam/callback</url-pattern>
                              </servlet-mapping>
                              <servlet-mapping>
                              <servlet-name>GAMOAuthAccessToken</servlet-name>
                              <url-pattern>/oauth/gam/access_token</url-pattern>
                              </servlet-mapping>
                              <servlet-mapping>
                              <servlet-name>GAMOAuthUserInfo</servlet-name>
                              <url-pattern>/oauth/gam/userinfo</url-pattern>
                              </servlet-mapping>
                              <servlet-mapping>
                              <servlet-name>GAMOAuthSignOut</servlet-name>
                              <url-pattern>/oauth/gam/signout</url-pattern>
                              </servlet-mapping>

NET applications

• See How to deploy .NET (C#) WEB application for information on deploying Net applications.
• After having created new Repository Connections in the production database, update connection.gam file using GAM Deploy Tool. Afterwards add connection.gam file and application.gam file to the virtual directory.
• In case of SD applications, add Metadata folder under the virtual directory.
• In case of SD applications, add gxmetadata folder under the virtual directory, only the <main_object>.<plataform>.json files for security.
• Add all the GAM libraries to the deployment. Depending on the DBMS used, they are located under <GenexusInstall>\Library\GAM\Platforms\. Copy the Artech.Security.*.dll files.

Ruby applications

• Deploy the application as explained here: How to deploy a Ruby application: Linux setup for running Ruby applications
• After having created new Repository Connections in the production database, update connection.gam file using Deploy Tool. Afterwards add connection.gam file and application.gam file to the virtual directory.
• In case of SD applications, add Metadata directory under the virtual directory.
• In case of SD applications, add gxmetadata directory under the virtual directory, only the <main_object>.<plataform>.json files for security.
• Add all the GAM libraries to the deployment. Depending on the DBMS used, they are located under <GenexusInstall>\Library\GAM\Platforms\. Copy all the .rb files.

Important note

In all platforms, take into consideration: Going into production: checklist for Applications using GAM