Table of Contents

Publishing items in the DataMiner Catalog

The DataMiner Catalog allows users to quickly look up, download, and deploy various DataMiner-related items.

This platform is constantly getting improved. At present, several workarounds are still needed to get certain items to show up in the Catalog. Below, you can find more information about how to publish specific kinds of items.

Note

Publishing public items to the Catalog is currently only possible for members of Skyline Communications.

Tip

See also: DataMiner Catalog

Publishing connectors

Connectors (also known as protocols or drivers) are XML files and assemblies that are packaged into .dmprotocol files. The source code of these is currently only available through the internal SLC SE RepoManager. They use internal Jenkins pipelines for QA and automatic publishing to the Catalog.

All connectors are public Catalog items. Perform the following steps to release a connector version:

  1. Make sure the following prerequisites are available:

  2. Open the source code:

    1. Find the connector in the SLC SE RepoManager under the tab Protocols.

    2. Open the connector solution using Visual Studio.

  3. Tag the commit:

    1. In the lower right corner, select and check out the correct branch. This must be a branch ending in ".X", e.g. 1.0.0.X.

    2. Right-click the branch and select View History.

    3. Right-click the commit you want to release and select New Tag.

    4. Fill in a tag name matching the branch. Connectors use four numbers for versioning, e.g. 1.0.0.3.

    5. Fill in a comment.

    6. In the top bar in Visual Studio, select Git > Commit or Stash.

      This opens a new window.

    7. In the new window, select the ellipsis "..." and choose Push all Tags to Origin.

This will tag the commit, which will trigger Jenkins to perform a release cycle.

You can monitor the release pipeline:

  • If it goes yellow or green, the connector has been successfully released, and users will be able to find it in the Catalog.

  • If it goes red, the release failed. You will need to either re-run the pipeline or remove the tag, fix the reported problems, and tag the commit again to trigger a new release.

Publishing DataMiner install packages

DataMiner install packages, i.e. .dmapp files, can contain any other artifacts, including other install packages and companion files. The source code of these packages is currently only available through the internal SLC SE RepoManager. They use internal Jenkins pipelines for QA and automatic publishing to the Catalog.

  1. Make sure the following prerequisites are available:

  2. Open the source code:

    1. Find or create a new install package in the SLC SE RepoManager under the tab Packages.

      Note

      Make sure you use the correct Constraint field to define the appropriate visibility of the Catalog item. See Creating a repository.

    2. Open the solution using Visual Studio.

  3. Include the required artifacts:

    1. Open manifest.xml.

      Tip

      If you open this in Visual Studio, you will get Intellisense.

    2. You can now add XML tags to add artifacts like connectors, Automation scripts, etc.

    Tip

    For more information, refer to Creating a repository for an install package.

  4. Tag the commit:

    1. In the lower right corner, select and check out the correct branch. This must be a branch ending in ".X", e.g. 1.0.0.X.

    2. Right-click the branch and select View History.

    3. Right-click the commit you want to release and select New Tag.

    4. Fill in a tag name matching the branch. Packages use three numbers with a "-CUx" suffix for versioning, e.g. 1.0.1-CU0.

    5. Fill in a comment.

    6. In the top bar in Visual Studio, select Git > Commit or Stash.

      This opens a new window.

    7. In the new window, select the ellipsis "..." and choose Push all Tags to Origin.

This will tag the commit, which will trigger Jenkins to perform a release cycle.

You can monitor the release pipeline:

  • If it goes yellow or green, the install package has been successfully released, and users will be able to find it in the Catalog.

  • If it goes red, the release failed. You will need to either re-run the pipeline or remove the tag, fix the reported problems, and tag the commit again to trigger a new release.

Publishing Automation scripts

Automation scripts are XML files and assemblies that are packaged into .dmapp files. The source code of these is currently available both through the internal SLC SE RepoManager and on GitHub. All new Automation scripts should be created on GitHub.

If you use SLC SE RepoManager, Jenkins will be used to automatically publish scripts to the Catalog when tagging. For this, you should follow the same steps as described for connectors above.

If you use GitHub, the scripts will be published as private Catalog items. You can have them made public by contacting the Cloud domain.

Publishing dashboards

Dashboards are JSON files with configuration settings that can be imported into DataMiner to create a DataMiner dashboard. The source code of these is currently only available through the internal SLC SE RepoManager. They use internal Jenkins pipelines for QA and automatic publishing to the Catalog.

Dashboards are currently published as private Catalog items with type Unknown. You can find them in the Catalog by searching on their name.

As dashboards are a purely visual artifact, the source code is rarely changed directly within the JSON file. Instead, adjustments are made using the Dashboards app UI. Once those adjustments are finished, the JSON is exported.

  1. Make sure the following prerequisites are available:

  2. Create a dashboard repository:

    1. Open the SLC SE RepoManager.

    2. Navigate to the Dashboards tab and click the + button on the right to create a new repository.

      Note

      Make sure you use the correct Constraint field to define the appropriate visibility of the Catalog item. See Creating a repository.

    3. Select your new repository and click the clone button in the top-right corner.

    4. Browse to the repository in File Explorer.

  3. Export the dashboard:

    1. Connect to the DataMiner Agent containing the dashboard using RDP.

    2. Go to the folder C:\Skyline DataMiner\Dashboards.

    3. Find the .json file representing the dashboard.

    4. Copy the .json file into the dashboard repository.

  4. Trigger the dashboard pipeline:

    1. Use your preferred GIT application to commit and push the dashboard repository.

      You can do this with Visual Studio Code, SourceTree, TortoiseGit, or just GIT Bash commands.

    2. Check if the Jenkins pipeline is green or yellow.

      You can do so with the link displayed in the top-right corner of SLC SE RepoManager when your repository is selected.

    3. Optionally, tag a commit to release a stable version.

  5. If you want to make sure the deployed dashboard is listed as a public item in the Catalog, either contact the Cloud domain or create an install package as explained below.

    1. Open the SLC SE RepoManager.

    2. Follow the steps for install packages to create and release a new install package containing the dashboard.

      Make sure you use the correct Constraint field so your package is listed as a public Catalog item. See Creating a repository.

      In manifest.xml, add a Dashboard tag using the SLC SE RepoManager path to your repository as the repo path and the name of your branch as the range. You can easily get this value by clicking the Copy button at the top of the SLC SE RepoManager when you have selected your dashboard.

      For example:

      <Dashboards>
   <Dashboard>
      <RepoPath>Dashboards\SLCSandbox\TempRegistrationTrial</RepoPath>
      <Version>
         <Selection>
            <Range rangeSelection="latestBuild">1.0.0.X</Range>
         </Selection>
      </Version>
   </Dashboard>
</Dashboards>

Publishing Visio files

Visio files can be used as a custom user interface for elements, services, or views. They are generally published as single .vsdx files.

  1. Create a Visio repository

    1. Open the SLC SE RepoManager.

    2. Navigate to the Visios tab and click the + button on the right to create a new repository.

      Note

      Make sure you use the correct Constraint field to define the appropriate visibility of the Catalog item. See Creating a repository.

    3. Select your new repository and click the clone button in the top-right corner.

    4. Browse to the repository in File Explorer.

    5. Copy the .vsdx file in the repository.

  2. Trigger the Visio pipeline

    1. Use your preferred GIT application to commit and push the dashboard repository.

      You can do this with Visual Studio Code, SourceTree, TortoiseGit, or just GIT Bash commands.

    2. Check if the Jenkins pipeline is green or yellow.

      You can do so with the link displayed in the top-right corner of SLC SE RepoManager when your repository is selected.

    3. Tag a commit to release a stable version.

Propose changes