helpcenter/Web/Controls/Help/Server/Windows/Community/Troubleshooting/Troubleshooting.ascx
alexandervnuchkov 1542b141e2 Refactoring
2017-07-20 18:16:25 +03:00

276 lines
24 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<%@ 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="InstallationIssues">Installation issues</span></li>
<li><span class="gs_link" id="ConfigurationIssues">Configuration issues</span></li>
<li><span class="gs_link" id="UsageIssues">Usage issues</span></li>
</ul>
<div class="keyword_block">
<ul>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/server-version/server-version.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/install-onlyoffice/install-onlyoffice.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/local-server/local-server.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/create-portal/create-portal.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/system-requirements/system-requirements.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/backup-data/backup-data.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/data-backup/data-backup.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/customize-portal/customize-portal.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/community-server/community-server.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 server solution onto my local server. Where can I download the latest version?</p>
<p><span class="answer">A:</span>The latest server solution is available at <a href="https://github.com/ONLYOFFICE/CommunityServer">Github</a> and <a href="http://sourceforge.net/projects/teamlab/files/ONLYOFFICE_CommunityServer/">SourceForge</a>.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I opened the server solution folder at SourceForge/Github and found several files/subfolders there. What is the difference between them?</p>
<p><span class="answer">A:</span>At SourceForge, you can find the <b>Community Server</b> installation file and source codes:</p>
<ul>
<li>The <b>ONLYOFFICE_CommunityServer_Win-install.(version_number).exe</b> installation file allows you to skip compilation stage and install <b>Community Server</b> onto your server. You just need to run the .exe file and the server solution will be installed. Please refer to our detailed <a href="<%=VirtualPathUtility.ToAbsolute("~/Guides/Install-Enterprise.aspx")%>">guide</a> to learn more on the installation process.</li>
<li>The <b><a href="http://sourceforge.net/projects/teamlab/files/ONLYOFFICE_CommunityServer/">sources</a></b> folder contains the <b>Community Server</b> source code that you need to compile. It can be customized and improved under the <a href="http://opensource.org/licenses/AGPL-3.0">GNU AGPL v.3 license</a>. Please refer to these <a class="links" href="<%=VirtualPathUtility.ToAbsolute("~/server/windows/community/compile-source-code.aspx")%>">instructions</a> to find out how to compile and deploy the server solution from source codes.</li>
</ul>
<%--<p>The Online Editors v2.5.7 installation file and source codes are available <a href="http://sourceforge.net/projects/teamlab/files/ONLYOFFICE_DocumentServer/v2.5/">here</a>.</p>
<ul>
<li><b>ONLYOFFICE-OnlineEditors-v2.5.7.exe</b> - the Online Editors v2.5.7 installation file. You can read our <a href="<%=VirtualPathUtility.ToAbsolute("~/guides/install-office-apps.aspx")%>">guide</a> to learn more on the installation process.</li>
<li><b>ONLYOFFICE-OnlineEditors.src.zip</b> - the Online Editors v2.5.7 source codes. You can read these <a href="https://help.onlyoffice.com/products/files/doceditor.aspx?fileid=3457567&doc=RjVTWndkNUxkTk1XRlBkVE9zemZQUT09PyIzNDU3NTY3Ig2#">instructions</a> on compiling Online Editors from source codes.</li>
</ul>--%>
<p>The <a href="https://github.com/ONLYOFFICE/CommunityServer"><b>CommunityServer</b></a> folder at Github contains the <b>Community Server</b> source codes.</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_RAM/SysReqs_RAM.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_OS1/SysReqs_OS1.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/SystemRequirements/SysReqs_Add_Soft1/SysReqs_Add_Soft1.ascx" /></li>
</ul>
</div>
<div class="question_answer">
<p><span>Q:</span>I have already installed the server solution onto my server, but I'm not sure what version I use. How can I check this?</p>
<p><span class="answer">A:</span>You can check the exact version number in the following way:</p>
<ol>
<li>open the <code>web.studio/web.appsettings.config</code> file</li>
<li>have a look at the &lt;add key=”web.install-url” value=”http://service.onlyoffice.com/install/email.ashx?v=77″ /&gt; parameter, namely what number goes after v=</li>
</ol>
</div>
</div>
<div class="gs_content" id="InstallationIssues_block">
<h2>Installation issues</h2>
<div class="question_answer">
<p><span>Q:</span>I need installation instructions. Where can I find them?</p>
<p><span class="answer">A:</span>The installation instructions can be found in the <a class="links" href="<%=VirtualPathUtility.ToAbsolute("~/server/windows/community/index.aspx")%>">Installing</a> section of our Help Center.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I'd like to install the server solution onto Windows Server 2012. Is it possible?</p>
<p><span class="answer">A:</span>Yes, you can install the server solution onto <b>Windows Server 2012</b>, but youll need to make some alterations in its settings to get the server solution run:</p>
<ol>
<li>go to <code>C:\Windows\System32\inetsrv\config\applicationHost.config</code></li>
<li>find the &lt;sectionGroup name=”system.webServer”&gt; section</li>
<li>change &lt;section name=”handlers” overrideModeDefault=”Deny” /&gt; to &lt;section name=”handlers” overrideModeDefault=”Allow” /&gt;</li>
<li>change &lt;section name=”modules” overrideModeDefault=”Deny” /&gt; to &lt;section name=”modules” overrideModeDefault=”Allow” /&gt;</li>
</ol>
</div>
<div class="question_answer">
<p><span>Q:</span>I use an older server solution. How can I migrate to the latest one?</p>
<p><span class="answer">A:</span>The detailed instructions on how to upgrade <b>Community Server</b> to the latest version can be found in this <a class="links" href="<%=VirtualPathUtility.ToAbsolute("~/server/windows/community/upgrade-server.aspx")%>">article</a>.</p>
<p><b>Please don't forget to backup your portal data before you start the migration process.</b></p>
</div>
<div class="question_answer">
<p><span>Q:</span>I get the following error: &quot;Server Error in / Application. Index was out of range. Must be non-negative and less than the size of the collection&quot;. How can I solve this problem?</p>
<p><span class="answer">A:</span>Please try to add symbols to the <code>core.machinekey</code> key in the <code>web.appsettings.config</code> file, so that it contains 8 or more symbols.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I get the following error: &quot;{SQL_ERROR}: {SQL_STATE: HY000} Specified key was too long; max key length is 1000 bytes&quot;. How can I solve this problem?</p>
<p><span class="answer">A:</span>We recommend that you install mysql-essential-5.1.58-win32 or you need to change the settings of your database server, so that it lets you use long keys.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I have just installed the server solution onto my computer, but I can't find its folders. Could you tell me where I can find them?</p>
<p><span class="answer">A:</span>By default, versions older than 7.5 are installed into the following directory: <b>C:\ProgramData\TeamLab</b>, version 7.5 is installed into the <b>C:\Program Files (x86)\TeamLab Server</b> directory, version 7.7 is installed into the <b>C:\Program Files\Ascensio System SIA\ONLYOFFICE</b> directory.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I have downloaded the source code. But I don't know how to start using it with Visual Studio 2010. What am I doing wrong?</p>
<p><span class="answer">A:</span>The server solution represents a number of small projects, not a single one that can be opened using Visual Studio. These projects are compiled using the following .bat file: <code>redistributable\asc\BuildAndDeploy.bat</code>. We use Visual Studio 2012.</p>
</div>
</div>
<div class="gs_content" id="ConfigurationIssues_block">
<h2>Configuration issues</h2>
<div class="question_answer">
<p><span>Q:</span>When I try to launch <b>Community Server</b> for the first time, the localhost is unavailable and the ONLYOFFICE website does not run returning the <b>The process cannot access the file because it's being used by another process. (Exception from HRESULT: 0x80070020)</b> error. How can this be fixed?</p>
<p><span class="answer">A:</span>The error can be fixed in two ways:
<ol>
<li>switch the ONLYOFFICE website to another port in Internet Information Services (IIS);</li>
<li>or remove all other websites (if you have any) in IIS from port 80.</li>
</ol>
<br />You can also try to disable Skype in case you have it running.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I want to switch my portal from HTTP to HTTPS. How can I do that?</p>
<p><span class="answer">A:</span>Place your certificate in PEM format on the computer where the server solution is installed. Specify the full path to this file using the slash (<b>/</b>) in the server solution <code>config.js</code> file. Then restart the <code>OnlyOfficeRouter</code> service.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I want to change the domain name of my portal. How do I do that?</p>
<p><span class="answer">A:</span>You can assign a domain name either in the <b>DNS Settings - Custom domain name</b> field on the <b>Settings - General</b> tab, or in the <code>mappeddomain</code> field of the <code>tenants_tenants</code> table.</p>
</div>
<div class="question_answer" id="SphinxIssue">
<p><span>Q:</span>I cannot use full text search with <b>Community Server</b>. How can set it up?</p>
<p><span class="answer">A:</span>To set up full text search in <b>Community Server</b> you will need to do the following:
<ol>
<li>Download <code>sphinx</code> version 2.2.10 from the <a target="_blank" href="http://sphinxsearch.com/downloads/sphinx-2.2.10-release-win32.zip/thankyou.html">official website</a></li>
<li>Unpack the downloaded archive file to some place, e.g. to <code>C:\Program Files\Sphinx-2.2.10</code></li>
<li>Add path to the <code>bin</code> Sphinx directory (e.g. <code>C:\Program Files\Sphinx-2.2.10\bin</code> to the <b>system</b> (<b>NOT</b> user) PATH environment variable.
<p>This is done the following way: go to the <b>Control Panel</b> -> <b>System</b> -> <b>Advanced system settings</b> - in the opened dialog window click the <b>Environment Variables...</b> button, there choose the <b>PATH</b> variable and click <b>Edit</b>. Select <b>New</b> in the opened window, enter the name for the new varialbe (e.g. <code>sphinx</code>), and browse for its path using the appropriate button. Then save the results.</p>
</li>
<li>Change the <b>OnlyofficeIndex</b> launch type from <code>disabled</code> to <code>automatic</code> and run it.
<p>Go to the <b>Control Panel</b> -> <b>Administrative Tools</b> -> <b>Services</b>, find the <b>OnlyofficeIndex</b> service, right-click it and select <b>Properties</b>. In the opened dialog window use the drop-down menu to select the <b>Automatic</b> startup type, click <b>OK</b> and start the service.</p>
</li>
</ol>
<br />Automatic installation is not supported for Windows due to licensing restrictions.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I have a problem with the email notifications being sent. I get messages with the server name where the server solution is being hosted (PC name) instead of my custom DNS name which I added. How to solve it?</p>
<p><span class="answer">A:</span>Please add the &lt;add key=”web.host” value=”&lt;YOUR_DOMAIN&gt;”/&gt; string into the <code>web.appsettings.config</code> file.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I added the domain to the web.appsettings.config file. It works if I run a website on port 80. How can I define that for a different port?</p>
<p><span class="answer">A:</span>You can add the following string within the <code>web.appsettings.config</code> file: &lt;add key=”web.host” value=”http://&lt;DOMAIN&gt;:&lt;PORT&gt;”/&gt;.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I've successfully configured and tested the SMTP settings, but email notification is not working. Why is it so?</p>
<p><span class="answer">A:</span>Obviously you have some problems with your network. Please try to check it. For this purpose please go to Start >> Run, enter the cmd command. Then enter ping notify.onlyoffice.com or ping mail.onlyoffice.org into the opened black window and press the Enter key. If after that your IP address isnt displayed, something is wrong with your network.</p>
</div>
<div class="question_answer">
<p><span>Q:</span><b>Talk</b> does not work. How can I solve this problem?</p>
<p><span class="answer">A:</span>Make sure that the <code>OnlyofficeJabber</code> service is running and added to the firewall and antivirus exceptions. Ports <b>5222</b> and <b>5280</b> must be opened.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>Mailbox cannot be connected to the <b>Mail</b> module or no mail is received to the connected mailbox. How can I solve this problem?</p>
<p><span class="answer">A:</span>Make sure that the <code>OnlyofficeMailAggregator</code> service is running and added to the firewall and antivirus exceptions. Also, make sure that the following ports are opened for the outgoing requests:
<ul>
<li><code>SMTP</code>: 25, 465</li>
<li><code>IMAP</code>: 143, 993</li>
<li><code>POP3</code>: 110, 995</li>
</ul>
</p>
</div>
<div class="question_answer">
<p><span>Q:</span>Notifications about the portal events are not received to the email address. How can I solve this problem?</p>
<p><span class="answer">A:</span>Make sure that the <code>OnlyofficeNotify</code> service is running and added to the firewall and antivirus exceptions. Make sure that the port <b>25</b> is opened for the outgoing requests.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>OnlyofficeAutoreplay Service does not work. How can I solve this problem?</p>
<p><span class="answer">A:</span>Make sure that the port <b>25</b> is opened for the incoming requests. Make also sure that you set your DNS <b>MX record</b> correctly.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>I want to update something in the code of the server solution to look like I want it to be. There should be a solution file to see a well arranged project. Where can I find that solution file?</p>
<p><span class="answer">A:</span>There is no solution file, but you can create it yourself and add the projects to it manually. Projects compilation order can be found here: <code>_ci\projects\build.proj</code>.</p>
</div>
</div>
<div class="gs_content" id="UsageIssues_block">
<h2>Usage issues</h2>
<div class="question_answer">
<p><span>Q:</span>I need to backup my portal data. How can I do that?</p>
<p><span class="answer">A:</span>You can create a database backup by means of MySQL. Or you can create a data backup manually by copying your data from the following directories:</p>
<table>
<tr><td>Data\Files\</td></tr>
<tr><td>Data\Mail\</td></tr>
<tr><td>web.studio\addons\mail\Data</td></tr>
<tr><td>web.studio\data\</td></tr>
<tr><td>web.studio\Products\Community\Modules\Blogs\Data\</td></tr>
<tr><td>web.studio\Products\Community\Modules\Bookmarking\Data\</td></tr>
<tr><td>web.studio\Products\Community\Modules\Forum\Data\</td></tr>
<tr><td>web.studio\Products\Community\Modules\News\Data\</td></tr>
<tr><td>web.studio\Products\Community\Modules\PhotoManager\Data\</td></tr>
<tr><td>web.studio\Products\Community\Modules\Wiki\Data\</td></tr>
<tr><td>web.studio\Products\CRM\Data\</td></tr>
<tr><td>web.studio\Products\Projects\Data\</td></tr>
</table>
<p></p>
</div>
<div class="question_answer">
<p><span>Q:</span>I tried to access the portal from my Android phone, but I failed. Why?</p>
<p><span class="answer">A:</span>The server solution doesnt have the mobile access, so you cant access your portal from Android phones and iOS devices that would be possible, if youd use the SaaS solution.</p>
</div>
<div class="question_answer">
<p><span>Q:</span>The Projects module is stuck at the loading icon after migrating from 6.0 to 6.5. How can I solve the problem?</p>
<p><span class="answer">A:</span>First of all try to clear your browser cache some Java scripts were updated in version 6.5 and if the scripts of the previous version were saved in cache, it may cause the problem.</p>
</div>
<%--<div class="question_answer">
<p><span>Q:</span>I want to view and edit the documents stored on my portal. How can I do that?</p>
<p><span class="answer">A:</span>Document/Spreadsheet/Pesentation Editor is not included into the server solution, that's why it's impossible to view and edit documents directly on your portal. To view or edit a document, you need to download it to your computer hard disk drive, view/edit it and upload back to your portal in case you made some changes in the file. As for the access rights management in the Documents module of the server solution, its present there but in some other form:</p>
<ul>
<li>If you are given the 'Read Only' access rights to a document, youll be able to download, view and even edit it on your computer, but you cant upload it to the portal overwriting the existing document. Youll have to save it with another name.</li>
<li>If you have the 'Full Access' rights to a file, youll be able to download, view, edit it on your computer and upload to your portal replacing the existing one.</li>
</ul>
<div class="notehelp">If you download more than one file from your portal, they will be packed into a ZIP archive.</div>
</div>
<div class="question_answer">
<p><span>Q:</span>I'd like to import documents from other sources into the Documents module. Is it possible?</p>
<p><span class="answer">A:</span>Using the SaaS version you can import your documents from various sources like Google Drive, Box, Zoho. This feature is disabled in the server solution, but you can activate it adding the corresponding registration keys (you can get from Google, Box, Zoho) into the <code>web.consumers.config</code> file:</p>
<table>
<tr><td>&lt;add name="googleConsumerKey" value="&lt;YOUR_KEY&gt;"/&gt;</td></tr>
<tr><td>&lt;add name="googleConsumerSecret" value="&lt;YOUR_KEY&gt;"/&gt;</td></tr>
<tr><td>&lt;add name="box.net" value="&lt;YOUR_KEY&gt;"/&gt;</td></tr>
<tr><td>&lt;add name="box.net.framehandler" value="http://&lt;YOUR_TEAMLAB_DOMAIN&gt;/import/boxframecallback.aspx"/&gt;</td></tr>
<tr><td>&lt;add name="zoho" value="&lt;YOUR_KEY&gt;"/&gt;</td></tr>
</table>
</div>
<div class="question_answer">
<p><span>Q:</span>I'd like to integrate my Dropbox account into ONLYOFFICE. Can I do that?</p>
<p><span class="answer">A:</span>Using the SaaS version you can synchronize your Dropbox account with ONLYOFFICE. This feature is disabled in the server solution, but you can activate it adding the corresponding registration keys (you can get them from Dropbox) into the <code>web.consumers.config</code> file:</p>
<table>
<tr><td>&lt;consumers&gt;</td></tr>
<tr><td>&lt;keys&gt;</td></tr>
<tr><td>&lt;clear/&gt;</td></tr>
<tr><td>&lt;add name="dropboxappkey" value="YOUR_KEY"/&gt;</td></tr>
<tr><td>&lt;add name="dropboxappsecret" value="YOUR_KEY"/&gt;</td></tr>
<tr><td>&lt;/keys&gt;</td></tr>
<tr><td>&lt;/consumers&gt;</td></tr>
</table>
<p>Then add the following string to the <code>web.appsettings.config</code> file:</p>
<table>
<tr><td>&lt;add key="files.thirdparty.enable" value="dropbox"/&gt;</td></tr>
</table>
<div class="notehelp">You can also integrate your Box, Google or SkyDrive account in the same way.</div>
</div>--%>
<div class="question_answer">
<p><span>Q:</span>While using the server solution, I faced a problem that is not mentioned here. What should I do?</p>
<p><span class="answer">A:</span>Feel free to visit our <a target="_blank" href="http://dev.onlyoffice.org/">forum for developers</a> to find answers to any questions you have. You can also describe your problem in <a href="https://github.com/ONLYOFFICE/CommunityServer/issues">Github Issues</a> section and the community members will try to help you out.</p>
</div>
</div>
</div>