Uploaded image for project: 'eZ Publish / Platform'
  1. eZ Publish / Platform
  2. EZP-25862

Impossible to setup cluster environment using documentation instructions

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Critical Critical
    • Resolution: Fixed
    • Affects Version/s: 16.02, 1.3.1
    • Fix Version/s: QA tracked issues
    • Component/s: Documentation
    • Labels:
    • Environment:

      3 servers: server1, server2 and the third server with Mysql, where server1 and server2 fetch data from server3
      Operating Systems: Debian 8
      PHP Versions: PHP 5.6.20-0+deb8u1
      Database and version: Mysql 5.5.49-0+deb8u1

      Description

      Using dfs configuration, it's not possible to configure cluster environment

      I used the following configuration in my ezplatform.yml

      ezpublish:
          # Repositories configuration, setup default repository to support solr if enabled
          repositories:
              default:
                  storage: ~
                  search:
                      engine: %search_engine%
                      connection: default
       
          # Siteaccess configuration, with one siteaccess per default
          siteaccess:
              list: [site]
              groups:
                  site_group: [site]
              default_siteaccess: site
              match:
                  URIElement: 1
       
          # System settings, grouped by siteaccess and/or siteaccess group
          system:
              default:
                  io:
                      metadata_handler: dfs
                      binarydata_handler: nfs
                      url_prefix: "storage"
              site_group:
                  # These reflect the current installers, complete installation before you change them. For changing var_dir
                  # it is recommended to install clean, then change setting before you start adding binary content, otherwise you'll
                  # need to manually modify your database data to reflect this to avoid exceptions.
                  var_dir: var/site
                  # System languages. Note that by default, content, content types, and other data are in eng-GB locale,
                  # so removing eng-GB from this list may lead to errors or content not being shown, unless you change
                  # all eng-GB data to other locales first.
                  languages: [eng-GB]
       
      # new doctrine connection for the dfs legacy_dfs_cluster metadata handler.
      doctrine:
          dbal:
              connections:
                  dfs:
                      driver: pdo_mysql
                      host: 10.0.5.4
                      port: 3306
                      dbname: ezp
                      user: ezp
                      password: "mypassword"
                      charset: UTF8
       
      # declare the handlers
      ez_io:
          binarydata_handlers:
              nfs:
                  flysystem:
                      adapter: nfs_adapter
          metadata_handlers: transp
              dfs:
                  legacy_dfs_cluster:
                      connection: doctrine.dbal.dfs_connection
      
      

      At this point, I have had a yml parsing problem, being the culprit
      metadata_handlers: transp

      Side note that is not on documentation

      I was only able to make my cluster environment to work, adding

      oneup_flysystem:
          adapters:
              nfs_adapter:
                  local:
                      directory: "/mnt/ezdfs/$var_dir$/$storage_dir$"
      

      so, my final ezplatform.yml that worked was:

      ezpublish:
          # Repositories configuration, setup default repository to support solr if enabled
          repositories:
              default:
                  storage: ~
                  search:
                      engine: %search_engine%
                      connection: default
       
          # Siteaccess configuration, with one siteaccess per default
          siteaccess:
              list: [site]
              groups:
                  site_group: [site]
              default_siteaccess: site
              match:
                  URIElement: 1
       
          # System settings, grouped by siteaccess and/or siteaccess group
          system:
              default:
                  io:
                      metadata_handler: dfs
                      binarydata_handler: nfs
                      url_prefix: "storage"
              site_group:
                  # These reflect the current installers, complete installation before you change them. For changing var_dir
                  # it is recommended to install clean, then change setting before you start adding binary content, otherwise you'll
                  # need to manually modify your database data to reflect this to avoid exceptions.
                  var_dir: var/site
                  # System languages. Note that by default, content, content types, and other data are in eng-GB locale,
                  # so removing eng-GB from this list may lead to errors or content not being shown, unless you change
                  # all eng-GB data to other locales first.
                  languages: [eng-GB]
       
      # new doctrine connection for the dfs legacy_dfs_cluster metadata handler.
      doctrine:
          dbal:
              connections:
                  dfs:
                      driver: pdo_mysql
                      host: 10.0.5.4
                      port: 3306
                      dbname: ezp
                      user: ezp
                      password: "ezp"
                      charset: UTF8
       
      # declare the handlers
      ez_io:
          binarydata_handlers:
              nfs:
                  flysystem:
                      adapter: nfs_adapter
          metadata_handlers:
              dfs:
                  legacy_dfs_cluster:
                      connection: doctrine.dbal.dfs_connection
       
      oneup_flysystem:
          adapters:
              nfs_adapter:
                  local:
                      directory: "/mnt/ezdfs/$var_dir$/$storage_dir$"
      
      

        Activity

        Hide
        Bertrand Dunogier added a comment -

        I suppose the trans in metadata_handlers:transp is just a typo/artifact, to be removed.

        Yes, it is a typo. Removed it in the DEVELOPER space version. Also fixed the configuration example by adding the missing flysystem configuration block: https://doc.ez.no/pages/diffpagesbyversion.action?pageId=31430387&selectedPageVersions=8&selectedPageVersions=7.

        Show
        Bertrand Dunogier added a comment - I suppose the trans in metadata_handlers:transp is just a typo/artifact, to be removed. Yes, it is a typo. Removed it in the DEVELOPER space version. Also fixed the configuration example by adding the missing flysystem configuration block: https://doc.ez.no/pages/diffpagesbyversion.action?pageId=31430387&selectedPageVersions=8&selectedPageVersions=7 .
        Hide
        Bertrand Dunogier added a comment -

        @doc / Dominika Kurek: see comment above. Please review the doc change, and send to QA if approved.

        Show
        Bertrand Dunogier added a comment - @doc / Dominika Kurek : see comment above. Please review the doc change, and send to QA if approved.
        Hide
        Paulo Nunes (Inactive) added a comment -

        @doc/Dominika Kurek:
        suggestion: In the first example, line 28, we might change "/mnt/ezdfs/$var_dir$/$storage_dir$" to /path/to/nfs/$var_dir$/$storage_dir$

        Show
        Paulo Nunes (Inactive) added a comment - @doc/ Dominika Kurek : suggestion: In the first example, line 28, we might change "/mnt/ezdfs/$var_dir$/$storage_dir$" to /path/to/nfs/$var_dir$/$storage_dir$
        Hide
        Bertrand Dunogier added a comment -

        I don't disagree with the above. I'll leave it to you, doc team, as it is really an examples consistency/approach question.

        Show
        Bertrand Dunogier added a comment - I don't disagree with the above. I'll leave it to you, doc team, as it is really an examples consistency/approach question.
        Hide
        Dominika Kurek added a comment - - edited

        Changed the path to /<path to nfs>/, for clarity.

        Show
        Dominika Kurek added a comment - - edited Changed the path to /<path to nfs>/ , for clarity.
        Hide
        Paulo Nunes (Inactive) added a comment -

        Verified by QA

        Show
        Paulo Nunes (Inactive) added a comment - Verified by QA

          People

          • Assignee:
            Unassigned
            Reporter:
            Paulo Nunes (Inactive)
          • Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: