Skip to content

gcoop-libre/freeipa-sssd-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FreeIPA SSSD Tools

date tag description
2024-02-06 v0.9.1 add ipa-hlt-chk and ipa-hlt-gui to check Network, DNS, NTP, SSSD, KRB5 and others dependencies to determine health of IPA
2023-06-28 v0.9.0 add ipa-sss-err for filter SynLog of sAMAccountName with at least one sync error (error!=0), add ipa-sss-exp for filter SynLog when record date match with accountExpires date and add ipa-sss-nsy for filter SynLog of sAMAccountName with at least one no sync (sss_cache=0)
2023-04-25 v0.8.0 add /resyn in ipa-api-syn to run ipa-sss-syn with IPA_SSS_SYN_LAST=1 to skip error=2 validation
2023-04-05 v0.7.3 ipa-sss-plt: plot syn errors with error code in label
2023-03-07 v0.7.2 replace date -d with date $UTC and accountExpires=0 or dataExpireTimestamp=1 with 1970-01-01 00:00 in ipa-sss-syn
2023-03-07 v0.7.1 force invalidate cache when dataExpireTimestamp <= NOW in ipa-sss-syn
2023-03-06 v0.7.0 report errors (40,41,42,43) when failed syn and add wait after invalidate and populate (Default 0s) in ipa-sss-syn
2023-02-27 v0.6.1 fix format date in filter function for ipa-srv-mon.log in ipa-sss-dat
2023-02-13 v0.6.0 add support to convert datetime to local timezone by default in ipa-sss-syn
2022-12-22 v0.5.1 add config function in ipa-srv-mon to read configuration from .ipa-config
2022-12-19 v0.5.0 add ipa-sss-ldb to count cache records, add ipa-sss-rsy to backup and ipa-sss-rtr to restore SSSD cache to preserve RAMDISK
2022-11-28 v0.4.0 update scripts to generate and plot metrics and get and sync users
2022-05-03 v0.3.0 add API to enqueue cache synchronization requests and process them sequentially
2022-05-02 v0.2.0 added tools to split, filter, analyze and graph log files
2022-05-02 v0.1.0 first public version of ipa-sss-syn

Tools Overview

Repository of useful scripts for FreeIPA and SSSD.

script description
ipa-src-cfg Common functions and variables
ipa-src-chk Check syntax using shellcheck
ipa-src-hlp Generate Markdown Help
ipa-src-tbl Generate Markdown Table Overview
ipa-srv-mon Capture metrics of IPA process
ipa-sss-all Generate and plot metrics in HTML gallery
ipa-sss-chk Verify Syntax of SynLog
ipa-sss-dat Generate .dat file to plot SynLog
ipa-sss-day Split SynLog by date
ipa-sss-dff show attributes differences between sync requests from log
ipa-sss-htm Generate HTML gallery of SynLog Plots Images
ipa-sss-ldb IPA SSSD cache count records
ipa-sss-log Generate report of SynLog
ipa-sss-plt Plot SynLog between hours range
ipa-sss-rsy IPA SSSD copy cache files to preserve RAMDISK
ipa-sss-rtr Restore SSSD cache files to preserve RAMDISK
ipa-sss-sum Plot summarized SynLog attribute stats
ipa-sss-syn IPA SSSD Synchronize Cache
ipa-sss-usr Split SynLog by user
ipa-usr-all IPA SSSD get all users
ipa-usr-syn IPA SSSD syn all usernames defined in file

See IPA tools source Help in ipa-src-hlp.md

Install

Manual

Clone the repository:

  cd /opt
  git clone https://gitlab.com/gcoop-libre/freeipa-sssd-tools

Add to /root/.bashrc:

   if [[ -d "/opt/freeipa-sssd-tools" ]]
   then
       PATH="/opt/freeipa-sssd-tools:$PATH"
   fi

Ansible/AWX

Use gcoop-libre.freeipa_sssd_tools from:

License

GNU General Public License, GPLv3.

Author Information

This repo was created in 2021 by Osiris Alejandro Gomez, worker cooperative of gcoop Cooperativa de Software Libre.