Deploy the GBC from the command line

You can deploy a GBC client from the command line with the gasadmin gbc --deploy command and options. The GBC client must be packaged as a runtime package.

Tip:

If you installed the Genero Identity Provider, you have access to the Genero Deployment App. The Deployment App provides a browser-based graphical interface that simplifies deploying and managing GBC clients. Go to Deploying and managing the GBC in the Single sign-on User Guide for more information. The gasadmin tool does not require the Genero Identity Provider.

As a prerequisite, the GBC client must be a runtime package, which is packaged as a zip file. For details about creating a GBC runtime package from your GBC customization project, see the Genero Browser Client User Guide.

To run the gasadmin command, you must have the environment for the GAS. If you are using the Genero Workplace Window, your environment should be set; otherwise, you must set the GAS environment. Set the GAS environment by executing the script $FGLASDIR/envas (Unix, Linux, MacOS) or $FGLASDIR/envas.bat (Microsoft® Windows).

Deploy a GBC client

To deploy a GBC, you specify the path and filename:
gasadmin gbc --deploy path-to-gbc-archive

Example: Deploy GBC

This example uses the gasadmin gbc --deploy command to deploy a GBC client on the GAS.
gasadmin gbc --deploy c:\fjs\gbc-projects\gbc-5.00.08\archive\custA.zip

List deployed GBC clients

To list all deployed GBC clients:
gasadmin gbc --list
All deployed GBC clients are listed, with the default identified.

In addition, the static GBC included with FGLGWS is identified.

Set a GBC client as the default

To set a deployed GBC client as default:
gasadmin gbc --default gbc-name

Use the --list option to verify the setting worked.

Example: Listing GBC clients and setting a default

These examples show how you can use gasadmin gbc command options to list the deployed GBC clients and set a default client on the GAS.

gasadmin gbc --list 
gasadmin gbc --default custB
Figure: List deployed GBC and set default

Image shows the result of the gasadmin commands to list deployed GBC and to set the default client