~~Title: Knowledgebase: STROOT Variables~~
~~NOTOC~~

<html><font color=#990000 size="+2"><b>Knowledge Base: Windows Runtime</b></font></html>

\\

===STROOT Variables:  Secifying wrong values or omitting the STROOT variable can affect runtime start-up.===

\\

The ''STROOT'' system variable is used to specify the software install directory.  Relative location of binaries and platform archives are based on the location that ''STROOT'' points to.  On the Windows platform the installer will automatically create and populate the system variable.  On other platforms or non-installer distributions this variable must be set manually.

Windows users may check the variable by going to ''System>>Control Panel>>System>>Advanced system settings'' and clicking the  ''Environment Variables'' button or by opening a Windows Shell (DOS) window and setting the variable in the following way:

\\

<code>
  set %STROOT%=C:\StreamScape
  ..
  set
  ..
  STROOT=C:\StreamScape
</code>

\\

Note that Windows does not allow you to set a variable to automatically re-initialize by default via the command shell.  The best way to do this is to use the control panel UI and ensure that the variable is defined in the ''System Variables'' section.

\\

<WRAP round tip>
The //STROOT// variable is used by SLANG, Management Nodes, Task Nodes and the Application Workbench.  When not defined, unpredictable behavior may result. Management Nodes employ an internal Activator Process that is launched for the purposes of automated upgrades, log forwarding and launching of Task Nodes.  When the activator bootstraps child processes it uses the //STROOT// variable to determine where to obtain binaries and other artifcts.  Care should be taken to ensure that the variable points to the same version installation as the Management Node so that there are no version discrepancies or other surprises. 

The variable may be changed to point to a different location in order to use different runtime versions.  It should be noted that mixing versions of runtime and/or client libraries may have unpredictable results and should only be done in compliance with certified and supported platform versions.  Please consult build-specific  [[:release_notes|release nodes]] to verify library compatibility.
</WRAP>

\\ 

[[kb:win:start |{{:icons_large:bowlerhat-transp.png?48}}]] [[kb:win:start|Back]]