diff --git a/Web/App_GlobalResources/Resource.resx b/Web/App_GlobalResources/Resource.resx index 36a30e6f5..88bcfea85 100644 --- a/Web/App_GlobalResources/Resource.resx +++ b/Web/App_GlobalResources/Resource.resx @@ -5215,4 +5215,13 @@ RANK function + + Connecting Dameng database to ONLYOFFICE Docs + + + Connecting Oracle database to ONLYOFFICE Docs + + + Connecting MsSQL database to ONLYOFFICE Docs + \ No newline at end of file diff --git a/Web/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx b/Web/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx new file mode 100644 index 000000000..96bd4cd90 --- /dev/null +++ b/Web/Controls/Help/ArticlesCompleteList/TipsTricks/181_connect_dameng.ascx @@ -0,0 +1,3 @@ +<%@ Control Language="C#" %> +" + href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-dameng.aspx")%>"> \ No newline at end of file diff --git a/Web/Controls/Help/ArticlesCompleteList/TipsTricks/182_connect_oracle.ascx b/Web/Controls/Help/ArticlesCompleteList/TipsTricks/182_connect_oracle.ascx new file mode 100644 index 000000000..5d991c4a2 --- /dev/null +++ b/Web/Controls/Help/ArticlesCompleteList/TipsTricks/182_connect_oracle.ascx @@ -0,0 +1,3 @@ +<%@ Control Language="C#" %> +" + href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-oracle.aspx")%>"> \ No newline at end of file diff --git a/Web/Controls/Help/ArticlesCompleteList/TipsTricks/183_connect_mssql.ascx b/Web/Controls/Help/ArticlesCompleteList/TipsTricks/183_connect_mssql.ascx new file mode 100644 index 000000000..7dec4190e --- /dev/null +++ b/Web/Controls/Help/ArticlesCompleteList/TipsTricks/183_connect_mssql.ascx @@ -0,0 +1,3 @@ +<%@ Control Language="C#" %> +" + href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-connect-mssql.aspx")%>"> \ No newline at end of file diff --git a/Web/Controls/Help/Installation/Docs.ascx b/Web/Controls/Help/Installation/Docs.ascx index 2b21c2876..17d295356 100644 --- a/Web/Controls/Help/Installation/Docs.ascx +++ b/Web/Controls/Help/Installation/Docs.ascx @@ -49,6 +49,9 @@
  • ">Connecting Amazon S3 bucket as a cache to ONLYOFFICE Docs
  • ">Configuring IP filter for ONLYOFFICE Docs
    • +
    • +
    • +
  • System requirements
    diff --git a/Web/Controls/Help/Server/Document/DocsConnectDameng/DocsConnectDameng.ascx b/Web/Controls/Help/Server/Document/DocsConnectDameng/DocsConnectDameng.ascx new file mode 100644 index 000000000..d58bfacc8 --- /dev/null +++ b/Web/Controls/Help/Server/Document/DocsConnectDameng/DocsConnectDameng.ascx @@ -0,0 +1,55 @@ +<%@ Control Language="C#" Inherits="BaseContentUserControls"%> +<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %> + + + +
    +
    +

    Connecting Dameng database to ONLYOFFICE Docs

    +
    +
      +
      • +
      • +
    +
    +
    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
    +

    Connecting to Dameng server

    +

    The Document Server has several variables, DB_TYPE DB_HOST DB_USER DB_PASSWORD DB_PORT, that allow you to customize your database connection. However, currently only MYSQL/MariaDB and PostgreSQL are supported officially.

    +

    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:

    +
      +
    1. + Add new db type: + 
      https://github.com/ONLYOFFICE/Docker-DocumentServer/blob/feature/damengdb-compose/run-document-server.sh#L152C4-L154C9
      +
      2. +
    2. + Add the function of remote database creation: + 
      https://github.com/ONLYOFFICE/Docker-DocumentServer/blob/feature/damengdb-compose/run-document-server.sh#L423C1-L432C2
      +
      3. +
    +

    After these changes have been added to the entry script, the document server is ready to initialize the connection to the database.

    +

    Create a simple compose file, in which you specify the necessary variables for the Document Server service:

    +
      +
    • DB_TYPE: damengdb
      • +
    • DB_HOST: Name (dns name) of the database service in compose file
      • +
    • DB_USER: Username
      • +
    • DB_PASS: User password
      • +
    • DB_PORT: Service port with database
      • +
    +

    Mount the binary directory from the damengdb container so that the document server container has access to the disql utility. Please refer to the docker-compose.yml to learn more.

    +

    Running a stand

    +

    To start the stand, execute the following commands:

    +
      + 
    1. git clone -b feature/damentdb-compose https://github.com/ONLYOFFICE/Docker-DocumentServer.git
      2. + 
    2. cd Docker-DocumentServer/tests/damengdb/
      3. + 
    3. docker compose up –d
      4. +
    +
    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
    +
    +
    \ No newline at end of file diff --git a/Web/Controls/Help/Server/Document/DocsConnectMsSQL/DocsConnectMsSQL.ascx b/Web/Controls/Help/Server/Document/DocsConnectMsSQL/DocsConnectMsSQL.ascx new file mode 100644 index 000000000..c4c95a221 --- /dev/null +++ b/Web/Controls/Help/Server/Document/DocsConnectMsSQL/DocsConnectMsSQL.ascx @@ -0,0 +1,67 @@ +<%@ Control Language="C#" Inherits="BaseContentUserControls"%> +<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %> + + + +
    +
    +

    Connecting MsSQL database to ONLYOFFICE Docs

    +
    +
      +
      • +
      • +
    +
    +

    Currently, there are no Docker variables that allow connecting with MsSQL; the user must perform the steps manually. The steps to connect MsSQL database to ONLYOFFICE Docs are as follows:

    +
      +
    1. + Install ONLYOFFICE Docs: + 
      sudo docker run -i -t -d -p 80:80 --name onlyoffice \
