# Installation

## Requirements

As powerGate allows to automate data synchronization between Vault and ERP systems, the [Vault system requirements](<https://www.autodesk.com/support/technical/article/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

**.NET Framework:** 4.7 or higher

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

### Workstations

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

- Vault Professional

**coolOrange powerJobs Client**: [powerJobs Client](<inv:powerjobs_client#index>) is installed automatically *(optional)* </br>

- [powerEvents](<inv:powerevents#index>) is needed to easily realize integrations between Vault Client, Inventor and the ERP system (see [ERP integration sample](<erp_integrations:ERP integrations>)).

### Job Processor

**coolOrange powerJobs Processor**: [powerJobs Processor](<inv:powerjobs_processor#index>) *(optional)*</br>

- Needed to perform automated data synchronization tasks between Vault and ERP via the Job Processor.

## 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>).\
To accept the products EULA when starting the setup in silent mode pass the ***ACCEPT_EULA=1*** argument.\
This installs all components needed on a [workstation](<installation:workstations>) by default:
```bash
"\\path\to\networklocation\powerGate24.0_Vault2024.exe" -silent ACCEPT_EULA=1
```

To install only the main components (*Cmdlets* and *.NET Library*) on the [Job Processor](<installation:workstations>) machine, pass the ***MAIN_COMPONENTS_ONLY=1*** argument.\
This will NOT install any *[sample files](<erp_integrations:scripts>)* and no *[powerJobs Client](<inv:powerjobs_client#index>)*:
```bash
"\\path\to\networklocation\powerGate24.0_Vault2024.exe" -silent ACCEPT_EULA=1 MAIN_COMPONENTS_ONLY=1
```

## After the Setup
After installing powerGate on a development environment, the provided [sample files](<erp_integrations:scripts>) can be used to implement your own Vault ERP integration.\
It is recommended to disable all PowerShell scripts that are not used and have been replaced with your own version.

## 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\\Client Customizations* (only on [workstations](<installation:workstations>))

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](<inv:licensing#license_information>) to activate the product
- **powerGate Logs** - Opens the log file location

## Updates

To install a newer version of powerGate on [workstations](<installation:workstations>), just execute the setup file of the new version.\
ERP integrations will then continue to work as usual, with all delivered [sample files](<erp_integrations:scripts>) also beeing updated (see *C:\ProgramData\coolOrange\Client Customizations\Disabled* folder).\
Improvements in these files will automatically take effect only for those PowerShell scripts that were also previously [enabled](<inv:powerevents#client_customizations:enable or disable scripts>).

:::{note}
On the [Job Processor](<installation:workstations>), Vault Workgroup (unsupported) and Vault 2020 or older environments, powerGate must be updated with the previously used `MAIN_COMPONENTS_ONLY=1` argument.

Please note that for such installations that contain only the main components ([](</code_reference/commandlets>) and [](</code_reference/net_library>)), future updates can also be performed **only with this argument**!\
Otherwise the update will be prevented by the installer. A full installation on workstations is then unfortunately only possible by [uninstalling](<installation:uninstall>) the old version before installing the new one.
:::

## 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".