pre 152 tweaks (#1009)

- remove deprecated pdf generation process
- minor release tweaks

Author: Brian969

.github/workflows/release.yml

@@ -221,340 +221,6 @@ jobs:
           name: ${{ steps.build.outputs.release-asset-name }}
           path: ${{ steps.build.outputs.release-path }}
 
-  build-documentation:
-    name: Build Documentation
-    runs-on: ubuntu-latest
-    outputs:
-      documentation-archive-name: ${{ steps.setup.outputs.dir }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-      - name: Install xetex
-        run: |
-          sudo apt-get install texlive-xetex
-          sudo apt install librsvg2-bin
-          sudo apt install 'fonts-dejavu*'
-
-      - name: Setup Env
-        id: setup
-        env:
-          PREFIX: AWS-SEA
-          SUFFIX: Documentation
-        run: |
-          mkdir ${PREFIX}-${SUFFIX}
-          echo ::set-output name=prefix::$(echo "${PREFIX}")
-          echo ::set-output name=suffix::$(echo "${SUFFIX}")
-          echo ::set-output name=dir::$(echo "${PREFIX}-${SUFFIX}")
-
-      - name: PDF output 0
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/0-${{ steps.setup.outputs.prefix }}-Solution-Summary.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            README.md
-
-      - name: PDF output 1
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/1-${{ steps.setup.outputs.prefix }}-Installation-Guide.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/installation/installation.md
-
-      - name: PDF output 1a
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/1a-${{ steps.setup.outputs.prefix }}-v150-Upgrade-Guide.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/installation/v150-Upgrade.md
-
-      - name: PDF output 2
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/2-${{ steps.setup.outputs.prefix }}-Ops-FAQ.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/faq/faq.md
-
-      - name: Copy file output 3
-        run: |
-          cp docs/architectures/AWS_Diagrams_Account_Network_VPC.pdf ${{ steps.setup.outputs.dir }}/3-${{ steps.setup.outputs.prefix }}-Diagrams_Account_Network_VPC.pdf
-
-      - name: PDF output 4a
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4a-${{ steps.setup.outputs.prefix }}-Config-File-Customization.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/installation/customization-index.md
-
-      - name: Copy file output 4b
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.example.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.example.json
-
-      - name: Copy file output 4b1
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.lite-VPN-example.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.lite-VPN-example.json
-
-      - name: Copy file output 4b2
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.multi-region-example.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.multi-region-example.json
-
-      - name: Copy file output 4b3
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.ultralite-example.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.ultralite-example.json
-
-      - name: Copy file output 4b4
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.example-oldIP.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.example-oldIP.json
-
-      - name: Copy file output 4b5
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.lite-CTNFW-example.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.lite-CTNFW-example.json
-
-      - name: Copy file output 4b6
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.lite-GWLB-example.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.lite-GWLB-example.json
-
-      - name: Copy file output 4b7
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.lite-NFW-example.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.lite-NFW-example.json
-
-      - name: Copy file output 4b8
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.lite-VPN-example-oldIP.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.lite-VPN-example-oldIP.json
-
-      - name: Copy file output 4b9
-        run: |
-          cp reference-artifacts/SAMPLE_CONFIGS/config.test-example.json ${{ steps.setup.outputs.dir }}/4b-${{ steps.setup.outputs.prefix }}-config.test-example.json
-
-      - name: PDF output 4c
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4c-${{ steps.setup.outputs.prefix }}-Multi-file-Config-Capabilities.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/installation/multi-file-config-capabilities.md
-
-      - name: PDF output 4d
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4d-${{ steps.setup.outputs.prefix }}-Config-Sample-Snippets.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            ./reference-artifacts/SAMPLE_CONFIGS/sample_snippets.md
-
-      - name: Copy file output 4e
-        run: |
-          cp reference-artifacts/Third-Party/firewall-example-A-A-multitunnel.txt ${{ steps.setup.outputs.dir }}/4e-${{ steps.setup.outputs.prefix }}-firewall-example-A-A-multitunnel.txt
-
-      - name: PDF output 4f
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4f-${{ steps.setup.outputs.prefix }}-Firewall-config-Customizations.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            ./reference-artifacts/SAMPLE_CONFIGS/firewall_file_available_variables.md
-
-      - name: PDF output 4g
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4g-${{ steps.setup.outputs.prefix }}-logging-locations.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=11in
-            -V geometry:paperheight=8.5in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/architectures/pbmm/log-file-locations.md
-
-      - name: PDF output 4h
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4h-${{ steps.setup.outputs.prefix }}-What-Where.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=11in
-            -V geometry:paperheight=8.5in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/installation/what-we-do-where.md
-
-      - name: PDF output 4i
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4i-${{ steps.setup.outputs.prefix }}-Public-Workload-Fortigate.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/installation/guides/public-facing-workload-via-fortigate.md
-
-      - name: PDF output 4j
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4j-${{ steps.setup.outputs.prefix }}-State-Machine-Inputs.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/installation/sm_inputs.md
-
-      - name: PDF output 4k
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4k-${{ steps.setup.outputs.prefix }}-Object-Naming.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/installation/object-naming.md
-
-      - name: PDF output 4l
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/4l-${{ steps.setup.outputs.prefix }}-ALZ-Import-Account.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/operations/operations-import-ALZAccount.md
-
-      - name: PDF output 5
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/5-${{ steps.setup.outputs.prefix }}-Operations-Troubleshooting-Guide.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/operations/operations-troubleshooting-guide.md
-
-      - name: PDF output 6
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/6-${{ steps.setup.outputs.prefix }}-Developer-Guide.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/developer/developer-guide.md
-
-      - name: PDF output 7
-        uses: docker://pandoc/latex:2.10
-        with:
-          args: >
-            --output=${{ steps.setup.outputs.dir }}/7-${{ steps.setup.outputs.prefix }}-PBMM-Architecture.pdf
-            --from=gfm
-            --resource-path=.:docs/architectures/pbmm:docs/installation:docs/operations
-            -V linkcolor:blue
-            -V geometry:paperwidth=8.5in
-            -V geometry:paperheight=11in
-            -V geometry:margin=.8in
-            -V documentclass=report
-            --pdf-engine=xelatex
-            docs/architectures/pbmm/architecture.md
-
-      - name: Upload Artifact
-        uses: actions/upload-artifact@v2
-        with:
-          name: ${{ steps.setup.outputs.dir }}
-          path: ${{ steps.setup.outputs.dir }}/
-
   upload-archive-to-release:
     # We don't want to upload artifact to the release if the workflow was dispatched manually
     if: github.event_name != 'workflow_dispatch'

src/mkdocs/docs/installation/install.md

@@ -2,9 +2,9 @@
 
 ## 1.1. Overview
 
-**_We encourage customers installing the Accelerator to get the support of their local AWS account team (SA, TAM, CSM, ProServe) to assist with the installation of the Accelerator, as the Accelerator leverages, deploys, or orchestrates over 30 different AWS services._**
+**_We encourage customers installing the Accelerator to get the support of their local AWS account team (SA, TAM, CSM, ProServe) to assist with the installation of the Accelerator, as the Accelerator leverages, deploys, or orchestrates over 50 different AWS services._**
 
-_Users are strongly encouraged to also read the [Accelerator Operations/Troubleshooting Guide](../operations/index.md) before installation. The Operations/Troubleshooting Guide provides details as to what is being performed at each stage of the installation process, including detailed troubleshooting guidance._
+_Users are strongly encouraged to also read the [Accelerator Operations/Troubleshooting Guide](../operations/index.md) before installation and the [FAQ](../faq/index.md) while waiting for the installation to complete. The Operations/Troubleshooting Guide provides details as to what is being performed at each stage of the installation process, including detailed troubleshooting guidance._
 
 These installation instructions assume one of the prescribed architectures is being deployed.
 
@@ -15,6 +15,7 @@ These installation instructions assume one of the prescribed architectures is be
 -   Management or root AWS Organization account (the AWS Accelerator cannot be deployed in an AWS sub-account)
     -   No additional AWS accounts need to be pre-created before Accelerator installation
 -   If required, a limit increase to support your desired number of new AWS sub-accounts (default limit is 10 sub-accounts)
+    - **recent changes to new AWS account limits are causing accelerator installation failures, please work with your local account team to increase your limits**
 -   Valid Accelerator configuration file, updated to reflect your requirements (see below)
 -   Determine your primary or Accelerator `control` or `home` region, this is the AWS region in which you will most often operate
 -   Government of Canada customers are still required to do a standalone installation at this time, please request standalone installation instructions from your Account SA or TAM
@@ -212,7 +213,7 @@ Multiple options exist for downloading the GitHub Accelerator codebase and pushi
     - Do NOT download the code off the main GitHub branch, this will leave you in a completely unsupported state (and with beta code)
 3. Push the extracted codebase into the newly created CodeCommit repository, maintaining the file/folder hierarchy
 4. Set the default CodeCommit branch for the new repository to main
-5. Create a branch following the Accelerator naming format for your release (i.e. `release/v1.5.1-a`)
+5. Create a branch following the Accelerator naming format for your release (i.e. `release/v1.5.2`)
 
 ### 1.4.3. AWS Internal (Employee) Accounts Only
 
@@ -315,7 +316,7 @@ If deploying to an internal AWS employee account and installing the solution wit
     - Add an `Email` address to be used for State Machine Status notification
     - The `GitHub Branch` should point to the release you selected
         - if upgrading, change it to point to the desired release
-        - the latest stable branch is currently `release/v1.5.1-a`, case sensitive
+        - the latest stable branch is currently `release/v1.5.2`, case sensitive
         - click `Next`
 7. Finish deploying the stack
     - Apply a tag on the stack, Key=`Accelerator`, Value=`ASEA` (case sensitive).