smeedee.github.com/troubleshooting.html at master · Smeedee/smeedee.github.com · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Smeedee - A management tool for agile projects</title>
<link rel="stylesheet" type="text/css" href="css/styles.css" />
<link rel="stylesheet" href="css/noobslide.css" type="text/css" media="screen" />
<script type="text/javascript" src="js/mootools-1.2-core.js"></script>
<script type="text/javascript" src="js/noobslide.js"></script>


</head>

<body>
<div id="stripes"></div>
<div id="wrap">
    <div id="menu">
        <dl>

            <dt><a href="index.html">Home</a></dt>
            <dt><a href="download.html">Download</a></dt>
            <dt><a href="faq.html">FAQ</a></dt>
            <dt><a href="#">Documentation</a></dt>
            <dt><a href="#">Contact</a></dt>

        </dl>
        <div id="logo"></div>
    </div>


    <div id="illustration">


    </div>


    <div id="textbox">

        <div id="top">
            <b class="b5"></b>
            <b class="b4"></b>
            <b class="b3"></b>
            <b class="b2"></b>
            <b class="b1"></b>
        </div>
        <div id="bot">
            <b class="b1"></b>
            <b class="b2"></b>
            <b class="b3"></b>
            <b class="b4"></b>
            <b class="b5"></b>
        </div>


        <div id="textcontent">

            <div class="contentRight">

    <h1>Documentation</h1>
    <ul>
        <li><a href="faq.html">FAQ</a></li>
        <li><a href="troubleshooting.html">Troubleshooting</a></li>
    </ul>
    <h1>For contributors</h1>
    <ul>
        <li><a href="dev_getting_started.html">Getting started</a></li>
        <li><a href="dev_detailed_intro.html">Detailed introduction</a></li>
        <li><a href="dev_architecture_overview.html">Architecture overview</a></li>
    </ul>

            </div>
            <div class="contentLeft">


<h1 style="margin-right:255px;">Troubleshooting</h1>

<h2 style="margin-right:255px;">Out of browser experience</h2>
<h4>Some of my widgets are missing.</h4>
<p>
    We have experienced some issues with newer versions of Windows not properly
    resolving localhost to 127.0.0.1. If you experience issues where only some
    of your installed widgets are loading, usually a random set each time you
    run Smeedee - you should try reinstalling the out of browser version from the
    browser version displayed when you connect to the server using a
    specific IP instead of hostname. (E.g. 127.0.0.1 instead of localhost)
</p>
<p>
    Alternatively you can set your hosts file to staticaly resolve localohost
    to 127.0.0.1. You can do this by editing
    C:\Windows\system32\drivers\etc\hosts and adding a line "127.0.0.1
    localhost" to this file.
</p>

<h2>IIS Troubleshooting</h2>
<p>
    The server part of Smeedee is hosted by IIS, and if it is not correctly
    configured, Smeedee won't work. You may see symptoms like no Admin Tasks,
    never-ending loading of slideshow configuration or just no Smeedee at all! Here
    is a list of things you can check to verify your IIS configuration.
</p>

<h4>App Pool .NET version</h4>
<p>
    Make sure that the application pool that the smeedee application runs in is set to use .NET 4.0.
    <ol>
        <li>Open the IIS Management Console</li>
        <li>On the left hand side click Application Pools under the server node</li>
        <li>Find the Smeedee App Pool and click Basic Settings</li>
        <li>Confirm that the .NET Framework Version is set to 4.0</li>
        <img src="images/AppPoolDialog.png"/>
    </ol>
 </p>

<h4>ISAPI Filters for .NET 4.0</h4>
<p>
    Make sure that the ISAPI fileters for .NET 4.0 are added and enabled</p>
    <ol>
        <li>Open the IIS Management Console</li>
        <li>Select Default Web Site under the server node</li>
        <li>Double Click the icon with the name ISAPI FIlters. There should be two entries for .NET 4.0 like the image below
        <img src="images/ISAPI_FiltersDialog.png" />
        </li>
        <li>If you are missing the .NET 4.0 entries you need to add the file C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_filter.dll</li>
    </ol>
</p>


<h4>ISAPI & CGI Restrictions</h4>
<p>
    Make sure that ISAPI and CGI is enabled</p>
    <ol>
        <li>Open the IIS Management Console</li>
        <li>Select the server in the list on the left</li>
        <li>Double click the icon with the text ISAPI and CGI Restrictions</li>
        <li>Confirm that the .NET 4.0 ISAPI filters are set to "allowed"
        <img src="images/ISAPI_CGI_RestrictionsDialog.png" />
        </li>
    </ol>
</p>

            </div>
            <div class="break"></div>

        </div>
    </div>

    <div id="footer" style="color:#FFF" />

</div>

</body>
</html>