Giter Club home page Giter Club logo

knowledge-base's Introduction

CMDB und ITSM-Tool-Integration mit i-doit

kb.i-doit.com

Note: This repository is the source of the i-doit kb.

Build status Creative Commons Attribution-ShareAlike 4.0 International

What is i-doit?

With i-doit, you can document all technical and administrative information in your organization together in one place. One documentation for all use cases to optimize and automate critical processes. Create the digital twin of all things that matter to your business and ensure interoperability between platforms and systems on the basis of a well structured documentation system. i-doit is operated by synetics GmbH, located in Düsseldorf/Germany.

Contribute!

All contributors are welcome! Please read our guidelines first.

Support

Do you like to get in touch with us?

Copyright & License

Copyright (C) 2023 synetics GmbH

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

knowledge-base's People

Contributors

bheisig avatar dependabot[bot] avatar dmingal avatar jaagut avatar leonardfischer avatar ljuergenliemke avatar martinhartkopf avatar michaelov avatar patfeiler avatar phoerselmann avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

knowledge-base's Issues

Improved SSO Login

The main change here will be, that i-doit will no longer login users automatically. Meaning every user will first be moved to the login page. Here they will have the chance to login with a username and password.

If SSO is configured, they will see the “SSO Login” button below the inputs when clicking this, they will be redirected with the GET Parameter use-sso=1. This should then trigger the default SSO logic.

Meaning: for customers who still want to be logged in directly, this would be the workaround: open i-doit with a URL like http://your-idoit.int/?use-sso=1

  • check ticket
  • check behavior for sso configurations

Wrong indentation in the examples for the console ini files

Needs to be changed on complete page

Wrong

    [commandArguments]

Correct

[commandArguments]
  • docs/de/automatisierung-und-integration/cli/console/verwendung-von-konfigurationsdateien-fuer-console-commands.md
  • docs/en/automation-and-integration/cli/console/using-configuration-files-for-console-cli.md

Instructions what to do after a dist-upgrade or php upgrade

  • dist-upgrade from ubuntu 20.04 to 22.04
  • General update from php 7.4 to php 8.x
dist-upgrade from ubuntu 20.04 to 22.04

Missing APT packages to install ``` sudo apt install libapache2-mod-fcgid php8.1-bcmath php8.1-cli php8.1-common php8.1-curl php8.1-fpm php8.1-gd php8.1-ldap php8.1-mbstring php8.1-mysql php8.1-opcache php8.1-pgsql php8.1-soap php8.1-xml php8.1-zip ```

PHP 8.1 FPM enabled in Apache2

a2enmod proxy_fcgi setenvif
a2enconf php8.1-fpm
sudo service apache2 restart

Modify Apache i-doit.conf

sudo nano /etc/apache2/sites-available/i-doit.conf

Change the PHP version from 7.4 to 8.1 in the following line

SetHandler "proxy:unix:/var/run/php/php8.1-fpm.sock|fcgi://localhost/"

Restart apache2

sudo service apache2 restart

Copy PHP i-doit.ini to the new PHP folder

sudo cp -i /etc/php/7.4/mods-available/i-doit.ini /etc/php/8.1/mods-available/i-doit.ini

Check the new i-doit.ini to see if the max_input_vars and post_max_size values are correct, otherwise change them

sudo cat /etc/php/8.1/mods-available/i-doit.ini | grep max_input_vars
sudo cat /etc/php/8.1/mods-available/i-doit.ini | grep post_max_size

Modify the variables in all three php.ini files

sudo find / -name -f php.ini
  • max_input_vars = 10000
  • post_max_size = 256MB

Activate the new PHP version 8.1

sudo update-alternatives --set php /usr/bin/php8.1

Restart PHP 8.1

sudo service php8.1-fpm restart

Restart Apache

sudo service apache2 restart

General update from php 7.4 to php 8.x

i-doit 29 release

GER

  • create docs/de/versionshistorie/changelogs/changelog-29.md
  • update docs/de/versionshistorie/changelogs/index.md
  • create docs/de/versionshistorie/release-notes/release-notes-29.md
  • update docs/de/versionshistorie/release-notes/index.md
  • update docs/de/versionshistorie/index.md
  • update config/de/mkdocs.yml

EN

  • create docs/en/version-history/changelogs/changelog-29.md
  • update docs/en/version-history/changelogs/index.md
  • create docs/en/version-history/release-notes/release-notes-29.md
  • update docs/en/version-history/release-notes/index.md
  • update docs/en/version-history/index.md
  • update config/en/mkdocs.yml

Add FAQ MariaDB fix corrupted database after blackout

Possible errors:

