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


Chapter 1 Scripting Deployment : Accessing Online Help for Commands

Accessing Online Help for Commands
Online help is available for the AppManage and buildear utilities.
AppManage Help
The AppManage online help shows the command line syntax, describes each command option and provides command line examples. For example, typing AppManage on the command line produces the following help.
C:\tibco\tra\<version>\bin>appmanage
Usage: AppManage [options] [args...]
(to execute a task)
or AppManage -? [options]
(to print detailed message of each option)
where options include:
   -export           export a deployment configuration file
   -upload           upload an archive
   -config           configure an application
                     If -ear is specified, upload the archive first
   -deploy           deploy an application
                     If -ear is specified, upload the archive first
                     If -deployConfig is specified, configure the
                     application first
   -undeploy         undeploy an application
   -delete           delete an application
                     If -force is specified, undeploy the
                     application first.
   -start            start successfully deployed service instances
                     of an application
   -stop             gracefully shutdown successfully deployed
                     service instances of an application
   -kill             immediately kill successfully deployed                      service instances of an application
   -moveAppData      Redeploy application with new location for
                     Application Data
   -truncate         Truncate the application deployment revision
   -batchExport      To export deployment configuration files for
                     all the archives under a directory
   -batchUpload      Uplaod all applications specified in
                     AppManage.batch
   -batchConfig      Config all applications specified in
                     AppManage.batch
   -batchDeploy      Deploy all applications specified in
                     AppManage.batch
   -batchUndeploy    Undeploy all applications specified in
                     AppManage.batch
   -batchDelete      Delete all applications specified in
                     AppManage.batch
   -batchstart       Start all applications specified in
                     AppManage.batch
   -batchstop        Stop all applications specified in
                     AppManage.batch
   -batchkill        Kill all applications specified in
                     AppManage.batch
   -batchMoveAppData Move Application Data to or from local for
                     all applications specified in AppManage.batch
To display help about a command line option, type:
AppManage -? command line option
AppManage "-?" comand line option
Buildear Help
The buildear utility help can be displayed by typing:
buildear -h
The buildear utility online help does not explain that the -p and -o options require the full path to the project and EAR file .
The buildear utility always reports success even if the operation was not successful.
Specifying Application Names
Many AppManage commands use the -app option that specifies the application name. The -app value must include the full path to the application as set in the Application Management module in the TIBCO Administrator GUI. For example, the next diagram shows two applications in the Application Management module. The Path column lists the full path for each application. Note that the DefaultDesktop application is at the top level and the NewHireApp is contained in the HireApp folder.
Figure 1 TIBCO Administrator GUI
When running a command option such as -undeploy against the top level DefaultDesktop application, the following syntax must be used for the -app option:
AppManage -undeploy -app DefaultDesktop -user a -pw a -domain test
When running the same command against the NewHireApp application that is contained in the HireApp folder, the following syntax must be used for the -app option. A forward slash separates the folder and application name.
AppManage -undeploy -app HireApp/NewHireApp -user a -pw a -domain test

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