helpcenter/Web/Controls/Help/Server/Docker/DockerTroubleshooting/DockerTroubleshooting.ascx
alexandervnuchkov 71f171fb08 First commit
2016-08-29 16:51:20 +03:00

150 lines
9.4 KiB
Plaintext

<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
<script runat="server">
protected override void Init()
{
PageTitle = PageCaption = "Troubleshooting. Server Solution";
MetaKeyWords = "";
MetaDescription = "";
var guides = new GuidesModel();
guides.CaptionRelatedTips = "Related Tips & Tricks";
guides.Title = "Report Templates";
guides.RelatedTips = "Are you tired of generating reports manually? Now you can set up needed parameters once and regularly receive automatic reports by email.";
guides.LearnMore = "Learn more...";
(Page as BasePage).Guides = guides;
}
</script>
<div class="MainHelpCenter GettingStarted">
<ul class="TableOfContents">
<li><span class="gs_link gs_active" id="all">All</span></li>
<li><span class="gs_link" id="GeneralIssues">General issues</span></li>
<li><span class="gs_link" id="OneclickIssues">One Click Installation issues</span></li>
<li><span class="gs_link" id="DockerIssues">Docker issues</span></li>
<li><span class="gs_link" id="MonoIssues">Mono issues</span></li>
</ul>
<div class="keyword_block">
<ul>
<li>
<cc:LocalizeContent ID="LocalizeContent3" runat="Server" ControlName="~/Controls/Help/Tags/local-server/local-server.ascx" />
</li>
<li>
<cc:LocalizeContent ID="LocalizeContent4" runat="Server" ControlName="~/Controls/Help/Tags/server-version/server-version.ascx" />
</li>
<li>
<cc:LocalizeContent ID="LocalizeContent2" runat="Server" ControlName="~/Controls/Help/Tags/community-server/community-server.ascx" />
</li>
<li>
<cc:LocalizeContent ID="LocalizeContent6" runat="Server" ControlName="~/Controls/Help/Tags/document-server/document-server.ascx" />
</li>
<li>
<cc:LocalizeContent ID="LocalizeContent7" runat="Server" ControlName="~/Controls/Help/Tags/mail-server-server/mail-server-server.ascx" />
</li>
<li>
<cc:LocalizeContent ID="LocalizeContent10" runat="Server" ControlName="~/Controls/Help/Tags/docker-version/docker-version.ascx" />
</li>
</ul>
</div>
<div class="gs_content" id="GeneralIssues_block">
<h2>General issues</h2>
<div class="question_answer">
<p><span>Q:</span>I want to install the Docker-based server onto my local server. How can I do that?</p>
<p><span class="answer">A:</span>The latest Docker-based online office server is available at <a target="_blank" href="https://registry.hub.docker.com/u/onlyoffice/">Docker hub</a>. Please select which you would like to install: <a target="_blank" href="https://registry.hub.docker.com/u/onlyoffice/documentserver/">Document Server</a>, <a target="_blank" href="https://registry.hub.docker.com/u/onlyoffice/communityserver/">Community Server</a> or <a target="_blank" href="https://registry.hub.docker.com/u/onlyoffice/mailserver/">Mail Server</a> and follow the instructions on the appropriate page.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>What system do I need to have to install the server solution and successfully use it?</p>
<p><span class="answer">A:</span>The system requirements are:</p>
<ul>
<li>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/SystemRequirements/SysReqs_CPU/SysReqs_CPU.ascx" />
</li>
<li>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/SystemRequirements/SysReqs_RAM1/SysReqs_RAM1.ascx" />
</li>
<li>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/SystemRequirements/SysReqs_HDD/SysReqs_HDD.ascx" />
</li>
<li>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/SystemRequirements/SysReqs_Add_Hard/SysReqs_Add_Hard.ascx" />
</li>
<li>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/SystemRequirements/SysReqs_OS2/SysReqs_OS2.ascx" />
</li>
<li>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/SystemRequirements/SysReqs_Add_Soft5/SysReqs_Add_Soft5.ascx" />
</li>
</ul>
</div>
<div class="question_answer">
<p><span>Q:</span>I installed one of the servers using Docker service, but it lacks performance. I am sure that my computer meets all the requirements. What can be wrong?</p>
<p><span class="answer">A:</span>Docker specifies Google DNS servers by default and the server tries to contact them every time it makes some network requests. It stalls the performance due to the DNS server inaccessibility if no Internet connection is present. So if your <b>Community Server</b>, <b>Document Server</b> or <b>Mail Server</b> is not going to have access to the Internet, we recommend that you change the default Docker DNS address to the address of your local DNS server. To do that go to the <code>/etc/default/docker</code> file and change the IP address in the following line to the IP address of a DNS server in your local network:
<pre><code>docker_OPTS="--dns 8.8.8.8"
</code></pre>
</p>
</div>
<div class="question_answer">
<p><span>Q:</span>The document editors open and the interface appears, but the document itself does not load, continually showing loading progress. What can be done?</p>
<p>
<span class="answer">A:</span>The reason might be that the computer must be able to address itself using the Internet loopback access, i.e. it must be accessible from outside for itself. You can allow it to do that editing the <b>iptables</b> to have the redirects like this:
<pre><code>iptables -t nat -A PREROUTING -d &lt;public_ip&gt; -j DNAT --to-destination &lt;local_ip&gt;
iptables -t nat -A POSTROUTING -s &lt;local_ip&gt; -j SNAT --to-source &lt;piblic_ip&gt;
</code></pre>
Do not forget to substitute the <code>public_ip</code> and the <code>local_ip</code> addresses with the real IP addresses.
</p>
</div>
</div>
<div class="gs_content" id="OneclickIssues_block">
<h2>One Click Installation issues</h2>
<div class="question_answer">
<p><span>Q:</span>I have authentication problems and cannot connect to the server. What can be done?</p>
<p>
<span class="answer">A:</span>Check your server configuration. The reason might be that your Linux server have been configured to disallow SSH login via password. Open the <code>/etc/ssh/sshd_config</code> file using any available editor and look for the following line to find out what the configuration is set for authentication via password:
<pre><code>PasswordAuthentication no
</code></pre>
Change its value to <b>yes</b> and restart the SSHD service with the following command:
<pre><code>service sshd restart
</code></pre>
You will also need to change another line to be able to connect the server using the license key file:
<pre><code>PubkeyAuthentication no
</code></pre>
Change its value to <b>yes</b> and restart the SSHD service as shown above.
</p>
</div>
</div>
<div class="gs_content" id="DockerIssues_block">
<h2>Docker issues</h2>
<div class="question_answer">
<p><span>Q:</span>I rebooted the server without stopping the docker container with <b>docker stop id</b> command and now I have the <b>ERR_TOO_MANY_REDIRECTS</b> error for my server. What can be done to fix that?</p>
<p>
<span class="answer">A:</span>Please edit the <code>/var/www/onlyoffice/WebStudio/web.appsettings.config</code> file removing the very last line:
<pre><code>&lt;add key="web.warmup.type" value="basic" /&gt;
</code></pre>
and restart monoserve with the following command:
<pre><code>sudo service monoserve restart
</code></pre>
</p>
<p><span>Q:</span>I'm using Fedora Linux and processes fail to start inside Docker container. Is there a fix to the issue?</p>
<p><span class="answer">A:</span>Fedora and RHEL/CentOS users should try disabling SELinux with <b>setenforce 0</b> command. If it fixes the issue then you can either stick with SELinux disabled which is not recommended by RedHat, or switch to using Ubuntu.</p>
</div>
</div>
<div class="gs_content" id="MonoIssues_block">
<h2>Mono issues</h2>
<div class="question_answer">
<p><span>Q:</span>I cannot run Docker-based server as it crashes for my system. What can be wrong?</p>
<p><span class="answer">A:</span>Docker-based online office server installation requires the presence of mono (version <b>4.0.0</b> or later) that may cause problems for some Linux kernel versions. The full list of supported kernel versions is available <a target="_blank" href="http://onlyo.co/1PABPEI">here</a>).</p>
</div>
</div>
</div>