-Upgrade after a crash is not supported.
-Generic error
-Database corrupt
-Failed to start MariaDB

Solution:

This error also happens when your Database data is corrupt. You may fix this issue by moving your Db data files (ib_logfile0 and ib_logfile1) mentioned below to another location. ib_logfile0 and ib_logfile1 are system tablespace for the InnoDB infrastructure. These files contains several classes for information vital for InnoDB. You may read about these files here.

Before following below steps please keep a copy of files (ib_logfile0 and ib_logfile1) so you may restore your data in case it is lost:

Follow below steps:

Login to server via SSH with root access.
Navigate to /var/lib/mysql.
If you see files like, ib_logfile0 and ib_logfile1, rename or move them to some other folder.
Stop and start the MySQL service by running sudo service mysql stop and sudo service mysql start

And then

Systemctl status mariadb.service

New external API endpoint

API 2.0

  • added new external endpoint page
  • updated navigation
  • removed new tag from older api endpoints
  • add changelog

Remove deprecated endpoints API 2.0

We need to remove the endpoints, that have been “deprecated" and will be removed in 2.0:
From API-453

  • “cmdb.category.create” in isys_api_model_cmdb_category
  • “cmdb.category.update” in isys_api_model_cmdb_category
  • “cmdb.category.quickpurge” in isys_api_model_cmdb_category
  • “cmdb.object.create” in isys_api_model_cmdb_object → We need to create “cmdb.object.save” as new option
  • “cmdb.object.update” in isys_api_model_cmdb_object -> We need to create "cmdb.object.save" as new option
  • “cmdb.object.quickpurge” in isys_api_model_cmdb_object

i-doit release v30

  • Check new features/fixes to document
    • #508
    • More information about the reason for a failed connection to the JDisc Server (ID-9341)
    • Import_rooms via ldap-sync does not work with camelCase (ID-9995)
    • Support MariaDB 10.11 (ID-10042)
    • There are two Specific categories Installation available (ID-10074)
    • Add object type to list of "Assigned Objects (person groups)" (in Organization) (ID-10462)
    • #485
    • ID-10508 in #485 integrated
    • #487
    • #493

System requirements

GER

  • update Current version
  • update LAMP / WAMP Stack
  • update recommended usage
  • update Compatibility matrix
  • Add MariaDB 10.11 update docs/de/installation/systemvoraussetzungen.md

EN

  • update Current version
  • update LAMP / WAMP Stack
  • update recommended usage
  • update Compatibility matrix
  • Add MariaDB 10.11 update docs/en/installation/system-requirements.md

Update API 2.0

Update release notes and changelog

GER

  • create docs/de/versionshistorie/changelogs/changelog-30.md
  • update docs/de/versionshistorie/changelogs/index.md
  • create docs/de/versionshistorie/release-notes/release-notes-30.md
  • update docs/de/versionshistorie/release-notes/index.md
  • update docs/de/versionshistorie/index.md
  • update config/de/mkdocs.yml

EN

  • create docs/en/version-history/changelogs/changelog-30.md
  • update docs/en/version-history/changelogs/index.md
  • create docs/en/version-history/release-notes/release-notes-30.md
  • update docs/en/version-history/release-notes/index.md
  • update docs/en/version-history/index.md
  • update config/en/mkdocs.yml

Archive hotfix page and create new

GER

  • create docs/de/administration/hotfixes/hotfix-archive/v29.md
    - copy & paste docs/de/administration/hotfixes/index.md into new file
    - add additional ../ to every link
  • update docs/de/administration/hotfixes/index.md
    - remove old hotfixes (Add-on hotfixes only get removed if new version is released)
  • update de/administration/hotfixes/hotfix-archiv/index.html
  • update config/de/mkdocs.yml

EN

  • create docs/en/system-administration/hotfixes/hotfix-archive/v29.md
    - copy & paste docs/en/system-administration/hotfixes/index.md into new file
    - add additional ../ to every link
  • update docs/en/system-administration/hotfixes/index.md
    - remove old hotfixes (Add-on hotfixes only get removed if new version is released)
  • update en/system-administration/hotfixes/hotfix-archive/index.html
  • update config/de/mkdocs.yml

Archive hotfix page and create new

GER

  • create docs/de/administration/hotfixes/hotfix-archive/v29.md
    - copy & paste docs/de/administration/hotfixes/index.md into new file
    - add additional ../ to every link
  • update docs/de/administration/hotfixes/index.md
    - remove old hotfixes (Add-on hotfixes only get removed if new version is released)
  • update de/administration/hotfixes/hotfix-archiv/index.html
  • update config/de/mkdocs.yml

