GitHubHelp

netniV/racktables-reports

Custom Reports Plugin for Racktables

★ 0Forks 0JavaScriptGitHub ↗Compare

README

Custom Reports for Racktables

This is an additional plugin for RackTables, that creates Custom Reports Tabs right in the Reports page. It's based on the work of Mogilowski Sebastian [email protected] (Website and HowTo: http://www.mogilowski.net/projects/racktables )

The original plugin was rewritten to follow the new plugin standards for RackTables.

Other changes for version 0.4.0:

  • Unify Server, Switch and Virtual Machine Reports (maintaining only one function for all)

  • allow users to customize the path to the CSS and JS files via config variables ('Configuration' => 'User interface')

  • always show: Name, MAC(s), IPv4 and IPv6 addresses, comment and contact information

  • additionally show:

    • Type, asset no., location, OEM S/N, HW expire date and OS for servers

    • Type, asset no., location, OEM S/N, HW expire date and OS version for switches

    • OS and Hypervisor (container) for virtual machines

  • show MAC addresses also for switches (configurable via config variable 'REPORTS_SHOW_MAC_FOR_SWITCHES')

  • enhance CSV filename with the short form of the export (server,switches,vm or custom => export_server_$date.csv)

  • create 'mailto' links, if the contact is an Email address

INSTALL

  1. Copy the files to the plugins/reports/ folder of your RackTables plugins installation ( /path/to/racktables/plugins/reports/ ).

  2. Do NOT Copy the CSS and JS and image files as these should now be referenced automatically

  3. Activate the plugin via the Configuration => Plugins menu.

  4. If you really did want to copy the files around, Depending on where you copied the CSS and JS files in step 2, you might want to adjust the configuration variables in 'Configuration' => 'User interface':

    REPORTS_CSS_PATH => defaults to 'css/report' (NO trailing slashes)
REPORTS_JS_PATH  => defaults to 'js/report'  (NO trailing slashes)

  5. You might also want to enable/disable the MAC(s) column for your switch report via 'Configuration' => 'User interface':

    REPORTS_SHOW_MAC_FOR_SWITCHES => defaults to 'yes'

USAGE

Login into RackTables and go to "Reports".

Now you find "Custom", "Server", "Switches" and "Virtual machines" in the report menu.

Sort multiple columns simultaneously by holding down the shift key and clicking a second, third or even fourth column header!

Save your custom report by supplying a name in the "Save:" field and click on the "Ok" button. Restoring your custom report criteria: simply click on the link in the form with the name you provided.

Contributors

netniVlrupp

Issues