# PortabilityMGT 1.3.0 — Installation Instructions

## Packages in this release

| Package | Audience | Installs to |
|---|---|---|
| `PortabilityMGT_v1.3_Setup.msi` | Administrators — full profile-share management | `C:\Program Files\Liquidware\PortabilityMGT` |
| `PortabilityMGT-Tech_v1.3_Setup.msi` | Help-desk technicians — scoped to one profile/environment | `C:\Program Files\Liquidware\PortabilityMGT-Tech` |

Both packages are per-machine MSIs, can be installed side by side, create Start Menu
and Desktop shortcuts under **Liquidware**, and register for clean uninstall in
Windows Settings. Installing a newer version automatically upgrades an existing
install. Distribute only the Technician package to help-desk staff.

## Requirements

- Windows 10/11 or Windows Server 2016+ (x64). No .NET runtime needed — the
  applications are self-contained.
- **Administrator rights are required to run the application** (enforced by the app
  manifest). The `takeown`/`icacls`-based force-delete needs elevation.
- Network access to the Portability profile share(s).
- *Optional:* **7-Zip** (`7z.exe`) enables editing of `.7z` archives in the archive
  viewer (rename / remove / edit-and-save entries). The app finds it automatically in
  `C:\Program Files\7-Zip`, next to the application EXE, or on PATH. Without it,
  `.7z` archives open read-only; `.louzip` and `.lou` editing works regardless.

## Install

Interactive:

```
msiexec /i PortabilityMGT_v1.3_Setup.msi
msiexec /i PortabilityMGT-Tech_v1.3_Setup.msi
```

Silent (for software distribution):

```
msiexec /i PortabilityMGT_v1.3_Setup.msi /qn
msiexec /i PortabilityMGT-Tech_v1.3_Setup.msi /qn
```

Uninstall via Windows Settings → Apps, or:

```
msiexec /x PortabilityMGT_v1.3_Setup.msi /qn
msiexec /x PortabilityMGT-Tech_v1.3_Setup.msi /qn
```

## Configure the Technician Edition (admins)

The technician picker offers a fixed list of environments. To define your own:

1. Open `C:\Program Files\Liquidware\PortabilityMGT-Tech` as administrator.
2. Copy `environments.sample.txt` to `environments.txt`.
3. Edit `environments.txt` — one environment per line:

   ```
   # Lines starting with # or ; are comments
   Dev=\\DMN1.FMR.com\FIDFile\FS1105\profiles
   QA=\\DMN1.FMR.com\FIDFile\FS3427\profiles
   Prod=\\DMN1.FMR.com\FIDFile\FS3425\profiles
   ```

Any number of environments and any names are allowed; the dialog adapts. If
`environments.txt` is missing or contains no valid entries, built-in defaults are
used. Because the file lives under Program Files, only administrators can change it,
and your edited `environments.txt` is preserved across upgrades and uninstalls
(only the `.sample` file is managed by the installer).

### Technician workflow

1. Launch **PortabilityMGT Technician**.
2. Select the environment and enter the **username** of the profile to manage, then
   click **Open Profile**. The tool is now confined to that user's profile folder.
3. Leave the username empty to open the whole environment share instead (for cases
   where the profile name must be looked up first).
4. Use the **🌐 Environment** toolbar button to switch environment or user at any
   time without restarting.

## Verifying the installed version

Right-click the EXE → Properties → Details: file version **1.3.0.0** for both
editions, or check the MSI entry in Windows Settings → Apps ("PortabilityMGT" /
"PortabilityMGT Technician", version 1.3.0.0).