EN

  • create docs/en/system-administration/hotfixes/hotfix-archive/v29.md
    - copy & paste docs/en/system-administration/hotfixes/index.md into new file
    - add additional ../ to every link
  • update docs/en/system-administration/hotfixes/index.md
    - remove old hotfixes (Add-on hotfixes only get removed if new version is released)
  • update en/system-administration/hotfixes/hotfix-archive/index.html
  • update config/de/mkdocs.yml

Add Hotfixes

JDisc mapping error ID-10424
Templates are not displayed when the for e.g. Nagios Add-on is installed ID-10534

i-doit 29 add-on updates

GER

  • Analysis 1.5 docs/de/i-doit-pro-add-ons/api/index.md
  • API 1.16 docs/de/i-doit-pro-add-ons/api/index.md
  • Cabling 1.4 docs/de/i-doit-pro-add-ons/cabling.md
  • Documents 1.7 docs/de/i-doit-pro-add-ons/documents/index.md
  • Floorplan 1.8 docs/de/i-doit-pro-add-ons/floorplan.md

EN

  • Analysis 1.5 docs/en/i-doit-pro-add-ons/analysis.md
  • API 1.16 docs/en/i-doit-pro-add-ons/api/index.md
  • Cabling 1.4 docs/en/i-doit-pro-add-ons/cabling.md
  • Documents 1.7 docs/en/i-doit-pro-add-ons/documents/index.md
  • Floorplan 1.8 docs/en/i-doit-pro-add-ons/floorplan.md

Outdated: i-doit pro Add-ons -> API (JSON-RPC) -> category fields for data arrays

Hello,

I was looking at the category documentation for Operating System and noticed that it may be outdated.

This is because:

  • the following fields seem to be missing: assigned_version_for_report, assigned_databases, installDate
  • every data type in the docs is int (except for description), even though it seems like the API might also accept strings for some of those values, e.g., for assigned_version.

See here from the administration page:
image

I noticed this because I wondered why every expected request argument is int, even though you can insert string values in the web UI, for example in assigned_version.

This issue probably also applies to other categories too.

Additional question:
My API client uses "cmdb.category_info.read" to find out the data type that is expected for "cmdb.category.save".
In the case of the attribute assigned_version, we can see (in the response down below) that
response["result"]["assigned_version"]["data"]["type"] = "int" (and its a "dialog_plus").
So it seems like it only accepts int, but we have seen above in the administration that it should also accept string. Is it true, that the API also accepts strings? Currently, I have no way to test this out. And how is it possible to know only from API responses, that the data type for assigned_version and other attributes is int OR string?

Running this RPC

{
    "jsonrpc": "2.0",
    "method": "cmdb.category_info.read",
    "params": {
        "apikey": "...",
        "category": "C__CATG__OPERATING_SYSTEM"
    },
    "id": 1
}

also returns

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "application": {...},
        "application_type": {...},
        "application_priority": {...},
        "assigned_license": {...},
        "assigned_license_key": {...},
        "assigned_it_service": {...},
        "assigned_variant": {...},
        "assigned_version": {
            "title": "Version number",
            "check": {
                "mandatory": null
            },
            "info": {
                "title": "LC__CATG__VERSION_TITLE",
                "type": "dialog_plus",
                "primaryField": false,
                "backwardCompatible": false
            },
            "data": {
                "type": "int",
                "field": "isys_catg_application_list__isys_catg_version_list__id",
                "sourceTable": "isys_catg_version_list",
                "references": [
                    "isys_catg_version_list",
                    "isys_catg_version_list__id"
                ],
                "readOnly": false,
                "joins": [
                    {},
                    {},
                    {}
                ],
                "index": true,
                "select": {}
            },
            "ui": {
                "id": "C__CATG__OPERATING_SYSTEM_VERSION",
                "type": "popup",
                "default": "-1",
                "params": {
                    "p_strPopupType": "dialog_plus",
                    "p_strClass": "input-small",
                    "p_arData": {}
                }
            },
            "format": {
                "callback": [
                    "isys_global_application_export_helper",
                    "applicationAssignedVersion"
                ]
            }
        },
        "assigned_version_for_report": {...},
        "assigned_databases": {...},
        "installDate": {...},
        "description": {...}
    }
}

Install guide for SLES 15 SP5

  • Waiting for trial renewal
  • Install new code
  • Check i-doit installation
  • update installation guide

Things to note here:

php8 is shipped by default
php-mcrypt is no longer needed
In the /etc/php8/apache2/php.ini file, session.save_path = /var/lib/php8 is specified, but this folder is not writable by the wwwrun user by default. With openSUSE it works

