Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cfg2html/cfg2html

cfg2html is a UNIX shell script similar to supportinfo, getsysinfo or get_config, except that it creates a HTML (and plain ASCII) system documentation for HP-UX, SCO-UNIX, AIX, Sun OS and Linux systems. Plug-ins for SAP, Oracle, Informix, Serviceguard, Fiber Channel/SAN, TIP/ix, OpenText (IXOS/LEA), SN Mass Storage like MAS, EMC, EVA, XPs, Network Node Manager and DataProtector etc. are included. The first versions of cfg2html were written for HP-UX. Meanwhile the cfg2html HP-UX stream was ported to all major *NIX platforms and small embedded systems.
https://github.com/cfg2html/cfg2html

aix ascii collector embedded-systems hp-ux html linux nix-platforms shell shell-script sunos swissarmyknife system-information unix

Last synced: 4 days ago
JSON representation

cfg2html is a UNIX shell script similar to supportinfo, getsysinfo or get_config, except that it creates a HTML (and plain ASCII) system documentation for HP-UX, SCO-UNIX, AIX, Sun OS and Linux systems. Plug-ins for SAP, Oracle, Informix, Serviceguard, Fiber Channel/SAN, TIP/ix, OpenText (IXOS/LEA), SN Mass Storage like MAS, EMC, EVA, XPs, Network Node Manager and DataProtector etc. are included. The first versions of cfg2html were written for HP-UX. Meanwhile the cfg2html HP-UX stream was ported to all major *NIX platforms and small embedded systems.

Awesome Lists containing this project

README 

        
# cfg2html (Config to HTML)



## Overview



**cfg2html** is a small utility for collecting the necessary system configuration files and system setup into an ASCII file and an HTML file. Easy to use and very useful in disaster recovery situations. cfg2html is written entirely in the native language of system administration: as shell scripts. Experienced users and system administrators can adapt or extend the cfg2html scripts to suit their particular needs, either by using the plugin framework or by modifying the source code.



## Purpose



cfg2html collects the system configuration into one HTML and one text file. cfg2html is the sysadmin's Swiss Army knife. It was written to get all the information needed to plan an update, do basic troubleshooting or performance analysis. As a bonus, cfg2html produces a nice HTML and simple plain ASCII documentation of your system.



This includes the collection of cron and at, installed hardware, installed software, file systems, dump and swap configuration, LVM, network settings, kernel, system extensions, applications and subsystems.



## Where to get cfg2html



The first versions of cfg2html were written for HP-UX. Subsequently, the cfg2html HP-UX stream was ported to all major *NIX platforms and small embedded systems. cfg2html works on Linux, HP-UX, SunOS, AIX etc. The original HP-UX version is now deprecated.



See our GitHub Source development tree at .



From there, you may download the zip file at  to your Downloads folder.  Once extracted, one way to run the program is simply to run the cfg2html script from the un-zipped high-level folder.



Alternatively, you may wish to clone it to your system with git via:



    git clone https://github.com/cfg2html/cfg2html.git

    cd cfg2html

    make help



Running the make command will modify the source code to identify the latest patch level in a generated installable package for use by dnf/yum, apt, zypper, etc. for installation of the program.



NOTE:  You need an annotated git tag on your local build system, else the build will fail.

git describe --long should output something like "7.0.1-4-g6cef5f2"



If you do not want to build cfg2html on your own, we have pre-built installations that you can download from  and also from the github release page 



## Issue Tracker



If you find a problem or bug, want to discuss feature requests, or have some bright new ideas, please create a new issue on our GitHub project page 

When using it, please ensure that any criticism you provide is constructive. Please do not use the issue tracker for general help and assistance with using cfg2html.



Feel free to open a pull request to fix a problem yourself or to contribute to a new feature.



## Contributing on GitHub



To contribute to a project that is hosted on GitHub, you can fork the project on github.com, then clone your fork locally, make a change, push back to GitHub and then send us a merge request for your pull, which will email the maintainer.



Please consider to give a star on github to show your support! +1



Please try to keep pull requests as small as possible - one new feature or fix set per pull request is preferred. This makes it easier to review and discuss your contribution.



Fork project on github:



    git clone https://github.com/my-user/cfg2html

    cd cfg2html

    repeat (edit files),(testing) until OK

    git add (modified files)

    git commit -m 'Explain what I changed'

    git push origin master



Then go to github and click the ‘pull request’ button!



## ChangeLog and Tags



NOTE: This is only a suggestion!



- Semantic Versioning  e.g. 1.0.19

- For ChangeLog use ruby.gem.releasor or something like  or 

- Use Annotated tags (-a)!

- Don't use hash signs (#) in the git commit message, they might get headlines with MarkDown in the ChangeLog.md

- See also 

- If possible use this git commit format:

    {new|chg|fix}: [{dev|use?r|pkg|test|doc}:] COMMIT_MESSAGE [!{minor|refactor} ... ]

    To see a full documentation of such commit message convention, please look up the reference file gitchangelog.rc.reference, see 



----