Add docspace-nextcloud-migration.aspx article

Web/Controls/Help/Administration/Administration.ascx

@@ -443,6 +443,7 @@
                                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/administration/docspace-webhooks.aspx")%>">Using webhooks in DocSpace</a></li>
                                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/administration/docspace-workspace-migration.aspx")%>">Migrating ONLYOFFICE Workspace data to ONLYOFFICE DocSpace</a></li>
                                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/administration/docspace-google-migration.aspx")%>">Migrating Google Workspace data to ONLYOFFICE DocSpace</a></li>
+                                    <li><a href="<%=VirtualPathUtility.ToAbsolute("~/administration/docspace-nextcloud-migration.aspx")%>">Migrating Nextcloud data to ONLYOFFICE DocSpace</a></li>
                                 </ul>
             </div>
         </li>

Web/Controls/Help/Administration/ConfiguringDocSpace.ascx

@@ -72,6 +72,7 @@
                                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/administration/docspace-webhooks.aspx")%>">Using webhooks in DocSpace</a></li>
                                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/administration/docspace-workspace-migration.aspx")%>">Migrating ONLYOFFICE Workspace data to ONLYOFFICE DocSpace</a></li>
                                     <li><a href="<%=VirtualPathUtility.ToAbsolute("~/administration/docspace-google-migration.aspx")%>">Migrating Google Workspace data to ONLYOFFICE DocSpace</a></li>
+                                    <li><a href="<%=VirtualPathUtility.ToAbsolute("~/administration/docspace-nextcloud-migration.aspx")%>">Migrating Nextcloud data to ONLYOFFICE DocSpace</a></li>
                                 </ul>
                             </li>
                             

Web/Controls/Help/Guides/General/DocSpaceMigrationNextcloud/DocSpaceMigrationNextcloud.ascx

