blob: cce201d3b5552a5902bb7412c9fab522a40dfb25 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
Installation
============
An environment suitable for running docker containers is recommended.
If that is not available, SNMPTRAP source can be downloaded and run
in a VM or on baremetal.
Both scenarios are documented below.
As a docker container
---------------------
**trapd** is delivered as a docker container based on python 3.6. The
host or VM that will run this container must have the docker application
loaded and available to the userID that will be running the SNMPTRAP container.
If running from a docker container, it is assumed that *Config
Binding Service* has been installed and is successfully providing valid
configuration assets to instantiated containers as needed.
Also required is a working DMAAP/MR environment. trapd
publishes traps to DMAAP/MR as JSON messages and expects the host
resources and publishing credentials to be included in the *Config Binding Service*
config.
Installation
^^^^^^^^^^^^
The following command will download the latest trapd container from
nexus and launch it in the container named "trapd":
``docker run --detach -t --rm -p 162:6162/udp -P --name=trapd nexus3.onap.org:10001/onap/org.onap.dcaegen2.collectors.snmptrap:2.0.3 ./bin/snmptrapd.sh start``
Running an instance of **trapd** will result in arriving traps being published
to the topic specified by Config Binding Services.
Standalone
----------
**trapd** can also be run outside of a container environment, without CBS interactions.
If CBS is not present, SNMPTRAP will look for a JSON configuration file specified via the
environment variable CBS_SIM_JSON at startup. Location of this file should be specified
as a relative path from the <SNMPTRAP base directory>/bin directory. E.g.
Installation
^^^^^^^^^^^^
Prerequisites
"""""""""""""
trapd requires the following to run in a non-docker environment:
- Python 3.6+
- Python module “pysnmp” 4.4.5
- Python module “requests” 2.18.3
To install prerequisites:
``export PATH=<path to Python 3.6 binary>:$PATH``
``pip3 install --no-cache-dir requests==2.18.3``
``pip3 install --no-cache-dir pysnmp==4.4.5``
Download latest trapd version from Gerrit
"""""""""""""""""""""""""""""""""""""""""
Download a copy of the latest trapd image from gerrit in it's standard runtime location:
``cd /opt/app``
``git clone --depth 1 ssh://<your linux foundation id>@gerrit.onap.org:29418/dcaegen2/collectors/snmptrap snmptrap``
"Un-dockerize"
""""""""""""""
``mv /opt/app/snmptrap/snmptrap /opt/app/snmptrap/bin``
Configure for your environment
""""""""""""""""""""""""""""""
In a non-docker environment, ONAP trapd is controlled by a locally hosted JSON configuration file. It is
referenced in the trapd startup script as:
.. code-block:: bash
CBS_SIM_JSON=../etc/snmptrapd.json
This file should be in the exact same format is the response from CBS in a fully implemented container/controller environment. A sample file is included with source/container images, at:
.. code-block:: bash
/opt/app/snmptrap/etc/snmptrapd.json
Make applicable changes to this file - typically things that will need to change include:
.. code-block:: bash
"topic_url": "http://localhost:3904/events/ONAP-COLLECTOR-SNMPTRAP"
Action: Change 'localhost' and topic name (ONAP-COLLECTOR-SNMPTRAP) to desired values in your environment.
.. code-block:: bash
"snmpv3_config" (needed only when SNMPv3 agents are present)
Action: Add/delete/modify entries as needed to align with SNMP agent configurations in a SNMPv3 environment.
Start the application
"""""""""""""""""""""
``nohup /opt/app/snmptrap/bin/snmptrapd.sh start > /opt/app/snmptrap/logs/snmptrapd.out 2>&1 &``
|
