raynetgmbh/rayventory-datahub-agent repository overview

⁠RayVentory Data Hub

RayVentory Data Hub integrates various data sources into a holistic overview, which is then normalized and visualized in dashboards and reports. From this, important key figures and therefore action decisions can be derived.

⁠All data in one central solution

The integration of different data sources and the preparation of clear dashboards are the core functionality of the Technology Asset Inventory solution RayVentory. Due to the high flexibility and automatability, you achieve a fully comprehensive overview of your IT infrastructure, such as information about your IT devices and cloud usage, in the shortest possible time.

By leveraging existing data sources, vulnerabilities and missing data are quickly identified and can be efficiently remediated through RayVentory‘s inventory functionality. As a result, information is provided to the various stakeholders in a targeted way. In doing so, you can independently determine, for example, the level of detail and the right time for providing the information.

⁠Prerequisities

In order to run this container you'll need docker installed.

• Windows⁠
• OS X⁠
• Linux⁠

On Windows, make sure to use Linux Containers, WSL2 is recommended.

⁠Usage

The default configuration consists of three containers:

• A database (Microsoft SQL Server Express OR MariaDB)
• Frontend and backend for the Data Hub
• Data Hub Agent

The default configuration is standalone and should work out-of-the-box.

⁠Installation with docker-compose

The easiest way to run the image with reasonable default is to use docker-compose command.

1. Get the docker-compose.yml⁠ file from this repository, or docker-compose_mariaDb.yml⁠ for MariaDB.
2. In the folder containing the downloaded definition, run the following command: docker-compose up -d.

⁠First start

1. Login to http://localhost:80⁠ and use the following credentials:

• Login: root
• Password: raynet

1. Provide the valid license for the product.
2. After log-in, change your root password and create application users.

⁠Default docker-compose (with SQL Server Express)

version: "3.7"
services:

  database:
    image: mcr.microsoft.com/mssql/server:2019-latest
    ports:
      - "1434:1433"
    environment: 
      - ACCEPT_EULA=Y
      - SA_PASSWORD=Start123!@#
      - MSSQL_PID=Express
    restart: always
    volumes:
      - sql_data:/var/opt/mssql

  web:
    image: raynetgmbh/rayventory-datahub:12.6
    ports:
      - "81:80"
    depends_on:
      - database
    restart: always
    environment:
      - connectionStrings__System=Server=database,1433;Database=datahub;User ID=sa;Password=Start123!@#
      - connectionStrings__ReportDatabase=Server=database,1433;Initial Catalog=master;User ID=sa;Password=Start123!@#
      - TasksManagement__LogsDirectory=/app/raynet/datahub/task-logs
      - KotlinDirectoryPath=/app/raynet/datahub/kotlin
      - InitialTenantId={72ba6fc2-d5fa-49ee-8281-841e762aea05}
      - BASEURL=http://localhost:81 
    volumes:
      - ./host-logs:/app/raynet/datahub/task-logs

  agent:
    image: raynetgmbh/rayventory-datahub-agent:12.6
    depends_on:
      - web
    restart: always
    environment:
      - DataHubUrl=http://web:80
      - TenantId={72ba6fc2-d5fa-49ee-8281-841e762aea05}
      - KotlinDirectoryPath=/app/raynet/datahub-agent/kotlin
volumes: 
  sql_data:

⁠Default docker-compose (with MariaDB)

version: "3.7"
services:

  mariadb:
    image: "mariadb:latest"
    restart: 'always'
    volumes: 
      - /var/docker/mariadb/conf:/etc/mysql
    environment:
      MYSQL_ROOT_PASSWORD: raynetRootPassword
      MYSQL_DATABASE: datahub
      MYSQL_USER: raynetUser
      MYSQL_PASSWORD: raynetPassword
    ports:
      - 3307:3306

  web:
    image: raynetgmbh/rayventory-datahub:12.6
    ports:
      - "8080:80"
    depends_on:
      - mariadb
    restart: always
    environment:
      - connectionStrings__System=Server=mariadb,3307;Database=datahub;User ID=root;Password=raynetRootPassword
      - connectionStrings__ReportDatabase=Server=mariadb,3307;Database=datahub;User ID=root;Password=raynetRootPassword
      - connectionStrings__Driver=mysql
      - TasksManagement__LogsDirectory=/app/raynet/datahub/task-logs
      - KotlinDirectoryPath=/app/raynet/datahub/kotlin
      - InitialTenantId={72ba6fc2-d5fa-49ee-8281-841e762aea05}
      - BASEURL=http://localhost:8080 
    volumes:
      - ./host-logs:/app/raynet/datahub/task-logs
    links:
      - mariadb
  agent:
    image: raynetgmbh/rayventory-datahub-agent:12.6
    depends_on:
      - web
    restart: always
    environment:
      - DataHubUrl=http://web:80
      - TenantId={72ba6fc2-d5fa-49ee-8281-841e762aea05}
      - KotlinDirectoryPath=/app/raynet/datahub-agent/kotlin

⁠The image

RayVentory Data Hub is available on docker hub:

• https://hub.docker.com/r/raynetgmbh/rayventory-datahub⁠
• https://hub.docker.com/r/raynetgmbh/rayventory-datahub-agent⁠

You can use tags 12.6 (recommended) or stable to get the last 12.6 or the last stable version respectively.

⁠Environment Variables

Data Hub:

• DataHub_ConnectionStrings_System - The connection string to the database, where the application data is stored
• DataHub_ConnectionStrings_ReportDatabase - The connection string to the server, which orchestrates creation of tenant databases.
• DataHub_ConnectionStrings_Driver - The type of the underlying database driver (supported values: mysql or mssql (default))
• DataHub_InitialTenantId - The GUID of the initial tenant.
• BASEURL - The base URL, that will be used in the web browser to access the content. Should also contain protocol name and the port.

Data Hub Agent:

• DataHubAgent_DataHubUrl - The URL to connect to the server. It can reference internal docker services, and should contain the protocol name and the port.
• DataHubAgent_TenantId - The tenant ID, assigned to the agent. -

⁠License Activation

RayVentory Data Hub needs a valid license to run. If there is no valid license, RayVentory Data Hub will open the activation screen.

⁠Documentation

• Release notes (HTML)⁠
• Installation Guide (HTML)⁠
• User Guide (HTML)⁠

⁠Find Us

• Raynet GmbH corporate website⁠
• Raynet EALM GitHub⁠