@@ -0,0 +1,161 @@
+<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
+<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
+
+<script runat="server">
+    protected override void Init()
+    {
+        PageTitle = PageCaption = "Migrating Nextcloud data to ONLYOFFICE DocSpace";
+        MetaKeyWords = "DocSpace settings, data import, migrate Nextcloud data";
+        MetaDescription = "Learn how to migrate the Nextcloud data to your DocSpace.";
+
+        var guides = new GuidesModel();        
+        (Page as BasePage).Guides = guides;
+	}
+</script>
+
+<div class="MainHelpCenter">     
+    <h1>Migrating Nextcloud data to ONLYOFFICE DocSpace</h1>
+    
+     <h2 id="_introduction">Introduction</h2>
+     <div class="block_of_step">
+         <p>In this article, we will show you how to transfer the <b>Nextcloud server</b> data to your <b>ONLYOFFICE DocSpace</b>.</p>
+         <p>Starting from <b>v 2.5</b>, <b>ONLYOFFICE DocSpace</b> supports exporting Nextcloud users, users’ files, sharing settings and groups.</p>
+      </div>
+
+    <h2 id="step1">Export data from Nextcloud</h2>
+    <h3 id="maintenance_mode">Enabling the maintenance mode</h3>
+    <div class="block_of_step">
+         <div class="screen_text">
+             <p>First, you need to enable the <b>maintenance mode</b> on your <b>Nextcloud server</b>. The <b>maintenance mode</b> stops the server and allows us to export data from the <b>Nextcloud installation</b> folder and <b>MySQL</b> database. To activate the maintenance mode:</p>
+             <ol>
+                 <li>Go to the folder with the <b>Nextcloud</b> installation.
+<pre><code>cd /var/www/html/nextcloud</code></pre>
+                 </li>
+                 <li>Run the occ file to enable the <b>maintenance mode</b>.
+<pre><code>sudo -u www-data php occ maintenance:mode --on</code></pre>
+                     <div class="notehelp">
+                         Depending on the operating system, the location of the Nextcloud installation folder might differ.
+                     </div>
+                 </li>
+			</ol>
+         </div>
+    </div>
+
+      <h3 id="export">Exporting the data folder</h3>
+    <div class="block_of_step">
+        <div class="screen_text">
+            <p>To successfully migrate your data to <b>ONLYOFFICE Workspace</b>, we need to include users' folders in our backup archive. They are located in the <b>data</b> folder within the <b>Nextcloud</b> directory.</p>
+            <p>To export the <b>data</b> folder run the following command:</p>
+<pre><code>sudo rsync -Aax /var/www/html/nextcloud/data [preferred location]/data/</code></pre>
+            <p>Where <b>[preferred location]</b> is a destination of the exported folder.</p>
+        </div>
+    </div>
+
+     <h3 id="database">Exporting the database</h3>
+    <div class="block_of_step">
+        <div class="screen_text">
+            <p>Also, we need to export the <b>MySQL</b> backup file. There are two possible ways of dumping the database.</p>
+            <p>In case the database is deployed on the same server, execute:</p>
+            <div class="screen_text">
+<pre><code>sudo mysqldump --lock-tables -u root -p nextcloud_db > [preferred location]/nextcloud-dirbkp_`date +"%Y%m%d"`/</code></pre>
+                <p>Where <b>[preferred location]</b> is a destination of the exported folder.</p>
+            </div>
+            <div class="screen_text">
+                <p>If the database is deployed on a different server, run the following command:</p>
+<pre><code>mysqldump --single-transaction -h [server] -u [username] -p[password] [db_name] > nextcloud-sqlbkp_`date +"%Y%m%d"`.bak</code></pre>
+            </div>
+        </div>
+	</div>
+
+      <h3 id="disable">Disabling the maintenance mode</h3>
+    <div class="block_of_step">
+        <div class="screen_text">
+            <p>After all the necessary folders and files have been exported, we can disable the <b>maintenance mode</b> and start the <b>Nextcloud server</b>.</p>
+            <p>To do that, go to the Nextcloud installation folder and  execute:</p>
+<pre><code>sudo -u www-data php occ maintenance:mode --off</code></pre>
+        </div>
+    </div>
+
+     <h2 id="step2">Prepare the data for import</h2>
+    <div class="block_of_step">
+        <div class="screen_text">
+            <p>In order to import the data, you need to compress certain files and folders to a zip archive. The <b>archive.zip</b> file contains the <b>data</b> folder which stores the folders of the <b>Nextcloud</b> users and the database <b>backup file</b>. The structure of the <b>archive.zip</b> file looks as follows:</p>
+<pre><code>-archive:
+    - data:
+        - user1
+        - user2
+        - user3
+    - MySQL backup file
+</code></pre>
+ 
+          <div class="notehelp">
+              We recommend storing only users' folders within the <b>data</b> directory. Storing the remaining files and folders within this directory might cause mistakes when importing the data.  
+		 </div>
+       </div>        
+	</div>
+
+       <h2 id="step_3">Import the data to ONLYOFFICE DocSpace</h2>
+      <div class="block_of_step">			
+			<div class="screen_text">
+				<ol>
+                    <li>Log in to your <b>ONLYOFFICE DocSpace</b>.</li>
+                    <li>Use the <img alt="Options icon" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/GettingStarted/dsoptionsicon.png")%>" /> menu in the lower left corner and select the <b>Settings</b> option.</li>
+                    <li>Choose the <b>Data import</b> section.</li>
+                    <li>Click the <b>Import</b> link next to the <b>Nextcloud</b> service.
+                        <div class="screenBlock"> 
+				            <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" target="image-4_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide218/step1-1.png")%>" />     
+				            <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" id="image-4_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide218/step1-1.png")%>" />
+			                <div target="image-4_eventcom_guides" class="screenphoto_magnifier"></div>
+			            </div>
+                    </li>
+                    <li>Click the folder icon next to the selection box and select the archives of the users.
+                    <p>Wait for the archive to load. When the loading is complete, click the <b>Next step</b> button.</p>
+                    <div class="screenBlock">
+                        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" target="image-5_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step1.png")%>" />     
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" id="image-5_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step1.png")%>" />
+			            <div target="image-5_eventcom_guides" class="screenphoto_magnifier"></div>
+                    </div>
+                    </li>
+                    <li>Select users from the list and click the <b>Next step</b> button. Only users with e-mails will be migrated first.                      
+                    <div class="screenBlock"> 
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" target="image-6_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step2.png")%>" />     
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" id="image-6_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step2.png")%>" />
+			            <div target="image-6_eventcom_guides" class="screenphoto_magnifier"></div>
+			        </div>                                    
+                    </li>
+                    <li>Now you can select not filled e-mail users and fill in their e-mail addresses. To do that, fill in the user's e-mail address. Click the <b>Tick</b> button next to the e-mail text box. Select several users from the list by ticking users' checkboxes. Proceed to the next step by clicking the <b>Next step</b> button.
+                      <div class="screenBlock"> 
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" target="image-7_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step3.png")%>" />     
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" id="image-7_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step3.png")%>" />
+			            <div target="image-7_eventcom_guides" class="screenphoto_magnifier"></div>
+			        </div>      
+                    </li>
+                    <li>Select user types (DocSpace roles: DocSpace admin, room admin, power user) and click the <b>Next step</b> button.                        
+                    <div class="screenBlock"> 
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" target="image-8_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step4.png")%>" />     
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" id="image-8_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step4.png")%>" />
+			            <div target="image-8_eventcom_guides" class="screenphoto_magnifier"></div>
+			        </div>                                    
+                    </li>
+                    <li>Select modules for import (users, groups, personal files, shared files, shared folders). Click the <b>Start data import</b> button to proceed with the final step.
+                        <div class="screenBlock"> 
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" target="image-9_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step5.png")%>" />     
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" id="image-9_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step5.png")%>" />
+			            <div target="image-9_eventcom_guides" class="screenphoto_magnifier"></div>
+			        </div>
+                    </li>
+                    <li>After the data is migrated, click the <b>Finish</b> button to complete the data import.
+                        <div class="screenBlock"> 
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" target="image-10_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step6.png")%>" />     
+				        <img alt="Migrating Nextcloud data to ONLYOFFICE DocSpace" id="image-10_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide220/step6.png")%>" />
+			            <div target="image-10_eventcom_guides" class="screenphoto_magnifier"></div>
+			        </div>
+                    </li>
+                </ol>
+            <p>Also, you can send a welcome letter to the new users. This letter will inform your users about migration to <b>ONLYOFFICE DocSpace</b>. It contains a brief description of the main features and a login link. To send the letter, check the <b>Send invite letter</b> option before clicking the Finish button.</p>
+            <p>After the migration is complete, the new users and groups can be found in the <b>Accounts</b> section.</p>
+            <p>Personal files and shared files can be accessed through the <b>Documents</b> section. Shared folders can be accessed through the <b>Rooms</b> sections.</p>
+		 </div>
+	 </div>
+      
+</div>

Web/administration/docspace-nextcloud-migration.aspx

@@ -0,0 +1,12 @@
+<%@ Page Title="" Language="C#" MasterPageFile="~/Masters/Administration/AdministrationArticles.master" %>
+<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
+
+<asp:Content ID="Content4" ContentPlaceHolderID="pagebodyidpage" runat="Server">
+    <body class="administration_guides_docspace">
+</asp:Content>
+<asp:Content ID="Content2" ContentPlaceHolderID="content" runat="Server">
+	<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Guides/General/DocSpaceMigrationNextcloud/DocSpaceMigrationNextcloud.ascx" />
+</asp:Content>
+<asp:Content ID="content1" ContentPlaceHolderID="leftmenupage" runat="server">
+	<div class="administrationdocspacepage general">
+</asp:Content>