# OpenText HostExplorer ShopFloor - install scripts

These three files are git-tracked snapshots of what lives at runtime
in `/home/camp/pxe-images/main/dependencies/opentext/`. The full
runtime tree also contains the bundled installer binaries (~106 MB
total) which are intentionally NOT in git:

```
OpenTextHostExplorer15x64.msi      ~16 MB
OpenTextHostExplorer15x64.cab      ~86 MB
OpenTextHostExplorer15x64_ServicePack1.msp   ~4.4 MB
ShopFloorx64.mst                   ~20 KB
Profile/                           5 .hep connection profiles
Accessories/EB/                    6 .ebs/.ebx macros
HostExplorer/Keymap/               2 .kmv keymaps
HostExplorer/Menu/                 2 .hmv menu layouts
W10shortcuts/                      4 .lnk public-desktop shortcuts
```

The canonical source for everything (scripts AND binaries) is
`/home/camp/pxe-images/main/dependencies/opentext/`. The files in
this dir are mirrors that exist so changes to the install logic and
the version stamp end up in git history. When editing:

1. Edit `/home/camp/pxe-images/main/dependencies/opentext/Setup-OpenText.ps1`
   (or `.cmd` / `version.txt`)
2. Re-run `bash playbook/sync-preinstall.sh` to push the runtime tree
   to the live PXE server
3. `cp` the changed file(s) into `playbook/preinstall/opentext/` here
   so git picks up the change
4. Re-upload the changed file(s) to Azure Blob at
   `prod/main/dependencies/opentext/<filename>`

To bump OpenText version: edit `version.txt` only - the value flows
through to Setup-OpenText.ps1 (which reads it at runtime), to
Install-OpenText.ps1 (the DSC wrapper, which downloads version.txt
first as a cheap detection check), and to the registry marker at
`HKLM:\SOFTWARE\GE\OpenText\Installed`.