Check Improvements from v28

  • [Improvement][Import] Allow user to import "input" of the first object in cabling import
  • Improvement][JDisc] JDisc: It should be possible to import more information (SLOT) regarding hard disc
  • [Improvement][JDisc] Import von einzelnen Geräten aus JDisc anhand der IP über die Console / IP filter for JDisc import console command
  • [Improvement][JDisc] New JDisc Import Mode: "Update (Existing)"
  • [Improvement][JDisc] JDisc Import: Import SNMP Attribute (to custom attributes)
  • [Improvement][JDisc] Comparison of available objects from i-doit and JDisc
  • [Improvement][JDisc] Archive objects, that have not been seen by JDisc for a defined set of days

[Improvement][JDisc] black/whitelist for Layer 3 networks and host addresses

As a user of i-doit and JDisc, I want to blacklist/whitelist defined layer-3-nets and ip addresse/ranges for the import from JDisc. Some addresses originate from changing ip-addresses which are dynamic by the provider so they also create new layer-3-nets and information, that is not needed in i-doit.
Check ID-8391

Add expert setting maxlength.list.placeholder

See ID-8969

Ger: Die Experteneinstellung “maxlength.list.placeholder” muss erhöht werden, damit viele Objekte in Listen referenziert werden können.
En: The expert setting "maxlength.list.placeholder" must be increased to be able to reference lots of referenced objects in lists.

i-doit 29 archive hotfix pages

  • create overrides/asssets/downloads/hotfixes/v29/

German

  • create docs/de/administration/hotfixes/hotfix-archive/v28.md
    - copy & paste docs/de/administration/hotfixes/index.md into new file
    - add additional ../ to every link
  • update docs/de/administration/hotfixes/index.md
    - remove old hotfixes (Add-on hotfixes only get removed if new version is released)
  • update de/administration/hotfixes/hotfix-archiv/index.html
  • update config/de/mkdocs.yml

English

  • create docs/en/system-administration/hotfixes/hotfix-archive/v28.md
    - copy & paste docs/en/system-administration/hotfixes/index.md into new file
    - add additional ../ to every link
  • update docs/en/system-administration/hotfixes/index.md
    - remove old hotfixes (Add-on hotfixes only get removed if new version is released)
  • update en/system-administration/hotfixes/hotfix-archive/index.html
  • update config/de/mkdocs.yml

Add missing Feature to changelog for API 1.16 and add method

  • Add "Get a connection endpoint of a cable via API" to changelog
  • Add method examples

This endpoint can be called with cmdb.cabling.read and retrieves the information which connector is connected of a cable object.

Call Example:

{
    "jsonrpc": "2.0",
    "method": "cmdb.cabling.read",
    "id": 1,
    "params": {
        "objID": 2821,
        "apikey": [{api-key}]
    }
}

Response Example:

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "start": {
            "presentation": "server11 > server_output11",
            "connector": {
                "id": 2,
                "title": "server_output11",
                "type": "C__CATG__CONNECTOR",
                "inOutput": "Output"
            },
            "ciObject": {
                "id": 162,
                "title": "server11",
                "type": "Server",
                "typeConstant": "C__OBJTYPE__SERVER"
            }
        },
        "end": {
            "presentation": "switch_classic > input_switch11",
            "connector": {
                "id": 3,
                "title": "input_switch11",
                "type": "C__CATG__CONNECTOR",
                "inOutput": "Input"
            },
            "ciObject": {
                "id": 172,
                "title": "switch_classic",
                "type": "Switch",
                "typeConstant": "C__OBJTYPE__SWITCH"
            }
        }
    }
}

Update system requirements

GER

  • update Current version
  • update LAMP / WAMP Stack
  • update recommended usage
  • update Compatibility matrix
  • Add MariaDB 10.11 update docs/de/installation/systemvoraussetzungen.md

EN

  • update Current version
  • update LAMP / WAMP Stack
  • update recommended usage
  • update Compatibility matrix
  • Add MariaDB 10.11 update docs/en/installation/system-requirements.md

Update release notes and changelog

GER

  • create docs/de/versionshistorie/changelogs/changelog-30.md
  • update docs/de/versionshistorie/changelogs/index.md
  • create docs/de/versionshistorie/release-notes/release-notes-30.md
  • update docs/de/versionshistorie/release-notes/index.md
  • update docs/de/versionshistorie/index.md
  • update config/de/mkdocs.yml

EN

  • create docs/en/version-history/changelogs/changelog-30.md
  • update docs/en/version-history/changelogs/index.md
  • create docs/en/version-history/release-notes/release-notes-30.md
  • update docs/en/version-history/release-notes/index.md
  • update docs/en/version-history/index.md
  • update config/en/mkdocs.yml

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.