Skip to content

osiris/freeipa-sssd-tools

 
 

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.

Packages

No packages published

Languages

  • Shell 88.2%
  • Python 10.1%
  • Other 1.7%