When something does not work
Find what you see in the tables. For problems with a model or with results, see section 11 of the user guide. If the problem stays, send the data of the last section to support.
No Probistica tab in Excel
Do these checks in this order:
- 64-bit Excel. Click File > Account > About Excel. The first line must show "64-bit". Probistica has no add-in for 32-bit Excel.
- The add-in list. Click File > Options > Add-ins. At "Manage", select Excel Add-ins and click Go. The list must show Probistica with a check mark. If it is not there, install again (see Install Probistica).
- Disabled items. Click File > Options > Add-ins. At "Manage", select Disabled Items and click Go. If Probistica is in the list, select it and click Enable. Then close and start Excel again.
- The download mark. Excel blocks an XLL file from the internet. Install with the setup program (see Install Probistica): it writes the add-in without the mark. Do not load the file from the ZIP by hand. If you loaded a file by hand before, clear its check box in the add-in list of step 2, close Excel, and run the setup.
- A policy for signed add-ins. If your organization requires signed add-ins (File > Options > Trust Center > Trust Center Settings > Add-ins), Excel loads Probistica only when the add-in is signed and your IT department trusts the certificate of its publisher. The file
manifest.txtof the package tells you whetherProbistica64.xllis signed (the linesignature: unsignedmeans that it is not). Ask your IT department. - A blocked setup. If Windows or a rule of your organization blocks the setup program, do not load the add-in by hand. Send the full text of the message to support, or ask your IT department. A manual load is only for IT staff and developers (INSTALL.md, "Other ways for IT staff and developers").
Messages of the setup program
The setup program shows these messages in its window and writes them to its log. A message that ends with "Nothing was changed." means that no file and no setting changed.
| Message | Do this |
|---|---|
| Close all Excel windows first (N Excel process(es) run). Nothing was changed. | Save your work and close each Excel window. Open the Task Manager and look for an Excel process without a window. On a server with several users, the Excel of another user also counts; ask your IT department. |
| This Excel is 32-bit (the Click-to-Run value Platform is x86). Probistica needs 64-bit Excel. Nothing was changed. | Probistica runs only in 64-bit Excel. Ask your IT department for 64-bit Office. Then install again. |
| Another Probistica64.xll is registered in Excel: ... Remove it first (in Excel: File > Options > Add-ins), then run the install again. Nothing was changed. | Excel loads a Probistica64.xll from another folder. In Excel, clear its check box in the Add-ins dialog. Close Excel and install again. |
A message that names atRISK64.xll and tells you to remove the old atRISK add-in first | atRISK is the old working name of this add-in. An early test build with that name is registered in Excel. If Settings > Apps > Installed apps shows "atRISK", uninstall it there. Otherwise, clear its check box in the Add-ins dialog of Excel. Close Excel and install again. |
| The old atRISK add-in is installed: ... Remove the old atRISK add-in first: ... Nothing was changed. | An early test build with the name atRISK is still installed, also when Excel does not load it. If Settings > Apps > Installed apps shows "atRISK", uninstall it there. Otherwise, delete the file that the message names. Then install again. |
| The add-in file does not exist: ... Nothing was changed. | Extract all files of the ZIP file into one folder. Start Probistica-setup.exe from that folder. |
| Excel's user add-ins folder does not exist: ... Nothing was changed. | This can occur for a new Windows user. Create the folder %APPDATA%\ in File Explorer. Then install again. |
| Excel's Options key does not exist: ... Start Excel once and close it, then run the install again. Nothing was changed. | (Setup only.) Start Excel once and close it. Then install again. |
| The add-in file is the installed copy itself: ... Nothing was changed. | (Setup only.) Start the setup from the release folder, not from the add-ins folder. |
| The copy ... exists already. Nothing was changed. | Wait one second and run again. The name of the copy holds the time. |
| The export of the Options key failed. Nothing was changed. | Make sure that your %TEMP% folder exists and that you can write to it. Then run again. |
| The log file cannot be written: ... | (Setup only.) Give a log file in a folder that you can write to. |
| The add-in is uninstalled, but the setup cannot delete the setup program in ... | (Setup only.) Close each window of the setup program. Then delete the folder %LOCALAPPDATA%\ yourself. |
| Use /install or /uninstall, not both. | Give only one of the two options. |
| Unknown option: ... | (Setup only.) Check the command line. The message shows the correct form. |
| Use /report alone, without /install or /uninstall. | (Setup only.) Give only one of the options /report, /install, and /uninstall. |
| The option ... is given twice. | (Setup only.) Give each option only once. |
| The option ... needs a value. | (Setup only.) Give the value after the option, for example /log "<file>". |
| The environment variable ... does not give a full path. Nothing was changed. | (Setup only.) Ask your IT department. The variables APPDATA, LOCALAPPDATA, and TEMP must be full paths. |
| The setup cannot read the current state: ... Nothing was changed. | (Setup only.) Run the setup again. If the message stays, send the log and the full text to support. |
| The setup cannot start the helper that deletes the installed setup program (...). Delete the folder ... yourself. | (Setup only.) The add-in is uninstalled. Delete the folder %LOCALAPPDATA%\ yourself. |
| The add-in is installed, but the setup cannot copy all the pages to ... Some pages are missing in Help. Run the install again. | (Setup only.) The add-in works, but Help can miss some pages. Close each program that shows a page of the folder docs. Then install again. |
| The add-in is installed, but the setup cannot replace the pages in ... Close each program that shows one of these pages, then run the install again. | (Setup only.) Close each program that shows a page of %LOCALAPPDATA%\. Then install again. |
| The setup cannot delete the pages in ... Close each program that shows one of these pages, then run the uninstall again. | (Setup only.) The add-in is uninstalled. The entry in Settings > Apps stays. Close each program that shows a page of %LOCALAPPDATA%\. Then uninstall again. |
| No user guide next to the add-in file: ... The setup copies no page, ... | (Setup only.) The install is complete, but Help shows no user guide. Extract all files of the ZIP file into one folder, with the folder docs next to Probistica64.xll. Then install again. |
| The docs folder of the install folder is a link to another folder: ... The setup does not change it. | (Setup only.) The setup does not write or delete through a link. Remove the link. Then install or uninstall again. |
| The setup failed: ... (or: The setup failed at this step: ...) | (Setup only.) Send the log and the full text of the message to support. |
Before each change, the setup program saves a copy of Excel's options key in %TEMP%\. The copy is a record of the add-in list before the change. Keep it for support. An import of the copy does not remove the values that the install added, so use the uninstall of Install Probistica to remove Probistica.
License messages
A refused run shows a message with the reason, for example "The run did not start. License: no license file was found." A run from VBA writes Refused|License: <reason> to the hidden name Probistica_LastRun. The License dialog shows the same reason for each license file. When no file is valid, the reason names the first file, for example "(L-000123.lic; 1 more file(s) are also not valid)".
| Reason after "License:" | Do this |
|---|---|
| no license file was found | Import your license file (see Your Probistica license). |
| the license file is too large; the license file is empty or too large; the license file cannot be read (...) | Save the file from the email again and import it again. |
| the license file is not valid JSON (...); the license file is not a JSON object; the license file format is not 1; the license file needs keyId, payload, and signature; the license file has a bad payload or signature encoding | The file is damaged. Save it from the email again. Do not open it in a program that can change it. |
| the license signature is not valid; the file was changed or damaged | The content of the file changed. Ask the seller for a new copy. |
| the license file is signed with a test key | This is a test license. Ask the seller for a product license. |
| the license file is signed with an unknown key (...) | This build does not know the key of the file. Ask the seller for a file for your version. |
| the license content is not valid (...) | Ask the seller for a new file. Send the reason. |
| the license is for the product ..., not ... | The file is for another product. Ask the seller for the correct file. |
| the license is valid from ... | The license starts on that date. If the date is wrong, check the clock of the computer. |
| the license is for a different computer (...; this computer is ...) | Send the machine ID of this computer to the seller and ask for a new file. |
| the license is for a different Windows user (...; this user is ...) | Send the user ID of this Windows user to the seller and ask for a new file. |
| the computer clock is before a time that Probistica already saw (...); correct the clock; if the clock is correct, contact support | Set the correct date and time on the computer. If the clock is already correct, send the full text to support. Support tells you how to reset the clock state. |
| the license expired on ... | Renew the license (see Your Probistica license). |
| the license expired on ...; runs stop on ... unless the license is renewed | This is the grace period. Runs still work. Renew the license before the second date. |
| this build (...) is newer than the maintenance end of the license (...) | Use a build from before the maintenance end, or renew the maintenance. |
| the license does not include the feature ... | Ask the seller for a license with this feature. A run from VBA needs the feature automation. |
| no single license includes all of ... | One license file must have all these features. Ask the seller for one file with all of them. |
| the license ... is revoked; contact support | The activation service ended this license, or this computer was deactivated. Contact support. |
| the license check failed (...) | Send the full text to support. |
Excel stays open or stops when it closes
Sometimes Excel does not end when you close it. An Excel process then stays in the Task Manager without a window. Sometimes Windows also reports that Excel stopped at the close. This is a known limit of this build. We saw it in Excel instances that test scripts start and stop, also when Probistica was not loaded. The measurement script had closed its workbook before Excel was stopped by force. This does not establish that every exit failure occurs after all workbooks close.
- Wait 30 seconds.
- If no Excel window is open, open the Task Manager. Click Details, select EXCEL.EXE, and click End task.
- Do not end an Excel that shows a window. You can lose work that you did not save.
- If Excel shows Document Recovery at the next start, open each file in the list. Keep the version that you want.
Scripts outside Excel. A script in PowerShell or Python can make Excel stop when it keeps an Excel object of a closed workbook. Release each Excel object before the script closes its workbook or quits Excel.
If Excel stops at the close more than once, send support the date and the time of each close.
What to send to support
Send these items to support@probistica.com:
- The product version of
Probistica64.xll(see Overview, "Find the version"). - The Excel version and its bitness: the first line of File > Account > About Excel.
- The Windows version: press Windows+R, type
winver, and press Enter. - The text of the License dialog. Click in the text, press Ctrl+A, then press Ctrl+C, and paste the text into your message.
- The steps that cause the problem, and the message that you see.
- For a problem with the setup, its log. Start the setup from a command prompt with
/log <file>to get one.
Do not send your workbook unless support asks for it.