helpcenter/Web/Controls/Help/Server/DocsEnterprise/windows/InstallEnterpriseEdition/InstallEnterpriseEdition.ascx

257 lines
19 KiB
Plaintext

<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
<script runat="server">
protected override void Init()
{
PageTitle = PageCaption = "Installing ONLYOFFICE Docs for Windows on a local server";
MetaKeyWords = "";
MetaDescription = "";
}
</script>
<div class="MainHelpCenter">
<h1 class="subHeaderFeaturesCaption Guides_Video_Captions">Installing ONLYOFFICE Docs <%= ((BasePage)Page).EditionVersion %> for Windows on a local server</h1>
<cc:localizecontent runat="Server" controlname="~/Controls/Help/VariousControls/Versions/DocumentServer/DocumentServerWindows_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/install-ONLYOFFICE/install-ONLYOFFICE.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/document-server/document-server.ascx" /></li>
<li class="enterprise_display">
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/docs-enterprise/docs-enterprise.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/windows-version/windows-version.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><b><%= ((BasePage)Page).EditionVersion %></b> allows you to install <b>ONLYOFFICE Docs</b> on your local server and integrate online editors with <span class="developer_display">your web application</span><span class="community_enterprise_display"><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/groups-index.aspx")%>">ONLYOFFICE collaboration platform</a> or <a href="<%=VirtualPathUtility.ToAbsolute("~/integration.aspx")%>">other popular systems</a></span>.</p>
<p><b>ONLYOFFICE Docs</b> is an online office suite comprising viewers and editors for texts, spreadsheets and presentations, fully compatible with Office Open XML formats: .docx, .xlsx, .pptx and enabling collaborative editing in real time.</p>
<p><b>Functionality</b></p>
<ul>
<li>Document Editor</li>
<li>Spreadsheet Editor</li>
<li>Presentation Editor</li>
<li>Mobile web viewers</li>
<li class="developer_enterprise_display">Mobile web editors</li>
<li>Collaborative editing</li>
<li>Hieroglyph support</li>
<li>Support for all the popular formats: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML</li>
</ul>
<div class="developer_enterprise_display">
<p><b>Pro features</b></p>
<ul>
<li>Document comparison</li>
<li>Content Controls insertion</li>
<li>Sheet Views</li>
</ul>
</div>
<p>See the <a target="_blank" href="https://github.com/ONLYOFFICE/DocumentServer#onlyoffice-document-server-editions">detailed list of features</a> available for <b>ONLYOFFICE Docs</b> <b><%= ((BasePage)Page).EditionVersion %></b>.</p>
<div class="community_enterprise_display">
<p>Integrating it with <b>ONLYOFFICE Groups</b> you will be able to:</p>
<ul>
<li>share files;</li>
<li>manage access rights to documents;</li>
<li>embed documents on a website;</li>
<li>view and edit files stored on Drive, Box, Dropbox, OneDrive, OwnCloud connected to ONLYOFFICE.</li>
</ul>
<div>
<div class="notehelp">If you want to use <b>ONLYOFFICE Docs</b> together with <b>ONLYOFFICE Groups</b>, they must be installed on two different machines.</div>
</div>
</div>
<p>This guide will show you how to install <b>ONLYOFFICE Docs <%= ((BasePage)Page).EditionVersion %></b> Windows version to your machine.</p>
</div>
</div>
</div>
<h2 id="SystemRequirements">System requirements</h2>
<div class="block_of_step">
<div class="screen_text">
<ul>
<li>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/SystemRequirements/SysReqs_OS5/SysReqs_OS5.ascx" />
</li>
<li>
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Common/SystemRequirements/SysReqs_Add_Soft10/SysReqs_Add_Soft10.ascx" />
</li>
</ul>
</div>
</div>
<h2 id="InstallingPrerequisites">Installing prerequisites</h2>
<div class="block_of_step">
<div class="screen_text">
<p>Download and install the following components:</p>
<ul>
<li><a target="_blank" href="https://erlang.org/download/otp_win64_19.1.exe">Erlang</a></li>
<li><a target="_blank" href="https://github.com/rabbitmq/rabbitmq-server/releases/download/rabbitmq_v3_5_4/rabbitmq-server-3.5.4.exe">RabbitMQ</a></li>
<li class="developer_enterprise_display"><a target="_blank" href="https://github.com/tporadowski/redis/releases/download/v5.0.9/Redis-x64-5.0.9.msi">Redis</a></li>
<li><a target="_blank" href="https://get.enterprisedb.com/postgresql/postgresql-9.6.0-1-windows-x64.exe">PostgreSQL</a></li>
</ul>
</div>
</div>
<h2 id="CreatingDatabase">Creating a database</h2>
<div class="block_of_step">
<div class="screen_text">
<p>You can create a database using the <b>pgAdmin</b> tool or <b>Command Prompt</b>.</p>
<div class="notehelp nh_notice">The created database must have <b>onlyoffice</b> both for user and password.</div>
<p><b>Method 1</b></p>
<ol>
<li>
Run the <code>"%ProgramFiles%\PostgreSQL\9.6\pgAdmin 4\bin\pgAdmin4.exe"</code> executable file.
</li>
<li>
In the <b>pgAdmin</b> window, connect to the <b>PostgreSQL server</b> and create a new login role named <code>onlyoffice</code> with the <code>onlyoffice</code> password. To do that perform the following steps:
<ol>
<li>Right-click on the <b>Login/Group Roles</b> item in the left-side menu and select <b>Create</b> -> <b>Login/Group Role</b>.</li>
<li>In a new window that opens enter <code>onlyoffice</code> in the <b>Name</b> field.
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img9_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step10.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img9_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step10.png")%>" />
<div target="img9_eventcom_guides" class="screenphoto magnifier"></div>
</div>
</li>
<li>Switch to the <b>Definition</b> tab and enter <code>onlyoffice</code> in the <b>Password</b> field.</li>
<li>Go to the <b>Privileges</b> tab and click on the <b>Can login?</b> switcher to set the <b>Yes</b> value.
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img12_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step10-2.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img12_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step10-2.png")%>" />
<div target="img12_eventcom_guides" class="screenphoto magnifier"></div>
</div>
</li>
<li>Click the <b>Save</b> button.</li>
</ol>
</li>
<li>
Create the <code>onlyoffice</code> database, choosing the created login role <code>onlyoffice</code> as an owner.
<p>To do that, right-click on the <b>Databases</b> item in the left-side menu, select <b>Create</b> -> <b>Database...</b>. In a new window that opens enter <code>onlyoffice</code> in the <b>Database</b> field and select the <code>onlyoffice</code> role in the <b>Owner</b> list, then click <b>Save</b>.</p>
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img10_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step11.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img10_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step11.png")%>" />
<div target="img10_eventcom_guides" class="screenphoto magnifier"></div>
</div>
</li>
</ol>
<p><b>Method 2</b></p>
<p>Run the <b>Command Prompt</b> (press the <code>win+r</code> key combination, type in <code>cmd</code> and press <b>Enter</b>).</p>
<p>Consistently execute the following commands:</p>
<pre><code>cd /D "%ProgramFiles%\PostgreSQL\9.6\bin"
psql -U postgres -c "CREATE DATABASE onlyoffice;"
psql -U postgres -c "CREATE USER onlyoffice WITH password 'onlyoffice';"
psql -U postgres -c "GRANT ALL privileges ON DATABASE onlyoffice TO onlyoffice;"
</code></pre>
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img11_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step12.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img11_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step12.png")%>" />
<div target="img11_eventcom_guides" class="screenphoto magnifier"></div>
</div>
</div>
</div>
<h2 id="InstallingDocumentServer">Installing ONLYOFFICE Docs</h2>
<div class="block_of_step">
<div class="screen_text">
<p>As soon as all the components are installed and the database is created, you can proceed to the main program installation. Download the <a target="_blank" href="<%= ((BasePage)Page).VersionName %>"><%= ((BasePage)Page).EditionVersion %> installation file</a> in the <b>ONLYOFFICE Docs</b> section.</p>
<p>Double-click the <b>onlyoffice-documentserver<%= ((BasePage)Page).CommandName %>.exe</b> file you have just downloaded.</p>
<div class="notehelp">
By default <b>ONLYOFFICE Docs</b> listens to the incoming connections using port <b>80</b>. Starting with version <b>4.3</b> you can change the port for <b>ONLYOFFICE Docs</b> if you plan to use it instead of the default one. To do that run the executable file with the parameter:
<pre><code>onlyoffice-documentserver<%= ((BasePage)Page).CommandName %>.exe /DS_PORT=&lt;PORT_NUMBER&gt;</code></pre>
Where <code>&lt;PORT_NUMBER&gt;</code> is the number of port you want <b>ONLYOFFICE Docs</b> to use.
</div>
<p>The <b>DocumentServer Setup Wizard</b> will be launched. Click the <b>Next ></b> button to start the installation process.</p>
</div>
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img2_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step1.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img2_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step1.png")%>" />
<div target="img2_eventcom_guides" class="screenphoto magnifier"></div>
</div>
<div class="screen_text">
<p>By default, <b>ONLYOFFICE Docs</b> will be installed to the following folder: <code>C:\Program Files\ONLYOFFICE\DocumentServer\</code>. If necessary, you can change it clicking the <b>Browse</b> button and selecting the necessary folder on your computer. Then click the <b>Next ></b> button.</p>
</div>
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img3_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step2.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img3_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step2.png")%>" />
<div target="img3_eventcom_guides" class="screenphoto magnifier"></div>
</div>
<div class="screen_text">
<p>If some additional components necessary for the <b>ONLYOFFICE Docs</b> proper work are missing on your PC, these dependencies will be downloaded and installed first. Click the <b>Install</b> button and wait while the missing components are being installed. If the required components are already installed on your PC, the <b>ONLYOFFICE Docs</b> installation will start.</p>
</div>
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img4_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step3.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img4_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step3.png")%>" />
<div target="img4_eventcom_guides" class="screenphoto magnifier"></div>
</div>
<div class="screen_text">
<p>In the <b>Configuring PostgreSQL connection</b> dialog window, specify the following parameters:</p>
<ul>
<li><b>Host</b>: localhost</li>
<li><b>User</b>: onlyoffice</li>
<li><b>Password</b>: onlyoffice</li>
<li><b>Database</b>: onlyoffice</li>
</ul>
</div>
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img5_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step5.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img5_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step5.png")%>" />
<div target="img5_eventcom_guides" class="screenphoto magnifier"></div>
</div>
<div class="screen_text">
<p>In the <b>Configuring RabbitMQ connection</b> dialog window, specify the following parameters:</p>
<ul>
<li><b>Host</b>: localhost</li>
<li><b>User</b>: guest</li>
<li><b>Password</b>: guest</li>
</ul>
</div>
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img6_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step6.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img6_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step6.png")%>" />
<div target="img6_eventcom_guides" class="screenphoto magnifier"></div>
</div>
<div class="developer_enterprise_display">
<div class="screen_text">
<p>In the <b>Configuring Redis connection</b> dialog window, specify the following parameters:</p>
<ul>
<li><b>Host</b>: localhost</li>
</ul>
</div>
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img7_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step7.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img7_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step7.png")%>" />
<div target="img7_eventcom_guides" class="screenphoto magnifier"></div>
</div>
</div>
<div class="screen_text">
<p>Once the installation process is completed, click the <b>Finish</b> button to close the wizard window.</p>
</div>
<div class="screen_block">
<img alt="Installing ONLYOFFICE Docs" target="img8_eventcom_guides" class="screenphoto screen_guides noresize" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/small/guide86/step9.png")%>" />
<img alt="Installing ONLYOFFICE Docs" id="img8_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/Help/Guides/big/guide86/step9.png")%>" />
<div target="img8_eventcom_guides" class="screenphoto magnifier"></div>
</div>
<div class="screen_text">
<p>If the <b>Open ONLYOFFICE DocumentServer demo</b> option is checked, the <b><%= ((BasePage)Page).EditionVersion %></b> welcome page will open in your browser. Alternatively, you can enter <a target="_blank" href="http://localhost/example">http://localhost/example</a> in the address bar of your browser. Here you can find further instructions on how to enable document examples or integrate online editors into your web application using the <a href="http://api.onlyoffice.com/editors/basic"> provided API</a>.</p>
<p class="community_enterprise_display">To connect <b>ONLYOFFICE Docs</b> to <b>ONLYOFFICE Groups</b>, please refer to <a target="_blank" href="<%=VirtualPathUtility.ToAbsolute("~/server/windows/document/connect-document-server.aspx")%>">this instruction</a>.</p>
</div>
</div>
<div class="developer_enterprise_display">
<h2 id="Registering">Registering your <%= ((BasePage)Page).EditionVersion %> version</h2>
<div class="block_of_step">
<div class="screen_text">
<p>If you bought <b><%= ((BasePage)Page).EditionVersion %></b> and received the <b>license.lic</b> file, you can place it to your installation to obtain the software full version.</p>
<p>When you are a Windows user, the <b>license.lic</b> file is placed to the following folder:</p>
<pre><code>%ALLUSERSPROFILE%\ONLYOFFICE\Data\license.lic
</code></pre>
<p>After that your version of <b><%= ((BasePage)Page).EditionVersion %></b> will become registered and full-featured.</p>
</div>
</div>
</div>
</div>