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

Incomplete documentation regarding the upgrade of eZ Publish 5

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Blocker Blocker
    • Resolution: Fixed
    • Affects Version/s: 5.0.0rc1
    • Component/s: Documentation
    • Labels:
    • Environment:

      Operating System: RHEL 6.3
      PHP Version: 5.3.3
      Database and version: MySQL 5.1.61
      Browser (and version): Firefox 16.0

      Description

      The documentation of the upgrade from eZ Publish 4.7 to 5.0 is missing the step where you need to create a ezpublish_prod.yml file and how to create it.
      There is no such information on the https://github.com/ezsystems/ezpublish5/blob/master/INSTALL.md file nor on the http://doc.ez.no/eZ-Publish/Upgrading/Upgrading-to-5.0/Upgrading-from-4.7-to-5.0

        Issue Links

          Activity

          Hide
          Pedro Resende (Inactive) added a comment - - edited

          Also missing step in the http://doc.ez.no/eZ-Publish/Upgrading/Upgrading-to-5.0/Upgrading-from-4.7-to-5.0, you have to change the [DesignSettings] to

          [DesignSettings]
          SiteDesign=admin
          AdditionalSiteDesignList[]=admin

          instead of

          [DesignSettings]
          SiteDesign=ezflow_site_admin
          AdditionalSiteDesignList[]=admin2
          AdditionalSiteDesignList[]=admin
          AdditionalSiteDesignList[]=ezflow

          and don't copy the admin2 folder from the /design in the Step 1: Upgrade the distribution files

          Show
          Pedro Resende (Inactive) added a comment - - edited Also missing step in the http://doc.ez.no/eZ-Publish/Upgrading/Upgrading-to-5.0/Upgrading-from-4.7-to-5.0 , you have to change the [DesignSettings] to [DesignSettings] SiteDesign=admin AdditionalSiteDesignList[]=admin instead of [DesignSettings] SiteDesign=ezflow_site_admin AdditionalSiteDesignList[]=admin2 AdditionalSiteDesignList[]=admin AdditionalSiteDesignList[]=ezflow and don't copy the admin2 folder from the /design in the Step 1: Upgrade the distribution files
          Hide
          Pedro Resende (Inactive) added a comment -

          Missing the creation of ezpublish_prod.yml file

          ezpublish:
              siteaccess:
                  default_siteaccess: eng
                  list:
                      - ezflow_site
                      - eng
                      - ezflow_site_admin
                      - iphone
                  groups:
                      ezflow_site_clean_group:
                          - ezflow_site
                          - eng
                          - ezflow_site_admin
                          - iphone
                  match:
                      URIElement: '1'
              system:
                  ezflow_site_clean_group:
                      database:
                          type: mysql
                          user: ezp
                          password: ezp
                          server: localhost
                          database_name: ezp
                      var_dir: var/ezflow_site_clean
                  eng:
                      url_alias_router: false
                      image_variations:
                          small:
                              reference: null
                              filters:
                                  - { name: geometry/scaledownonly, params: [100, 160] }
                          medium:
                              reference: null
                              filters:
                                  - { name: geometry/scaledownonly, params: [200, 290] }
                          listitem:
                              reference: null
                              filters:
                                  - { name: geometry/scaledownonly, params: [130, 190] }
                          articleimage:
                              reference: null
                              filters:
                                  - { name: geometry/scaledownonly, params: [170, 350] }
                          articlethumbnail:
                              reference: null
                              filters:
                                  - { name: geometry/scaledownonly, params: [70, 150] }
                          gallerythumbnail:
                              reference: null
                              filters:
                                  - { name: geometry/scaledownonly, params: [105, 100] }
                          galleryline:
                              reference: null
                              filters:
                                  - { name: geometry/scaledownonly, params: [70, 150] }
                          imagelarge:
                              reference: null
                              filters:
                                  - { name: geometry/scaledownonly, params: [550, 730] }
                          large:
                              reference: null
                              filters:
                                  - { name: geometry/scaledownonly, params: [360, 440] }
                          rss:
                              reference: null
                              filters:
                                  - { name: geometry/scale, params: [88, 31] }
                          logo:
                              reference: null
                              filters:
                                  - { name: geometry/scaleheight, params: [36] }
                          infoboximage:
                              reference: null
                              filters:
                                  - { name: geometry/scalewidth, params: [75] }
                          billboard:
                              reference: null
                              filters:
                                  - { name: geometry/scalewidth, params: [764] }
                  ezflow_site_admin:
                      url_alias_router: false
                  ezflow_site:
                      url_alias_router: false
                  iphone:
                      url_alias_router: false
              imagemagick:
                  enabled: true
                  path: /usr/bin/convert
          imports:
              -
                  resource: ezpublish.yml

          Show
          Pedro Resende (Inactive) added a comment - Missing the creation of ezpublish_prod.yml file ezpublish: siteaccess: default_siteaccess: eng list: - ezflow_site - eng - ezflow_site_admin - iphone groups: ezflow_site_clean_group: - ezflow_site - eng - ezflow_site_admin - iphone match: URIElement: '1' system: ezflow_site_clean_group: database: type: mysql user: ezp password: ezp server: localhost database_name: ezp var_dir: var/ezflow_site_clean eng: url_alias_router: false image_variations: small: reference: null filters: - { name: geometry/scaledownonly, params: [100, 160] } medium: reference: null filters: - { name: geometry/scaledownonly, params: [200, 290] } listitem: reference: null filters: - { name: geometry/scaledownonly, params: [130, 190] } articleimage: reference: null filters: - { name: geometry/scaledownonly, params: [170, 350] } articlethumbnail: reference: null filters: - { name: geometry/scaledownonly, params: [70, 150] } gallerythumbnail: reference: null filters: - { name: geometry/scaledownonly, params: [105, 100] } galleryline: reference: null filters: - { name: geometry/scaledownonly, params: [70, 150] } imagelarge: reference: null filters: - { name: geometry/scaledownonly, params: [550, 730] } large: reference: null filters: - { name: geometry/scaledownonly, params: [360, 440] } rss: reference: null filters: - { name: geometry/scale, params: [88, 31] } logo: reference: null filters: - { name: geometry/scaleheight, params: [36] } infoboximage: reference: null filters: - { name: geometry/scalewidth, params: [75] } billboard: reference: null filters: - { name: geometry/scalewidth, params: [764] } ezflow_site_admin: url_alias_router: false ezflow_site: url_alias_router: false iphone: url_alias_router: false imagemagick: enabled: true path: /usr/bin/convert imports: - resource: ezpublish.yml
          Hide
          André Rømcke added a comment - - edited

          @pedro Upgrade page has been updated earlier today to explain how you generate prod files, so please re test regarding your last comment.

          In addition #1 now contains info on which design folders to not copy, command for setting up assets are explained, virtual host doc in 5.x tree has been updated based on the one in install.md, updated paths to reflect last weeks change and added ezpublish/cache & ezpublish/logs to folders permission command.

          Show
          André Rømcke added a comment - - edited @pedro Upgrade page has been updated earlier today to explain how you generate prod files, so please re test regarding your last comment. In addition #1 now contains info on which design folders to not copy, command for setting up assets are explained, virtual host doc in 5.x tree has been updated based on the one in install.md, updated paths to reflect last weeks change and added ezpublish/cache & ezpublish/logs to folders permission command.
          Hide
          André Rømcke added a comment - - edited

          Now also added section on admin2 design, and updated ezdemo to contain info on update sql script in ezcomments.

          ( Joao will double check his claim as yml files are not used by legacy kernel/scripts when executed from own folder )

          Show
          André Rømcke added a comment - - edited Now also added section on admin2 design, and updated ezdemo to contain info on update sql script in ezcomments. ( Joao will double check his claim as yml files are not used by legacy kernel/scripts when executed from own folder )
          Hide
          Joao Pingo (Inactive) added a comment - - edited

          On step #1:
          chmod -R a+rwx ezpublish/cache ezpublish/logs ezpublish_legacy/design ezpublish_legacy/extension ezpublish_legacy/settings ezpublish_legacy/var

          ezpublish/var and ezpublish/logs does not exists...

          The folders must be created manually or this 2 chmod commands could be run in step #6, after running
          php ezpublish/console ezpublish:configure --env=prod <package> <adminsiteaccess>

          Show
          Joao Pingo (Inactive) added a comment - - edited On step #1: chmod -R a+rwx ezpublish/cache ezpublish/logs ezpublish_legacy/design ezpublish_legacy/extension ezpublish_legacy/settings ezpublish_legacy/var ezpublish/var and ezpublish/logs does not exists... The folders must be created manually or this 2 chmod commands could be run in step #6, after running php ezpublish/console ezpublish:configure --env=prod <package> <adminsiteaccess>
          Show
          Andrea Melo (Inactive) added a comment - Documentation reviewed. Link: http://doc.ez.no/doc_inside_admin/eZ-Publish/Upgrading/Upgrading-to-5.0/Upgrading-from-4.7-to-5.0
          Hide
          Pedro Resende (Inactive) added a comment -

          The section "Shell commands" and "Recommended shell commands using setfacl" mention to chmod ezpublish/

          {cache,logs,config}

          but those folders are only present after running the following lines

          php ezpublish/console assets:install --symlink web
          php ezpublish/console ezpublish:legacy:assets_install --symlink web

          Described on "Step 6: Generate eZ Publish 5 yml configuration & symlink assets"

          Show
          Pedro Resende (Inactive) added a comment - The section "Shell commands" and "Recommended shell commands using setfacl" mention to chmod ezpublish/ {cache,logs,config} but those folders are only present after running the following lines php ezpublish/console assets:install --symlink web php ezpublish/console ezpublish:legacy:assets_install --symlink web Described on "Step 6: Generate eZ Publish 5 yml configuration & symlink assets"
          Hide
          André Rømcke added a comment -

          > ezpublish/var and ezpublish/logs does not exists...

          You mean "ezpublish_legacy/var" right?

          Show
          André Rømcke added a comment - > ezpublish/var and ezpublish/logs does not exists... You mean "ezpublish_legacy/var" right?
          Hide
          Pedro Resende (Inactive) added a comment -

          No, the folders cache and logs inside ezpublish/.
          They are only created after running the Symfony commands.

          Show
          Pedro Resende (Inactive) added a comment - No, the folders cache and logs inside ezpublish/. They are only created after running the Symfony commands.
          Hide
          André Rømcke added a comment -

          The logs and cache folders will be part of the next eZ Publish 5 builds.
          Was there any other folder related issues?

          Show
          André Rømcke added a comment - The logs and cache folders will be part of the next eZ Publish 5 builds. Was there any other folder related issues?
          Hide
          Pedro Resende (Inactive) added a comment -

          In that case, everything seems fine

          Show
          Pedro Resende (Inactive) added a comment - In that case, everything seems fine
          Hide
          Pedro Resende (Inactive) added a comment -

          Tested and approved by Q.A.

          Show
          Pedro Resende (Inactive) added a comment - Tested and approved by Q.A.

            People

            • Assignee:
              Unassigned
              Reporter:
              Pedro Resende (Inactive)
            • Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Time Tracking

                Estimated:
                Original Estimate - Not Specified
                Not Specified
                Remaining:
                Remaining Estimate - 0 minutes
                0m
                Logged:
                Time Spent - 1 day, 2 hours, 30 minutes
                1d 2h 30m