# Installation

## Requirements

As powerEvents is an extension to *Vault Applications*, 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:**  2024 / 2023 / 2022 / 2021

- Vault Professional
- Vault Workgroup

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

**[powerVault](<inv:powervault#index>)**:  is installed automatically

## Setup

The powerEvents setup is delivered as an executable and accepts the standard windows installer arguments documented [here](<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:
```bash
"\\path\to\networklocation\powerEvents24.0_Vault2024.exe" -silent ACCEPT_EULA=1
```

## Windows permissions

In order to execute and synchronize distributed scripts and modules properly, the current windows user needs the following rights on:
| Path                                                 | Required Rights                           |
| -----------------------------------------------------| ------------------------------------------|
| C:\\ProgramData\\coolOrange\\ | **Read**, **Write** and **Delete** data   |

## Install Locations

powerEvents is installed in the following locations on your system:

- All program libraries and executable files are placed in *C:\\ProgramData\\Autodesk\\\[Vault Version\]\\Extensions\\powerEvents*
- The Cmdlets will be installed to *C:\\Program Files\\coolOrange\\Modules\\powerEvents*
- All client customization files, e.g. scripts and module libraries, are placed in *C:\\ProgramData\\coolOrange\\Client Customizations*
- The script *C:\\ProgramData\\coolOrange\\Publish-Customizations.ps1* helps distribute the client customizations to other Vault environments

Following shared libraries are installed in *GAC*:

- coolOrange.logging.dll
- coolOrange.VaultServices\_\[Vault Version\].dll

Following shortcuts are added in the start menu:

- **powerEvents Configuration** - Opens the directoy with the files of the different client customizations
- **powerEvents ISE** - Opens the IDE and opens a sample script
- **powerEvents Information** - Opens the About dialog with product related information
- **powerEvents License Information** - Opens the [License Information dialog](<inv:licensing#license_information>) to activate the product
- **powerEvents Logs** - Opens the log file location

## Updates

To install a newer version of powerEvents just execute the setup file of the new version. This will automatically update the files in the existing installation.\
Please note that also sample customizations (and standard scripts for powerJobs Client) will be updated.

If a tested version of your customizations has already been [distributed](<client_customizations:distribution>) to other workstations, it is therefore **recommended** to run the update on one environment first.\
Then start a Vault application to test possible changes. In case of local modifications a warning box will remind to publish the new version of customizations to your Vault Server.\
Afterwards, the new powerEvents version can also be installed on all other environments without notifying Vault users again about the already confirmed changes.

:::{note}
When upgrading from versions [v23.0.9](<change_logs/powerevents_v23:v23.0.9>) or earlier with **enabled**  [sample scripts](<client_customizations:scripts>) these scripts are automatically reverted to their original state after the update.

To [re-enable sample scripts](<getting_started:activating a sample script>) that have been enabled manually on the previous install, move them from *%ProgramData%/coolOrange/Client Customizations/Disabled* to *%ProgramData%/coolOrange/Client Customizations* .
:::

## Uninstall

To remove powerEvents from a computer one perform of the following steps :
- Execute the setup file again. This will give you the option to repair or remove powerEvents. Click on "Remove" to uninstall the program.
- Go to "Control Panel - Programs and Features", find "coolOrange powerEvents for Vault" and run "Uninstall".