Cfg2html fosdem2014

cfg2html
Cfg2html (or Config to HTML) project
URL: http://www.cfg2html.com/
Main author: Ralph Roth
Talk given by Gratien D'haese
(co-developer for HP-UX and Linux)

What is cfg2html?
●

●

●

●

●
2

A UNIX shell script (or collection of) to gather all kind of
system information and combine these into one big
ASCII and HTML file
See it as a complete set of system documentation of an
UNIX system
Various versions are available for Linux, HP-UX, Solaris,
AIX, Brocade switches
Useful for sysadmins, support teams and in case of
disasters
License GPLv3

Similar tools as cfg2html available?
●

System Configuration Collector (snapshots)
–
–

Logbook (easy to compare)

–
●

Web interface (via SCC-server part)
Support for various UNIX and Linux distro's

Linux-Explorer (LINUXexplo)
–
–

●

Creates a gzipped tar archive
Linux only

OSC Inventory NG Server for Unix
–

3

Focused on hardware

Pro-active vs. Reactive
●

Reactive support tools to ease vendor assistance
●
●
●
●
●

●

Pro-active support tools to ease systen admin
headaches
●

4

SuSe: supportconfig
RHEL: sosreport
HP-UX: getsysinfo.sh
AIX: zsnap
SunOS: SUN explorer

Cfg2html (collection of all your systems configuration
on a central point (e.g. NFS share)

Where to get it?
●

http://www.cfg2html.com
–

●

Main web site

http://groups.yahoo.com/group/cfg2html/
–
–

●

Download area for new and older releases
Mailing list archives

https://github.com/cfg2html/cfg2html
–
–

6

Main development for version 6.x
Issues tracker

How to use cfg2html?
●

Usage: sudo cfg2html -h

●

Run it: sudo cfg2html
–

You can run it from source tree, or

–

You can run it from RPM, DEB binary (Linux obviously)
●

●
●
●

7

@OBS

- http://download.opensuse.org/repositories/home:/gdha/
Main script: /usr/sbin/cfg2html
Collector scripts: /usr/share/cfg2html/...
Configuration: /etc/cfg2html/local.conf,
/usr/share/cfg2html/conf/default.conf

Sample output of running cfg2html
$ sudo ./cfg2html
--=[ http://www.cfg2html.com ]=--------------------------------------------Starting
cfg2html-linux version 6.16-git201312020913
Path to Cfg2Html ./cfg2html
HTML Output File /var/log/cfg2html/fedora20.html
Text Output File /var/log/cfg2html/fedora20.txt
Partitions
/var/log/cfg2html/fedora20.partitions.save
Errors logged to /var/log/cfg2html/fedora20.err
Local config
./linux/etc/local.conf
Started at
2014-01-08 08:15:56
WARNING
USE AT YOUR OWN RISK!!! :-))
<<<<<
--=[ http://www.cfg2html.com ]=--------------------------------------------Collecting:
Collecting:
Collecting:
Collecting:
Collecting:
Collecting:
Collecting:
Collecting:
Collecting:
Collecting:
Collecting:
8

Linux System (Fedora release 20 (Heisenbug)) .........................................
Cron and At ..........
Hardware ....................
Software ........
Filesystems, Dump- and Swapconfiguration ..........
Multipath Configuration ........
LVM ............
Network Settings ..................................
Kernel, Modules and Libraries ...............
System Enhancements .
Applications and Subsystems ...........

--=[ http://www.cfg2html.com ]=--------------------------------------------Returncode=1 (see /var/log/cfg2html/fedora20.err)

Output of /var/log/cfg2html/$(hostname).txt
Linux System (Fedora release 20 (Heisenbug)) ---- CPU and Model info
- uname & hostname
- Host alias
- OS, Kernel version
- Linux Standard Base Version
- OS Specific Release Information (/etc/fedora-release)
- OS Specific Release Information (/etc/os-release)
- OS Specific Release Information (/etc/redhat-release)
- OS Specific Release Information (/etc/system-release)
- POSIX Standards/Settings
- locale specific information
- System ulimit
- System Configuration Variables
- Used Memory and Swap
- Detailed Memory Usage (meminfo)
- Zoned Buddy Allocator/Memory Fragmentation and Zones
- Kernel slabinfo Statistics
- Additional page allocator information
- Per-zone page allocator
- VM-Statistics 1 10
- VM-Statistics (Summary)
- Uptime
- Active Process - Tree Overview
- Top load processes
- Top memory consuming processes
- Top file handles consuming processes
- reboots
9

Source Tree
cfg2html
hpux

linux

cfg2html-linux.sh

lib
lib

aix
etc

doc

$ git clone git@github.com:cfg2html/cfg2html.git
11

sunos
packaging

Configuration Files
●

/etc/cfg2html/default.conf (main configuration file)
–

●

Should not be changed; add your preferences in the
local.conf

/etc/cfg2html/local.conf (your personalized configuration
file)
–

OUTPUT_URL=nfs://nfs.company.com/vol/cfg2html/linux
●
●

mount nfs.company.com:/vol/cfg2html/linux
ls -l /mnt/cfg2html/

drwxr-xr-x 2 nobody nogroup 4096 Jan
12

9 00:40 lnx02

/mnt

We need your help
●

We are looking for developers for AIX, Solaris,...

●

AIX: https://sourceforge.net/projects/cfg2html/
–

●

Solaris: http://groups.yahoo.com/neo/groups/cfg2html/files/sun/
–

13

Version dates from September 2011 (v2.81)
Version dates from April 2012 (v1.7)

Q&A
Contacts:
Ralph Roth - ralph.roth@gmail.com
Gratien D'haese - gratien.dhaese@gmail.com
URL: www.cfg2html.com
14

Cfg2html fosdem2014

More Related Content

What's hot (20)

Similar to Cfg2html fosdem2014 (20)

More from Gratien D'haese (8)

Recently uploaded (20)

Cfg2html fosdem2014