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 a TIBCO Consultant By Profession with more than 6 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

13 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.

    Reply
      1. Chandan

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

        Reply
  2. SB

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

    Reply
  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

    Reply
  4. muonsha

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

    I am getting this error

    Reply
  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

    Reply
    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.

      Regards
      Kishor Ugale

      Reply
  6. Jatin Singhal

    Hi,

    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 ”

    Reply
  7. Thanga

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

    Reply
  8. kishor ugale

    Hi,

    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.

    Thanks
    Kishor

    Reply
    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.

      Reply

Leave a Reply

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