Skip to content

Feature/23874 add execution policy to upgrade and install #174

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions content/en/docs/2024.9/Reference/troubleshooting/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,14 @@ To work around this error, either uninstall the platform and reinstall it using

1. Uninstall the platform by taking the following steps:
1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down Expand Up @@ -300,6 +308,14 @@ A workaround for this is provided by Intel.

1. Uninstall the platform by taking the following steps:
1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,14 @@ A collection of registry settings need to be applied to guarantee your server is
The settings can be applied by running a script. Be aware that the server will be restarted when the script is run. Apply the settings by following these instructions:

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
To check all necessary ports are free, follow these steps.
1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
1. Open a Windows PowerShell (x64) window as administrator.
{{< alert title="Important" color="warning" >}}It is critical to make sure this is a new PowerShell window. If any Service Fabric cmdlets have been run previously to running the `Cortex.Innovation.Upgrade.ps1` script, the upgrade will close halfway through due to the PowerShell module being updated.{{< /alert >}}

1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation 2024.9 - App Server Install Scripts\Upgrade Application Server` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
1. Open a Windows PowerShell (x64) window as administrator.
{{< alert title="Important" color="warning" >}}It is critical to make sure this is a new PowerShell window. If any Service Fabric cmdlets have been run previously to running the `Cortex.Innovation.Upgrade.ps1` script, the upgrade will close halfway through due to the PowerShell module being updated.{{< /alert >}}

1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation 2024.9 - App Server Install Scripts\Upgrade Application Server` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,13 @@
1. Open a Windows PowerShell (x64) window as administrator.

1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation 2024.9 - Web App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,14 @@ A collection of registry settings need to be applied to guarantee your server is
The settings can be applied by running a script. Be aware that each server will be restarted when the script is run. Apply the settings by following these instructions:

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down Expand Up @@ -80,6 +88,14 @@ To avoid answering all of the prompts `-Override 0` can be added to the end of t
If Windows Defender is not running on the Application Servers, ensure that the [Antivirus Exclusions][] have been added to the running antivirus software on each of the Application Servers and continue to the next section, otherwise follow these steps:

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand All @@ -100,6 +116,14 @@ If Windows Defender is not running on the Application Servers, ensure that the [
To check all necessary ports are free, follow these steps:

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down Expand Up @@ -249,6 +273,14 @@ More advanced configuration (such as changing ports) can be undertaken by modify
## Test Installation Script

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,14 @@ This guide describes how to upgrade {{% ctx %}} Gateway on v7.2 to include Innov
### Upgrade {{% ctx %}} Gateway

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - Web App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -134,6 +134,14 @@ A Friendly Name should be assigned to the certificate being used for the Cortex
### Upgrade {{% ctx %}} Gateway

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - Web App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,14 @@ Apply the settings by following these instructions:

1. Copy from one of the application servers the `Cortex.Innovation.Install.SSLBestPractices.ps1` file extracted during the [Make Installation Artefacts Available][] step into a suitable location on the Web Application Server.
1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Change the location to the folder where the `Cortex.Innovation.Install.SSLBestPractices.ps1` file was copied to using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,14 @@ If required, a separate X.509 SSL certificate can be obtained to be used by the
### Test Update Certificates Script

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,14 @@ A collection of registry settings need to be applied to guarantee your server is
The settings can be applied by running a script. Be aware that each server will be restarted when the script is run. Apply the settings by following these instructions:

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down Expand Up @@ -80,6 +88,14 @@ To avoid answering all of the prompts `-Override 0` can be added to the end of t
If Windows Defender is not running on the Application Servers, ensure that the [Antivirus Exclusions][] have been added to the running antivirus software on each of the Application Servers and continue to the next section, otherwise follow these steps:

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand All @@ -100,6 +116,14 @@ If Windows Defender is not running on the Application Servers, ensure that the [
To check all necessary ports are free, follow these steps:

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down Expand Up @@ -249,6 +273,14 @@ More advanced configuration (such as changing ports) can be undertaken by modify
## Test Installation Script

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,14 @@ It is possible for {{% ctx %}} Gateway to reuse the certificate used when [insta
### Install {{% ctx %}} Gateway

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - Web App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -176,6 +176,14 @@ Once the certificate has been imported, a `Friendly Name` should be assigned whi
### Install {{% ctx %}} Gateway

1. Open a Windows PowerShell (x64) window as administrator.
1. Type and run the following command to temporarily modify the PowerShell Execution Policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
```

{{< alert title="Note">}}This is a temporary change and will only affect the current PowerShell window.{{< /alert >}}

1. Navigate PowerShell to inside the `Cortex Innovation {{< version >}} - Web App Server Install Scripts` folder using the following command, modifying the path as necessary:

```powershell
Expand Down
Loading