~~Title: Knowledge Base: Windows Runtime~~

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

This knowledgebase covers recurring issues on Windows platforms.  There are no product differences between various windows installations or versions so it is not expected that differences in behavior should occur between Windows Server or Workstation versions.  Microsoft Surface enabled devices likewise should continue to function the same way as standard desktop systems.

\\

====Installation and Setup Issues====


\\

<WRAP left round info 100%>
This section covers errors or issues that come up durring installation and setup of runtime and workbench on the Windows platform.
Windows installer makes the assumption that users have administrative privilidges to install software on their system and to write
to the application data, profile and global variables area.  Subsequent installation of the Workbench product (ie. for upgrades) will 
not over-write these areas, thereby allowing you to upgrade to future versions of the tools without loosing prior settings.
</WRAP>
<WRAP clear/>

^ Issue ^ Description           ^
| [[kb:win:stroot-vars | STROOT Variable]]   | Secifying wrong values or omitting the **STROOT** variable can affect runtime start-up.  |
| [[kb:win:sec-profile | Security Profiles]]  | Non-administrators have issues with installer. |
| [[kb:win:sec-profile | Installer Compatibility]]  | Installer halts with an error saying it can't run. |
| [[kb:win:sec-profile | Installer Hangs]]  | Installer hangs near completion. |
| [[kb:win:sec-profile | Workbench Resolution Issues]]  | Workbench starts with an extremley small-scale resolution. |


\\
{{gallery> kb:win:installerwindows7compatibility.png?509x400&859X667crop&lightbox}}

===Windows 8+ Installation Tips===

\\
Windows 8 and higher adds a number of features that handle graphics, application launch and application security much differently then ealier versions.  There are a number of small but annoying configuration tweaks that may need to happen depending on your windows version and how you set up security profiles on your machine. 

\\

===Installer Compatibility Mode===
\\

Windows executables that launch graphic programs depend on specific .Net framework versions and their graphic device interface (GDI) has changes over the years. Unfortunatley Windows installer frameworks (like those from Flexera that StreamScape uses) do not always use the latest versions of the .Net framework.  For this reason, you may see incompatibility errors when initally launching Application Workbench installer.

Not to worry, there is an easy solution. Before installation, right-click on the installer, select //Properties//, select the //Compatibility// tab, and check the Checkbox next to //Run this program in compatibility mode// and select //Windows 7//.  This will switch to the old mode, allowing the install to proceed.

\\

===High Resolution Monitors Make Applications Tiny and Unusable===
{{gallery> kb:win:installerhighdpiscaling.png?509x400&859X667crop&lightbox}}
\\
New versions of Windows introduced features for supporting High Resolution Monitors and Screens.  This allows applications that support high-resolution [[wp>Dots_per_inch | DPI]] graphics to be properly displayed by monitors and Graphics Cards.  Unfortunatley this feature has some unintended blow-back that causes  programs without high-resolution DPI support to dynamically convert to high-res and automatically re-size to much smaller windows, making the application unusable.  

Here is what happens. The user launches an application such as Workbench and Windows asks the application for its resolution settings.  If the application supports high resolution DPI it responds with correct dimensions.  However most legacy applications and tools are not written specifically for high resolution monitors and they respond with null values, causing Windows to make a best-guess estimate. Usually this ends badly and the user sees a default application with a tiny, unusable resolution.     

To solve this problem, right click on the application link or executable, select //Properties// and check the Checkbox next to //Override high DPI scaling behavior//.  In the Combo Box below it, select //System//.  This tells Windows to calculate application window size based on absolute screen size and not based on pixel count dictated by DPI auto-scaling. See the //example on the right// for how to set this option and //restart Workbench// if it is runnig while you make this change.

Note that this problem can occur in StreamScape Installer and in Application Workbench executables. Property Settings affect only the specific executable or Windows Application Link.  If you are re-installing the software or upgrading to a new version that overlays the old executable or re-creates the applicaiotn link, you will need to do this again to re-apply the changes.

By defalt, the TruView Application Workbench executable is located in the following directory path: **<%STROOT%>\<Version>\truview\bin**. For example a directory like //C:\StreamScape\TruView-3.6b103.003.52\truview\bin//.

<WRAP left round info 100%>
StreamScape's Application Workbench automatically versions the installs so by default a new version of the tool will install in a new sub-directory.  However, if you have a desk-top link that already has these settings enabled, it is suggested that you simplky re-associate the link with the new sub-directory, thereby preserving the settings.
</WRAP>
<WRAP clear/>


===Installer Seems to Hang Near Completion===

\\

Sometimes as the install nears completion you may see it hang.  If this happens, chances are that you have a confirmation dialog open somewhere behind one of your other windows. On machines with multiple monitors the acknowledgement dialogs will tend to open on the primary screen.  To solve this problem, locate the dialog box that may be opened.  Usually it is a prompt by installer to set the //STROOT// variable or overwrite files that already exist.  Find the open dialog and click //Yes to All//.  The installation will complete.

\\
{{gallery> kb:win:overwriteconfirmation.png?509x400&859X667crop&lightbox}}
{{gallery> kb:win:installerappearstohang.png?509x400&859X667crop&lightbox}}

