Uploaded Dameng, PostgresQL articles.
This commit is contained in:
parent
16b3d7765b
commit
dbd41154bb
@ -5137,4 +5137,10 @@
|
||||
<data name="IntegratingOODropboxTitle" xml:space="preserve">
|
||||
<value>Integrate ONLYOFFICE with Dropbox.</value>
|
||||
</data>
|
||||
<data name="ConnectDamengTitle" xml:space="preserve">
|
||||
<value>Connecting Dameng database to ONLYOFFICE Docs</value>
|
||||
</data>
|
||||
<data name="ConnectPostgresQLTitle" xml:space="preserve">
|
||||
<value>Connecting PostgresQL database to ONLYOFFICE Docs</value>
|
||||
</data>
|
||||
</root>
|
@ -0,0 +1,3 @@
|
||||
<%@ Control Language="C#" %>
|
||||
<a class="crm-task-title sm_tipstricks sm_saas sm_documents" id="link_181" title="<asp:Literal runat="server" Text="<%$ Resources:Resource, ConnectDamengTitle %>" />"
|
||||
href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-dameng.aspx")%>"><asp:Literal runat="server" Text="<%$ Resources:Resource, ConnectDamengTitle %>" /></a>
|
@ -0,0 +1,3 @@
|
||||
<%@ Control Language="C#" %>
|
||||
<a class="crm-task-title sm_tipstricks sm_saas sm_documents" id="link_182" title="<asp:Literal runat="server" Text="<%$ Resources:Resource, ConnectPostgresQLTitle %>" />"
|
||||
href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-postgresql.aspx")%>"><asp:Literal runat="server" Text="<%$ Resources:Resource, ConnectPostgresQLTitle %>" /></a>
|
@ -49,6 +49,8 @@
|
||||
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-amazon.aspx")%>">Connecting Amazon S3 bucket as a cache to ONLYOFFICE Docs</a></li>
|
||||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/GettingStarted/205_configure_jwt.ascx" /></li>
|
||||
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-configure-ipfilter.aspx")%>">Configuring IP filter for ONLYOFFICE Docs</a></li>
|
||||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx" /></li>
|
||||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/TipsTricks/182_connect_postgresql.ascx" /></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><h6>System requirements</h6>
|
||||
|
@ -0,0 +1,55 @@
|
||||
<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
|
||||
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
|
||||
|
||||
<script runat="server">
|
||||
protected override void Init()
|
||||
{
|
||||
PageTitle = PageCaption = "Connecting Dameng database to ONLYOFFICE Docs";
|
||||
MetaKeyWords = "dameng, database, editors";
|
||||
MetaDescription = "Connect Dameng database to ONLYOFFICE Docs";
|
||||
}
|
||||
</script>
|
||||
|
||||
<div class="main_buscall_container dataBackup">
|
||||
<div class="MainHelpCenter">
|
||||
<h1 class="subHeaderFeaturesCaption TipsCaption">Connecting Dameng database to ONLYOFFICE Docs</h1>
|
||||
<div class="keyword_block">
|
||||
<ul>
|
||||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/document-server/document-server.ascx" /></li>
|
||||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/server-version/server-version.ascx" /></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="notehelp">The current guide suggests that a test bench has already been implemented in a separate feature/damengdb-compose branch: https://github.com/ONLYOFFICE/Docker-DocumentServer/tree/feature/damengdb-compose/tests/damengdb</div>
|
||||
<h2>Connecting to Dameng server</h2>
|
||||
<p>The Document Server has several variables, <b><em>DB_TYPE DB_HOST DB_USER DB_PASSWORD DB_PORT</em></b>, that allow you to customize your database connection. However, currently only MYSQL/MariaDB and PostgreSQL are supported officially.</p>
|
||||
<p>To connect DamengDb, modify the entry point script and add connection conditions and parameters to the initialization entry point script of the Document Server image:</p>
|
||||
<ol>
|
||||
<li>
|
||||
Add new db type:
|
||||
<pre>https://github.com/ONLYOFFICE/Docker-DocumentServer/blob/feature/damengdb-compose/run-document-server.sh#L152C4-L154C9</pre>
|
||||
</li>
|
||||
<li>
|
||||
Add the function of remote database creation:
|
||||
<pre>https://github.com/ONLYOFFICE/Docker-DocumentServer/blob/feature/damengdb-compose/run-document-server.sh#L423C1-L432C2</pre>
|
||||
</li>
|
||||
</ol>
|
||||
<p>After these changes have been added to the entry script, the document server is ready to initialize the connection to the database.</p>
|
||||
<p>Create a simple compose file, in which you specify the necessary variables for the Document Server service:</p>
|
||||
<ul>
|
||||
<li><b>DB_TYPE</b>: damengdb</li>
|
||||
<li><b>DB_HOST</b>: Name (dns name) of the database service in compose file</li>
|
||||
<li><b>DB_USER</b>: Username</li>
|
||||
<li><b>DB_PASS</b>: User password</li>
|
||||
<li><b>DB_PORT</b>: Service port with database</li>
|
||||
</ul>
|
||||
<p>Mount the binary directory from the damengdb container so that the document server container has access to the <b>disql</b> utility. Please refer to the <a href="https://github.com/ONLYOFFICE/Docker-DocumentServer/blob/feature/damengdb-compose/tests/damengdb/docker-compose.yml#L34" target="_blank">docker-compose.yml</a> to learn more.</p>
|
||||
<h2>Running a stand</h2>
|
||||
<p>To start the stand, execute the following commands:</p>
|
||||
<ol>
|
||||
<li><pre><code>git clone -b feature/damentdb-compose https://github.com/ONLYOFFICE/Docker-DocumentServer.git</code></pre></li>
|
||||
<li><pre><code>cd Docker-DocumentServer/tests/damengdb/</code></pre></li>
|
||||
<li><pre><code>docker compose up –d</code></pre></li>
|
||||
</ol>
|
||||
<div class="notehelp">The database image must be available on hub.docker. We have uploaded the image v8.1.2.128 for your convenience: https://hub.docker.com/r/danilaworker/damengdb</div>
|
||||
</div>
|
||||
</div>
|
@ -0,0 +1,169 @@
|
||||
<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
|
||||
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
|
||||
|
||||
<script runat="server">
|
||||
protected override void Init()
|
||||
{
|
||||
PageTitle = PageCaption = "Connecting PostgresQL database to ONLYOFFICE Docs";
|
||||
MetaKeyWords = "postgresql, database, editors";
|
||||
MetaDescription = "Connect PostgresQL database to ONLYOFFICE Docs";
|
||||
}
|
||||
</script>
|
||||
|
||||
<div class="main_buscall_container dataBackup">
|
||||
<div class="MainHelpCenter">
|
||||
<h1 class="subHeaderFeaturesCaption TipsCaption">Connecting PostgresQL database to ONLYOFFICE Docs</h1>
|
||||
<div class="keyword_block">
|
||||
<ul>
|
||||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/document-server/document-server.ascx" /></li>
|
||||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/server-version/server-version.ascx" /></li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<h2>Installing and configuring PostgreSQL for Debian, Ubuntu, and derivatives</h2>
|
||||
<div class="block_of_step">
|
||||
<div class="screen_text">
|
||||
<p>Install the PostgreSQL version included in your version of Ubuntu:</p>
|
||||
<pre><code>sudo apt-get install postgresql </code></pre>
|
||||
<p>If you want to install some other PostgreSQL version from the PostgreSQL Repository, please see the <a href="https://www.postgresql.org/download/linux/ubuntu/">official PostgreSQL documentation</a> for more detail on that.</p>
|
||||
<p>After PostgreSQL is installed, create the PostgreSQL database and user:</p>
|
||||
<p>The database user must have the <b>onlyoffice</b> name. You can specify any password.</p>
|
||||
<pre><code>sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"</code></pre>
|
||||
<pre><code>sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"</code></pre>
|
||||
<p>For more information, please refer to the <a href="https://helpcenter.onlyoffice.com/installation/docs-enterprise-install-ubuntu.aspx">full guide on installing ONLYOFFICE Docs for Debian, Ubuntu, and derivatives</a>.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<h2>Installing and configuring PostgreSQL for CentOS and derivatives</h2>
|
||||
<div class="block_of_step">
|
||||
<div class="screen_text">
|
||||
<p><b>Install the PostgreSQL</b> version included in your version of CentOS:</p>
|
||||
<pre><code>sudo yum install postgresql postgresql-server</code></pre>
|
||||
<ol>
|
||||
<li>
|
||||
<b>Initialize the PostgreSQL database:</b>
|
||||
<pre><code>sudo service postgresql initdb</code></pre>
|
||||
<pre><code>sudo chkconfig postgresql on</code></pre>
|
||||
<p>On CentOS 9, <code>chkconfig</code> is not installed by default. Install it using the following command:</p>
|
||||
<pre><code>sudo yum install chkconfig</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<b>Turn on the 'trust' authentication method</b> for IPv4 and IPv6 <code>localhost</code>:
|
||||
<ol>
|
||||
<li>Open the <code>/var/lib/pgsql/data/pg_hba.conf</code> file in a text editor.</li>
|
||||
<li>
|
||||
Find the <code>host all all 127.0.0.1/32 ident</code> string and replace it with the following one.
|
||||
<pre><code>host all all 127.0.0.1/32 trust</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
Then find the <code>host all all ::1/128 ident</code> string and replace it with the following one:
|
||||
<pre><code>host all all ::1/128 trust</code></pre>
|
||||
</li>
|
||||
</ol>
|
||||
</li>
|
||||
<li>Save the changes.</li>
|
||||
</ol>
|
||||
<p><b>Restart the PostgreSQL service:</b></p>
|
||||
<pre><code>sudo service postgresql restart</code></pre>
|
||||
<p><b>Create the PostgreSQL database and user:</b></p>
|
||||
<ol>
|
||||
<li>You can specify any user name and password.</li>
|
||||
<li>
|
||||
First run the following command:
|
||||
<pre><code>cd /tmp </code></pre>
|
||||
to prevent the <code>could not change directory to "/root"</code> warning if running from root.
|
||||
</li>
|
||||
<li>
|
||||
Then the database and the user must be created:
|
||||
<pre><code>sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"</code></pre>
|
||||
<pre><code>sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"</code></pre>
|
||||
</li>
|
||||
</ol>
|
||||
<p>For more information, please refer to the <a href="https://helpcenter.onlyoffice.com/installation/docs-enterprise-install-centos.aspx">full guide on installing ONLYOFFICE Docs for CentOS and derivatives</a>.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<h2>Installing and configuring PostgreSQL for Linux</h2>
|
||||
<div class="block_of_step">
|
||||
<div class="screen_text">
|
||||
<h3>Updating PostgresQL on Linux</h3>
|
||||
<p>The database schema has been changed in v6.3. When updating to v6.3, you may also need to upgrade the database schema to ensure the ability to use the <a href="https://helpcenter.onlyoffice.com/ONLYOFFICE-Editors/ONLYOFFICE-Document-Editor/HelpfulHints/Password.aspx">password protection</a> feature. </p>
|
||||
<ol>
|
||||
<li>
|
||||
Download the script for upgrading the database schema.
|
||||
<ul>
|
||||
<li>For PostgreSQL: https://github.com/ONLYOFFICE/server/blob/develop/schema/postgresql/upgrade/upgradev630.sql</li>
|
||||
<li>For MySQL: https://github.com/ONLYOFFICE/server/blob/develop/schema/mysql/upgrade/upgradev630.sql</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
Execute the script using the command line.
|
||||
<ul>
|
||||
<li>For PostgreSQL: <code>psql -U onlyoffice -W onlyoffice < {path-to-upgradev630.sql}</code></li>
|
||||
<li>For MySQL: <code>mysql -u root -p onlyoffice < {path-to-upgradev630.sql}</code></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Specify the password used when creating the database (onlyoffice).</li>
|
||||
</ol>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<h2>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">You can specify any user name and password.</div>
|
||||
<p><b>Method 1</b></p>
|
||||
<ol>
|
||||
<li>
|
||||
Run the <code>"%ProgramFiles%\PostgreSQL\12\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 "%ProgramFiles%\PostgreSQL\12\bin"
|
||||
psql -U postgres -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
|
||||
psql -U postgres -c "CREATE DATABASE onlyoffice OWNER 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>
|
||||
<p>For more information, please refer to the <a href="https://helpcenter.onlyoffice.com/installation/docs-enterprise-install-windows.aspx">full guide on installing ONLYOFFICE Docs for Windows</a></p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
22
Web/installation/docs-connect-dameng.aspx
Normal file
22
Web/installation/docs-connect-dameng.aspx
Normal file
@ -0,0 +1,22 @@
|
||||
<%@ Page Title="" Language="C#" MasterPageFile="~/Masters/InstallationGuides/InstallationDocsEEArticles.master" %>
|
||||
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
|
||||
<asp:Content ID="Content4" ContentPlaceHolderID="pagebodyidpage" runat="Server">
|
||||
<body class="docs_connect_dameng">
|
||||
</asp:Content>
|
||||
<asp:Content ID="content3" ContentPlaceHolderID="breadstop" runat="server">
|
||||
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/VariousControls/TopControls/DocumentServerTop/DocumentServerTop.ascx" />
|
||||
</asp:Content>
|
||||
<asp:Content ID="Content1" ContentPlaceHolderID="content" runat="Server">
|
||||
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Document/DocsConnectDameng/DocsConnectDameng.ascx" />
|
||||
</asp:Content>
|
||||
<asp:Content ID="content2" ContentPlaceHolderID="leftmenupage" runat="server">
|
||||
<div class="guidespage document">
|
||||
<div id="SeeAlsoBlockLinks">
|
||||
<div class="caption guides one">
|
||||
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/GettingStarted/166_owncloud.ascx" />
|
||||
</div>
|
||||
<div class="caption video one">
|
||||
<cc:localizecontent runat="Server" controlname="~/Controls/Help/ArticlesCompleteList/Video/150_integrate_owncloud.ascx" />
|
||||
</div>
|
||||
</div>
|
||||
</asp:Content>
|
22
Web/installation/docs-connect-postgresql.aspx
Normal file
22
Web/installation/docs-connect-postgresql.aspx
Normal file
@ -0,0 +1,22 @@
|
||||
<%@ Page Title="" Language="C#" MasterPageFile="~/Masters/InstallationGuides/InstallationDocsEEArticles.master" %>
|
||||
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
|
||||
<asp:Content ID="Content4" ContentPlaceHolderID="pagebodyidpage" runat="Server">
|
||||
<body class="docs_connect_postgresql">
|
||||
</asp:Content>
|
||||
<asp:Content ID="content3" ContentPlaceHolderID="breadstop" runat="server">
|
||||
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/VariousControls/TopControls/DocumentServerTop/DocumentServerTop.ascx" />
|
||||
</asp:Content>
|
||||
<asp:Content ID="Content1" ContentPlaceHolderID="content" runat="Server">
|
||||
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Server/Document/DocsConnectPostgresQL/DocsConnectPostgresQL.ascx" />
|
||||
</asp:Content>
|
||||
<asp:Content ID="content2" ContentPlaceHolderID="leftmenupage" runat="server">
|
||||
<div class="guidespage document">
|
||||
<div id="SeeAlsoBlockLinks">
|
||||
<div class="caption guides one">
|
||||
<cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/ArticlesCompleteList/GettingStarted/166_owncloud.ascx" />
|
||||
</div>
|
||||
<div class="caption video one">
|
||||
<cc:localizecontent runat="Server" controlname="~/Controls/Help/ArticlesCompleteList/Video/150_integrate_owncloud.ascx" />
|
||||
</div>
|
||||
</div>
|
||||
</asp:Content>
|
Loading…
Reference in New Issue
Block a user