|
25 | 25 |
|
26 | 26 | # NetApp ONTAP Arrays AsBuiltReport |
27 | 27 |
|
28 | | -NetApp ONTAP AsBuiltReport is a module of the parent "AsBuiltReport" [project](https://github.com/AsBuiltReport/AsBuiltReport). AsBuiltReport is a PowerShell module which generates As-Built documentation for many common datacentre infrastructure systems. Reports can be generated in Text, HTML and MS Word formats and can be presented with custom styling to align with your company/customer's brand. |
| 28 | +NetApp ONTAP As Built Report is a PowerShell module which works in conjunction with [AsBuiltReport.Core](https://github.com/AsBuiltReport/AsBuiltReport.Core). |
29 | 29 |
|
30 | | -For detailed documentation around the whole project, please refer to the `README.md` file in the parent AsBuiltReport repository (linked to above). This README is specific only to the NetApp ONTAP Array repository. |
| 30 | +[AsBuiltReport](https://github.com/AsBuiltReport/AsBuiltReport) is an open-sourced community project which utilises PowerShell to produce as-built documentation in multiple document formats for multiple vendors and technologies. |
| 31 | + |
| 32 | +Please refer to the AsBuiltReport [website](https://www.asbuiltreport.com) for more detailed information about this project. |
31 | 33 |
|
32 | 34 | ## :books: Sample Reports |
33 | 35 |
|
34 | 36 | ### Sample Report - Custom Style 1 |
35 | 37 |
|
36 | 38 | Sample NetApp ONTAP As Built report HTML file: [Sample NetApp As-Built Report.html](https://technomyth.zenprsolutions.net/wp-content/uploads/2021/11/NetApp-ONTAP-As-Built-Report.html) |
37 | 39 |
|
38 | | -Sample NetApp ONTAP As Built report with health checks, using custom report style. |
39 | | - |
40 | | - |
41 | | - |
42 | | -### Sample Report - Custom Style 2 |
43 | | - |
44 | | -Sample NetApp ONTAP As Built report with health checks, using custom report style. |
45 | | - |
46 | | - |
47 | | - |
48 | | -### Sample Report - Custom Style 3 |
49 | | - |
50 | | -Sample NetApp ONTAP As Built report with health checks, using custom report style. |
51 | | - |
52 | | - |
53 | | - |
54 | 40 | # :beginner: Getting Started |
55 | 41 |
|
56 | 42 | Below are the instructions on how to install, configure and generate a NetApp ONTAP As Built Report |
@@ -83,15 +69,27 @@ These modules may also be manually installed. |
83 | 69 | | AsBuiltReport.Core | 1.1.0 | [Link](https://www.powershellgallery.com/packages/AsBuiltReport.Core) | [Link](https://github.com/AsBuiltReport/AsBuiltReport.Core/releases/latest) | |
84 | 70 | | Netapp.ONTAP | 9.9.1 | [Link](https://www.powershellgallery.com/packages/NetApp.ONTAP) | | |
85 | 71 |
|
86 | | -### :package: Module Installation |
| 72 | +### Linux & macOS |
| 73 | + |
| 74 | +- .NET Core is required for cover page image support on Linux and macOS operating systems. |
| 75 | + - [Installing .NET Core for macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos) |
| 76 | + - [Installing .NET Core for Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux) |
| 77 | + |
| 78 | +❗ If you are unable to install .NET Core, you must set `ShowCoverPageImage` to `False` in the report JSON configuration file. |
| 79 | + |
| 80 | +## :package: Module Installation |
| 81 | + |
| 82 | +### PowerShell |
87 | 83 |
|
88 | 84 | Open a PowerShell terminal window and install each of the required modules as follows; |
89 | 85 |
|
90 | 86 | ```powershell |
91 | 87 | Install-Module AsBuiltReport.NetApp.ONTAP |
92 | 88 | ``` |
93 | 89 |
|
94 | | -Ensure you repeat the following steps for the [system requirements](https://github.com/AsBuiltReport/AsBuiltReport.NetApp.ONTAP#wrench-system-requirements) also. |
| 90 | +### GitHub |
| 91 | + |
| 92 | +If you are unable to use the PowerShell Gallery, you can still install the module manually. Ensure you repeat the following steps for the [system requirements](https://github.com/AsBuiltReport/AsBuiltReport.NetApp.ONTAP#wrench-system-requirements) also. |
95 | 93 |
|
96 | 94 | 1. Download the code package / [latest release](https://github.com/AsBuiltReport/AsBuiltReport.NetApp.ONTAP/releases/latest) zip from GitHub |
97 | 95 | 2. Extract the zip file |
|
0 commit comments