.. container:: paragraph
- One all requirements are in place, APEX can be build.
+ Once all requirements are in place, APEX can be build.
There are several different artifacts one can create
building APEX, most of them defined in their own
- *profile*. APEX can also be build in a standard way with
+ *profile*. APEX can also be built in a standard way with
standard tests (``mvn clean install``) or without
standard tests (``mvn clean install -DskipTests``).
- Cygwin: ``/cygdrive/c/dev/apex``
.. important::
- A Build requires ONAP Nexus
- APEX has a dependency to ONAP parent projects. You might need to adjust your Maven M2 settings. The most current
- settings can be found in the ONAP oparent repo: `Settings <https://git.onap.org/oparent/plain/settings.xml>`__.
-
- .. important::
-
- A Build needs Space
- Building APEX requires approximately 2-3 GB of hard disc space, 1 GB for the actual build with full
- distribution and 1-2 GB for the downloaded dependencies
-
- .. important::
- A Build requires Internet (for first build to download all dependencies and plugins)
- During the build, several (a lot) of Maven dependencies will be downloaded and stored in the configured local Maven
- repository. The first standard build (and any first specific build) requires Internet access to download those
- dependencies.
-
- .. important::
+ A Build requires ONAP Nexus
+ APEX has a dependency to ONAP parent projects. You might need to adjust your Maven M2 settings. The most current
+ settings can be found in the ONAP oparent repo: `Settings <https://git.onap.org/oparent/plain/settings.xml>`__.
+
+ .. important::
+
+ A Build needs Space
+ Building APEX requires approximately 2-3 GB of hard disc space, 1 GB for the actual build with full
+ distribution and 1-2 GB for the downloaded dependencies
+
+ .. important::
+ A Build requires Internet (for first build to download all dependencies and plugins)
+ During the build, several (a lot) of Maven dependencies will be downloaded and stored in the configured local Maven
+ repository. The first standard build (and any first specific build) requires Internet access to download those
+ dependencies.
+
+ .. important::
Building RPM distributions
- RPM images are only build if the ``rpm`` package is installed (Unix). To install ``rpm``
- run ``sudo apt-get install rpm``, then build APEX.
+ RPM images are only built if the ``rpm`` package is installed (Unix). To install ``rpm``
+ run ``sudo apt-get install rpm``, then build APEX.
Standard Build
--------------
The build will have created all artifacts required for an APEX
installation. The following example show how to change to the target
- directory and how it should look like.
+ directory and how it should look.
+-----------------------------------------------------------------------------------------------------------------------------+
| Unix, Cygwin |
.. container:: content
- .. code:: bash
+ .. code:: bash
mvn checkstyle:checkstyle -DapexAll
.. container:: paragraph
- Use Maven to for a standard build with standard tests.
+ Use Maven for a standard build with standard tests.
- .. important::
+ .. important::
Some tests have specific timing Requirements
- Some of the tests have very specific timing requirements. If run on a low-powered build machine, or if the build
- machine is on high load, those tests might fail and the whole build might fail as well. If this happens, reduce the load
- on your build machine and restart the build.
+ Some of the tests have very specific timing requirements. If run on a low-powered build machine, or if the build
+ machine is on high load, those tests might fail and the whole build might fail as well. If this happens, reduce the load
+ on your build machine and restart the build.
+-----------------------------------+-----------------------------------+
| Unix, Cygwin | Windows |
The build takes about 10 minutes with tests on a standard development
laptop. It should run through without errors, but with a lot of
- messages from the build process. If build with tests (i.e. without
+ messages from the build process. If built with tests (i.e. without
``-DskipTests``), there will be error messages and stack trace prints
from some tests. This is normal, as long as the build finishes
- successful.
+ successfully.
Build with all Tests
--------------------
Use Maven to for a standard build with *all* tests.
- .. important::
+ .. important::
Some tests have specific timing Requirements.
- Some of the tests have very specific timing requirements. If run on a low-powered build machine, or if the build
- machine is on high load, those tests might fail and the whole build might fail as well. If this happens, reduce the load
- on your build machine and restart the build.
+ Some of the tests have very specific timing requirements. If run on a low-powered build machine, or if the build
+ machine is on high load, those tests might fail and the whole build might fail as well. If this happens, reduce the load
+ on your build machine and restart the build.
- .. important::
+ .. important::
Might require specific software.
- When running all tests, some modules require specific software installed on the build machine. For instance,
- testing the full capabilities of context (with distribution and persistence) will require Hazelcast and Infinispan
- installed on the build machine.
+ When running all tests, some modules require specific software installed on the build machine. For instance,
+ testing the full capabilities of context (with distribution and persistence) will require Hazelcast and Infinispan
+ installed on the build machine.
+----------------------------------------------+----------------------------------------------+
| Unix, Cygwin | Windows |
.. container:: paragraph
A standard APEX build will not build all components. Some parts
- are for specific deployments, only. Use Maven to for a standard
+ are for specific deployments, only. Use Maven for a standard
build with *all* components.
- .. important::
+ .. important::
Might require specific software.
- When building all components, some modules require specific software installed on the build machine.
+ When building all components, some modules require specific software to be installed on the build machine.
+----------------------------------------------+----------------------------------------------+
| Unix, Cygwin | Windows |
.. container:: paragraph
- The APEX Maven build also includes stand-alone documentations,
+ The APEX Maven build also includes stand-alone documentation,
such as the HowTo documents, the Installation Guide, and the User
Manual. Use Maven to build the APEX Documentation. The Maven
- options ``-N`` prevents Maven to go through all APEX modules,
+ option ``-N`` prevents Maven from going through all APEX modules,
which is not necessary for the documentation. The final documents
will be in ``target/generated-docs`` (Windows:
``target\generated-docs``). The *HTML* documents are in the
``html/`` folder, the *PDF* documents are in the ``pdf/`` folder.
- Once the documentation is build, copy the *HTML* and *PDF*
+ Once the documentation is built, copy the *HTML* and *PDF*
documents to a folder of choice
+-------------------------------------------------------+--------------------------------------------------------+
Once the web site is staged, copy the full site to a folder of
choice or into a web server.
- .. important::
+ .. important::
Building a Site takes Time.
- Building and staging the APEX web site can take very long. The stand-alone documentation will take about 2 minutes. The
- sites for all modules and projects and the main APEX site can take between 10-30 minutes depending on your build machine (~10 minutes
- without generating source and test-source reports, closer to 30 minutes with all reports).
+ Building and staging the APEX web site can take very long. The stand-alone documentation will take about 2 minutes. The
+ sites for all modules and projects and the main APEX site can take between 10-30 minutes depending on your build machine (~10 minutes
+ without generating source and test-source reports, closer to 30 minutes with all reports).
.. container:: paragraph
#. Next run a simple install without tests
- #. Now generate the APEX stand -alone documentation, they are in
+ #. Now generate the APEX stand-alone documentation, they are in
the local package only so we can use the *-N* switch
#. Last build the actual sites and stage (copy to the staging
- Javadoc for *all* methods
- - All project must build with all tests on Unix, Windows,
+ - All projects must build with all tests on Unix, Windows,
*and* Cygwin
.. container:: ulist
.. container:: olist arabic
- #. Eclipse Window Preferences Java Code Style
+ #. Eclipse Window Preferences Java Code Style
Clean Up → Import…
#. Select your template file
.. container:: olist arabic
- #. Eclipse Window Preferences Java Code Style
+ #. Eclipse Window Preferences Java Code Style
Code Templates → Import…
#. Select your templates file
.. container:: olist arabic
- #. Eclipse Window Preferences Java Code Style
+ #. Eclipse Window Preferences Java Code Style
Formatter → Import…
#. Select your formatter profile file
package to do all files) and right click JAutodoc Add
Header
- #. To add JAutodoc stubs to a files, select on a file (or on
- the package to do all files) and right click JAutodoc
+ #. To add JAutodoc stubs to files, select on a file (or on
+ the package to do all files) and right click JAutodoc
Add Javadoc
Using Checkstyle
#. Ensure that Off/On Tags are enabled in Eclipse
- #. In Eclipse Window Preferences Java Code Style
+ #. In Eclipse Window Preferences Java Code Style
Formatter window press Edit…
#. Click on the *Off/On Tags* tab
.. container:: paragraph
- No use the provided ``CliOptions`` and ``CliParser``.
+ Now use the provided ``CliOptions`` and ``CliParser``.
Manually importing means to add the following lines to the
start of your application (in Eclipse this import will be
done automatically):
.. container:: paragraph
- The APEX utilities project provides means to versioning an
- application automatically towards the APEX version it is written
- for. This is realized by generating a file called
+ The APEX utilities project provides a means to version an
+ application automatically towards the APEX version for which it is
+ written. This is realized by generating a file called
``app-version.txt`` that includes the Maven project version. This
file is then automatically deployed in the folder ``etc`` of a
- full APEX distribution. The CLI Parser here provides a mthod to
+ full APEX distribution. The CLI Parser here provides a method to
access this version for an application.
.. container:: paragraph
- Cygwin: ``/cygdrive/c/dev/apex-pdp``
.. important::
- A Build requires ONAP Nexus
- APEX has a dependency to ONAP parent projects. You might need to adjust your Maven M2 settings. The most current
- settings can be found in the ONAP oparent repo: `Settings <https://git.onap.org/oparent/plain/settings.xml>`__.
+ A Build requires ONAP Nexus
+ APEX has a dependency to ONAP parent projects. You might need to adjust your Maven M2 settings. The most current
+ settings can be found in the ONAP oparent repo: `Settings <https://git.onap.org/oparent/plain/settings.xml>`__.
.. important::
- A Build needs Space
- Building APEX requires approximately 2-3 GB of hard disc space, 1 GB for the actual build with full distribution and 1-2 GB for
- the downloaded dependencies
+ A Build needs Space
+ Building APEX requires approximately 2-3 GB of hard disc space, 1 GB for the actual build with full distribution and 1-2 GB for
+ the downloaded dependencies
.. important::
- A Build requires Internet (for first build)
- During the build, several (a lot) of Maven dependencies will be downloaded and stored in the configured local Maven
- repository. The first standard build (and any first specific build) requires Internet access to download those dependencies.
+ A Build requires Internet (for first build)
+ During the build, several (a lot) of Maven dependencies will be downloaded and stored in the configured local Maven
+ repository. The first standard build (and any first specific build) requires Internet access to download those dependencies.
.. important::
- Building RPM distributions
- RPM images are only build if the ``rpm`` package is installed (Unix). To install ``rpm`` run ``sudo apt-get install rpm``,
- then build APEX.
+ Building RPM distributions
+ RPM images are only built if the ``rpm`` package is installed (Unix). To install ``rpm`` run ``sudo apt-get install rpm``,
+ then build APEX.
.. container:: paragraph
- Use Maven to for a standard build without any tests.
+ Use Maven for a standard build without any tests.
+-------------------------------------------------------+--------------------------------------------------------+
| Unix, Cygwin | Windows |
The build will have created all artifacts required for an APEX
installation. The following example show how to change to the target
- directory and how it should look like.
+ directory and how it should look.
+----------------------------------------------------------------------------------------------------------------------------+
| Unix, Cygwin |
| .. container:: content |
| |
| .. code:: bash |
-| :number-lines: |
+| :number-lines: |
| |
-| # sudo dpkg -i apex-pdp-package-full-2.0.0-SNAPSHOT.deb |
+| # sudo dpkg -i apex-pdp-package-full-2.0.0-SNAPSHOT.deb |
| Selecting previously unselected package apex-uservice. |
| (Reading database ... 288458 files and directories currently installed.) |
| Preparing to unpack apex-pdp-package-full-2.0.0-SNAPSHOT.deb ... |
.. container:: content
|Extract the TAR archive|
-
+
.. container:: paragraph
The right-click on the new created TAR file and extract the actual
directory. Use Maven to build APEX (all details on building
APEX from source can be found in *APEX HowTo: Build*).
Install from the created artifacts (``rpm``, ``deb``,
- ``tar.gz``, or copying manually).
+ ``tar.gz``, or copy manually).
- .. important::
- Building RPM distributions
- RPM images are only build if the ``rpm`` package is installed (Unix). To install ``rpm`` run ``sudo apt-get install rpm``,
- then build APEX.
+ .. important::
+ Building RPM distributions
+ RPM images are only build if the ``rpm`` package is installed (Unix). To install ``rpm`` run ``sudo apt-get install rpm``,
+ then build APEX.
.. container:: paragraph
The following example shows how to build the APEX system,
- without tests (``-DskipTests``) to safe some time. It
- assumes that the APX GIT repositories are cloned to:
+ without tests (``-DskipTests``) to save some time. It
+ assumes that the APEX GIT repositories are cloned to:
.. container:: ulist
- Windows: ``C:\dev\apex``
- +-------------------------------------------------------+--------------------------------------------------------+
+ +-------------------------------------------------------+--------------------------------------------------------+
| Unix, Cygwin | Windows |
+=======================================================+========================================================+
| .. container:: | .. container:: |
The build takes about 2 minutes without test and about 4-5 minutes
with tests on a standard development laptop. It should run through
without errors, but with a lot of messages from the build process. If
- build with tests (i.e. without ``-DskipTests``), there will be error
+ built with tests (i.e. without ``-DskipTests``), there will be error
messages and stack trace prints from some tests. This is normal, as
- long as the build finishes successful.
+ long as the build finishes successfully.
.. container:: paragraph
.. container:: ulist
- - ``APEX_USER`` with the user under whos name and permission APEX
+ - ``APEX_USER`` with the user under whose name and permission APEX
should be started (Unix only)
- ``APEX_HOME`` with the directory where APEX is installed (Unix,
.. container:: paragraph
The first row in the following table shows how to set these
- environment variables temporary (assuming the user is
+ environment variables temporarily (assuming the user is
``apexuser``). The second row shows how to verify the settings.
The last row explains how to set those variables permanently.
| | |
| # export APEX_USER=apexuser | >set APEX_HOME=C:\apex\apex-full-2.0.0-SNAPSHOT |
| # cd /opt/app/policy/apex-pdp | |
- | # export APEX_HOME=`pwd` | |
+ | # export APEX_HOME=`pwd` | |
| | |
+------------------------------------------------+ |
| .. container:: | |
| | |
| # setenv APEX_USER apexuser | |
| # cd /opt/app/policy/apex-pdp | |
- | # setenv APEX_HOME `pwd` | |
+ | # setenv APEX_HOME `pwd` | |
| | |
+------------------------------------------------+---------------------------------------------------------+
| .. container:: | .. container:: |
| | |
| # env | grep APEX | >set APEX_HOME |
| # APEX_USER=apexuser | APEX_HOME=\apex\apex-full-2.0.0-SNAPSHOT |
- | # APEX_HOME=/opt/app/policy/apex-pdp | |
+ | # APEX_HOME=/opt/app/policy/apex-pdp | |
| | |
+------------------------------------------------+---------------------------------------------------------+
.. container:: paragraph
- For a per-user setting, edit the a user’s ``bash`` or ``tcsh``
+ For a per-user setting, edit the user’s ``bash`` or ``tcsh``
settings in ``~/.bashrc`` or ``~/.tcshrc``. For system-wide
settings, edit ``/etc/profiles`` (requires permissions).
.. container:: paragraph
Make sure that the log directory exists. This is important when
- APEX was installed manually or when the log directory was changed
+ APEX is installed manually or when the log directory is changed
in the settings (see above).
-
+
+------------------------------------------------------------------+-------------------------------------------------------+
| Unix, Cygwin | Windows |
+==================================================================+=======================================================+
.. code:: bash
:number-lines:
- # $APEX_HOME/bin/apexEngine.sh -c $APEX_HOME/examples/config/SampleDomain/Stdin2StdoutJsonEventJava.json (1)
- # $APEX_HOME/bin/apexEngine.sh -c C:/apex/apex-full-2.0.0-SNAPSHOT/examples/config/SampleDomain/Stdin2StdoutJsonEventJava.json (2)
- >%APEX_HOME%\bin\apexEngine.bat -c %APEX_HOME%\examples\config\SampleDomain\Stdin2StdoutJsonEventJava.json :: (3)
+ # $APEX_HOME/bin/apexEngine.sh -c $APEX_HOME/examples/config/SampleDomain/Stdin2StdoutJsonEventJava.json (1)
+ # $APEX_HOME/bin/apexEngine.sh -c C:/apex/apex-full-2.0.0-SNAPSHOT/examples/config/SampleDomain/Stdin2StdoutJsonEventJava.json (2)
+ >%APEX_HOME%\bin\apexEngine.bat -c %APEX_HOME%\examples\config\SampleDomain\Stdin2StdoutJsonEventJava.json :: (3)
.. container:: colist arabic
.. container:: paragraph
The engine should start successfully. Assuming the logging levels are
- not change (default level is ``info``), the output should look
+ not changed (default level is ``info``), the output should look
similar to this (last few lines)
.. container:: listingblock
.. container:: paragraph
- Important are the last two line, stating that APEX has added the
+ Important are the last two lines, stating that APEX has added the
final action listener to the engine and that the engine is started.
.. container:: paragraph
.. container:: paragraph
The following table shows an input event in the left column and an
- output event in the right column. Past the input event into the
+ output event in the right column. Paste the input event into the
console where APEX is running, and the output event should appear in
the console. Pasting the input event multiple times will produce
output events with different values.
.. container:: paragraph
Installing and using the WAR applications requires a web server
- that can execute ``war`` web archives. We recommend to use
+ that can execute ``war`` web archives. We recommend using
`Apache Tomcat <https://tomcat.apache.org/>`__, however other
web servers can be used as well.
Documentation <https://tomcat.apache.org/tomcat-9.0-doc/index.html>`__
or the `Manager App
HOW-TO <https://tomcat.apache.org/tomcat-9.0-doc/manager-howto.html>`__.
- Once you installed an APEX WAR application (and wait for
+ Once you have installed an APEX WAR application (and wait for
sufficient time for Tomcat to finalize the installation), open
the ``Manager App`` in Tomcat. You should see the APEX WAR
application being installed and running.
information that is provided by other systems. APEX keeps
context coordinated across all the the instances running a
particular policy. If a policy running in an APEX engine
- changes the value of a piece of context, that value is is
+ changes the value of a piece of context, that value is
available to all other APEX engines that use that piece of
context. APEX takes care of distribution, locking, writing
of context to persistent storage, and monitoring of context.
An APEX engine can be configured to use various combinations
of event input handlers, event output handlers, event
protocols, context handlers, and logic executors. The system
- is build using a plugin architecture. Each configuration
+ is built using a plugin architecture. Each configuration
option is realized by a plugin, which can be loaded and
configured when the engine is started. New plugins can be
added to the system at any time, though to benefit from a
- new plugin an engine will need to be restarted.
+ new plugin, an engine will need to be restarted.
.. container:: imageblock
APEX offers a lot of flexibility for defining, deploying,
and executing policies. Based on a theoretic model, it
- supports virtually any policy model and allows to translate
+ supports virtually any policy model and supports translation of
legacy policies into the APEX execution format. However, the
most important aspect for using APEX is to decide what
policy is needed, what underlying policy concepts should be
- Feedback, i.e. why did something happen or not happen.
Similar to analysis, but here the feedback will be in the
- input event and the policy needs to something with that
+ input event and the policy needs to do something with that
information. Feedback can be related to history or
experience, for instance a previous policy execution. The
policy needs to be context-aware or be a meta-policy.
additional information of any kind but cannot
change/alter them
- - Global context (read and write), the policy the policy
+ - Global context (read and write), the policy
has access to additional information of any kind and can
alter this information (for instance to record historic
information)
| | For e.g. dmaap, noop, ueb |
+-----------------------------------+-----------------------------------+
| **10** | List of topics' details to which |
- | | messages are sent to. |
+ | | messages are sent. |
+-----------------------------------+-----------------------------------+
| **11** | Topic name of the sink to which |
- | | PDP-A sends messages to. |
+ | | PDP-A sends messages. |
+-----------------------------------+-----------------------------------+
| **12** | List of servers for the sink |
| | topic. |
APEX offers a lot of flexibility for defining, deploying,
and executing policies. Based on a theoretic model, it
- supports virtually any policy model and allows to
- translate legacy policies into the APEX execution format.
+ supports virtually any policy model and supports
+ translation of legacy policies into the APEX execution format.
However, the most important aspect for using APEX is to
decide what policy is needed, what underlying policy
concepts should be used, and how the decision logic
attempt to teach you about the scripting languages
themselves … that is up to you!
- .. tip::
- JVM-based scripting languages
- For more more information on scripting for the Java platform see: https://docs.oracle.com/javase/8/docs/technotes/guides/scripting/prog_guide/index.html
+ .. tip::
+ JVM-based scripting languages
+ For more more information on scripting for the Java platform see: https://docs.oracle.com/javase/8/docs/technotes/guides/scripting/prog_guide/index.html
- .. note::
- What do Tasks do?
- The function of an Apex Task is to provide the logic that can be executed for an Apex State as one of the steps in
- an Apex Policy. Each task receives some *incoming fields*, executes some logic (e.g: make a decision based on
- *shared state* or *context*, *incoming fields*, *external context*, etc.), perhaps set some *shared state* or
- *context* and then emits *outgoing fields*. The state that uses the task is responsible for extracting the
- *incoming fields* from the state input event. The state also has an *output mapper* associated with the task, and
- this *output mapper* is responsible for mapping the *outgoing fields* from the task into an appropriate
- output event for the state.
+ .. note::
+ What do Tasks do?
+ The function of an Apex Task is to provide the logic that can be executed for an Apex State as one of the steps in
+ an Apex Policy. Each task receives some *incoming fields*, executes some logic (e.g: make a decision based on
+ *shared state* or *context*, *incoming fields*, *external context*, etc.), perhaps set some *shared state* or
+ *context* and then emits *outgoing fields*. The state that uses the task is responsible for extracting the
+ *incoming fields* from the state input event. The state also has an *output mapper* associated with the task, and
+ this *output mapper* is responsible for mapping the *outgoing fields* from the task into an appropriate
+ output event for the state.
.. container:: paragraph
.. container:: content
- .. code:: javascript
+ .. code:: javascript
:number-lines:
/*
and exit.
.. note::
- How to return a value from task logic
- Some languages explicitly support returning values from the script (e.g. MVEL and JRuby) using an explicit
- return statement (e.g. ``return true``), other languages do not (e.g. JavaScript and Jython). For
- languages that do not support the ``return`` statement, a special field called ``returnValue`` must be
- created to hold the result of the task logic operation (i.e. assign a ``java.lang.Boolean``
- value to the ``returnValue`` field before completing the task).
- Also, in MVEL if there is no explicit return statement then the return value of the last executed statement will return
- (e.g. the statement a=(1+2) will return the value 3).
+ How to return a value from task logic
+ Some languages explicitly support returning values from the script (e.g. MVEL and JRuby) using an explicit
+ return statement (e.g. ``return true``), other languages do not (e.g. JavaScript and Jython). For
+ languages that do not support the ``return`` statement, a special field called ``returnValue`` must be
+ created to hold the result of the task logic operation (i.e. assign a ``java.lang.Boolean``
+ value to the ``returnValue`` field before completing the task).
+ Also, in MVEL if there is no explicit return statement then the return value of the last executed statement will return
+ (e.g. the statement a=(1+2) will return the value 3).
.. container:: paragraph
``executor`` keyword in MVEL):
Table 1. The ``executor`` Fields / Methods
-
+
+------------+-------------+--------------------------------+-------------------------------------------------------------------------------------+
| Name | Type | Java type | Description |
+============+=============+================================+=====================================================================================+
the scripting languages themselves … that is up to you!
.. tip::
- JVM-based scripting languages
- For more more information on Scripting for the Java platform see:
- https://docs.oracle.com/javase/8/docs/technotes/guides/scripting/prog_guide/index.html
-
- .. note::
- What does Task Selection Logic do?
- When an Apex state references multiple tasks, there must be a way to dynamically decide
- which task should be chosen and executed. This can depend on the many factors, e.g. the
- *incoming event for the state*, *shared state* or *context*, *external context*,
- etc.. This is the function of a state’s Task Selection Logic. Obviously, if there is
- only one task then Task only one task then Task Selection Logic is not needed.
- Each state must also select one of the tasks a the *default state*. If the Task
- Selection Logic is unable to select an appropriate task, then it should select the
- *default task*. Once the task has been selected the Apex Engine will then execute that
- task.
+ JVM-based scripting languages
+ For more more information on Scripting for the Java platform see:
+ https://docs.oracle.com/javase/8/docs/technotes/guides/scripting/prog_guide/index.html
+
+ .. note::
+ What does Task Selection Logic do?
+ When an Apex state references multiple tasks, there must be a way to dynamically decide
+ which task should be chosen and executed. This can depend on the many factors, e.g. the
+ *incoming event for the state*, *shared state* or *context*, *external context*,
+ etc.. This is the function of a state’s Task Selection Logic. Obviously, if there is
+ only one task then Task only one task then Task Selection Logic is not needed.
+ Each state must also select one of the tasks a the *default state*. If the Task
+ Selection Logic is unable to select an appropriate task, then it should select the
+ *default task*. Once the task has been selected the Apex Engine will then execute that
+ task.
.. container:: paragraph
be returned, but this will cause the policy invoking this task
will fail and exit.
- .. note::
+ .. note::
How to return a value from Task Selection Logic
- Some languages explicitly support returning values from the script (e.g. MVEL and
- JRuby) using an explicit return statement (e.g. ``return true``), other languages do not (e.g.
- JavaScript and Jython). For languages that do not support the ``return`` statement, a special field called
- ``returnValue`` must be created to hold the result of the task logic operation (i.e. assign a ``java.lang.Boolean``
- value to the ``returnValue`` field before completing the task).
- Also, in MVEL if there is not explicit return statement then the return value of the last executed statement will
- return (e.g. the statement a=(1+2) will return the value 3).
+ Some languages explicitly support returning values from the script (e.g. MVEL and
+ JRuby) using an explicit return statement (e.g. ``return true``), other languages do not (e.g.
+ JavaScript and Jython). For languages that do not support the ``return`` statement, a special field called
+ ``returnValue`` must be created to hold the result of the task logic operation (i.e. assign a ``java.lang.Boolean``
+ value to the ``returnValue`` field before completing the task).
+ Also, in MVEL if there is not explicit return statement then the return value of the last executed statement will
+ return (e.g. the statement a=(1+2) will return the value 3).
.. container:: paragraph
.. container:: content
- .. code:: javascript
+ .. code:: javascript
var albumProblemMap = executor.getContextAlbum("albumProblemMap");
var linkProblem = albumProblemMap.getSchemaHelper().createNewInstance();
.. container:: content
- .. code:: javascript
+ .. code:: javascript
var linkProblem = executor.getContextAlbum("albumProblemMap").getSchemaHelper().createNewInstance();
.. container:: content
- .. code::
+ .. code::
:number-lines:
git clone https://gerrit.onap.org/r/policy/apex-pdp
- Cygwin: ``/cygdrive/c/dev/apex-pdp``
- .. important::
+ .. important::
A Build requires ONAP Nexus
- APEX has a dependency to ONAP parent projects. You might need to adjust your Maven M2 settings. The most current
- settings can be found in the ONAP oparent repo: `Settings <https://git.onap.org/oparent/plain/settings.xml>`__.
+ APEX has a dependency to ONAP parent projects. You might need to adjust your Maven M2 settings. The most current
+ settings can be found in the ONAP oparent repo: `Settings <https://git.onap.org/oparent/plain/settings.xml>`__.
- .. important::
- A Build needs Space
- Building APEX requires approximately 2-3 GB of hard disc space, 1 GB for the actual build with full
- distribution and 1-2 GB for the downloaded dependencies
+ .. important::
+ A Build needs Space
+ Building APEX requires approximately 2-3 GB of hard disc space, 1 GB for the actual build with full
+ distribution and 1-2 GB for the downloaded dependencies
- .. important::
+ .. important::
A Build requires Internet (for first build)
- During the build, several (a lot) of Maven dependencies will be downloaded and stored in the configured local Maven
- repository. The first standard build (and any first specific build) requires Internet access to download those
- dependencies.
+ During the build, several (a lot) of Maven dependencies will be downloaded and stored in the configured local Maven
+ repository. The first standard build (and any first specific build) requires Internet access to download those
+ dependencies.
- .. important::
+ .. important::
Building RPM distributions
- RPM images are only build if the ``rpm`` package is installed (Unix). To install ``rpm`` run ``sudo apt-get install rpm``,
- then build APEX.
+ RPM images are only build if the ``rpm`` package is installed (Unix). To install ``rpm`` run ``sudo apt-get install rpm``,
+ then build APEX.
.. container:: paragraph
.. container:: content
- .. code::
+ .. code::
:number-lines:
[INFO] tools .............................................. SUCCESS [ 0.248 s]
| .. container:: content |
| |
| .. code:: |
-| :number-lines: |
+| :number-lines: |
| |
-| # sudo dpkg -i apex-pdp-package-full-2.0.0-SNAPSHOT.deb |
+| # sudo dpkg -i apex-pdp-package-full-2.0.0-SNAPSHOT.deb |
| Selecting previously unselected package apex-uservice. |
| (Reading database ... 288458 files and directories currently installed.) |
| Preparing to unpack apex-pdp-package-full-2.0.0-SNAPSHOT.deb ... |
.. container:: content
- .. code::
+ .. code::
:number-lines:
# cd /opt
.. container:: content
- .. code::
+ .. code::
:number-lines:
>c:
from the created artifacts (``rpm``, ``deb``, ``tar.gz``, or
copying manually).
- .. important::
- Building RPM distributions
- RPM images are only build if the ``rpm`` package is installed (Unix). To install ``rpm`` run
- ``sudo apt-get install rpm``, then build APEX.
+ .. important::
+ Building RPM distributions
+ RPM images are only build if the ``rpm`` package is installed (Unix). To install ``rpm`` run
+ ``sudo apt-get install rpm``, then build APEX.
.. container:: paragraph
- Windows: ``C:\dev\apex``
- +-------------------------------------------------------+--------------------------------------------------------+
+ +-------------------------------------------------------+--------------------------------------------------------+
| Unix, Cygwin | Windows |
+=======================================================+========================================================+
| .. container:: | .. container:: |
.. container:: content
- .. code::
+ .. code::
:number-lines:
[INFO] tools .............................................. SUCCESS [ 0.248 s]
.. container:: content
- .. code::
+ .. code::
:number-lines:
# sudo groupadd apexuser
| | |
| # export APEX_USER=apexuser | >set APEX_HOME=C:\apex\apex-full-2.0.0-SNAPSHOT |
| # cd /opt/app/policy/apex-pdp | |
- | # export APEX_HOME=`pwd` | |
+ | # export APEX_HOME=`pwd` | |
| | |
+------------------------------------------------+ |
| .. container:: | |
| | |
| .. container:: content | |
| | |
- | .. code:: tcsh | |
+ | .. code::tcsh | |
| :number-lines: | |
| | |
| # setenv APEX_USER apexuser | |
| # cd /opt/app/policy/apex-pdp | |
- | # setenv APEX_HOME `pwd` | |
+ | # setenv APEX_HOME `pwd` | |
| | |
+------------------------------------------------+---------------------------------------------------------+
| .. container:: | .. container:: |
| | |
| # env | grep APEX | >set APEX_HOME |
| # APEX_USER=apexuser | APEX_HOME=\apex\apex-full-2.0.0-SNAPSHOT |
- | # APEX_HOME=/opt/app/policy/apex-pdp | |
+ | # APEX_HOME=/opt/app/policy/apex-pdp | |
| | |
+------------------------------------------------+---------------------------------------------------------+
.. container:: content
- .. code::
+ .. code::
:number-lines:
Starting Apex service with parameters [] . . .
.. container:: content
- .. code::
+ .. code::
:number-lines:
- # $APEX_HOME/bin/apexEngine.sh -c $APEX_HOME/examples/config/SampleDomain/Stdin2StdoutJsonEventJava.json (1)
- # $APEX_HOME/bin/apexEngine.sh -c C:/apex/apex-full-2.0.0-SNAPSHOT/examples/config/SampleDomain/Stdin2StdoutJsonEventJava.json (2)
- >%APEX_HOME%\bin\apexEngine.bat -c %APEX_HOME%\examples\config\SampleDomain\Stdin2StdoutJsonEventJava.json :: (3)
+ # $APEX_HOME/bin/apexEngine.sh -c $APEX_HOME/examples/config/SampleDomain/Stdin2StdoutJsonEventJava.json (1)
+ # $APEX_HOME/bin/apexEngine.sh -c C:/apex/apex-full-2.0.0-SNAPSHOT/examples/config/SampleDomain/Stdin2StdoutJsonEventJava.json (2)
+ >%APEX_HOME%\bin\apexEngine.bat -c %APEX_HOME%\examples\config\SampleDomain\Stdin2StdoutJsonEventJava.json :: (3)
.. container:: colist arabic
.. container:: content
- .. code::
+ .. code::
:number-lines:
Starting Apex service with parameters [-c, v:/dev/ericsson/apex/onap/apex-pdp/packages/apex-pdp-package-full/target/install_hierarchy/examples/config/SampleDomain/Stdin2StdoutJsonEventJava.json] . . .
.. container:: content
- .. code::
+ .. code::
:number-lines:
# $APEX_HOME/bin/apexApps.sh rest-editor
.. container:: content
- .. code::
+ .. code::
:number-lines:
>%APEX_HOME%\bin\apexApps.bat rest-editor
.. container:: content
- .. code::
+ .. code::
:number-lines:
Apex Editor REST endpoint (ApexEditorMain: Config=[ApexEditorParameters: URI=http://localhost:18989/apexservices/, TTL=-1sec], State=READY) starting at http://localhost:18989/apexservices/ . . .
.. container:: content
- .. code::
+ .. code::
:number-lines:
#
.. container:: content
- .. code::
+ .. code::
{
"engineServiceParameters":{
.. container:: content
- .. code::
+ .. code::
"engineServiceParameters" : {
"name" : "AADMApexEngine", (1)
.. container:: content
- .. code::
+ .. code::
"eventInputParameters": { (1)
"FirstConsumer": { (2)
.. container:: content
- .. code::
+ .. code::
"eventInputParameters": {
"Input1": {
.. container:: content
- .. code::
+ .. code::
"engineServiceParameters":{
"engineParameters":{
.. container:: content
- .. code::
+ .. code::
"engineServiceParameters":{
"engineParameters":{
.. container:: content
- .. code::
+ .. code::
"engineServiceParameters":{
"engineParameters":{
.. container:: content
- .. code::
+ .. code::
"engineServiceParameters":{
"engineParameters":{
.. container:: content
- .. code::
+ .. code::
"engineServiceParameters":{
"engineParameters":{
.. container:: content
- .. code::
+ .. code::
"engineServiceParameters":{
"engineParameters":{
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "FILE", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "FILE", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "FILE", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology": "EVENT_REQUESTOR" (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology": "EVENT_REQUESTOR" (1)
.. container:: content
- .. code::
+ .. code::
"eventInputParameters": {
"EventRequestorConsumer": {
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "KAFKA", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "KAFKA", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "JMS", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "JMS", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "WEBSOCKET", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "WEBSOCKET", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "RESTCLIENT", (1)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters" : {
"carrierTechnology" : "RESTCLIENT", (1)
.. container:: content
- .. code::
+ .. code::
"eventInputParameters": {
"MyConsumer": {
.. container:: content
- .. code::
+ .. code::
"eventOutputParameters": {
"MyProducer": {
.. container:: content
- .. code::
+ .. code::
<servlet>
...
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters": {
"carrierTechnology": "RESTREQUESTOR", (1)
.. container:: content
- .. code::
+ .. code::
"eventName": "GuardResponseEvent", (1)
"eventNameFilter": "GuardResponseEvent", (2)
.. container:: content
- .. code::
+ .. code::
"carrierTechnologyParameters": {
"carrierTechnology": "RESTREQUESTOR", (1)
.. container:: content
- .. code::
+ .. code::
"eventNameFilter": "GuardRequestEvent", (1)
"requestorMode": true, (2)
.. container:: content
- .. code::
+ .. code::
"eventProtocolParameters":{
"eventProtocol" : "JSON"
.. container:: content
- .. code::
+ .. code::
"eventProtocolParameters":{
"eventProtocol" : "JSON",
.. container:: content
- .. code::
+ .. code::
"eventProtocolParameters":{
"eventProtocol" : "APEX"
.. container:: content
- .. code::
+ .. code::
"eventProtocolParameters":{
"eventProtocol" : "JMSTEXT",
.. container:: content
- .. code::
+ .. code::
"eventProtocolParameters":{
"eventProtocol" : "JMSOBJECT",
.. container:: content
- .. code::
+ .. code::
"eventProtocolParameters":{
"eventProtocol" : "XML",
.. container:: content
- .. code::
+ .. code::
"eventProtocolParameters":{
"eventProtocol" : "XML",
.. container:: content
- .. code::
+ .. code::
{
"engineServiceParameters" : {
.. container:: content
- .. code::
+ .. code::
usage: org.onap.policy.apex.service.engine.main.ApexMain [options...]
options
.. container:: content
- .. code::
+ .. code::
usage: org.onap.policy.apex.auth.clieditor.ApexCLIEditorMain [options...]
options
.. container:: content
- .. code::
+ .. code::
usage: org.onap.policy.apex.client.editor.rest.ApexEditorMain [options...]
-h,--help outputs the usage of this command
.. container:: content
- .. code::
+ .. code::
Apex Editor REST endpoint (ApexEditorMain: Config=[ApexEditorParameters: URI=http://localhost:18989/apexservices/, TTL=-1sec], State=READY) starting at http://localhost:18989/apexservices/ . . .
Sep 05, 2018 11:24:30 PM org.glassfish.grizzly.http.server.NetworkListener start
.. container:: content
- .. code::
+ .. code::
usage: org.onap.policy.apex.client.monitoring.rest.ApexMonitoringRestMain [options...]
-h,--help outputs the usage of this command
.. container:: content
- .. code::
+ .. code::
Apex Services REST endpoint (ApexMonitoringRestMain: Config=[ApexMonitoringRestParameters: URI=http://localhost:18989/apexservices/, TTL=-1sec], State=READY) starting at http://localhost:18989/apexservices/ . . .
Sep 05, 2018 11:26:20 PM org.glassfish.grizzly.http.server.NetworkListener start
.. container:: content
- .. code::
+ .. code::
usage: org.onap.policy.apex.client.deployment.rest.ApexDeploymentRestMain [options...]
-h,--help outputs the usage of this command
.. container:: content
- .. code::
+ .. code::
Apex Services REST endpoint (ApexDeploymentRestMain: Config=[ApexDeploymentRestParameters: URI=http://localhost:18989/apexservices/, TTL=-1sec], State=READY) starting at http://localhost:18989/apexservices/ . . .
Sep 05, 2018 11:27:09 PM org.glassfish.grizzly.http.server.NetworkListener start
.. container:: content
- .. code::
+ .. code::
usage: org.onap.policy.apex.client.full.rest.ApexServicesRestMain [options...]
-h,--help outputs the usage of this command
.. container:: content
- .. code::
+ .. code::
Apex Editor REST endpoint (ApexServicesRestMain: Config=[ApexServicesRestParameters: URI=http://localhost:18989/apexservices/, TTL=-1sec], State=READY) starting at http://localhost:18989/apexservices/ . . .
Sep 05, 2018 11:28:28 PM org.glassfish.grizzly.http.server.NetworkListener start
.. container:: content
- .. code::
+ .. code::
apexApps.sh - runs APEX applications
.. container:: content
- .. code::
+ .. code::
apexApps.sh: supported applications:
--> ws-echo engine eng-monitoring full-client eng-deployment tpl-event-json model-2-cli rest-editor cli-editor ws-console
.. container:: content
- .. code::
+ .. code::
apexApps.sh: application 'ws-console'
--> a simple console sending events to APEX, connect to APEX consumer port
.. container:: content
- .. code::
+ .. code::
apexApps.sh ws-echo -p 8888
.. container:: content
- .. code::
+ .. code::
gen-model2event v{release-version} - generates JSON templates for events generated from a policy model
usage: gen-model2event
.. container:: content
- .. code::
+ .. code::
apexApps.sh tpl-event-json -m $APEX_HOME/examples/models/SampleDomain/SamplePolicyModelJAVA.json -t stimuli
.. container:: content
- .. code::
+ .. code::
gen-model2event: starting Event generator
--> model file: examples/models/SampleDomain/SamplePolicyModelJAVA.json
.. container:: content
- .. code::
+ .. code::
{
"name" : "Event0000",
.. container:: content
- .. code::
+ .. code::
usage: gen-model2cli
-h,--help prints this help and usage screen
.. container:: content
- .. code::
+ .. code::
apexApps.sh model-2-cli -m $APEX_HOME/examples/models/SampleDomain/SamplePolicyModelJAVA.json
.. container:: content
- .. code::
+ .. code::
gen-model2cli: starting CLI generator
--> model file: examples/models/SampleDomain/SamplePolicyModelJAVA.json
parameter fields.
.. tip
-
- .. container:: title
-
- Field Schema types
-
- .. container:: paragraph
-
- APEX natively supports schema definitions in ``Java`` and ``Avro``.
-
- .. container:: paragraph
-
- ``Java`` schema definitions are simply the name of a Java Class. There are some restrictions:
-
- .. container:: ulist
-
- - the class must be instantiatable, i.e. not an Java interface or abstract class
-
- - primitive types are not supported, i.e. use ``java.lang.Integer`` instead of ``int``, etc.
-
- - it must be possible to find the class, i.e. the class must be contained in the Java classpath.
-
- .. container:: paragraph
-
- ``Avro`` schema definitions can be any valid `Avro <https://avro.apache.org/docs/current/spec.html>`__
- schema. For events using fields defined with ``Avro`` schemas, any incoming event containing that field must
- contain a value that conforms to the Avro schema.
+
+ .. container:: title
+
+ Field Schema types
+
+ .. container:: paragraph
+
+ APEX natively supports schema definitions in ``Java`` and ``Avro``.
+
+ .. container:: paragraph
+
+ ``Java`` schema definitions are simply the name of a Java Class. There are some restrictions:
+
+ .. container:: ulist
+
+ - the class must be instantiatable, i.e. not an Java interface or abstract class
+
+ - primitive types are not supported, i.e. use ``java.lang.Integer`` instead of ``int``, etc.
+
+ - it must be possible to find the class, i.e. the class must be contained in the Java classpath.
+
+ .. container:: paragraph
+
+ ``Avro`` schema definitions can be any valid `Avro <https://avro.apache.org/docs/current/spec.html>`__
+ schema. For events using fields defined with ``Avro`` schemas, any incoming event containing that field must
+ contain a value that conforms to the Avro schema.
.. container:: paragraph
the event definition pane.
.. tip::
- Optional Fields in APEX Events
- Parameter fields can be *optional* in events. If a parameter is not marked as *optional* then by default it
- is *mandatory*, so it must appear in any input event passed to APEX. If an *optional* field is not set
- for an output event then value will be set to ``null``.
+ Optional Fields in APEX Events
+ Parameter fields can be *optional* in events. If a parameter is not marked as *optional* then by default it
+ is *mandatory*, so it must appear in any input event passed to APEX. If an *optional* field is not set
+ for an output event then value will be set to ``null``.
.. container:: imageblock
.. container:: content
- .. code::
+ .. code::
/*
* ============LICENSE_START=======================================================
.. container:: content
- .. code::
+ .. code::
/*
* ============LICENSE_START=======================================================
default task is automatically selected and no 'Task
Selection Logic' is required.
- .. note::
- .. container:: title
-
- State Output Mappings
-
- .. container:: paragraph
-
- In a 'Policy' 'State' a 'State Output Mapping' has 3 roles:
- 1) Select which 'State' should be executed next, 2) Select
- the type of the state’s 'Outgoing Event', and 3)
- Populate the state’s 'Outgoing Event'. This is how states are
- chained together to form a (`Directed Acyclic Graph
- (DAG) <https://en.wikipedia.org/wiki/Directed_acyclic_graph>`__ )
- of states. The final state(s) of a policy are those that do
- not select any 'next' state. Since a 'State' can only
- accept a single type of event, the type of the event emitted
- by a previous 'State' must be match the incoming event type
- of the next 'State'. This is also how the last state(s) in
- a policy can emit events of different types. The 'State
- Output Mapping' is also responsible for taking the
- fields that are output by the task executed in the state and
- populating the state’s output event before it is emitted.
-
- .. container:: paragraph
-
- Each 'Task' referenced in 'State' must have a defined
- 'Output Mapping' to take the output of the task, select an
- 'Outgoing Event' type for the state, populate the state’s
- outgoing event, and then select the next state to be
- executed (if any).
-
- .. container:: paragraph
-
- There are 2 basic types of output mappings:
-
- .. container:: olist arabic
-
- #. **Direct Output Mappings** have a single value for
- 'Next State' and a single value for 'State Output
- Event'. The outgoing event for the state is
- automatically created, any outgoing event parameters
- that were present in the incoming event are copied
- into the outgoing event, then any task output fields
- that have the same name and type as parameters in the
- outgoing event are automatically copied into
- the outgoing event.
-
- #. **Logic-based State Output Mappings / Finalizers**
- have some logic defined that dynamically selects
- and creates the 'State Outgoing Event', manages
- the population of the outgoing event parameters
- (perhaps changing or adding to the outputs from the
- task), and then dynamically selects the next state to
- be executed (if any).
+ .. note::
+ .. container:: title
+
+ State Output Mappings
+
+ .. container:: paragraph
+
+ In a 'Policy' 'State' a 'State Output Mapping' has 3 roles:
+ 1) Select which 'State' should be executed next, 2) Select
+ the type of the state’s 'Outgoing Event', and 3)
+ Populate the state’s 'Outgoing Event'. This is how states are
+ chained together to form a (`Directed Acyclic Graph
+ (DAG) <https://en.wikipedia.org/wiki/Directed_acyclic_graph>`__ )
+ of states. The final state(s) of a policy are those that do
+ not select any 'next' state. Since a 'State' can only
+ accept a single type of event, the type of the event emitted
+ by a previous 'State' must be match the incoming event type
+ of the next 'State'. This is also how the last state(s) in
+ a policy can emit events of different types. The 'State
+ Output Mapping' is also responsible for taking the
+ fields that are output by the task executed in the state and
+ populating the state’s output event before it is emitted.
+
+ .. container:: paragraph
+
+ Each 'Task' referenced in 'State' must have a defined
+ 'Output Mapping' to take the output of the task, select an
+ 'Outgoing Event' type for the state, populate the state’s
+ outgoing event, and then select the next state to be
+ executed (if any).
+
+ .. container:: paragraph
+
+ There are 2 basic types of output mappings:
+
+ .. container:: olist arabic
+
+ #. **Direct Output Mappings** have a single value for
+ 'Next State' and a single value for 'State Output
+ Event'. The outgoing event for the state is
+ automatically created, any outgoing event parameters
+ that were present in the incoming event are copied
+ into the outgoing event, then any task output fields
+ that have the same name and type as parameters in the
+ outgoing event are automatically copied into
+ the outgoing event.
+
+ #. **Logic-based State Output Mappings / Finalizers**
+ have some logic defined that dynamically selects
+ and creates the 'State Outgoing Event', manages
+ the population of the outgoing event parameters
+ (perhaps changing or adding to the outputs from the
+ task), and then dynamically selects the next state to
+ be executed (if any).
.. container:: paragraph
.. container:: content
- .. code::
+ .. code::
#-------------------------------------------------------------------------------
# ============LICENSE_START=======================================================
.. container:: content
- .. code::
+ .. code::
/*
* ============LICENSE_START=======================================================
.. container:: content
- .. code::
+ .. code::
/*
* ============LICENSE_START=======================================================
.. container:: content
- .. code::
+ .. code::
{
"engineServiceParameters" : {
.. container:: content
- .. code::
+ .. code::
#-------------------------------------------------------------------------------
# ============LICENSE_START=======================================================
.. container:: content
- .. code::
+ .. code::
:number-lines:
<configuration debug="false">
.. container:: content
- .. code::
+ .. code::
:number-lines:
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
.. container:: content
- .. code::
+ .. code::
:number-lines:
<root level="info">
.. container:: content
- .. code::
+ .. code::
:number-lines:
<appender name="FILE" class="ch.qos.logback.core.FileAppender">
.. container:: content
- .. code::
+ .. code::
:number-lines:
<appender name="CTXT_FILE" class="ch.qos.logback.core.FileAppender">
.. container:: content
- .. code::
+ .. code::
:number-lines:
.. container:: content
- .. code::
+ .. code::
<statusListener class="ch.qos.logback.core.status.OnConsoleStatusListener" />
.. container:: content
- .. code::
+ .. code::
<configuration debug="true">
...
.. container:: content
- .. code::
+ .. code::
<logger name="org.infinispan" level="INFO" additivity="false">
<appender-ref ref="STDOUT" />
.. container:: content
- .. code::
+ .. code::
<logger name="org.apache.zookeeper.ClientCnxn" level="INFO" additivity="false">
<appender-ref ref="STDOUT" />
.. container:: content
- .. code::
+ .. code::
<appender name="POLICY_APPENDER_STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
.. container:: content
- .. code::
+ .. code::
<logger name="org.onap.policy.apex.executionlogging.TaskExecutionLogging" level="TRACE" additivity="false">
<appender-ref ref="POLICY_APPENDER_STDOUT" />
.. container:: content
- .. code::
+ .. code::
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${VAR_LOG}/apex.log</file>
.. container:: content
- .. code::
+ .. code::
<appender name="CTXT-FILE"
class="ch.qos.logback.core.rolling.RollingFileAppender">
.. container:: content
- .. code::
+ .. code::
<configuration debug="false">
<statusListener class="ch.qos.logback.core.status.NopStatusListener" />
.. container:: content
- .. code::
+ .. code::
<configuration debug="false">
<statusListener class="ch.qos.logback.core.status.NopStatusListener" />
.. container:: content
- .. code::
+ .. code::
:number-lines:
{
.. container:: content
- .. code::
+ .. code::
:number-lines:
#: $APEX_HOME/bin/apexEngine.sh -c $APEX_HOME/examples/config/VPN/Ws2WsServerAvroContextJsonEvent.json
.. container:: content
- .. code::
+ .. code::
:number-lines:
#: %APEX_HOME%\bin\apexEngine.bat -c %APEX_HOME%\examples\config\VPN\Ws2WsServerAvroContextJsonEvent.json
.. container:: content
- .. code::
+ .. code::
:number-lines:
2017-07-28 13:17:20,834 Apex [main] INFO c.e.a.s.engine.runtime.EngineService - engine model VPNPolicyModelAvro:0.0.1 added to the engine-AxArtifactKey:(name=VPNApexEngine-0,version=0.0.1)
.. important::
APEX engine needs to run first
- The example assumes that an APEX engine configured for *produce* carrier technology Websocket and *JSON* event protocol is executed first.
+ The example assumes that an APEX engine configured for *produce* carrier technology Websocket and *JSON* event protocol is executed first.
+---------------------------------------------------------+-----------------------------------------------------------+
| Unix, Cygwin | Windows |
.. container:: content
- .. code::
+ .. code::
# $APEX_HOME/bin/apexApps.sh ws-echo -p 42452 (1)
> %APEX_HOME%\bin\apexApps.bat ws-echo -p 42452 (2)
.. container:: content
- .. code::
+ .. code::
ws-simple-echo: starting simple event echo
--> server: localhost
.. important::
APEX engine needs to run first
- The example assumes that an APEX engine configured for *consume* carrier technology Websocket and *JSON* event
- protocol is executed first.
+ The example assumes that an APEX engine configured for *consume* carrier technology Websocket and *JSON* event
+ protocol is executed first.
+------------------------------------------------------------+--------------------------------------------------------------+
| Unix, Cygwin | Windows |
.. container:: content
- .. code::
+ .. code::
# $APEX_HOME/bin/apexApps.sh ws-console -p 42450 (1)
> %APEX_HOME%\bin\apexApps.sh ws-console -p 42450 (2)
.. container:: content
- .. code::
+ .. code::
ws-simple-console: starting simple event console
--> server: localhost
.. container:: content
- .. code::
+ .. code::
:number-lines:
#: $APEX_HOME/examples/events/VPN
.. container:: content
- .. code::
+ .. code::
:number-lines:
{Link=L09, LinkUp=true}
.. container:: content
- .. code::
+ .. code::
:number-lines:
ws-simple-echo: received
.. important::
A Build needs Space
- Building distribution requires approximately 1-2 GB of hard disc space, 100 MB for the actual build with full
+ Building distribution requires approximately 1-2 GB of hard disc space, 100 MB for the actual build with full
distribution and around 1 GB for the downloaded dependencies.
.. important::
The build will have created all artifacts required for distribution
installation. The following example show how to change to the target
- directory and how it should look like.
+ directory and how it should look.
+----------------------------------------------------------------------------------------------------------------------------+
| Unix, Cygwin |
.. container:: paragraph
- The right-click on the new created TAR file and extract the actual
+ Then right-click on the new created TAR file and extract the actual
distribution.
|
A distribution engine can be configured to use various combinations
of policy reception handlers, policy decoders and policy forwarders.
- The system is build using a plugin architecture. Each configuration
+ The system is built using a plugin architecture. Each configuration
option is realized by a plugin, which can be loaded and
configured when the engine is started. New plugins can be
added to the system at any time, though to benefit from a
- new plugin an engine will need to be restarted.
+ new plugin, an engine will need to be restarted.
|
Code Review / policy / parent.git / commitdiff