DATAGERRY Documentation

DATAGERRY is an enterprise-grade OpenSource CMDB, which completely leaves the definition of object types to the user.

Introduction

• Welcome to DATAGERRY
• License

Guides

• Admin Guide
  • 1. Setup
    • 1.1. Requirements
    • 1.2. Docker Image
    • 1.3. RPM setup
      • 1.3.1. Setup MongoDB
      • 1.3.2. Setup RabbitMQ
      • 1.3.3. Setup DATAGERRY
    • 1.4. tar.gz archive setup
      • 1.4.1. Setup MongoDB
      • 1.4.2. Setup RabbitMQ
      • 1.4.3. Setup DATAGERRY
    • 1.5. Setting up Nginx as reverse proxy
    • 1.6. Update DATAGERRY
  • 2. Configuration
  • 3. Getting Started
    • 3.1. Concept of DATAGERRY
    • 3.2. Quick Start
  • 4. Objects and Object Types
    • 4.1. Managing Categories
    • 4.2. Managing Object Types
      • 4.2.1. Adding/Editing an Object Type
      • 4.2.2. Changing an existing Object Type
      • 4.2.3. Importing/Exporting Object Types
    • 4.3. Managing Objects
      • 4.3.1. Active und Inactive Objects
      • 4.3.2. Exporting Objects
      • 4.3.3. Importing Objects
        • 4.3.3.1. CSV Import
        • 4.3.3.2. JSON
  • 5. Exportd
    • 5.1. Concept
    • 5.2. Configuration
      • 5.2.1. Define Sources
      • 5.2.2. Define Destinations
      • 5.2.3. Define Export Variables
      • 5.2.4. Configure Scheduling
    • 5.3. ExternalSystems
      • 5.3.1. ExternalSystemAnsible
      • 5.3.2. ExternalSystemCpanelDns
      • 5.3.3. ExternalSystemCsv
      • 5.3.4. ExternalSystemExecuteScript
      • 5.3.5. ExternalSystemGenericRestCall
      • 5.3.6. ExternalSystemOpenNMS
  • 6. User Management
    • 6.1. Local Users and Groups
    • 6.2. Access Rights
  • 7. Authentication
    • 7.1. Access Token
    • 7.2. Providers
• Development Guide
  • 1. Setup a development system
    • 1.1. Install Python
    • 1.2. Clone repository
      • 1.2.1. Install requirements
    • 1.3. Setting up third party dependencies
      • 1.3.1. MongoDB
      • 1.3.2. RabbitMQ
    • 1.4. Modify configuration file
      • 1.4.1. Database config
      • 1.4.2. Webserver config
      • 1.4.3. Message queueing config
    • 1.5. Starting the backend and frontend
      • 1.5.1. Starting DATAGERRY
        • 1.5.1.1. Generate clean database
        • 1.5.1.2. Insert test data (optional)
      • 1.5.2. Starting angular frontend
        • 1.5.2.1. Installation
        • 1.5.2.2. Development server
        • 1.5.2.3. Build
  • 2. GIT Repository
    • 2.1. Branches
    • 2.2. Creating a Release
      • 2.2.1. latest symlink
  • 3. Documentation
    • 3.1. Generation
    • 3.2. Approach
  • 4. Process Management
    • 4.1. adding a new service
  • 5. Logging
    • 5.1. Log Levels
    • 5.2. Log Output
    • 5.3. Changing the Log Configuration
  • 6. Event Handling
    • 6.1. structure of an event
      • 6.1.1. example:
    • 6.2. event routing
    • 6.3. list of event types
      • 6.3.1. cmdb.core.object:
      • 6.3.2. cmdb.core.objecttype:

API

• Representational State Transfer
  • Allowed methods
  • Permalink structure
    • 1. GET
    • 2. POST
    • 3. PUT
    • 4. DELETE
  • Routes