TIBCO AppManage Utility EAR Deployment Step By Step Tutorial

By | February 4, 2015

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\HTTPTestConfig.xml -ear HTTPTest.ear

appmanage utility export configuration from ear

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\HTTPTest.ear -deployConfig D:\Data\HTTPTestConfig.xml -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:

tibco appmanage deploy ear using command line


You can verify the correct deployment of the application by going to TIBCO Administrator and check under Application

deployed application using appmanage in tibco


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

Ajmal Abbasi

Ajmal Hussain Abbasi is Integration Consultant By Profession with more than 7 years experience in TIBCO products. He has extensive practical knowledge of TIBCO Business Works, TIBCO Spotfire, TIBCO BE, EMS and TIBCO ActiveSpaces. He has worked on a number of highly critical integration projects in Telecom sector by using his skills in Tibco Designer, Adapters, TIBCO EMS, RV, Administrator, TIBCO BE, TIBCO ActiveSpaces etc. Ajmal Abbasi is also experienced in developing solutions using Oracle PL/Sql, Linux and Java. You can contact Ajmal Abbasi for Consultancy, Technical Assistance and Technical Discussions.

More Posts - Website - Facebook - LinkedIn

17 thoughts on “TIBCO AppManage Utility EAR Deployment Step By Step Tutorial

  1. Chandan

    Thanks for the details. I am new here.
    Do we have any place where Tibco does the build as well. Build when i said, it means, build of ear file.

      1. Chandan

        We want to use Jenkin tools for build, is it something would you able to advice with Tibco?

  2. SB

    how take export only configuration of all deployed BW process with appman

    1. Kishor Ugale

      HI As per my understanding, only export of Configuration file of all Deployed BW Process is not possible, but you can use the batch export commands to export all the ear files and configuration files of deployed BW Process, there you can filter for only for configuration files, hope this solution will work for your requirement.

  3. devict

    Thanks for the post !
    I have one question though, is it possible to specify the java heap space parameter when deploying an application ? It can be found inside the “tra/domain//application//.tra” configuration file

  4. muonsha

    no matching s/w for service archive Process Archive . the service is disabled

    I am getting this error

  5. samrath

    getting an error message when trying to extract xml file and it says it is written into log file but unable to find the log file
    ‘plz let me know where can i find error message log file

    1. kishor ugale

      Hi Samrth,

      You will find the scripting deployment log file path at

      Path: Tibco\tra\domain\domain_name\logs\applicationmanagement.log, just check what error log print this log file and take the correcting action to complete your scripting deployment.

      Kishor Ugale

  6. Jatin Singhal


    I came through a scenario where i only want to deploy the Gv update file in the TIBCO Admin through Appmanage command. Is there an option to deploy the deploy config file only without using ear.

    I tried it once to deploy but got this error:
    No service configuration with name PartialBPM_V1.0.par. Please make sure contents in -deployconfig file matches -ear file
    at com.tibco.administrator.command.data.service.BaseService.config(BaseService.java:279)
    at com.tibco.administrator.command.data.service.FTBaseService.config(FTBaseService.java:85)
    at com.tibco.administrator.command.data.service.BW.config(BW.java:129)

    Command I used :
    ./AppManage -deploy -app -domain ST -deployconfig -user -pw ”

  7. Thanga

    AppManage -deploy -deployconfig c:\ears\deployment\filenotify.xml -app filenotify -domain tp003 -user admin
    -pw admin

  8. kishor ugale


    Is there any AppManage command for exporting the xml files ( configuration file) from EAR files in Bulk.

    For example i have 10 EAR file and i want to export xml file from all 10 EAR file in a single appManage command.


    1. Ahmed

      try this and feedback:
      AppManage -batchExport -noear -user admin -pw adminpw -domain testDomain -dir c:\temp\test
      where :
      -noear –> do not export EAR files.

  9. Amos LIDA


    May be the issue I’m facing is not related to this topic, but I need your help !

    I’m facing issue to persist some options I added to the tra file of one application. When there is a new deployment, the tra is reset and the added options are lost. How can I persist those options added to .tra ?
    Please, be aware that I do not want to impact all applications, so I don’t want to add the options to the bwengine.tra.
    Please, can you help me to get a solution ?


  10. Kishor Ugale

    HI Muonsha

    could you please check where you are going to deploy the ear file that machine have the BW installed properly if it yes then you need to enable the service from Tibco Admin URL at Configuration\Process Archive.Par level, once you enable it the deployed code move into undeployed state, then you just deploy it again by click on deploy tab, and it will start working,

    I hope this solution works for your requirement.

  11. Vishnu


    is it possible to start multiple BW Engines using a single script?



Leave a Reply

Your email address will not be published. Required fields are marked *