Getting started with the Data Sources module

Prerequisites

• A DataMiner Agent that has been configured to use HTTPS connections.

• DataMiner version 10.4.0/10.4.2 or higher.

• Depending on your DataMiner version, you may need to enable the DataAPI soft-launch option.

  Note

  To check whether this soft-launch option is required in your DataMiner version, see Overview of soft-launch options.

  Tip

  See Activating soft-launch options.

Installing the necessary DxMs

The Data API and Data Aggregator DxMs must be deployed on the same DMA.

To do so:

1. In the Admin app, check whether the correct organization is mentioned in the header bar.

   Tip

   See also: Accessing the Admin app

2. If a different organization should be selected, click the organization selector in the top-right corner and select the organization in the list.

3. In the pane on the left, under DataMiner Systems, select your DataMiner System and select the DxMs page.

4. Locate the node (i.e. the DMA) you want to install the DxMs on.

   • Next to the Data API module, click Deploy to start the automatic installation process.

   • Next to the DataAggregator module, click Deploy to start the automatic installation process.

     Note

     If the DataAggregator module is installed on your DMA already, click Upgrade.

Installing extra Python packages

When you install the DataAggregator module, Python 3.12.0 is automatically installed as well. You can find the dedicated Python folder at C:\Program Files\Skyline Communications\DataMiner DataAggregator\python.

The Scripts folder contains pip.exe, which can be used to install Python packages. Installed packages are added to the Lib\site-packages folder.

In the event that a scripted connector requires additional Python packages, you can install these using pip.exe:

Execute the following command from the command line (when in the Python folder):

 .\Scripts\pip.exe install <packageName>

In the above command, replace <packageName> with the name of the desired package. For example, .\Scripts\pip.exe install html5lib to install the html5lib package.

Note

Make sure you run the command-line tool as an administrator.