Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Getting Started : Managing Applications Using bcappmanage

Managing Applications Using bcappmanage
TIBCO BusinessConnect Scripting Deployment cannot be used for the initial TIBCO BusinessConnect application installation and configuration, which must be performed in the TIBCO BusinessConnect GUI using TIBCO Administrator. After you have used the GUI interface to install and configure the application, you can use either the same GUI or the command line interface to perform management and deployment tasks. Before performing any of the listed tasks, make sure to first provide information for the file commonConfig.properties. More details about this configuration file are available in Chapter 3, Parameters for commonConfig.properties.
All parameters in the file commonConfig.properties will be validated by TIBCO Runtime Agent. If any of the required parameters are missing or have been entered in a format that is not acceptable, TIBCO Runtime Agent will throw an error or insert default values, where appropriate.
To see the completed file commonConfig.properties with added parameters, see Appendix B, Configuration Properties File.
Task A: Preparing for Deployment
To prepare for configuration of a TIBCO BusinessConnect application using TIBCO BusinessConnect Scripting Deployment, the deployment configuration and configuration repository need to be exported. Both tasks are required and can be done in any order.
1.
bcappmanage -exportDeployConfig
The generated XML file will be used during the task invoked by the command -importDeployConfig. Repeat the command -exportDeployConfig if any of the configured deployment parameters have changed.
The complete command reference is available in -exportDeployConfig.
2.
bcappmanage -exportConfigRepo
This task is used for generating CSX configuration export files from the TIBCO BusinessConnect configuration repository. It supports four main categories: participants, operations, certificates, and entire installation.
The complete command reference is available in -exportConfigRepo.
Task B: Deploying and Managing TIBCO BusinessConnect Applications
Once the configuration repository and the deployment configuration are exported for the selected application categories, you can install, deploy, and manage the TIBCO BusinessConnect application.
1.
bcappmanage -createInstallation
Same as the Initialize Database task in the TIBCO BusinessConnect GUI, this task creates the TIBCO BusinessConnect installation. The complete command reference is available in -createInstallation.
2.
bcappmanage -activateProtocol
This task allows activation in one pass for all available protocol plugins installed on the machine where bcappmanage is running. The complete command reference is available in -activateProtocol.
3.
bcappmanage -createTables
This task is optional and is not needed when the audit, non-repudiation, and runtime data will be stored in the database account that is the same as the account of the configuration store. The complete command reference is available in -createTables.
4.
bcappmanage -importConfigRepo
Imports the previously exported configuration repository saved as a CSX file. The complete command reference is available in -importConfigRepo.
5.
bcappmanage -createApp
Creates deployment configuration for a TIBCO BusinessConnect application service. The complete command reference is available in -createApp.
6.
bcappmanage -extractConfigData
Extracts configuration data of the participants, agreements, transports, operations and the associated bindings from TIBCO BusinessConnect configuration store. The extracted data is stored as key-value pairs in Configuration Store Reporting Schema and can be queried for generating JasperReports. The complete command reference is available in -extractConfigData.
7.
bcappmanage -importDeployConfig
Imports the previously exported deployment configuration in XML format and also does machine assignments. Names of the Interior hosts in the commonConfig.properties file must be specified exactly as they are shown on the screen Resource Management > Machines in TIBCO Administrator. Same needs to be ensured for all property settings that use the machine names in their key. To learn more about machine bindings, see Binding Maps. The complete command reference is available in -importDeployConfig.
8.
bcappmanage -configFTClusterMap
This command is optional. It configures mappings of machines to fault-tolerant groups and mappings of fault-tolerant groups to Public Smart Routing clusters.
Configuration of fault-tolerant clusters for Public Smart Routing with TIBCO BusinessConnect Scripting Deployment requires the machine bindings of service instances be configured during the –importDeployConfig task. This tool does not recognize machine bindings that are configured using the TIBCO BusinessConnect administration console GUI. The complete command reference is available in -configFTClusterMap.
9.
bcappmanage -deployApp
This command corresponds to the Deploy task in the TIBCO BusinessConnect GUI and deploys the TIBCO BusinessConnect application service with an option to suspend starting of all service instances on deploy. The complete command reference is available in -deployApp.
10.
bcappmanage -startApp
This task can be used for starting the TIBCO BusinessConnect engines deployed in scripted mode. The options define whether an individual engine or all engines will be started, and also whether these engines are on the Interior server. The complete command reference is available in -startApp.
Task C: Preparing and Managing Gateway Server Tokens
Once the Interior Server is deployed and running, you can create the Gateway Server token and use it to start and deploy the Gateway Server. Two commands for managing these tokens have been supplied:
Other Management Tasks
These tasks are dedicated to managing configured and deployed applications:

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved