1SW-COLLECTOR(8)                   strongSwan                   SW-COLLECTOR(8)
2
3
4

NAME

6       sw-collector  - Extracts software installation events from dpkg history
7       log
8

SYNOPSIS

10       sw-collector [--debug level] [--quiet] [--count event-count]
11
12       sw-collector [--debug level] [--quiet] [--installed|--removed]
13                    --list|--unregistered
14
15       sw-collector [--debug level] [--quiet] [--installed|--removed] [--full]
16                    --generate
17
18       sw-collector [--debug level] [--quiet] --migrate
19
20       sw-collector [--debug level] [--quiet] --check
21
22       sw-collector -h | --help
23

DESCRIPTION

25       sw-collector extracts information about software package  installation,
26       update  or removal events from the apt history log and stores the soft‐
27       ware events in an SQLite database. The retrieved history information is
28       then merged and made consistent with the actual list of installed soft‐
29       ware packages obtained with dpkg-query.
30

OPTIONS

32       -h, --help
33              Prints usage information and a short summary  of  the  available
34              commands.
35
36       -v, --debug level
37              Set debug level, default: 2.
38
39       -q, --quiet
40              Disable debug output to stderr.
41
42       -i, --installed
43              Apply command to installed software packages, only.
44
45       -r, --removed
46              Apply command to removed software packages, only.
47
48       -f, --full
49              Generate  ISO  19770-2:2015 SWID tags with full file information
50              (possible for installed software packages, only).
51
52       -l, --list
53              Lists all software packages stored  in  the  collector  database
54              showing their installation status.
55
56       -u, --unregistered
57              Lists  all  software  packages  residing  in the local collector
58              database but for which no SWID tags exist yet in a central  col‐
59              lector database reachable via a REST interface.
60
61       -g, --generate
62              Generates  ISO  19770-2:2015 SWID tags for all software packages
63              residing in the local collector database but for which  no  SWID
64              tags  exist in a central collector database reachable via a REST
65              interface.
66
67       -m, --migrate
68              Can be used to migrate collector  database  versions.  Currently
69              all architecture suffixes are removed from dpkg package names.
70
71       -C, --check
72              Checks  the  integrity  of  the  collector  database against the
73              actual list of installed packages obtained with dpkg-query.
74

CONFIGURATION

76       The following parameters can be configured in strongswan.conf:
77
78        sw-collector {
79           database = sqlite:///etc/pts/collector.db
80           history = /var/log/apt/history.log
81           first_time = 2016-04-22T20:55:14Z
82           rest_api {
83              uri = https://admin-user:ietf99hackathon@tnc.strongswan.org/api/
84              timeout = 120
85           }
86        }
87
88       The parameters of the swid_generator used with the  --generate  command
89       can be changed in the libimcv section of strongswan.conf:
90
91        libimcv {
92           swid_gen {
93              command = /usr/local/bin/swid_generator
94              tag_creator {
95                 name = strongSwan Project
96                 regid = strongswan.org
97              }
98           }
99        }
100

FILES

102       @PKGDATADIR@/templates/database/sw-collector/sw_collector_tables.sql
103

SEE ALSO

105       strongswan.conf(5)
106
107
108
109
1105.7.2                             2017-08-25                   SW-COLLECTOR(8)