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

100 lines
7.6 KiB
Plaintext

<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
<script runat="server">
protected override void Init()
{
PageTitle = PageCaption = "How to migrate your Community Server from Windows to Linux?";
MetaKeyWords = "";
MetaDescription = "Migrate your Community Server from Windows to Linux.";
var guides = new GuidesModel();
guides.CaptionRelatedTips = "Related Tips & Tricks";
guides.Title = "Installing Ascensio System Plug-in";
guides.TitleVideo = "How to become a ONLYOFFICE translator?";
guides.RelatedTips = "Would you like to create new documents, edit uploaded text files right on your portal? It's easy!";
guides.LearnMore = "Learn more...";
(Page as BasePage).Guides = guides;
}
</script>
<div class="MainHelpCenter">
<h1 class="subHeaderFeaturesCaption Guides_Video_Captions">How to migrate your Community Server from Windows to Linux?</h1>
<cc:localizecontent runat="Server" controlname="~/Controls/Help/VariousControls/Versions/CommunityServer/CommunityServer_8_1.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/windows-version/windows-version.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/linux-version/linux-version.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/migrate-server/migrate-server.ascx" /></li>
</ul>
</div>
<div class="video_ground video_trips">
<h2 id="introduction">Introduction</h2>
<div class="block_of_step">
<div class="screen_text">
<p>If you decide to migrate your <b>Community Server</b> from Windows to Linux server, you need to know that different portal versions might differ in database structure or folder names. So the successful migration can only be done for the same versions (e.g. from Windows <b>Community Server</b> 8.1 version to Linux <b>Community Server</b> 8.1 version, or from Windows <b>Community Server</b> 8.5 version to Linux <b>Community Server</b> 8.5 version).</p>
<p>Both <b>Community Server</b> for Windows and Linux distributives packages and the source code can be found here:
<br /><a target="_blank" href="http://sourceforge.net/projects/teamlab/files/ONLYOFFICE_CommunityServer/">http://sourceforge.net/projects/teamlab/files/ONLYOFFICE_CommunityServer/</a></p>
<p>The first published Linux version for <b>Community Server</b> was version 8.1, so in this guide we will consider it to be the first one that can be used for migration from Windows.</p>
</div>
</div>
</div>
<h2 id="Step1">Updating to the latest Windows version</h2>
<div class="block_of_step">
<div class="screen_text">
<p>First of all you will need to make sure that you have the latest Windows <b>Community Server</b> version installed. Check the <a target="_blank" href="http://sourceforge.net/projects/teamlab/files/ONLYOFFICE_CommunityServer/">SourceForge repository</a> to find out which Windows <b>Community Server</b> is available at the moment.</p>
<div class="notehelp">You might need to perform the step-by-step upgrade to each interim version first. Please refer to the <a href="<%=VirtualPathUtility.ToAbsolute("~/server/windows/community/upgrade-server.aspx")%>">How to upgrade your Community Server to the latest version?</a> guide to see how this can be done.</div>
</div>
</div>
<h2 id="Step2">Creating database backup</h2>
<div class="block_of_step">
<div class="screen_text">
<p>Once you have the latest version of <b>Community Server</b> for Windows installed you can proceed with data backup. To avoid the loss of data perform the backup of the following folders which contain the portal data:</p>
<ul>
<li><code>c:\Program Files\Ascensio System SIA\ONLYOFFICE\Data\</code> (or use the path where you have your Windows version installed)</li>
<li><code>c:\Program Files\Ascensio System SIA\ONLYOFFICE\WebStudio\</code> (or use the path where you have your Windows version installed)</li>
</ul>
<div class="notehelp">Please see your <code>web.storage.config</code> to find out which files are stored in the <code>c:\Program Files\Ascensio System SIA\ONLYOFFICE\WebStudio\</code> folder.</div>
<p>Create your MySQL database dump file using any available software you have for such purposes (we recommend using HeidiSQL, but you can use any available tools or applications for that).</p>
</div>
</div>
<h2 id="Step3">Installing the corresponding Linux version</h2>
<div class="block_of_step">
<div class="screen_text">
<p>Now that all the data is saved you need to install the <b>same</b> Linux <b>Community Server</b> version as the Windows <b>Community Server</b> version. Check the <a target="_blank" href="http://sourceforge.net/projects/teamlab/files/ONLYOFFICE_CommunityServer/">SourceForge repository</a> to find the right <b>Community Server</b> for Linux version.</p>
<p>Read the <a href="<%=VirtualPathUtility.ToAbsolute("~/server/linux/community/linux-installation.aspx")%>">Installing Community Server for Linux on a Local Server</a> guide for more details on how to install <b>Community Server</b> to your Linux machine and what the requirements are.</p>
</div>
</div>
<h2 id="Step4">Restoring the saved data to Community Server for Linux</h2>
<div class="block_of_step">
<div class="screen_text">
<p>First you will need to connect your SQL database to the portal.</p>
<p>Run the following command to do that changing the parameters in brackets for the actual data:</p>
<pre><code>mysql -u [uname] -p [pass] [db_to_restore] < [backupfile.sql]
</code></pre>
<p>After that copy the data from the <code>c:\Program Files\Ascensio System SIA\ONLYOFFICE\Data\</code> folder to the corresponding <code>/var/www/onlyoffice/Data</code> Linux folder. In case you want to transfer the configuration files completely from Windows to Linux, copy all the files you saved from the <code>c:\Program Files\Ascensio System SIA\ONLYOFFICE\WebStudio\</code> folder to the corresponding <code>/var/www/onlyoffice/WebStudio</code> folder, or choose which files need to be copied.</p>
</div>
</div>
<h2 id="Step5">Updating software version</h2>
<div class="block_of_step">
<div class="screen_text">
<p>Now you can run the portal and check the data for consistency and correct work. If everything is fine, update the Linux version of <b>Community Server</b> to the latest version. Read the <a href="<%=VirtualPathUtility.ToAbsolute("~/server/linux/community/upgrade-server.aspx")%>">How to upgrade your Community Server to the latest version?</a> guide to find out how to do that.</p>
</div>
</div>
</div>