+onlyoffice/documentserver-ee
      +
      2. +
    2. + Install MsSQL on the same or a separate server: + 
      sudo docker run -p 8080:1433 -d --name mssql  \
+-e "ACCEPT_EULA=Y" \
+-e "MSSQL_SA_PASSWORD=onlYoff1ce" \
+mcr.microsoft.com/mssql/server:2022-latest
+
      +
      3. +
    3. + Download a script for creating tables and copy it to the container; afterwards, create a database and run the script: + 
      wget https://github.com/ONLYOFFICE/server/raw/master/schema/mssql/createdb.sql
+sudo docker cp ./createdb.sql mssql:/
+sudo docker exec mssql /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P onlYoff1ce -Q "CREATE DATABASE onlyoffice;"
+sudo docker exec mssql /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P onlYoff1ce -Q "GO"
+sudo docker exec mssql /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P onlYoff1ce -i /createdb.sql
+
+
      +
      4. +
    4. + Change the parameters responsible for establishing a connection in local.json and switch Document Server to mssql: + 
      sudo docker exec -it onlyoffice bash
+nano /etc/onlyoffice/documentserver/local.json
+{
+  "services": {
+    "CoAuthoring": {
+      "sql": {
+        "type": "mssql",
+        "dbHost": "",
+        "dbPort": "8080",
+        "dbName": "onlyoffice",
+        "dbUser": "sa",
+        "dbPass": "onlYoff1ce"
+...
+# supervisorctl restart all
+
      +
      5. +
    +
    +
    \ No newline at end of file diff --git a/Web/Controls/Help/Server/Document/DocsConnectOracle/DocsConnectOracle.ascx b/Web/Controls/Help/Server/Document/DocsConnectOracle/DocsConnectOracle.ascx new file mode 100644 index 000000000..dc4fc2feb --- /dev/null +++ b/Web/Controls/Help/Server/Document/DocsConnectOracle/DocsConnectOracle.ascx @@ -0,0 +1,63 @@ +<%@ Control Language="C#" Inherits="BaseContentUserControls"%> +<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %> + + + +
    +
    +

    Connecting Oracle database to ONLYOFFICE Docs

    +
    +
      +
      • +
      • +
    +
    +

    Currently, there are no Docker variables that allow connecting with Oracle; the user must perform the steps manually. The steps to connect Oracle database to ONLYOFFICE Docs are as follows:

    +
      +
    1. + Install ONLYOFFICE Docs: + 
      sudo docker run -i -t -d -p 80:80 --name onlyoffice \
+onlyoffice/documentserver-ee
      +
      2. +
    2. + Install Oracle on the same or a separate server: + 
      docker run --name oracle -p 8080:1521 -p 8081:5500 \
+-e ORACLE_PASSWORD=admin \
+-e APP_USER=onlyoffice \
+-e APP_USER_PASSWORD=onlyoffice \
+-d gvenzl/oracle-xe:21-slim
+
      +
      3. +
    3. + Download a script for creating tables and copy it to the container; afterwards, create a database and run the script: + 
      wget https://github.com/ONLYOFFICE/server/raw/master/schema/oracle/createdb.sql
+docker cp ./createdb.sql oracle:/
+docker exec oracle sqlplus -s onlyoffice/onlyoffice@//localhost/xepdb1 @/createdb.sql
+
      +
      4. +
    4. + Change the parameters responsible for establishing a connection in local.json and switch Document Server to mssql: + 
      sudo docker exec -it onlyoffice bash
+nano /etc/onlyoffice/documentserver/local.json
+  "services": {
+    "CoAuthoring": {
+      "sql": {
+        "type": "oracle",
+        "dbHost": "",
+        "dbPort": "8080",
+        "dbName": "xepdb1",
+        "dbUser": "onlyoffice",
+        "dbPass": "onlyoffice"
+...
+
      +
      5. +
    +
    +
    \ No newline at end of file diff --git a/Web/installation/docs-connect-dameng.aspx b/Web/installation/docs-connect-dameng.aspx new file mode 100644 index 000000000..c450545e4 --- /dev/null +++ b/Web/installation/docs-connect-dameng.aspx @@ -0,0 +1,22 @@ +<%@ Page Title="" Language="C#" MasterPageFile="~/Masters/InstallationGuides/InstallationDocsEEArticles.master" %> +<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %> + + + + + + + + + + +
    + + \ No newline at end of file diff --git a/Web/installation/docs-connect-mssql.aspx b/Web/installation/docs-connect-mssql.aspx new file mode 100644 index 000000000..d58411644 --- /dev/null +++ b/Web/installation/docs-connect-mssql.aspx @@ -0,0 +1,22 @@ +<%@ Page Title="" Language="C#" MasterPageFile="~/Masters/InstallationGuides/InstallationDocsEEArticles.master" %> +<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %> + + + + + + + + + + +
    + + \ No newline at end of file diff --git a/Web/installation/docs-connect-oracle.aspx b/Web/installation/docs-connect-oracle.aspx new file mode 100644 index 000000000..c885af219 --- /dev/null +++ b/Web/installation/docs-connect-oracle.aspx @@ -0,0 +1,22 @@ +<%@ Page Title="" Language="C#" MasterPageFile="~/Masters/InstallationGuides/InstallationDocsEEArticles.master" %> +<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %> + + + + + + + + + + +
    + + \ No newline at end of file