helpcenter/Web/Controls/Help/Server/Linux/Document/ConnectDocumentServer/ConnectDocumentServer.ascx

<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>

<script runat="server">
    protected override void Init()
    {
        PageTitle = PageCaption = "Connecting Document Server to Community Server";
        MetaKeyWords = "";
        MetaDescription = "Learn how to connect Document Server to Community Server.";            
    }
</script>
<div class="main_buscall_container dataBackup">
    <div class="MainHelpCenter">
        <h1 class="subHeaderFeaturesCaption TipsCaption">Connecting Document Server to Community Server</h1>
        <cc:localizecontent runat="Server" controlname="~/Controls/Help/VariousControls/Versions/DocumentServer/DocumentServer_Current.ascx" />
        <cc:localizecontent runat="Server" controlname="~/Controls/Help/VariousControls/Versions/CommunityServer/CommunityServer_Current.ascx" />
        <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/linux-version/linux-version.ascx" /></li>
            </ul>
        </div>
        
        <p>If you want to connect <b>Document Server</b> to the <b>Community Server</b> portal installed on your local or remote server, you might need to alter configuration files both on the computer with <b>Community Server</b> and <b>Document Server</b> installed. So please first make sure you have administrator access to both machines.</p>
        <div class="notehelp"><b>Document Server</b> and <b>Community Server</b> must be installed on two different machines.</div>
        <cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/DocumentConnection/ExplainTheory/ExplainTheory.ascx" />
        <h2 id="ConnectDocServer81">Connecting Document Server to Community Server</h2>
        <p>Normally to connect <b>Document Server</b> to <b>Community Server</b> version 8.1 and later you only need to set up connection parameters in portal settings. To do that please go to <b>Settings</b> and select <b>Integration</b> - <b>Document Service</b>. Then simply fill in all the fields with the appropriate <b>Document Server</b> service addresses.</p>
        <cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/DocumentConnection/ServerCompatibility/ServerCompatibility.ascx" />
        <h2 id="CSConfigFiles">Editing configuration files for Community Server</h2>
        <p>In case this does not work or you are using <b>Community Server</b> earlier than version 8.1 and you are sure that the <b>Community Server</b> version is compatible with the <b>Document Server</b> version you are trying to connect (please consult the table above to see if that is so), you will need to perform the actions below, editing the configuration files.</p>
        <p>First of all you need to alter the <b>web.appsettings.config</b> file which can be found in the <code>/var/www/onlyoffice/WebStudio/</code> folder of the <b>Community Server</b> computer. Open it with a text editor (e.g. <b>nano</b>):</p>
        <cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/CommandList/Linux/CommandsForPage/OpenCommunityServerConfigFile.ascx" />
        <p>And add the following lines (or change these lines accordingly, in case they are already present):</p>
<pre class="prettyprint source linenums"><code>&lt;add key="files.docservice.url.public" value="http://documentserver-publicaddress/" /&gt;
&lt;add key="files.docservice.url.internal" value="http://documentserver-localaddress/" /&gt;
&lt;add key="files.docservice.url.portal" value="http://communityserver/" /&gt;</code></pre>
        <p>Where <code>documentserver-publicaddress</code> is the address of the computer with <b>Document Server</b> available for public networks, <code>documentserver-localaddress</code> is the address of the computer with <b>Document Server</b> available for local network and <code>communityserver</code> is the address of the computer with <b>Community Server</b> installed.</p>
        <div class="notehelp">For <b>Community Server</b> version earlier than <b>9.6</b> you will need to edit the following lines:
<pre><code>&lt;add key="files.docservice.url.converter" value="http://documentserver/ConvertService.ashx" /&gt;
&lt;add key="files.docservice.url.api" value="http://documentserver/web-apps/apps/api/documents/api.js" /&gt;
&lt;add key="files.docservice.url.apinew" value="http://documentserver/web-apps/apps/api/documents/api.js" /&gt;
&lt;add key="files.docservice.url.preloader" value="http://documentserver/web-apps/apps/api/documents/cache-scripts.html" /&gt;
&lt;add key="files.docservice.url.storage" value="http://documentserver/FileUploader.ashx" /&gt;
&lt;add key="files.docservice.url.portal" value="http://communityserver/" /&gt;
&lt;add key="files.docservice.url.command" value="http://documentserver/coauthoring/CommandService.ashx" /&gt;</code></pre>
            <p>Where <code>documentserver</code> and <code>communityserver</code> are the addresses of the computers with <b>Document Server</b> and <b>Community Server</b> installed.</p>
        </div>
        <p>These lines must be inserted after the <code>&lt;add key="files.docservice.secret.header" value="" /&gt;</code> line.</p>
        <p>After that restart the monoserve service:</p>
        <cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/CommandList/Linux/CommandsForPage/RestartServices/RestartMonoserveService.ascx" />
        <p>You will also need to run the SQL script for proper work:</p>
        <cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/CommandList/Linux/CommandsForPage/ConnectToMySQL/ConnectToMySQL.ascx" />
        <p>Enter the password, after that you should see the SQL welcome promtp:</p>
<pre><code>mysql&gt;
</code></pre>
        <p>Which means that you successfully entered SQL database. Enter the command (not omitting the semicolon):</p>
        <cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/CommandList/Linux/CommandsForPage/SelectMySQLDatabase/SelectOnlyofficeDatabase.ascx" />
        <p>Now you can run the command:</p>
        <cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/CommandList/Linux/CommandsForPage/DeleteRowsFromMySQLTable/DeleteRowsFromMySQLTable.ascx" />
        <div class="notehelp">In case there are problems with documents, you can try to change the &lt;add key="web.client.cache.resetkey" value="3" /&gt; line of the <b>web.appsettings.config</b> file entering any other numerical value instead of <b>3</b>.</div>
    </div>
</div>