# Installation

## Requirements

As powerJobs Processor is an extension to the Vault JobProcessor, 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 7 SP1
- Microsoft Windows 10

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

- Vault Professional
- Vault Workgroup

**Autodesk DWGTrueView:** 2022 / 2021 / 2020 *(optional)*

- In order to create PDF or other formats out of AutoCAD DWG.
- Supported versions:


  | Vault Version | DWG TrueView 2020                          | DWG TrueView 2021                          | DWG TrueView 2022                          |
  | :------------ | :----------------------------------------- | :----------------------------------------- | :----------------------------------------- |
  | 2020          | <img src="img/tested.png" width="15px">    | <img src="img/supported.png" width="15px"> | <img src="img/supported.png" width="15px"> |
  | 2021          | <img src="img/supported.png" width="15px"> | <img src="img/tested.png" width="15px">    | <img src="img/supported.png" width="15px"> |
  | 2022          | <img src="img/supported.png" width="15px"> | <img src="img/supported.png" width="15px"> | <img src="img/tested.png" width="15px">    |

    <img src="img/supported.png" width="15px"> … Not tested but supported\
    <img src="img/tested.png" width="15px"> … Tested and supported

**Autodesk Inventor:** 2022 / 2021 / 2020 *(optional)*

- In order to create PDF or other formats out of Inventor DWG, IDW and the like.
- Supported versions:

  | Vault Version | Inventor 2020                              | Inventor 2021                              | Inventor 2022                              |
  | :------------ | :----------------------------------------- | :----------------------------------------- | :----------------------------------------- |
  | 2020          | <img src="img/tested.png" width="15px">    | <img src="img/supported.png" width="15px"> | <img src="img/supported.png" width="15px"> |
  | 2021          | <img src="img/supported.png" width="15px"> | <img src="img/tested.png" width="15px">    | <img src="img/supported.png" width="15px"> |
  | 2022          | <img src="img/supported.png" width="15px"> | <img src="img/supported.png" width="15px"> | <img src="img/tested.png" width="15px">    |

    <img src="img/supported.png" width="15px"> … Not tested but supported\
    <img src="img/tested.png" width="15px"> … Tested and supported
 

**Windows PowerShell:** [PowerShell 4.0](https://www.microsoft.com/de-de/download/details.aspx?id=40855) or higher

**coolOrange powerVault**: [powerVault](powervault:index) is installed automatically

```{admonition} Recommendation
:class: warning

We recommend to install the Vault JobProcessor and powerJobs Processor on a **dedicated workstation**.\
As CAD- and potentially even other [](/jobprocessor/applications) shall run on such machine, a dedicated Job Processor environment is more appropriate from a hardware prospective.\
Additional software licenses must activated on this environment, depending on the used [](/jobprocessor/applications).
```

## Setup

The powerJobs Processor 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.

## Windows permissions

In order to execute, edit settings and synchronize the jobs properly, the current windows user needs the following rights on:
| Path                                                                                                         | Required Rights                                                              |
| ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- |
| C:\\ProgramData\\coolOrange\\powerJobs\\Jobs\\                                                               | **List folder / read data**, **write data** and **Read extended attributes** |
| C:\\ProgramData\\Autodesk\\\[Vault Version\]\\Extensions\\powerJobs Processor\\PowerJobs Processor.vcet.config | **Write** |

## After the Setup

After installing powerJobs Processor in **silent mode,** [Inventor](/jobprocessor/applications) **must be started** once, to make sure there are no problems with its installations and it is [registered correctly with the operating system](https://knowledge.autodesk.com/support/inventor/troubleshooting/caas/sfdcarticles/sfdcarticles/Vault-Jobprocessor-with-Inventor-Server-Jobprocesser-does-not-process-jobs-and-shows-the-errror-message-Inventor-needs-to-be-re-registered.html).

## Install Locations

powerJobs Processor is installed in the following locations on your system:

- powerJobs Processor executable and all related files are placed in C:\\Program Files\\coolOrange\\powerJobs Processor
- powerShell modules and libraries are placed in C:\\Program Files\\coolOrange\\Modules\\powerJobs
- Vault Client- and Job Processor extensions are placed in C:\\ProgramData\\Autodesk\\\[Vault Version\]\\Extensions\\powerJobs Processor
- Job definition files (e.g. scripts and modules) are placed in C:\\ProgramData\\coolOrange\\powerJobs

Following shared libraries are installed in GAC:

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

Following shortcuts are added in the start menu:

- **powerJobs Processor** - Starts the JobProcessor with extended UI
- **powerJobs Processor Configuration** - Opens the location for the configuration files
- **powerJobs Processor ISE** - Opens the IDE and opens a sample job
- **powerJobs Processor Information** - Opens the About dialog with product related information
- **powerJobs Processor License Information** - Opens the [License Information dialog](licensing:license_information) to activate the product
- **powerJobs Processor Logs** - Opens the log file location

## Environment Variables

powerJobs Processor sets three environment variables when it's installed. They contain the paths to the **jobs** and **modules** folder and the **job handler extension's directory**

The three environment variables are:

- POWERJOBS_JOBSDIR
- POWERJOBS_MODULESDIR
- POWERJOBS_PROCESSORDIR

## Updates

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

## Uninstall

In case you want to remove powerJobs Processor from your computer you can:

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