In one of my previous tutorials, I explained the steps to deploy EAR in a TIBCO Domain using Administrator GUI. Now in this step by step tutorial, I am going to explain how you can deploy EAR in a domain using Appmanage utility through command line.
What is AppManage Utility?
Appmanage is a utility which is available in the bin folder of TRA and can be used to extract deployment configurations from EAR and to deploy EAR in administration domain through command line.
Appmanage utility can also be used to undeploy an application from domain, delete application from domain and to start and stop application services from Tibco administrative domain.
Now after explaining basics of Appmanage utility and its usage, let’s proceed with step by step tutorial of deploying EAR to administrator domain using Appmanage utility commands.
Step 0: Develop a Simple Application in TIBCO Designer and Create EAR File
I am calling this step as Step 0 as Its not part of actual deployment, rather its kind of a pre-requisite as we need to first have a EAR available. For this example case, I just created a simple HTTP Application by designing a TIBCO process that receives a HTTP Request on a given port and then sends back a response using Send HTTP Response activity.
I am not going to explain the steps of EAR creation in this tutorial as that has been explained in one of my previous tutorials already.
For this tutorial, we just proceed from the point where we have EAR file already created with the name HTTPTest.ear
Step 1: Export Deployment Configuration from EAR using Appmanage Utility
As I mentioned earlier that AppManage utility can be used to export deployment configuration information from a EAR. For our case, we want to extract deployment configurations from the EAR HTTPTest.ear to a file (HTTPTestConfig.xml).
Below command will extract the configurations and save the XML in the given directory:
AppManage -export -out D:\Data\-ear HTTPTest
Please note that in order to run the above command, you should first move to the bin folder of TRA where AppManage utility is present. (It is in the location TIBCO_HOME/TRA/5.xx/bin/)
Once you h ave exported configurations in an XML file, you can make any changes in the file before proceeding to the deployment step. (e.g. you may need to make changes to some global variables like HTTP Port or Host name before deployment).
Step 2: Deploy EAR using AppManage Utility
In order to deploy EAR to administration domain, we use below command:
AppManage -deploy -ear D:\Data\-deployConfig -app HTTPTestApp -user admin -pw admin -domain TIBCO_AJMAL
Explanation of different arguments of the above command is given below:
-ear : Specify name of the EAR to be deployed
-deployConfig : Specify deployment confguration file to be used for deployment of EAR
-app : Specify the name of the application once it will be deployed
-user :User name of TIBCO administrative domain
-pw : Password of domain
-domain : Name of domain in which application should be deployed
As you can see in below screenshot that command has run successfully and has deployed the application in the domain specified:
You can verify the correct deployment of the application by going to TIBCO Administrator and check under Application
This completes tutorial on EAR deployment using Appmanage utility. I hope it will be useful for you. Feel free to comment/contact for any further help. Thanks