BIG-IP Report
Problem this snippet solves:
Overview
This is a script which will generate a report of the BIG-IP LTM configuration on all your load balancers making it easy to find information and get a comprehensive overview of virtual servers and pools connected to them.
This information is used to relay information to NOC and developers to give them insight in where things are located and to be able to plan patching and deploys. I also use it myself as a quick way get information or gather data used as a foundation for RFC's, ie get a list of all external virtual servers without compression profiles.
The script has been running on 13 pairs of load balancers, indexing over 1200 virtual servers for several years now and the report is widely used across the company and by many companies and governments across the world.
It's easy to setup and use and only requires auditor (read-only) permissions on your devices.
Demo/Preview
Interactive demo
http://loadbalancing.se/bigipreportdemo/
Screen shots
The main report:
The device overview:
Certificate details:
How to use this snippet:
Installation instructions
BigipReport REST
This is the only branch we're updating since middle of 2020 and it supports 12.x and upwards (maybe even 11.6).
- Downloads:
https://loadbalancing.se/downloads/bigipreport-v5.7.13.zip - Documentation, installation instructions and troubleshooting: https://loadbalancing.se/bigipreport-rest/
Docker support
https://loadbalancing.se/2021/01/05/running-bigipreport-on-docker/
Kubernetes support
https://loadbalancing.se/2021/04/16/bigipreport-on-kubernetes/
BIG-IP Report (Legacy)
Older version of the report that only runs on Windows and is depending on a Powershell plugin originally written by Joe Pruitt (F5)
BIG-IP Report (only download this if you have v10 devices):
https://loadbalancing.se/downloads/bigipreport-5.4.0-beta.zip
iControl Snapin
https://loadbalancing.se/downloads/f5-icontrol.zip
Documentation and Installation Instructions
https://loadbalancing.se/bigip-report/
Upgrade instructions
Protect the report using APM and active directory
Written by DevCentral member Shann_P:
https://loadbalancing.se/2018/04/08/protecting-bigip-report-behind-an-apm-by-shannon-poole/
Got issues/problems/feedback?
Still have issues? Drop a comment below. We usually reply quite fast. Any bugs found, issues detected or ideas contributed makes the report better for everyone, so it's always appreciated.
---
Join us on Discord: https://discord.gg/7JJvPMYahA
Code :
BigIP Report
Tested this on version:
12, 13, 14, 15, 16
- TimRikerCirrocumulus
I sent back some reviews to your code on github. I've not yet tried it out locally.
- MBauerNimbostratus
Dear Patrick,
I used version 5.6.2 and added my code to crawl the policy data as well.
I will try to share the code via github with you.
The F5 statement regarding the translation of the policy logic to readable code was that they cannot share this with me.
(Service Request #C3491339)
I started to create the logic for our most recent used policie configurations already.
Best regards,
Marius
- JRahmAdmin
Nice work , way to go!
Good news! Docker has approved my request to include BigIPreport in their open source program.
This means that the docker/k8s containers will be available as soon as it's activated (1-2 weeks).
Kind regards,
Patrik
Heads up to those running the report using Kubernetes.
My Dockerhub account was disabled and my application for the open source version has not been processed yet.
This means that you need to build and store the images yourself.
You can find the manifests here:
https://github.com/net-utilities/BigIPReport-Docker
Will also update the documentation to cover the pagination concept Tim added yesterday.
Here's a pre-release:
https://loadbalancing.se/downloads/bigipreport-v5.6.1.zip
If it works fine I'll update the version above.
- TimRikerCirrocumulus
I patched this in 5.6.1 Can you test once Patrik makes a release? or test from git.
- richi3161Nimbostratus
That´s correct. When I try to run the script twice again, I get exactly this error.
I believe the actual reason behind the error was that the script was executed twice in the same PSSession.
Kind regards,
Patrik
- richi3161Nimbostratus
Hello,
I have tried today the Version 5.5.9, but I am not able to run script - there is an issue with device certifcate check:
PS C:\bigipreport-v5.5.9> .\bigipreport-v5.5.9.ps1
2021-07-22 11:34:47 Starting: PSCommandPath=C:\bigipreport-v5.5.9\bigipreport-v5.5.9.ps1 ConfigurationFile=C:\bigipreport-v5.5.9/bigipreportconfig.xml CurrentJob= Location= PSScriptRoot=C:\bigipreport-v5.5.9
2021-07-22 11:34:47 Successfully loaded config file: C:\bigipreport-v5.5.9/bigipreportconfig.xml
2021-07-22 11:34:47 Insecure SkipCertificateCheck enabled, consider using valid certificates and DNS names
ParentContainsErrorRecordException: C:\bigipreport-v5.5.9\bigipreport-v5.5.9.ps1:654
Line |
654 | $PSDefaultParameterValues.Add("Invoke-RestMethod:SkipCertific …
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| Exception calling "Add" with "2" argument(s): "The key 'Invoke-RestMethod:SkipCertificateCheck' has
| already been added to the dictionary."
PS C:\bigipreport-v5.5.9>