Overview
Sometimes, while installing or upgrading FogBugz, you may receive the following error message:
[AS - Preflight] Paths are missing or misconfigured. Run DeveloperSetup to repair.
[psake] error: 2019-06-23 16:12:05:
~~~~~ [<<==>>] Exception: ScriptHalted
An unexpected exit code was received during your setup operation. Please inspect previous output for errors and contact
FogBugz support for assistance: https:// support.fogbugz.com
This article describes the root cause, troubleshooting steps, and the resolution for this error.
Environment
The resolution provided in this article applies to FogBugz On-Premises/On-Site products that are being installed on a Windows server.
Root Cause
The Java system variable JAVA_HOME
does not point to the correct location. Most of the time, the issue has to do with the PATH variable. If you clean it up and start fresh, the installer should pass that error.
JAVA_HOME
.
Troubleshooting Steps
To confirm that the error message mentioned above is related to Java, run the following test on the command prompt:
$pathsOK = (Test-Command java)
-and (Test-Command javac)
-and (Test-Command redis-cli)
-and (Test-Command Invoke-SqlCmd)
-and ($env:JAVA_HOME)
if (-not $pathsOK) { Write-LogWarn 'Paths are missing or misconfigured. Run DeveloperSetup to repair.' throw }
As long as Java and the Java compiler javac are on PATH, the installation should be fine. Thus, to resolve the error detailed above, add Java and javac to the PATH variable. For more details on configuring PATH
and JAVA_HOME
, refer to Installing the JDK Software and Setting JAVA_HOME.
If this is not the case and everything is fine with Java, then the issue might be related to redis-cli
or Invoke-SqlCmd
.
Resolution
In most cases, the solution is to uninstall all Java versions from the server and let the installer use its installer.
When Java has been upgraded to Java 8, make sure that JAVA_HOME
environment variable points to the correct location:
-
Navigate to Control Panel > System and Security > System.
-
Click Advanced system settings.
-
Click Environment Variables....
-
In System Variables:
-
If
JAVA_HOME
does not exist, click New. EnterJAVA_HOME
as the Variable name, the correct file path location in the Variable value field, and then click OK. -
If
JAVA_HOME
exists, select theJAVA_HOME
variable, click Edit, enter the correct file path location in the Variable value field, and then click OK.
-
Confirmation
Resume the installation process, and you should be able to proceed to the next step without errors.