Set default GBC client from the command line

Use the gasadmin gbc --default command to set the default GBC client for applications delivered by the GAS.

Before you begin:

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.

This procedure assumes you are connecting to a local GAS.

As a prerequisite, you have deployed the GBC client on the GAS. Confirm by executing gasadmin gbc --list.

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).

Steps

From a command prompt, execute the gasadmin gbc --default command and provide the GBC client name.
For example, to specify the GBC client named "my-gbc" as the default, execute:
```
gasadmin gbc --default my-gbc
```
Verify the default has been set using gasadmin.
```
gasadmin gbc --list
```

Next steps

Once you have completed your configuration, you can verify that the correct GBC client is used. Enter the application URL in a browser; this example uses the local standalone dispatcher:

http://localhost:6394/ua/r/myapp.

To find out which GBC client is being used, click on the Settings icon. In the dialog that opens, the version information is displayed. It contains the GBC version number appended with the customization suffix defined in the GBC customization being used. It also provides the build timestamp of the customization package.

If your application does not load, the issue may be with your customized GBC runtime package. See topics such as Fix configuration issues in the Genero Browser Client User Guide.