Commit Graph

1838 Commits

Author SHA1 Message Date
Ben Wyeth
f9916e673c Document warning cleanup + new version of docs builder 2019-04-11 13:43:47 +00:00
Dan Newton
923d593caf CORDA-2710 Add Java samples to upgrading to Corda 4 documentation (#4979) 2019-04-08 12:18:39 +01:00
Dan Newton
40e0e6d5f7 CORDA-2528 Update contract testing documentation (#4977) 2019-04-08 12:16:19 +01:00
willhr3
5314ccf33f Willh docupdate (#4985)
* Update tutorial-cordapp doc with runnodes instructions for mac

* Tutorial doc update - Moving comment into warning

* Fixing doc link
2019-04-04 14:31:38 +01:00
LankyDan
9d45049727 Tidy up codesets in contract constraints documentation
Code for these docs had the java and kotlin samples but were not
combined into a single codeset with tabs for each language.
2019-04-03 10:55:59 +01:00
Cais Manai
f4d7bc9a18 Cais r3 doc fixes (#4974)
* StatesAndContract.kt to TemplateContract.kt

* Updating to reflect new template structure

* Update tut-two-party-contract.rst
2019-04-02 11:20:12 +01:00
JamesHR3
d9e11b21ae Remove targetPlatformVersion check from FinalityFlow and update docs (#4955)
In Corda 4, FinalityFlow was updated to become an initiated flow, in order to ensure a node does not have to accept any signed transaction it receives without being able to check it first. The old behaviour of FinalityFlow was gated behind a targetPlatformVersion check, to prevent apps targeting V4 from using the old behaviour.

This is problematic for a few reasons. For an app wishing to be backwards compatible with a version running on V3, this forces the app to set targetPlatformVersion = 3, even if the app is thoroughly tested against V4. This goes against the purpose of the targetPlatformVersion. Another consequence is that an app remains pinned to targetPlatformVersion = 3 until it is sure that there are no other apps running at a lower version in the network, which would prevent newer versions of the app from taking advantage of features gated behind targetPlatformVersion checks. (Note that the restriction only prevents a new version of the app from initiating FinalityFlow with the old version - the old version is able to initiate a FinalityFlow and the new version will handle it, assuming the app has been written correctly.)

This fix removes the targetPlatformVersion check from FinalityFlow, and also provides a few documentation updates to clarify what level of testing would be expected to set a targetPlatformVersion.
2019-03-28 14:21:59 +00:00
James Carlyle
ea89f3aac4
Merge pull request #4880 from corda/carolynequinn-patch-1
Update UAT.md
2019-03-27 18:37:21 +01:00
josecoll
f7e475b8a1 Minor updates following RGB feedback. 2019-03-27 17:05:07 +01:00
josecoll
f43906b973 Document FinalityFlow error handling logic and reference flow hospital doc. 2019-03-27 17:05:07 +01:00
Ben Wyeth
a81fbadec5 CORDA-2808 docs build page (#4947)
* updated the docs build docs to be a bit more up to date with the docker image being used

* fixing the indented bullets
2019-03-27 15:40:36 +00:00
josecoll
142d444835 re-instate hmtlmode only for Design Docs. 2019-03-27 15:26:17 +01:00
josecoll
9ec82b4bca Minor tweaks and improvements in docs TOC to aid navigation and access. 2019-03-27 15:26:17 +01:00
ben
40c1741aba removed another warning 2019-03-27 15:25:40 +01:00
ben
4b5ec7aea6 more warnings gone 2019-03-27 15:25:40 +01:00
ben
8d44eabf4a got rid of a lot of the long errors in the markdown docs 2019-03-27 15:25:40 +01:00
ben
ed94387eff low hanging fruit 2019-03-27 15:25:40 +01:00
josecoll
b4ff2afa47
Fix incorrect version identifiers in URL's be adopting |corda_version| consistently. (#4934) 2019-03-25 18:23:17 +00:00
josecoll
f89c565312
Clarify need for shipping contract schemas in flow JARs. (#4930) 2019-03-25 14:56:18 +00:00
Ben Wyeth
a1f7c4f2f4 corda-2781 replace manual versions with substitutions (#4927)
* been through the docs manually and picked out substitutions

* hopefully addressing the url inconsistencies
2019-03-25 12:20:26 +00:00
Katelyn Baker
738f92de0a
CORDA-2779 - Fix Netmap REST endpoint docs (#4918)
* CORDA-2779 - Fix Netmap REST endpoint docs

* Review comments
2019-03-22 15:57:55 +00:00
ben
803ea3e652 changing substitution mechanism so that it can work with code blocks 2019-03-22 15:14:54 +01:00
Joel Dudley
78aee24f69
Fixes link. 2019-03-22 14:11:35 +00:00
Jonathan Locke
dc179d4ea1 ENT-3057: Log hibernate warns and errors in different log (#4889)
* ENT-3057: Log hibernate warns and errors in different log

If a hibernate error occurs (deadlock, for example) that would cause a flow to be sent to the hospital, hibernate logs the warnings and errors before we do. This results in duplication in the logs, and pollutes the log. To solve this, we create a new log appender named diagnostic-{node-name}.log and log any org.hibernate messages of warn and above to that file. This way, messages are not lost, which means that the information can be retrieved if need be.

* Corrected indentation of comment (changed tab to space)

* Updated node-administration document to mention diagnostic logging change

* Fixed integration test. It was breaking because it was fetching the first log file in the folder, assuming there would be only one. This assumption is now invalid because the diagnostic log file that was introduced. Two tests were found that used similar logic to find a log file to examine, hence both were corrected to look for log files beginning with "node"

* Updated documentation as per review comments.
2019-03-18 17:08:13 +00:00
Chris Rankin
abbf2562c2 CORDA-2750: Modularise the DJVM build. (#4897)
* CORDA-2750: Modularise the DJVM build.

* CORDA-2750: Update documentation and scripts for modular DJVM.
2019-03-17 06:06:51 +00:00
szymonsztuka
077f7385c7 CORDA-2393 Improve documentation for PostgreSQL to avoid missing hibernate_sequence (#4891) 2019-03-14 13:39:55 +00:00
josecoll
94d827ebe4
CORDA-2741 RPC client connection management section not fully working (#4870)
* RPC Client using HA addresses.

* Fix incorrect document code snippets by referencing working, compilable code.

* Minor updates following PR review.
2019-03-13 16:31:28 +00:00
Ben Wyeth
0551ba992b CORDA-2728: Add Quasar lib update step to applicataion upgrade notes (#4877)
* updated README so that it has a reference to the rst docs we care about

* adding some upgrade nodes for cordapps that have a lib/quasar.jar
2019-03-13 16:23:31 +00:00
Dimos Raptis
56beaf1be5 Docs style fix (#4871) 2019-03-12 17:25:47 +00:00
carolynequinn
93869f0dd7
Update UAT.md
Added in wording to reflect the existing UAT joiner guide, in shortened form, onto the docs site. This will be made better, but is an interim solution. Since we don't have another website suitable for this, our team has agreed with Marketing that this is the place this should live (given it is separate from the Foundation). Will try to edit the toctree so this 'pops out' in the left-hand menu.
2019-03-12 16:03:12 +00:00
Ben Wyeth
76b07967e2 CORDA-2715 - Update test runner instructions for CorDapp tutorial (#4863)
* made consistent with template review

* fixing nested bullet layouts

* updating based on (awesome) comments

* next iteration :-)

* more fixes
2019-03-12 10:26:17 +00:00
Ben Wyeth
b98ed6db23 CORDA-2729: Update integration testing instructions to explicitly mention node-driver dependency (#4873)
* adding a note so that it's clear what you have to include in gradle in order to use the driver classes

* responding to comments
2019-03-12 10:25:39 +00:00
Chris Rankin
dc83afb4de CORDA-2672: Tidy up CorDapp deployments in samples. (#4815)
* CORDA-2672: Tidy up CorDapp deployments in samples.

* CORDA-2672: Refactor Attachment Demo.

* Remove Bank of Corda from Trader Demo.

* Configure SLF4J simple loggers, fix comments and documentation.
2019-03-11 16:48:35 +00:00
Chris Rankin
ec5cbc2971 CORDA-2721: Update djvm check documentation, and fix CLI tool installation. (#4865)
* CORDA-2721: Fix DJVM CLI installation and runtime scripts.

* Update DJVM documentation to explain about `RuleViolationError`.

* CORDA-2721: Add comment about constants.properties being parsed by DJVM CLI scripts.
2019-03-09 18:27:45 +00:00
Chris Rankin
25851c78a3 CORDA-2703: Fix use of commas in node.conf examples. (#4852) 2019-03-08 16:42:03 +00:00
Chris Rankin
ea263b3e54 CORDA-2569: Add "flow kill <ID>" command to Corda's shell. (#4861)
* CORDA-2569: Add "flow kill <ID>" command to Corda's shell.

* Add testing and documentation for RPC killFlow operation.
2019-03-08 16:39:22 +00:00
JamesHR3
b3b184c93e [CORDA-2701] Ensure crlCheckSoftFail config option is respected (#4854)
* Plumb through the crlCheckSoftFail configuration option to bridge manager

* Add crlCheckSoftFail test to bridge manager and fix equivalent proton wrapper test

* Update documentation and set the node configuration default to true

* Revert default change and clarify consequences of setting option to false

* Remove NodeConfiguration default to leave only AMQPConfiguration default
2019-03-08 16:23:07 +00:00
Mike Hearn
785755067a Docs: use version numbers read from the build system, not duplicated. 2019-03-07 16:44:50 +01:00
josecoll
f6ba9a0819
CORDA-2684 Added new guide on CorDapp Constraints Migration procedures. (#4837)
* Added new guide on CorDapp Constraints Migration procedures.

* Apply formatting and upper/lowercase changes.

* Updated following PR review feedback from RGB and MH.

* Minor clarification and cleanup.

* Clarify step to ensure there is only one version ("signed") of the same Contracts CorDapp in the nodes /cordapp folder

* Incorporating feedback from SS.

* Replaced "propagate" with "transition".
Adjust terminology to be consistent.

* Removed confusing statement.
2019-03-07 09:32:16 +00:00
Dimos Raptis
3bb996d22f DOCS - clarify the upgrade policy for finality flow (#4853) 2019-03-06 09:55:59 +00:00
szymonsztuka
9da30b431f CORDA-2554 - Bootstrapper - option to include contracts to whitelist from signed JARs (#4712)
* NetworkBoostrapper can optionally whitelist contracts from signed jars based on include_whitelist.txt file.

* refactoring, docs

* logs

* add ne parameters to the generateWhitelist method at the end

* Addressing review comments.

* CORDA-2577 disable non-downgrade rule - test fix and docs
2019-03-04 11:01:08 +00:00
Roger Willis
5a4db990e7 Update tutorial-building-transactions.rst
Addressed @tudor-malene's comment
2019-03-02 17:45:34 +01:00
RogerWillis
dce411cfdf Removed part about exchanging transaction builder between parties. You can't do this as TransactionBuilder is not serializable. 2019-03-02 17:45:34 +01:00
Richard G Brown
987cb23c2a Clarify that bootstrapper only works in devMode 2019-03-02 17:39:32 +01:00
josecoll
e7534b3a7d
Fix broken URL. (#4835) 2019-03-01 16:50:41 +00:00
Dan Newton
cd321c9da2 Correct extending flows java docs and add note on overriding responders (#4830)
Add `@InitiatedBy` to the java docs on the responder flow, this is
already shown in the kotlin version.

Add a note on overriding responders, instructing developers to still
include the `@InitiatedBy` annotation on the new responder even though
the configuration setup can make developers think that defining the
override will guarantee the initiator and responder will join up
correctly.
2019-02-28 14:33:13 +00:00
Mike Hearn
b434d49111 Docs: fix backup recommendations link 2019-02-28 11:10:40 +01:00
Chris Rankin
b9e4804388 ENT-3128: Update documentation for Node Explorer. (#4817) 2019-02-27 14:32:39 +00:00
josecoll
c11f42fc05
CORDA-2655 - Document CorDapp upgradeability guarantees in Corda 4. (#4793)
* Document CorDapp upgradeability guarantees.

* Incorporating feedback from RGB.

* Incorporating feedback from MH.

* Minor updates following re-review by RGB

* Updates following review by MH.

* Include new document in index.

* Incorporating review feedback from MH.
2019-02-26 17:30:10 +00:00
Chris Rankin
111acc5d6e CORDA-2671: Remove broken ExplorerSimulator from Node Explorer. (#4811)
* CORDA-2671: Remove broken ExplorerSimulator from Node Explorer.

* CORDA-2671: Document that Node Explorer is included with DemoBench.
2019-02-25 18:11:06 +00:00