Generate Bookstore Application Configuration
The Bookstore sample application is provided at amsgce-runtime-<version>\samples\bookstore\com.tibco.restbt.sample.bookstore
Before creating the bookstore application Docker image, you must generate the application configuration from application DAA. Application configuration contains the YAML file and, Log4j configuration (optional), and JVM parameters files(optional).
You can generate application configuration in one of the following ways:
- Using Application Configurator UI
- Using DAA2Config command-line tool
- If the Bookstore application is already running in ActiveMatrix Service Grid 3.x setup, you can extract the application configuration by using the Application Extractor tool. See Application Extractor Tool.
Generating Application Configuration from the GUI (Application Configurator)
In this tutorial, you will upload the Bookstore application DAA to Application Configurator and complete the required configuration.
Procedure
-
Access the Application Configurator UI by navigating to
http://<hostname>:8087/appconfig/. -
Upload the bookstore application DAA in Application Configurator.
-
Complete the required configuration. For information, see TIBCO ActiveMatrix® Service Grid - Container Edition Administration.
- Download the application configuration
.zipfile to your machine.
The downloaded .zip file contains the application DAA, application configuration YAML file, and optionally, Log4j configuration file and JVM arguments file. Specify the path of this .zip file in the next step to build the Bookstore application image.
Generating Application Configuration from the CLI (DAA2Config)
Instead of using the Application Configurator, you can use DAA2Config command-line tool to generate the application configuration YAML file with default values. In this tutorial, you will use DAA2Config command to generate the application configuration YAML file.
Procedure
- Navigate to the
amsgce-runtime-<version>\daautil\binfolder. -
Run the following command to generate the YAML file from DAA:
You can check the parameters to pass to the command by running the
./DAA2Config.sh helpcommand.For Linux Platform:
./DAA2Config.sh -daaFile /home/amsgce-runtime-1.0.0/samples/bookstore/com.tibco.restbt.sample.bookstore/Deployment Artifacts/com.tibco.restbt.sample.bookstore.daa
For Windows Platform:
DAA2Config.bat -daaFile C:\amsgce-runtime-1.0.0\samples\bookstore\com.tibco.restbt.sample.bookstore\Deployment Artifacts\com.tibco.restbt.sample.bookstore.daa
The YAML file, node JVM parameters configuration file, and Log4j configuration file with default values are generated in the output location provided. If no output location is provided, all files are generated in the same folder where the DAA file is located.
-
To update the YAML file, you can use the text editor. After updating the YAML file, validate the configuration by using the
checkConfigcommand.For Linux Platform:
./checkConfig.sh -daaFolder "/home/apps/bookstore" -debug true
For Windows Platform:
checkConfig.bat -daaFolder "C:\home\apps\bookstore" -debug true
In the next step, specify the path of the folder containing the application configuration to build the Bookstore application image.