# Installation

## Requirements

As powerGate allows to automate data synchronization between Vault and ERP systems, the [Vault system requirements](<http://knowledge.autodesk.com/support/vault-products/troubleshooting/caas/sfdcarticles/sfdcarticles/System-requirements-for-Autodesk-Vault-products.html>) defined by Autodesk leads.

**Operating System:** 64-bit only

- Microsoft Windows 10
- Microsoft Windows 11

**Autodesk Vault Client:** 2023 / 2022 / 2021

- Vault Professional

**.NET Framework:** 4.5 or higher

**Windows PowerShell:** PowerShell 4.0 or [higher](<https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-5.1>)

**coolOrange powerJobs Client**: [powerJobs Client](<powerjobs_client:index>) gets installed automatically </br>
&emsp; [powerEvents](<powerevents:index>) is needed to use the standard [integration](<erp_integrations>) or to realize custom integrations between Vault Client, Inventor and the ERP system.

## Setup

The powerGate setup is delivered as an executable and accepts the [standard windows installer arguments](<https://docs.microsoft.com/en-us/windows/desktop/Msi/command-line-options>).\
The powerGate setup contains following features, which are installed per default:
- **CMDLETS**: Installs the [](</code_reference/commandlets>) and the [](</code_reference/net_library>). 
- **VAULT_ERP_INTEGRATION**: Installs the [Vault Client - ERP integration](<erp_integrations:erp integrations>) and the required [powerJobs Client](<powerjobs_client:index>).

To accept the products EULA when starting the setup in silent mode pass the **ACCEPT_EULA=1** argument.\
To install or deploy the product without [Vault Client - ERP integration](<erp_integrations:erp integrations>) and without [powerJobs Client](<powerjobs_client:index>), pass the **VAULT_ERP_INTEGRATION=0** argument:
```bash
"\\path\to\networklocation\powerGate23.0_Vault2023.exe" -silent ACCEPT_EULA=1 VAULT_ERP_INTEGRATION=0
```
Using `VAULT_ERP_INTEGRATION=0` is only recommeded when:
  * Upgrading an existing customization from v22.0 or older with an already implemented Vault integration (to avoid duplicate tabs)
  * **Only** the powerGate [Cmdlets](</code_reference/commandlets>) or the [.NET SDK](</code_reference/net_library>) are required

To upgrade a customized Vault integration from v23.0 or newer it is recommended to [disable](<powerevents:event_scripts:enable or disable scripts>) the scripts that are not in use or that are replaced with customized versions.

### Install Locations

powerGate is installed in the following locations on your system:

- The Cmdlets will be installed to *C:\\Program Files\\coolOrange\\Modules\\powerGate*
- All PowerShell scripts and XAML files relevant for the ERP integration are placed in *C:\\ProgramData\\coolOrange\\powerEvents*

Following shared libraries are installed in *GAC*:

- powerGate.Erp.Client.dll
- coolOrange.Logging.dll

Following shortcuts are added in the start menu:

- **powerGate Console** - Opens the PowerShell Console and loads the powerGate module
- **powerGate Information** - Opens the About dialog with product related information
- **powerGate License Information** - Opens the [License Information dialog](<licensing:license_information>) to activate the product
- **powerGate Logs** - Opens the log file location

## Updates

To install a newer version of powerGate just execute the setup file of the new version. This will automatically update the files in the existing installation.

:::{warning}
Upgrading from versions [v23.0.8 (or later)](<change_logs/powerGate_v23:v23.0.8>) that were NOT installed with **VAULT_ERP_INTEGRATION=0** have to be upgraded using the same argument.\
Otherwise the upgrade will be prevented by the installer and the old version has to be [uninstalled](<installation:uninstall>) before installing the new version.
:::

## Uninstall

In case you want to remove powerGate from your computer you can:

- Execute the setup file again. This will give you the option to repair or remove powerGate. Click on "Remove" to uninstall the program.
- Go to "Control Panel - Programs and Features", find "coolOrange powerGate" and run "Uninstall".