Core Admin Sample Scripts

The main purpose of this utility is to demonstrate how the AppManage commands from ActiveMatrix BusinessWorks 5.x translate to the corresponding ActiveMatrix BusinessWorks 6.x BWAdmin commands.

This utility creates a cmd/AppManage_deploy.cmd folder that contains BWAdmin commands and uses bwadmin -f cmd/AppManage_deploy.cmd to run it.

ActiveMatrix BusinessWorks Augmented Options:

• -appSpace or - a - AppSpace name to be used for application lifecycle.
• -profile or -p - Configuration Profile to use for deployment. This profile must be available in the EAR file.
• -profileFile- Configuration profile file to use for deployment.
• -debug - Turn on debug tracing for this utility.
• -sapp - Single application per AppSpace deployment mode. Each AppSpace supports only one application deployment.
• -mapp - Multiple applications per AppSpace deployment mode. Each AppSpace supports one or more application deployments.

This utility is a wrapper script around the following scripts:

• killtea.sh
• killbwagent.sh
• teaclean.sh only if -clean or -forceClean options is used
• bwclean.sh if and only if -clean or -forceClean options is used
• genbwagentini.sh
• tea.sh
• bwagent.sh
• registeragent.sh

[-h] or [-help] - Prints this usage message.

-clean Cleans TIBCO Enterprise Administrator Server Data Store and ActiveMatrix BusinessWorks Domain Data Store.

-forceClean Same as -clean, except it avoids prompting the user to confirm with clean.

-force Same as -forceClean

-forceclean Same as -forceClean

This script assumes that the following products are installed correctly and the environment variables are set accordingly:

TIBCO_HOME = TIBCO_HOME directory where you installed ActiveMatrix BusinessWorks.

TEA_HOME = Parent directory to TIBCO Enterprise Administrator's /bin directory.

Supports generation of bwagent.ini file for either Database/TIBCO EMS™, or Database/TIBCO FTL® as the technology type.

1. Stops TIBCO Enterprise Administrator Server and BWAgent Processes.
2. Restarts TIBCO Enterprise Administrator Server and BWAgent Processes.
3. Registers BWAgent to TIBCO Enterprise Administrator Server.

[-h] or [-help] - Prints this help message and exits.

[-h] or [-help] - Prints this help message and exits.

[-h] or [-help] - Prints this help message and exits.

[-network <bwagent Network Name>] - Connects to a named BWAgent network. This is an optional argument.

By default, this script uses $BW_HOME/config/bwagent.ini

[<bwadminArgs> ...] - Use BWAdmin to run commands found in the input files.

Start BWAdmin in the interactive mode if cmdFile is not specified.

A BWAgent network name is a named directory under ${TIBCO_HOME}/bw/networks and contains the corresponding bwagent.ini.

How to Set Up a Newly Named Network

1. Obtain a bwagent.ini created for the named BWAgent network. For example, a named network called "acmeNetwork".
2. Create the acmeNetwork directory under ${TIBCO_HOME}/bw/networks. For example, mkdir ${TIBCO_HOME}/bw/networks/acmeNetwork.
3. Copy bwagent.ini to the above directory.
4. Rerun bwadmin.sh -network acmeNetwork.

[-h] or [-help] - Prints this usage message.

[-network <Network>] - Starts up BWAgent using the configuration of a named network.

[-maxWait <n>] - Maximum amount of wait time (2 sec increment) for BWAgent startup success.

The default value for <n> is 30, which means 30 * 2 sec = 60 seconds

[-force] or [-forceClean] - Proceeds with wiping ActiveMatrix BusinessWorks Domain Data and internal Data Store without prompting user reconfirmation.

By default, the script prompts user confirmation.

This utility configures AppNodes in a Domain or AppSpace to form a fault-tolerant group and cross-engine persistence

[-h] or [-help] - Prints this usage message.

[-c] or [-clean] - Cleans up and drops all the previously configured database tables.

Use this option carefully. This operation cannot be undone. Do not specify both -setup and -cleanup on the same run.

[-s] or [-setup] - Does the one-time setup of the BWEngine database. When this option is used, -domain and -appspace arguments are not needed and are not used even if specified. ${BW_HOME}/config/sqlscripts/<dbtype>/create.sql is used to set up the database tables and configuration.

[-b] or [-bootstrap] - Does the cleanup, then set up.

[-t] or [-dbtype] - This is the default value is postgresql.

-cf <config.sh> - Sources configuration from the specified <config.sh> file.

By default, <$BW_HOME>/scripts/admin/config/bwengine-group-<dbtype>.sh

[-d] or [-domain] - Domain Name

[-a] or [-appspace <appspace>] - AppSpace Name. All AppNodes in the specified Domain and AppSpace are configured to form a Fault-Tolerant group and across engine persistence.

Deploys the specified ActiveMatrix BusinessWorks EAR file into -domain <DomainName> -appspace <AppSpaceName>

[-h] or [-help]- Prints this help message.

-ear <EARFile> - Enterprise Archive file to deploy

[-domain <DomainName>] - Domain Name - Optional parameter

If it is not specified, DomainName is computed from ${USER}-Domain

This utility creates the Domain if it does not exist.

[-appspace <AppSpaceName>] - AppSpace Name - Optional parameter

