SYSTEM_REPORT.COM, UTILITIES, Generates textual- and HTML configuration report The kit consists of the following files: ======================================== AAAREADME.TXT - this file, gives some installation hints FREEWARE_README.TXT - the freeware manifest with short overview FREEWARE_REALEASE.TXT - the freeware release form FREEWARE_REALEASE.PDF - the signed freeware release form SYSTEM_REPORT.CONF_TEMPLATE - sitespecific configuration template SYSTEM_REPORT.COM - the compressed procedure SYSTEM_REPORT.SOFTWARE - definitions file for software detection SYSTEM_REPORT.SRC - the uncompressed procedure with comments [.EXAMPLES]PPS01* - example report for a standalone Alphasystem [.EXAMPLES]SAP01C* - example report for a VAX/Alpha-cluster Note: The examples were created with version V1.4-06 of SYSTEM_REPORT, but are sufficient to give an overview. Installation ============ - just unzip the kit into a directory of your choice - edit SYSTEM_REPORT.SRC|.COM to adapt to your configuration (search for the string '#CUST' to jump to the customization section, the only thing to change here is the location of the configuration file (defaults to same location as the procedure itself) - edit the configuration file SYSTEM_REPORT.CONF (use SYSTEM_REPORT.CONF_TEMPLATE as a starter), change esp. the variables TARGET_DIR and TMPDIR - optionally create a sitespecific software definition file for your software, see SYSTEM_REPORT.SOFTWARE as an example, define its location in the configuration file - run it from a suitably privileged account, it needs SYSLCK,SYSPRV,OPER,CMKRNL,BYPASS, if all reports are enabled Files created ============= SYSTEM_REPORT creates the following files in TARGET_DIR: cluname_CONFIGURATION.HTML - main html file cluname_CONFIGURATION.TXT - ASCII report cluname_CONFIGURATION_ADDINFO.HTML - additional information in HTML format (called from main file) cluname_CONFIGURATION_ADDINFO.TXT - additional information in ASCII text cluname_CONFIGURATION_LEFT.HTML - left navigation frame source cluname_CONFIGURATION_RIGHT.HTML - right frame source (the real data) cluname_CONFIGURATION_SW_VERSIONS_node1.TXT - softwarelist for node NODE1 ... cluname_CONFIGURATION_SW_VERSIONS_nodeX.TXT - softwarelist for node NODEx cluname_CONFIGURATION_TOP.HTML - top frame source The files *_CONFIGURATION_SW_VERSIONS_*.TXT are used when creating the reports and may be deleted afterwards. A lot of temporary files are created during execution (on location TMPDIR, see customization section) and hopefully deleted afterwards. The report files are converted to StreamLF to avoid problems when served to the internet. SYSTEM_REPORTS run on OpenVMS V7.3 and higher and is tested on VAX and Alpha, but should run on IA64 also (sorry, no system available to test). Please, send errors and enhancement request to the adress below. Enjoy... ------------------------------------------------------------------ Karl Rohwedder karl.rohwedder@gmx.de