88babefd89
* Upgrade gradle wrapper to Gradle 5.0 * Upgrade to use locally deployed version of Capsule plugin (using Gradle 5.0) * Upgrade to use Corda Gradle Plugins 5.x (inclusive of Gradle 5.0 compatibility fixes) * Fix compile-time problems resolving log4j packages. * Update to use Artifactory deployed version of Capsule plugin (using Gradle 5.0) * Upgrade to use Gradle 4.2.1 (excluding default memory setting change: command line client now starts with 64MB of heap instead of 1GB.) * Added explicit compile-time dependency on 'de.jensd:fontawesomefx-commons:8.13' (compile-time error in tools:explorer without) * Update "wrapper" gradleVersion to 5.4.1 * Update Capsule plugin version label to reference R3 forked build. * Commit all gradle upgrade changes following: ./gradlew wrapper --gradle-version 5.4.1 * Increase maximum heap memory for Test tasks to 1GB, and upgrade build-scan plugin to 2.2.1. * Increase Test tasks' maximum memory to 1.5GB - what could go wrong? * Up maxHeapSize to 2g for gradle test runner (global setting). * Added explicit compile-time dependency on 'de.jensd:fontawesomefx-commons:8.13' (compile-time error in tools:demobench without) * Added forkEvery for node Unit tests. * Up :node test task 'forkEvery' to 10. * TC test execution tuning (:core, :node => forkEvery 10, default JVM heap size) * TC test execution tuning (bump JVM heap size up to 1g for :node) * TC test execution tuning (bump JVM heap size up to 1.5g for :node) * TC test execution tuning (re-instate global JVM heap size of 1Gb) * TC test execution tuning (re-instate JVM heap size of 2Gb for :node) * Update Corda Gradle plugins to 5.0.0 * Updated plugin resolution order + renamed artifactory URL to use "software.r3.com" * Reorder plugin resolution such that mavenlocal() is always queried first.
DemoBench
DemoBench is a standalone desktop application that makes it easy to configure and launch local Corda nodes. Its general usage is documented here.
Running locally
MacOSX/Linux:
./gradlew tools:demobench:installDist
cd tools/demobench/build/install/demobench
bin/demobench
Windows:
gradlew tools:demobench:installDist
cd tools\demobench\build\install\demobench
and then
bin\demobench
or, if Windows complains that the command line is too long:
java -Djava.util.logging.config.class=net.corda.demobench.config.LoggingConfig -jar lib\demobench-$version.jar
Testing
The Notary Node
When launched, DemoBench will look something like this:
Clicking the Start node button should launch a new Notary node.
The tab should display the correct national flag for the node's geographical
location. The View Database, Launch Web Server and Launch Explorer buttons
will be disabled until the node has finished booting, at which point the node
statistics (States in vault, Known transactions and Balance) will become
populated too.
The Corda node should boot into a shell with a command prompt. Type help at
this command prompt to list the commands available, followed by dashboard.
Press q to exit the dashboard, and then check the tab's buttons:
- Press
View Databaseto launch the H2 database's Web console in your browser. Pressing this button again should launch a second console session. - Press the
Launch Web Serverbutton to launch the Corda Webserver for this node. Once booted, it should open your browser to a page saying:
Installed CorDaps
No installed custom CorDapps
-
The button's text should now have changed to
Reopen web site. Pressing the button again should open a new session in your browser. -
Press the
Launch Explorerbutton to launch the Node Explorer for this notary. You should be logged into the Explorer automatically. TheLaunch Explorerbutton should now remain disabled until you close this node's Explorer again.
The Bank Node
Click the Add Node button, and DemoBench will ask you to configure another
node in a new tab. Choose Issuer GBP as additional configuration.
When you type in the shell start CashConfigDataFlow you should get the following result:
Flow completed with result: CashConfiguration(issuableCurrencies=[GBP], supportedCurrencies=[USD, GBP, CHF, EUR])
The CashIssueFlow is enabled for the currencies listed in bank node's finance configuration file (corda-finance.conf), in this instance it's GBP.
Launch the bank's Node Explorer, and check the network view. The Notary node should be displayed in Rome, whereas the Bank of Breakfast Tea should be in Liverpool.
Saving / Loading profiles
Choose File/Save As from DemoBench's main menu.
Save the profile and then examine its contents (ZIP format). It should look something like:
Length Date Time Name
--------- ---------- ----- ----
0 05-25-2017 11:57 notary/
490 05-25-2017 11:57 notary/node.conf
0 05-25-2017 11:57 notary/plugins/
0 05-25-2017 11:57 bankofbreakfasttea/
673 05-25-2017 11:57 bankofbreakfasttea/node.conf
0 05-25-2017 11:57 bankofbreakfasttea/plugins/
--------- -------
1163 6 files
Now choose File/Open from the main menu, and select the profile that you have
just saved. DemoBench should close the two existing tabs and then relaunch the
Notary and Bank nodes.
If you want to edit the content, please make sure that when zipping content back, the notary node is the first directory (ZIP files content is ordered)
Exiting DemoBench
Close DemoBench as a normal application on your platform; it should close any open Node Explorers before exiting.