Invantive Control for Excel is installed with a Windows Installer package. Failures fall into two groups: the installation itself does not complete, or it completes and the product then refuses to start. The second group is checked before the ribbon appears, so the messages come from the start-up checks rather than from the product proper.
Where the installation succeeded but the ribbon or the formulas are absent, the cause is another one; see [[The Add-in Does Not Load]].
## The Installer Does Not Complete
- `itgenmsi783`, or a wizard which reports that it "ended prematurely": the package could not be applied.
- "This installation package could not be opened": the download is incomplete or damaged.
- An installer which shows no window at all, or stops at "Preparing to install", is stuck on the Windows Installer database of the device rather than on the package.
Take the current release from the download site rather than reusing an older copy: several of these failures were defects in the packaging which were corrected by replacing the downloads, not by anything on the device. Restart the device before trying again, so that an installation of another program which is still pending can finish first. Where the installer is blocked by SmartScreen or by a download warning, "Keep" and "Run anyway" have to be answered, sometimes more than once; a download broken off halfway is a frequent cause of `itgendir105`.
## The Software Cannot Initialise
- `itgendir105`: an implementation such as `Invantive.Basics.IStateHelper` was not registered correctly. Files are missing or the installation is incomplete.
- `itgenaio002`: the application assembly has not been initialised.
- `itgenuty439` with `itgenutz183`: the software could not be initialised, because the utility base could not be instantiated.
All three point at the installation rather than at the workbook or the licence. Install the current release; each of them has been traced to a defect which a later release closed.
## The Start-up Checks Refuse
- `itgensuy026`: the disk holding one of the folders the product uses has too little free space. The limit is five gigabytes counted decimally, so 5,000,000,000 bytes and not five gibibytes. The message names both the folder and the space actually available.
- `itgensuy016`: URLs which the product needs cannot be resolved, naming the URL which failed. The check exists because a network which silently blocks these addresses otherwise produces failures much later and much harder to place. Ask whoever manages the network not to block the named address.
`itgensuy016` also appears on releases which are no longer supported, because the address it checks changed with the infrastructure. Upgrading is then the answer rather than a change to the network.
## After an Upgrade
An upgrade replaces both add-ins and re-registers the formulas, which is why problems surface at the first start of Microsoft Excel afterwards rather than during the installation. Close every Microsoft Excel window and end any remaining `EXCEL.EXE` from Task Manager before starting Excel again, so the new files are actually loaded.
Two rules keep the product supportable:
- Keep to a supported release. A considerable share of the failures reported here were corrected in a later release, and a release which is no longer supported is not corrected at all.
- Upgrade when the connected platform changes. Exact Online in particular has made changes which older releases do not follow; a release from before July 2023 does not work with One Exact Identity, for instance. See [[Log On Fails]].