Deploy on GAS

This procedure deploys the runtime package on the Genero Application Server.

Before you begin

You must have created the GBC runtime package for your customization project.

  1. Change the package name (optional).

    When the GBC runtime package for the customization is created, the filename takes the format: 

    fjs-gbc-version.suffix-buildbuildid-customization_customName.zip
    Tip:

    You can rename this file with a name that is shorter and easier to manage.

    In the steps below, the package name is referred to as customization-name.

  2. Deploy the customization project.

    There are two options for deploying the GBC runtime package:

    • Use your web browser to navigate to the deployment page (typically located at http[s]://server:port>[/gas]/ua/r/admin/DeploymentApp) and upload the customization-name.zip file. This option is only available if you have access to the Deployment App. For more information regarding the Deployment App, refer to the Single Sign-On User Guide.
    • If the Deployment App is not accessible, you must have console access to the server and a way to transfer the customization-name.zip file to the server. When the file is on the server, you execute the following command from the server console to deploy the GBC:
      $ gasadmin gbc --deploy customization-name.zip
    For further details, see the Genero Application Server User Guide.
  3. (Optional) Test the deployed customization.
    When the GBC is deployed, you can render your application using the following URL: 
    http://server-address:6394/ua/r/appName?gbc=customization-name
  4. Use the deployed customization.
    Set the customization as the default: 
    $ gasadmin gbc --default customization-name
    The application should now use the default customization when you run this URL:
    http://server-address:6394/ua/r/appName

    If the application does not display using the specified customization, check that the GAS administrator has not made changes that affect the GBC. For further information about the GBC and GAS administration, see Working with Genero Browser Client (GBC) in the Genero Application Server User Guide.