Running in Local Mode

Local mode allows application testing and debugging on the local file system.

This procedure shows you how to create runtime entities and deploy and run an application using bwadmin local mode.

You learn how to:

Set the bwadmin mode
Create a domain, AppSpace, and AppNode
Upload an application archive
Start the AppSpace
Deploy and start the uploaded application

Note: The runtime entities created in local mode are not visible to bwagents when they are started.

Procedure

In a terminal, navigate to the following paths:
Windows:
```
BW_HOME\bin
```
Unix:
```
${BW_HOME}/bin
```

Set the bwadmin mode to local.

Windows:

BW_HOME\bin>bwadmin mode local

Unix:

[root@BW_HOME bin]# ./bwadmin mode local

Create a domain. For more information, see Creating a Domain.

Windows:

BW_HOME\bin>bwadmin create domain D1

Unix:

[root@BW_HOME bin]# ./bwadmin create domain D1

Show the domain.

Windows:

BW_HOME\bin>bwadmin show domain

Unix:

[root@BW_HOME bin]# ./bwadmin show domain

Create an AppSpace in the domain. For more information, see Creating an AppSpace.

Windows:

BW_HOME\bin>bwadmin create -d D1 appspace AS1

Unix:

[root@BW_HOME bin]# ./bwadmin create -d D1 appspace AS1

Create an AppNode in the AppSpace. When creating an AppNode, you must specify the HTTP management port that allows communication with the AppNode.
Windows:
```
BW_HOME\bin>bwadmin create -domain D1 -appspace AS1 -httpPort 8060 appnode AN1
```
Unix:
```
[root@BW_HOME bin]# ./bwadmin  create -domain D1 -appspace AS1 -httpPort 8060 appnode AN1
```
The HTTP management port must be unique across all defined AppNodes on a machine. If the specified port is already in use, an error is issued and the AppNode cannot be created.

For more information, see Creating an AppNode.
Use the show command for the AppSpace after you've created the AppNode.
```
BW_HOME\bin>bwadmin show -domain D1 -appspace AS1 appnodes
```

Upload an application archive into the domain. The following command uploads the Bookstore sample application archive. Use forward slash in the Windows command line.

Windows:

BW_HOME\bin>bwadmin upload -domain D1 ../samples/core/admin/ears/bookstore/tibco.bw.sample.binding.rest.BookStore.application_1.0.0.ear

Unix:

[root@BW_HOME bin]# ./bwadmin upload -domain D1 ../samples/core/admin/ears/bookstore/tibco.bw.sample.binding.rest.BookStore.application_1.0.0.ear

For more information, see Uploading an Archive.

Show that the application archive was uploaded.

Windows:

BW_HOME\bin>bwadmin show -domain D1 archives

Unix:

[root@BW_HOME bin]# ./bwadmin show -domain D1 archives

Start the AppSpace. This starts the AppNode in the AppSpace.
Windows:
```
BW_HOME\bin>bwadmin start -domain D1 appspace AS1
```
Unix:
```
[root@BW_HOME bin]# ./bwadmin start -domain D1 appspace AS1
```
For more information, see Starting an AppSpace.

Deploy the application into the AppSpace. This deploys the application to the AppNode.

Windows:

BW_HOME\bin>bwadmin deploy -domain D1 -appspace AS1
tibco.bw.sample.binding.rest.BookStore.application_1.0.0.ear

Unix:

[root@BW_HOME bin]# ./bwadmin deploy -domain D1 -appspace AS1
tibco.bw.sample.binding.rest.BookStore.application_1.0.0.ear

For more information, see Deploying an Application.

See the deployed application using show command.

Windows:

BW_HOME\bin>bwadmin show -domain D1 application

Unix:

[root@BW_HOME bin]# ./bwadmin show -domain D1 application

Start the application. Each uploaded application maintains a version. The version number is required for starting and stopping the application.
Windows:
```
BW_HOME\bin>bwadmin start -d D1 -appspace AS1 application
tibco.bw.sample.binding.rest.BookStore.application 1.0
```
Unix:
```
[root@BW_HOME bin]# ./bwadmin start -d D1 -appspace AS1
```
To find the version number, you can use the show command, for example: bwadmin show -domain D1 application
For more information, see Starting an Application.
Use the -csv command to print the table content as a comma separated value table. The first row contains the headers and applies to domains, AppSpaces, AppNodes, Applications, Archive, Archives, Machines and Installations. For example, bwadmin[admin@d1]> show -csv apps to show all the Applications in the csv format.
Optionally, stop and undeploy the application, stop the AppSpace, and delete the entities (archive, AppNode, AppSpace, and domain).

ResultYou used bwadmin in local mode to create a domain (D1), an AppSpace (AS1), and an AppNode (AN1). You uploaded an application archive to the domain, deployed the application, and started and stopped the application. Spend some time experimenting with bwadmin commands. For more information about domains, AppSpaces, AppNodes, and applications, see Administration Tasks and Reference.