Troubleshooting

This section details some common problems when installing IFS Touch Apps Server and how to solve them.

Contents

 

 Missing SMO

If the installer shows this error, you are missing the prerequisite Web Deploy.

The installation is completed but the web site folder doesn't contain any files

In order to solve the problem with installation is completed but the web site folder doesn't contain any files, do the following.

Server Error in Application "IFS Touch Apps Server"

When navigating to the application (default http://localhost:8080/) you get:

HTTP Error 500.21 - Internal Server Error
Handler "PageHandlerFactory-Integrated-4.0" has a bad module "ManagedPipelineHandler" in its module list

To solve this, register .NET 4.0 ASP.NET.

%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -iru

Web Site works but apps can't connect

Ensure that you can reach the application service from your device. You can verify this in a browser. When you navigate to <Site URL>/Downlink.svc you should see a page like this:

If you can't reach the service, try to access the same URL from a browser on the TAS machine. If this works, the problem is most likely firewall/proxy related. However, if the problem remains when accessing the Downlink.svc URL locally on the TAS machine the problem could be related to Endpoint configuration in web.config. The Endpoints should match your IIS bindings.

If IIS has been configured for both HTTP and HTTPS, there should be two Endpoints in web.config as shown in the example below.

<services>
   <service name="Ifs.TouchApps.OnPremise.ServerRole.Downlink" behaviorConfiguration="downlinkBehaviour">
      <endpoint address="" binding="webHttpBinding" bindingConfiguration="WebHttpBinding_IDownlinkInterface" name="IFSCloudDownlink" contract="Ifs.Cloud.Downlink.Interface.ICloudServices" />
      <endpoint address="" binding="webHttpBinding" bindingConfiguration="WebHttpBinding_IDownlinkInterface_Transport" name="IFSCloudDownlink" contract="Ifs.Cloud.Downlink.Interface.ICloudServices" />
   </service>
</services>

If IIS has been configured for just HTTP, there should be a single Endpoint entry in web.config (the one with bindingConfiguration set to webHttpBinding_IDownlinkInterface).

Web Site not rendering properly

If you see the web site is not rendering properly and no styles in the pages after update to the latest release, then first try to refresh the page by pressing CTR+F5. This will allow browser to clean the local cache. If you still see the issues with styles/rendering of the web page (e.g. no styles and text only page), the most common issue would be conflicted MIME types.

Issue: IFS Touch App Server installer adds MIME types for certain files (.apk, .plist and .ipa) to the web site. If your IIS server already has the same file types in the global MIME list (IIS Web Server level), this will conflict with the Touch App Server MIME types. Because of this duplication, IIS will raise errors internally and the result will be empty stylesheets. This will cause your web page to appear as text only and affects functionality including app downloads.

Solution: To fix the issue, remove those duplicated MIME types from the IIS server (global level). After removing those duplicates, restart the IIS server and refresh your browser.

Client Affinity not working in a web farm

When using Application Request Routing (ARR) as a Load Balancer, Client Affinity will not work unless the machine name in the URL contains a '.'. Use the full machine name in the address.

Turn on Access Provider server trace

It can be useful to see the server trace from .net Access Provider to determine the cause of a certain error. Traces are logged to the TASTrace.log file. There are two properties in the web.config file that needs to be set in order to enable Access Provider server traces.

AccessProviderServerTrace - Setting this to "True" will enable Access Provider server trace. Default value is "False".

AccessProviderDebugUser - Traces will be logged only for the calls initiated by the user specified in this property.