helpcenter/Web/Controls/Help/Server/Docker/DockerTroubleshooting/DockerTroubleshooting.ascx

113 lines
8.3 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="DockerIssues">Docker issues</span></li>
<li><span class="gs_link" id="DocumentServerIssues">Document Server usage issues</span></li>
</ul>
<div class="keyword_block">
<ul>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/local-server/local-server.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/server-version/server-version.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/community-server/community-server.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/document-server/document-server.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/mail-server-server/mail-server-server.ascx" /></li>
<li><cc:LocalizeContent 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://hub.docker.com/r/onlyoffice/">Docker hub</a>. Please select which you would like to install: <a target="_blank" href="https://hub.docker.com/r/onlyoffice/documentserver/">Document Server</a>, <a target="_blank" href="https://hub.docker.com/r/onlyoffice/communityserver/">Community Server</a> or <a target="_blank" href="https://hub.docker.com/r/onlyoffice/mailserver/">Mail Server</a> and follow the instructions on the appropriate page.</p>
</div>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/TroubleshootingQA/TroubleshootingQA.ascx" />
<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>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/TroubleshootingQA1/TroubleshootingQA1.ascx" />
</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="DocumentServerIssues_block">
<h2>Document Server usage issues</h2>
<div class="question_answer">
<p><span>Q:</span>Data loss has occured when stopping <b>Document Server</b>. How to prevent data loss?</p>
<p><span class="answer">A:</span>Due to the operational characteristic, <b>Document Server</b> saves a document only after the document has been closed by all the users who edited it. To avoid data loss, you must forcefully disconnect the <b>Document Server</b> users when you need to stop <b>Document Server</b> in cases of the application update, server reboot etc. To do that, execute the following script on the server where <b>Document Server</b> is installed:
<pre><code>sudo docker exec &lt;CONTAINER&gt; documentserver-prepare4shutdown.sh
</code></pre>
</p>
<div class="notehelp">Executing the script may take a long time (up to 5 minutes).</div>
<div class="notehelp">Disconnecting users may take a long time (up to 5 minutes).</div>
</div>
</div>
</div>