Utility 'emgr_update_get_ws_settings' failed.

Baseline Update fails. ERROR: Failed to get instance configuration from Web Studio

-----Problem-----
A Baseline Update fails with an error message similar to the following:

[07.21.09 10:20:35] SEVERE: Utility 'emgr_update_get_ws_settings' failed. Refer to utility logs in [ENDECA_CONF]/logs/shell on host ITLHost.
Occurred while executing line 10 of valid BeanShell script:
[[

7| if (Forge.isDataReady())
8| {
9| // get Web Studio config, merge with Dev Studio config
10| ConfigManager.downloadWsConfig();
11| ConfigManager.fetchMergedConfig();
12|
13| // clean directories

]]

[07.21.09 10:20:35] SEVERE: Caught an exception while invoking method 'run' on object 'BaselineUpdate'. Releasing locks.
Caused by java.lang.reflect.InvocationTargetException
sun.reflect.NativeMethodAccessorImpl invoke0 - null
Caused by com.endeca.soleng.eac.toolkit.exception.AppControlException
com.endeca.soleng.eac.toolkit.script.Script runBeanShellScript - Error executing valid BeanShell script.
Caused by com.endeca.soleng.eac.toolkit.exception.EacComponentControlException
com.endeca.soleng.eac.toolkit.utility.Utility run - Utility 'emgr_update_get_ws_settings' failed. Refer to utility logs in [ENDECA_CONF]/logs/shell on host ITLHost.




The [project-prefix].emgr_update_get_ws_settings.log file in [ENDECA_CONF]/logs/shell (as indicated by the error message above) contains the following:
"ERROR: Failed to get instance configuration from Web Studio."


-----Cause-----
This error could happen if the ConfigManager component cannot access Web Studio.
The ConfigManager uses the "webStudioHost" and "webStudioPort" entries to retrieve the configuration files from Web Studio. If these entries are incorrect, the error message above will occur.




-----Solution-----
Ensure that the "webStudioHost" and "webStudioPort" properties for the "ConfigManager" component in the AppConfig.xml configuration file are correct.

The syntax for these properties is as follows:
<custom-component id="ConfigManager" host-id="ITLHost" class="com.endeca.soleng.eac.toolkit.component.ConfigManagerComponent">
<properties>
<property name="webStudioHost" value="[my-web-studio-host-here]" />
<property name="webStudioPort" value="[web-studio-port-here]" />
[...]

</properties>

[...]

</custom-component>

Utility 'emgr_update_get_ws_settings' failed

-----Problem----- 
The baseline update fails with the following error message:
[DATE TIME] INFO: [ITLHost] Starting shell utility 'emgr_update_get_ws_settings'.
[DATE TIME] SEVERE: Utility 'emgr_update_get_ws_settings' failed. Refer to utility logs in [ENDECA_CONF]/logs/shell on host ITLHost.
Occurred while executing line 10 of valid BeanShell script:
[[
7| if (Forge.isDataReady())
8| {
9| // get Web Studio config, merge with Dev Studio config
10| ConfigManager.downloadWsConfig();
11| ConfigManager.fetchMergedConfig();
12|
13| // clean directories
]]



Also, the 'emgr_update_get_ws_settings' file in [ENDECA_CONF]/logs/shell has the following error message:

ERROR: Directory [project-directory-here]\config\script\..\..\.\data\web_studio\config does not exist.


-----Cause-----
The .\data\web_studio\config folder is a temporary working directory used by the Deployment Template during the baseline update, in this case by the ConfigManager.downloadWsConfig().
If this directory is missing it will cause the error message above.


-----Solution-----
Recreate the missing .\data\web_studio\config folder and ensure that the Endeca user running the HTTP service has read and write permissions to this folder.