Tsv Exporter Worker
The Tsv Exporter Worker is a Web Application built to support the .NET WorkerService technology and leverages MibWorker. Currently in its beta phase, only the export module for Front is included in this distribution. The worker solution is designed to provide a reliable, lightweight and streamlined approach to handling export tasks, when compared to the Agent distribution.
Installation
To get started with the Tsv Exporter Worker, spin up a Docker container using the mib-workers-tsv-exporter
image. More details about our Docker Image Feeds can be found here.
Dependent services
- MibServer3
- MibServerApi
- MibAuthorization
- MibPermissions
- MibFileManagement (required if using File Management Microservice)
Note
By default, the service is published on port 8680
and provides a route for controlling the health of the service: /health
Configurations
Workers count
The Front export module is enabled by default, with a single worker. Number of workers can be customized with the environment variable below. Setting 0
disables the module.
MIBWORKERCONFIG_FRONTTSVEXPORTERWORKER_INSTANCESCOUNT=1
Heartbeat Interval
Defaults to 10000
milliseconds. This is the time interval that the worker checks for new jobs.
MIBWORKERCONFIG_FRONTTSVEXPORTERWORKER_HEARTBEATINTERVALMILLISECONDS=10000
Common configurations
These configurations are shared among all export modules.
MibDatabaseConfig - required
Configuration used to indicate the front database, which is the one also used by MibServer3.
MIBDATABASECONFIG_DEFAULT_DATABASE=FRONT
MIBDATABASECONFIG_DEFAULT_SERVER=db.sqlserver.example.com
MIBDATABASECONFIG_DEFAULT_TYPE=sql2005
MIBDATABASECONFIG_DEFAULT_USERNAME=username
MIBDATABASECONFIG_DEFAULT_PASSWORD=secret
Refer to MibDatabaseConfig for complete list of configuration keys.
MibPermissionMicroServiceClientConfig - required
Indicates the url of the Mib Permission Microservice.
MIBPERMISSIONMICROSERVICECLIENTCONFIG_DEFAULT_URLMICROSERVICE=http://permissions
StorageLibConfig - required
Note
Required only when not using File Management Microservice
Indicates the directory in which the final export files should be stored inside the container. A docker volume can be mapped to the specified path.
MIBSTORAGELIB2CONFIG_DEFAULT_TYPE=disk
MIBSTORAGELIB2CONFIG_DISK_PATH=/app/storage/tsv
MibAuthorizationClientConfig - required
MIBAUTHORIZATIONCLIENTCONFIG_DEFAULT_SERVERURL=http://authorization
MIBAUTHORIZATIONCLIENTCONFIG_DEFAULT_CLIENTID=clientid
MIBAUTHORIZATIONCLIENTCONFIG_DEFAULT_CLIENTSECRET=clientsecret
MibFileManagementMicroServiceClientConfig - required
Note
Required only when using File Management Microservice
- Available only from version MIB 6.0 ad above These are the minimum configurations:
MIBFILEMANAGEMENTMICROSERVICECLIENTCONFIG_DEFAULT_URLMICROSERVICE=http://filemanagement
Please refer to this documentation to see all available config keys.
When using the File Management Service in TSV, the upload process used is
Resumable upload
, in which the file is uploaded in chunks.
Configurations for Front Tsv Exporter
Note
The following configurations are required only when front export module is enabled
MibFrontTsvExporterConfig - required
These are the minimum configurations:
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_GRANTTYPE=password
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_CLIENTID=clientid
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_CLIENTSECRET=secret
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_USERNAME=user
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_PASSWORD=password
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_AUTHORIZATIONURL=http://mibauth
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_APIURL=http://mibapi
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_TEMPORARYTSVFILEFOLDER=/app/temp/tsv
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_TSVEXPORTURL=http://mibfront
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_MIBFRONTURL=http://mibfront
MIBFRONTTSVEXPORTERCONFIG_DEFAULT_USEFILEMANAGEMENTSERVICE=true
Refer to MibFrontTsvExporterConfig for complete list of configuration keys and accepted value format.