asbuiltreport / asbuiltreport.rubrik.cdm Goto Github PK

There have been a few issues surrounding empty objects, or the report failing when certain objects don't exist. To help alleviate this I've ran the report against and empty/unconfigured 5.3 CDM cluster and found the following is failing:

Retrieving/Outputting SMB Domain Information when it doesn't exist (Report Level 1/3/5)
Retrieving/Outputting Syslog settings when they don't exist (Report Level 1/3/5)
Retrieving/Outputting Guest OS Credentials when they don't exist (Report Level 1/3/5)
Retrieving/Outputting Protected Objects VMware VMs (Report Level 5)

I'm trying to generate a HTML report of a cluster running CDM 5.3 p3. It seems connection to the cluster succeeds and the module starts doing its thing, but failed with "Undefined API" error shown below. Is 5.3 p3 too new for this module perhaps?

command used:
New-AsBuiltReport -Target 'clustername' -Username 'admin' -Password 'password' -Report Rubrik.CDM -Format Html -OutputFolderPath 'C:\reports\rubrik' -Timestamp

Output:

Please wait while the Rubrik CDM As Built Report is being generated.
WARNING: [ 08:58:38:161 ] [ Document ] - The table column widths total '99'%. Total column width must equal 100%.
Column widths will be ignored.
New-AsBuiltReport : Undefined API
At line:1 char:1
+ New-AsBuiltReport -Target 'clustername' -Username 'admin' -Password 'password
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,New-AsBuiltReport

Hi,

Recently we were forced to use MFA by Rubrik, since then I am not able to run the report as local user and -Token option also fails, please advice

Invoke-AsBuiltReport.Rubrik.CDM : Authentication is possible but has failed or not yet been provided.
At C:\Program Files\WindowsPowerShell\Modules\AsBuiltReport.Core\1.1.0\Src\Public\New-AsBuiltReport.ps1:350 char:17

• ... & "Invoke-$($ReportModuleName)" -Target $Target -Credenti ...

•             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  

  • CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException
  • FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,Invoke-AsBuiltReport.Rubrik.CDM

New-AsBuiltReport : The property 'Number' cannot be found on this object. Verify that the property exists.
At line:1 char:2

•  + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
   + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,New-AsBuiltReport
  
  

===============================================================

New-AsBuiltReport : A parameter cannot be found that matches parameter name 'Token'.
At line:1 char:42

• •                                      ~~~~~~
    

    • CategoryInfo : InvalidArgument: (:) [New-AsBuiltReport], ParameterBindingException
    • FullyQualifiedErrorId : NamedParameterNotFound,New-AsBuiltReport

We have previously (months ago) used AsBuiltReport.Rubrik.CDM without any issue
We are trying to use AsBuiltReport.Rubrik.CDM again and we get the following error (see below).
We get the same error on both our Rubrik Cluster on different SLAs and it looks like the error is caused by SLAs with minute (for example 20) frequency.

** Versions **
Rubrik CDM 6.0.2-p1
PSVersion 5.1.19041.1320

ModuleType Version Name ExportedCommands

Script 5.3.1 Rubrik {Connect-Rubrik, Disconnect-Rubrik, Export-RubrikDatabase, Export-RubrikReport...}
Manifest 1.0.5 AsBuiltReport`

Describe the bug
New-AsBuiltReport fails when encoutering a SLA with 20 (example) minutes frequency

VERBOSE: [ 15:00:19:269 ] [ Document ] - Processing table 'SLA Frequencies'.
New-AsBuiltReport : Cannot bind argument to parameter 'Rows' because it is an empty collection.
At line:1 char:1
New-AsBuiltReport -Target '' -Username 'user' -Password ...
CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException
FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,New-AsBuiltReport

To Reproduce
Create a SLA with 20 minute frequency via RestAPI
Run New-AsBuiltReport
(SLA1 is assigned to a fileset backup and this might require so
New-AsBuiltReport_error.txt
me help from Rubrik support to enable in later versions of CDM)

Expected behavior
SLA should be documented as any other SLAs

Attachments

Screenshot
SLA according to v1 API
SLA according to v2 API
Excerpt from PS command

Look to move away from using expressions in favour of PSCustomPObjects in alignment with the contributing guidelines

The current report only displays object archives which have a type of S3 - S3Compatible needs to be included as well in the filter.

When running the report the following error is produced

New-AsBuiltReport: The property 'Width' cannot be found on this object. Verify that the property exists.New-AsBuiltReport: The property 'Width' cannot be found on this object. Verify that the property exists.

Rubrik CDM 7.0.3.p2
AsBuiltReport Version 1.0.3
Ps version : 7.3.0 core
o/s : Darwin 21.6.0

Powershell version 5
Rubrik Latest
AsBuiltReport Latest

VERBOSE: [ 23:33:02:507 ] [ Document ] - Document 'Rubrik As Built Report - 2020-07-30_23.32.45' processing completed.
VERBOSE: [ 23:33:02:512 ] [ Document ] - Total processing time '17.32' seconds.
N
New-AsBuiltReport : The property 'Value' cannot be found on this object. Verify that the property exists.
At line:1 char:1

• New-AsBuiltReport -Target 10.46.120.4 -Report Rubrik.CDM -Format Word ...

•   + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,New-AsBuiltReport
  
  

No Word or HTML file is generated

Need to add a Measure-Object to ensure that the Replication target and sources exist before trying to output to table.

Error when trying to run the initial report in the Readme.md

New-AsBuiltReport -Target 'cluster1.domain.local' -Token '1234abcd' -Report Rubrik.CDM -Format Html,Word -OutputFolderPath 'C:\Reports' -Timestamp

Describe the bug
The following error is displayed when a Rubrik as built report is generated.

The table column widths total '99'%. Total column width must equal 100%. Column widths will be ignored.

The following code shows the issue.

Four columns are defined for the table, however there are five column widths defined which do not total 100%.

$NodeInfo | Table -Name "Cluster Node Information" -ColumnWidths 25, 12, 12, 25, 25 -Columns brikId, id, status, supportTunnel -Headers 'Brik ID', 'ID', 'Status', 'Support Tunnel'

Expected behavior
Column Widths should total 100%. Column widths should match the number of columns which are defined for the table.

When processing the protected objects, the module mostly does null checks around everything. This check isn't applied to filesets - therefore, it causes the report to error out due to the following error

Cannot validate argument on parameter 'id'. The argument is null or empty. Provide an argument that is not null or empty, and then try the command again.

Need to apply the same logic to filesets as all other protected objects.

Need to output version of AsBuiltReport.Core, AsBuiltReport.Rubrik.CDM and Rubrik Powershell modules within the verbose logging. Will make troubleshooting customer issues a lot easier to know what versions they are running without having to ask :)

Add disks protected for each VM in the comprehensive report

When attmpting to generate a Rubrik CDM as built report, the following error message is displayed New-AsBuiltReport: A parameter cannot be found that matches parameter name 'StylePath'..

To Reproduce
Generate a Rubrik CDM as built report using AsBuiltReport.Rubrik.CDM module version 1.0.2 and AsBuiltReport.Core 1.3.0

Expected behavior
Rubrik CDM as built report should be generated without issues