Deploy runtime on GAS

This procedure shows you how to upgrade the GBC runtime package to the latest release and set it as the default.

NOTE : To understand the syntax diagrams, see Syntax diagrams.

With each update of the GBC client, you can deploy the GBC runtime package to the Genero Application Server (GAS) in order to use the latest version of the GBC client without any customization. You can do this using the command line or the DeploymentApp.

Before you begin, go to the Four Js Product Download Area and download the latest GBC runtime package: Genero Browser Client - Runtime package - Every OS.

Using the command line

  1. Set your environment by running the envas script ($FGLASDIR/envas or $FGLASDIR/envas.bat) for your GAS installation.

  2. From a command prompt, deploy the GBC runtime package using the gasadmin command.

$ gasadmin gbc --deploy fjs-gbc-<version>[.<suffix>]-build<build>-runtime.zip

TIP : The name of the runtime identifies the deployed GBC package. The default name can be lengthy. You may want to rename the GBC runtime package to use a simpler (and shorter) name before you deploy.

  1. Specify this package as the default GBC client using the gasadmin command.
$ gasadmin gbc --default fjs-gbc-<version>[.<suffix>]-build<build>-runtime.zip
  1. View the list of deployed GBC clients.
$ gasadmin gbc --list
  1. When the GBC is deployed, you can render your application using the default GBC with the following URL:

http://my.server.com:6394/ua/r/*appName`*

TIP : You can continue to use any (previously) deployed Genero Browser Clients by adding the URL parameter gbc=deployed_gbc_name to the end of the URL: http://my.server.com:6394/ua/r/appName?gbc=gbc-1.00.44

Using the DeploymentApp

NOTE : If you are not using GAS 3.20 or greater, the DeploymentApp may not be available. Consult the Genero Application Server User Guide for further details.

NOTE : You must set up the Genero Identity Provider (GIP) in order to have the DeploymentApp. Consult your GAS manual for further details.

  1. Ensure the Genero Application Server (GAS) is running.

  2. Enter the URL for the Genero DeploymentApp:

    http[s]://server:port>[/gas]/ua/r/admin/DeploymentApp

  3. Deploy the new browser client:

    1. Click Deploy and select Genero Browser Clients.
    2. Click Deploy.
    3. Select the GBC client by dropping or uploading a file.

The GBC client is listed under the Genero Browser Client(s) section.

TIP : The name of the runtime identifies the deployed GBC package. The default name can be lengthy. You may want to rename the GBC runtime package to use a simpler name. Double-click the name in the GBC client's row and enter a new name.

  1. To make this GBC client the default GBC client for applications, select the client in the Genero Browser Client(s) section and click Set as Default.

TIP : You can continue to use any (previously) deployed Genero Browser Clients by adding the URL parameter gbc=deployed_gbc_name to the end of the URL: http://my.server.com:6394/ua/r/appName?gbc=gbc-1.00.44