HelloDBP

A simple application for Software AG's Digital Business Platform (DBP). This project includes the design time source files and projects, plus a build file to install.

Prerequisites

1. A machine with the following products installed:
   • Integration Server with CloudStreams, JDBC Adapter, Terracotta DB Adapter, Dynamic Business Orchestrator, Task Engine ...
   • Designer with plugins...
   • Universal Messaging
   • Apama
   • MwS
   • MashZone NextGen
   • API Gateway
   • API Portal
   • Event Data Store

Quick Start

1. Start Command Central and Platform Manager (sometimes two of them) via Windows Services or startup.bat/sh
2. Go to Command Central UI and start servers in this order:
   1. Terracotta DB, Universal Messaging
   2. Integration Server, MwS, MashZone NextGen
   3. API Gateway (should auto-launch Event Data Store)
   4. API Portal
3. Install Cloudstreams Connector for IS
   1. Go to CloudStreams Cumulocity Download Page
   2. Click Download and Save file to disk
   3. Move the downloaded WmCumulocityProvider.zip file to Integration Server replicate/inbound folder (C:\SoftwareAG\IntegrationServer\instances\default\replicate\inbound)
   4. Open IS Administrator
   5. Go to Packages > Management > Install Inbound Packages and Install WmCumulocityProvider.
   6. Restart IS to reload CloudStreams with Cumulocity provider.
4. Install HelloDBP IS package
   1. Download the lastest HelloDBP package from IS folder.
   2. Go to Packages > Management > Install Inbound Packages and Install HelloDBP.zip.
   3. Open Designer Service Development perspective and use File > Sync Document Types > All Out-of-Sync... to sync the two DES types to the common repository.
5. Provide URL and Credentials for Cumulocity tenant
   1. Go to IS CloudStreams page
   2. Click on Cumulocity provider, disable the CumulocityConnection, Edit, and change the URL, User and Password. #. Re-enable the CumulocityConnection.
6. Enable the Event Persistence Connection
   1. Go to IS JDBC Adapter page
   2. Edit the EventStoreConnection
   3. In the "Other Properties" field, ensure the proper path to the suite folder.
   4. Enable the EventStoreConnection
7. Change the machine name for HelloREST API Descriptor
   1. Go to Designer Service Development perspective.
   2. Lock for Edit HelloREST, then open it.
   3. In the Host:Port field, change it to your local machine name.
8. Create the Things dataset in Terracotta DB
   1. One way to do this is via the Terracotta DB Adapter in IS
9. Clone this Git Repository using Designer Git perspective
   1. In Designer, click the "Open Perspective" button or menu and choose Git.
   2. Click on Clone Git Repository link.
   3. In the URI, paste the link to this repository (from the green "Clone or download" button).
   4. Click "Next" twice and then check the box "Import all existing Eclipse projects after clone finishes"
   5. Click "Finish".
   6. You must re-build the HelloApama project using Project > Clean... action in Designer.
10. Deploy the HelloDBO process
    1. Open the Dynamic Process Development perspective in Designer
    2. Open the HelloDBO - 1 process.
    3. Click on "Upload for Dynamic Process" button.
    4. When asked to deploy the "Analyze Alert" task, say Yes.
    5. Provide MwS sysadmin credentials.
    6. After a minute, navigate to Business Console, you should see the HelloDBO and Analyze Alert types now.
11. Import MashZone assets
    1. Go to folder MashZoneNG > prestocli > bin
    2. padmin importAlias -u (User) -w (Password) -f "(local git path)\HelloDBP\MashZone\Aliases.zip"
    3. padmin importDashboard -u -w -f "(local git path)\HelloDBP\MashZone\Dashboard.zip"
    4. Restart MashZone NextGen. This is needed for the Event Services to restart properly.
12. Create Apama correlator instance in Command Central
    1. Ensure Command Central and all SPM runtimes are started.
    2. Edit (local git path)\HelloDBP\CC\templates\hello-apama.yaml to change the apama.projectDir path.
    3. From directory (suite folder)\CommandCentral\client\bin, run:
       • sagcc exec templates composite import -i (local git path)\HelloDBP\CC\templates\hello-apama.yaml overwrite=true
       • sagcc exec templates composite apply sag-apama-correlator nodes=(local installation name) repo.product=(product repo alias) repo.fix=(fix repo alias) --sync-job --wait 360

To Do

1. Create a Business Console AppSpace and Gadget to be a small front end for ThingCo's customers to query for Things registered to their account, get a history of Thing Health for each one, rename a Thing, delete a Thing or create a new Thing.
2. Create a WmTestSuite project for HelloDBP.