Introduction#

The Subscriber Data Extract is a capability to provide an adhoc or scheduled basic data feed via the generation of a set of files.

The content of the files is settings around Subscribers and other key services in order to support billing/expense management operations and is not intended as a general data feed.

Additional fields or files may be added to the collection over time via the roadmap, so any planned file consumption should take that into account to minimize impact.

Data Export Overview#

The voss export command is used to carry out a bulk data export from the VOSS Automate system database. The exported data can for example be imported into a warehouse.

Important

Since a data export can take time, the voss export command can only be run in a screen session. First run screen and then voss export and its parameters.

Type voss export help for details.

The data extract schedule can be managed with the schedule command. For details on the use of the command, see: Scheduling. Since bulk data exports can typically take more than an hour on a scale system, it is recommended to schedule this task instead of running it manually from the console.

The export file format is JSON as per RFC 7159. For details on the filename, format and contents of the export files, refer to the Data Export Types topic in the Appendices.

The voss export command takes a type or group parameter to indicate the type of data to export.

The following are values of the group parameter:

  • subscriber

  • license

For example:

voss export group subscriber

platform@VOSS:~$ voss export group subscriber
Starting subscriber group export consisting of analogue_line_mgcp,
 analogue_line_sccp, call_pickup_group, contact_center_enterprise,
 contact_center_express, customer, extension_mobility, fmc,
 hunt_group, line, phones, site, subscriber, webex_teams, please wait...
Starting analogue_line_mgcp export, please wait...
Completed analogue_line_mgcp export,
 created 2019-09-30_0859_analogue_line_mgcp.json.gz.
[...]