Chapter 4. Business application execution
By default, business applications contain a single executable project, the service project. You can execute the service project on Windows or Linux, in standalone (unmanaged) or development (managed) mode. Standalone mode enables you to start your application without additional requirements. Applications started in development mode require Business Central to be available as the Decision Manager controller.
4.1. Running business applications in standalone mode
Standalone (unmanaged) mode enables you to start your business application without additional requirements.
Prerequisites
-
You have a
<business-application>.zip
file that you created using the business applications website. - The business application is configured.
Procedure
-
Navigate to the
<business-application>/<business-application>-service
folder. Enter one of the following commands:
Table 4.1. Standalone launch options Command
Description
./launch.sh clean install
Launches in standalone mode on Linux or UNIX.
./launch.bat clean install
Launches in standalone mode on Windows.
./launch.sh clean install -Pmysql
Launches in standalone mode on Linux or UNIX if you have configured the application with a MySQL database.
./launch.bat clean install -Pmysql
Launches in standalone mode on Windows if you have configured the application with a MySQL database.
./launch.sh clean install -Ppostgres
Launches in standalone mode on Linux or UNIX if you have configured the application with a postgreSQL database.
./launch.bat clean install -Ppostgres
Launches in standalone mode on Windows if you have configured the application with a PostgreSQL database.
The
clean install
argument directs Maven to build a fresh installation. The projects are then built in the following order:- Data model
- Business assets
Service
The first time that you run the script, it might take a while to build the project because all dependencies of the project are downloaded. At the end of the build, the application starts.
Enter the following command to access your business application:
http://localhost:8090/
-
Enter the credentials
user
/user
orkieserver
/kieserver1!
.
4.2. Running business applications in development mode
Development (managed) mode enables developers to work on a Red Hat Decision Manager business application business assets project and dynamically deploy changes to the business application without the need to restart it. In addition, development mode provides a complete monitoring environment for business automation capabilities, for example process instances, tasks, and jobs.
Prerequisites
-
You have a
<business-application>.zip
file that contains a business assets project, that you created using the business applications website. - You configured the business application.
- Business Central is installed and running.
Procedure
-
Navigate to the
<business-application>/<business-application>-service
folder. Enter one of the following commands:
Table 4.2. Managed launch options Command
Description
./launch-dev.sh clean install
Launches in development mode on Linux or UNIX.
./launch-dev.bat clean install
Launches in development mode on Windows.
./launch-dev.sh clean install -Pmysql
Launches in development mode on Linux or UNIX if you have configured the application with a MySQL database.
./launch-dev.bat clean install -Pmysql
Launches in development mode on Windows if you have configured the application with a MySQL database.
./launch-dev.sh clean install -Ppostgres
Launches in development mode on Linux or UNIX if you have configured the application with a postgreSQL database.
./launch-dev.bat clean install -Ppostgres
Launches in development mode on Windows if you have configured the application with a PostgreSQL database.
The
clean install
argument directs Maven to build a fresh installation. The projects are then built in the following order:- Data model
- Business assets
Service
The first time that you run the script, it might take a while to build the project because all dependencies of the project are downloaded. At the end of the build, the application starts.
Enter the following command to access your business application:
http://localhost:8090/
-
Enter the credentials
user
/user
orkieserver
/kieserver1!
. After the business application starts, it connects to the Decision Manager controller and is visible in MenuDeploy Execution Servers in Business Central.