AgenaRisk 10 API
Public AgenaRisk 10 API is a project that aims to make API programming with AgenaRisk easy. AgenaRisk Java API v2 is ultimately a convenient front-end for the AgenaRisk Core engine and puts the focus on:
- providing shortcuts for operations that previously used to be extremely complicated
- abstracting low level core data structures
- hiding most of the core functionality that was not self-explanatory or unsafe
- fully documented features
Prerequisites
- JDK 8
We recommend jdk1.8.0_192
Note: versions of Java above 8 have not been tested - Maven
Version >= 3.6.1 - Linux: net-tools, iproute2
Usage
See Example App for usage example
Licensing
Once cloned, you will need to perform mvn clean to trigger automatic download of non-Java dependencies into your project/lib directory.
mvn clean compile
Then, you can run the library with arguments to manage your license or override some configuration settings:
mvn exec:java@activate '-Dexec.args="-h"'
Key Activation (Online)
mvn exec:java@activate '-Dexec.args="--keyActivate --key 1234-ABCD-5678-EFGH"'
Key Activation (Offline)
First, you will need to generate an activation request file:
mvn exec:java@activate '-Dexec.args="--offlineActivationRequest --key 1234-ABCD-5678-EFGH --oPath activation_request.txt"'
Then, email this file to support@agenarisk.com. You will be provided an activation file in return, e.g. activation_confirmation.dat
mvn exec:java@activate '-Dexec.args="--offlineActivate --key 1234-ABCD-5678-EFGH --oPath activation_confirmation.dat"'
In order to deactivate a license (e.g. to move it to another machine), you will need to send the license release proof file to support@agenarisk.com
mvn exec:java@activate '-Dexec.args="--offlineDeactivate --key 1234-ABCD-5678-EFGH --oPath deactivation_proof.dat"'
Note that --oPath provided above is just for illustration and can be a path to any valid file location in the file system.
Enterprise Activation
Note if you are seeing the error: Only AgenaRisk Enterprise version can run in a headless environment, this could be because you are logged in via ssh or the OS is running in headless mode or genuinely does not have a GUI. You will either need to run it on OS with a GUI or get an enterprise license key.
If you do have an enterprise key, download AgenaRisk 10 Enterprise product files:
wget -r -nd --accept-regex '.*dat|guid|aid' -R "index.html*" -P enterprise https://resources.agenarisk.com/products/enterprise/
Then use a path override argument for product directory --directoryProduct <path>
mvn exec:java@activate '-Dexec.args="--keyActivate --key 1234-ABCD-5678-EFGH --directoryProduct enterprise"'
Note: you can also run this with e.g. java -jar com.agenarisk.api-0.9-SNAPSHOT.jar