If it is not specified, AppSpaceName is computed from the name of the EAR file.

This utility creates the AppSpace and AppNode if they do not exist.

[-redeploy|-force]: Redeploy if the application has been previously deployed.

The application is not redeployed if it exists and this option is not specified.

[-profile <Profile>]: Profile name to use for this deployment.

If it is not specified, the default profile as packaged in the Enterprise Archive file is used.

[-mapp]: Optional flag to set multiple applications per AppSpace mode. This is the default mode for ActiveMatrix BusinessWorks.

[-debug]: Prints debug tracing for this script ./deploy.sh

-h or -help - Prints this help message.

The following variables are required from ./config/bwadmin-default- config.sh:

• BWAgentNetworkName - Name of BWAgent Network.
• BWMachines - Defined as a list of machine names (as obtained through hostname -f). If you have only one machine to configure, do not add it to this list because this script auto-configures it as a standalone BWAgent Network.

This script uses hostname -f to determine the name of the machine it is run on. It then determines whether this machine is in the BWMachines list.

You can assume that the discoveryURL of the bwagent.ini is comparable to that of a Database server's URL, and BWAgentNetworkName is then comparable to the database name. You can configure both to access the specific instance of the database uniquely.

If the KEEP_BWAGENT_INI environment variable is defined, bwagent.ini generation is skipped.

You can edit either the ./config/bwadmin-default- config.sh file, or make a copy of it, edit it, and then set an environment variable BWADMIN_CONFIG to point to it. For example, export BWADMIN_CONFIG=~/config/bwadmin-my-config.sh

Generates a bwagent.ini file for either Database/EMS, or Database/TIBCO FTL® as the technology type.

-h or -help - Prints this help message.

<process name> - Name of the process you want to end. This script ends all instances of the pid that matches this name.

• tea
• bwagent
• bwappnode
• bwadmin

-h or -help - Prints this help message.

-h or -help - Prints this help message.

-h or -help - Prints this help message.

-h or -help - Prints this help message.

-h or -help - Prints this help message.

-h and -help - Prints this help message.

-h or -help - Prints this help message.

This utility assumes that the following environment variables have been set:

export TIBCO_HOME="<Where ActiveMatrix BusinessWorks is installed>"

At least one of the following environment variables is set:

export TEA_HOME="Where TIBCO Enterprise Administrator is installed in the form of $TIBCO_HOME/tea/<version>"

Or,

export TEA_HOSTNAME=<HostName>

If the TEA_HOSTNAME environment variable is set, it assumes that the TIBCO Enterprise Administrator server is running remotely from the local BWAgent instance.

If the TEA_HOSTNAME environment variable is not set, this script registers the local BWAgent to the locally running TIBCO Enterprise Administrator server.

-h or -help: Displays this usage message

<domain> - can be "Acme-QA-Domain" or "Acme-UAT-Domain". When not specified, the default is "Acme-QA-Domain"

<mode> - [-sapp ] or [-mapp]

-sapp- Single App AppSpace deployment mode. Each AppSpace supports only one application deployment.

• bootstrap.sh - only if running in a single machine setup
• runBookStore.sh
• runSamples.sh
• runAcme.sh -domain Acme-QA-Domain
• runAcme.sh -domain Acme-UAT-Domain

-h or -help - Displays this usage message and exits

-clean - Cleans the TIBCO Enterprise Administrator Server Data Store and ActiveMatrix BusinessWorks Domain Data Store.

The Data Store clean is not reversible. Make sure you back up your data stores before running this command. Use this option with utmost care, otherwise you risk losing all your configurations.

-forceClean - Same as -clean, except it avoids prompting you to confirm with clean.

-force - Same as -forceClean

<mode> - [-sapp | -mapp]

-sapp - Single Application per AppSpace deployment mode. Each AppSpace supports only one application deployment.

-mapp - Multiple Applications per AppSpace deployment mode. Each AppSpace supports one or more application deployments.

Generates the bwagent.ini file for either Database/EMS™, or Database/FTL® technology type.

-h or -help - Displays this usage message.

<mode> - [-sapp | -mapp]

-sapp - Single Application per AppSpace deployment mode. Each AppSpace supports only one application deployment.

-mapp - Multiple Application per AppSpace deployment mode. Each AppSpace supports one or more application deployments.

This script dynamically creates a bwadmin cmd file in cmd/Samples-Domain-<mode>.cmd and runs it.

-h or -help - Displays this usage message.

<mode>: [-sapp] or [-mapp]

-sapp: Single Application per AppSpace deployment mode. Each AppSpace supports only one application deployment.

-mapp: Multiple Application per AppSpace deployment mode. Each AppSpace supports one or more application deployments.

• tibemsd
• tea
• bwagent
• bwappnode
• bwadmin

-h or -help - Prints this usage message.

[-maxWait <n>] - Max number of wait time (2 sec increment) for TIBCO Enterprise Administrator Server startup success.

The default value for <n> is 30, which means 30 * 2 sec = 60 seconds.

The end effect of this clean up is similar to a fresh installation of TIBCO Enterprise Administrator.

-h or -help - Prints this usage message

-force or -forceClean - Proceeds with wiping ActiveMatrix BusinessWorks Domain Data and internal data store without prompting user reconfirmation.

By default, the script prompts user confirmation.