From 2d87811e7eac28e96dda1224bfd29a90b9aff088 Mon Sep 17 00:00:00 2001 From: Warren du Toit Date: Mon, 15 Sep 2025 16:46:50 +0200 Subject: [PATCH 1/3] FAQ addtion for users running MacOS --- .gitignore | 1 + docs/wiki/FAQ.md | 37 ++++++++++++++++++++++++++++++++++++- 2 files changed, 37 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index f67bb91..7d4928b 100644 --- a/.gitignore +++ b/.gitignore @@ -406,3 +406,4 @@ FodyWeavers.xsd # JetBrains Rider *.sln.iml +.DS_Store diff --git a/docs/wiki/FAQ.md b/docs/wiki/FAQ.md index 18da1c6..ba4c5f4 100644 --- a/docs/wiki/FAQ.md +++ b/docs/wiki/FAQ.md @@ -1,3 +1,38 @@ # Frequently Asked Questions -Currently, there are no frequently asked questions. +Does the Azure to Azure migration toolkit work on Mac? + Yes it does. + + - Follow the below steps as pre-requisites so that you can successfully use A2ATK on a Mac. + +1. Install homebrew if you do not have it. Open a terminal and run + +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" + +More info can be found here. https://brew.sh/ + +2. Once homebrew is installed, Install PowerShell. + +brew install powershell + +3. The executable to get into PowerShell is "pwsh". In a terminal you can type "pwsh" and you will get a PowerShell prompt. + +└🤘-> pwsh +PowerShell 7.5.2 +PS /Users/user> + +4. Now install the required modules. + + Install-Module Az (This is the Azure PowerShell Module) + Import-Module Az (Import the module) + Install-Module -Name Az.CostManagement (This is the Azure Cost Management PowerShell Module) + Import-Module Az.CostManagement (Import the module) + Install-Module -Name ImportExcel (This is the Excel PowerShell Module) - So that it can export to Excel correctly. + + One last package that needs to be installed to get the Excel formatting done correctly is mono-libgdiplus + You can do this by running + + brew install mono-libgdiplus + +Now just follow the rest of the steps in the Docs as if you were running Windows. All the commands will work in pwsh from the Mac terminal. + \ No newline at end of file From f15d31a5bb09bbf4b6c726cb02bd18524d09e8e6 Mon Sep 17 00:00:00 2001 From: Warren du Toit Date: Mon, 15 Sep 2025 16:55:15 +0200 Subject: [PATCH 2/3] update bare urls --- docs/wiki/FAQ.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/wiki/FAQ.md b/docs/wiki/FAQ.md index ba4c5f4..7164347 100644 --- a/docs/wiki/FAQ.md +++ b/docs/wiki/FAQ.md @@ -7,11 +7,11 @@ Does the Azure to Azure migration toolkit work on Mac? 1. Install homebrew if you do not have it. Open a terminal and run -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" +/bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))" -More info can be found here. https://brew.sh/ +More info can be found here: [https://brew.sh/](https://brew.sh/) -2. Once homebrew is installed, Install PowerShell. +1. Once homebrew is installed, Install PowerShell. brew install powershell From d4ff619f11dc188c02c157cfe8685ccb3f5fb4dc Mon Sep 17 00:00:00 2001 From: Warren du Toit Date: Mon, 15 Sep 2025 16:59:04 +0200 Subject: [PATCH 3/3] formatting fixes --- docs/wiki/FAQ.md | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/docs/wiki/FAQ.md b/docs/wiki/FAQ.md index 7164347..67be9ef 100644 --- a/docs/wiki/FAQ.md +++ b/docs/wiki/FAQ.md @@ -1,9 +1,9 @@ # Frequently Asked Questions -Does the Azure to Azure migration toolkit work on Mac? - Yes it does. +Does the Azure to Azure migration toolkit work on Mac? + Yes it does. - - Follow the below steps as pre-requisites so that you can successfully use A2ATK on a Mac. + - Follow the below steps as pre-requisites so that you can successfully use A2ATK on a Mac. 1. Install homebrew if you do not have it. Open a terminal and run @@ -13,26 +13,25 @@ More info can be found here: [https://brew.sh/](https://brew.sh/) 1. Once homebrew is installed, Install PowerShell. -brew install powershell +brew install powershell 3. The executable to get into PowerShell is "pwsh". In a terminal you can type "pwsh" and you will get a PowerShell prompt. -└🤘-> pwsh +└🤘-> pwsh PowerShell 7.5.2 -PS /Users/user> +PS /Users/user> -4. Now install the required modules. +4. Now install the required modules. Install-Module Az (This is the Azure PowerShell Module) - Import-Module Az (Import the module) + Import-Module Az (Import the module) Install-Module -Name Az.CostManagement (This is the Azure Cost Management PowerShell Module) - Import-Module Az.CostManagement (Import the module) - Install-Module -Name ImportExcel (This is the Excel PowerShell Module) - So that it can export to Excel correctly. + Import-Module Az.CostManagement (Import the module) + Install-Module -Name ImportExcel (This is the Excel PowerShell Module) - So that it can export to Excel correctly. One last package that needs to be installed to get the Excel formatting done correctly is mono-libgdiplus - You can do this by running + You can do this by running brew install mono-libgdiplus -Now just follow the rest of the steps in the Docs as if you were running Windows. All the commands will work in pwsh from the Mac terminal. - \ No newline at end of file +Now just follow the rest of the steps in the Docs as if you were running Windows. All the commands will work in pwsh from the Mac terminal. \ No newline at end of file