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

          Pedro Resende (Inactive) created issue -
          Pedro Resende (Inactive) made changes -
          Field Original Value New Value
          Link This issue relates to EZP-19961 [ EZP-19961 ]
          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
          André Rømcke made changes -
          Status Open [ 1 ] Backlog [ 10000 ]
          André Rømcke made changes -
          Status Backlog [ 10000 ] InputQ [ 10001 ]
          André Rømcke made changes -
          Rank Ranked higher
          André Rømcke made changes -
          Rank Ranked higher
          André Rømcke made changes -
          Status InputQ [ 10001 ] Development [ 3 ]
          Assignee André Rømcke [ andre.romcke@ez.no ]
          André Rømcke made changes -
          Link This issue is duplicated by EZP-77 [ EZP-77 ]
          André Rømcke made changes -
          Link This issue is duplicated by EZP-19582 [ EZP-19582 ]
          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.
          André Rømcke logged work - 07/Nov/12 5:22 PM
          • Time Spent:
            3 hours
             

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

          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 )
          André Rømcke made changes -
          Remaining Estimate 0 minutes [ 0 ]
          Time Spent 3 hours [ 10800 ]
          Worklog Id 22788 [ 22788 ]
          André Rømcke made changes -
          Status Development [ 3 ] Devlopment done [ 5 ]
          Joao Pingo (Inactive) made changes -
          Comment [ Step #6 "Generate eZ Publish 5 yml configuration & symlink assets" on upgrade documentation should be before step #4, if not the script files will not run ]
          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>
          Andrea Melo (Inactive) made changes -
          Status Devlopment done [ 5 ] Documentation [ 10010 ]
          Assignee André Rømcke [ andre.romcke@ez.no ] Andrea Melo [ andrea.melo@ez.no ]
          Andrea Melo (Inactive) logged work - 08/Nov/12 1:22 PM
          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
          Andrea Melo (Inactive) made changes -
          Time Spent 3 hours [ 10800 ] 4 hours [ 14400 ]
          Worklog Id 22933 [ 22933 ]
          Andrea Melo (Inactive) made changes -
          Status Documentation [ 10010 ] Documentation done [ 10011 ]
          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"
          André Rømcke made changes -
          Status Documentation done [ 10011 ] Documentation [ 10010 ]
          Assignee Andrea Melo [ andrea.melo@ez.no ] André Rømcke [ andre.romcke@ez.no ]
          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
          André Rømcke logged work - 12/Nov/12 12:55 PM
          • Time Spent:
            30 minutes
             
            <No comment>
          André Rømcke made changes -
          Time Spent 4 hours [ 14400 ] 4 hours, 30 minutes [ 16200 ]
          Worklog Id 23100 [ 23100 ]
          André Rømcke made changes -
          Status Documentation [ 10010 ] Documentation done [ 10011 ]
          Pedro Resende (Inactive) made changes -
          Status Documentation done [ 10011 ] QA [ 10008 ]
          Assignee André Rømcke [ andre.romcke@ez.no ] Pedro Resende [ pedro.resende@ez.no ]
          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.
          Pedro Resende (Inactive) made changes -
          Status QA [ 10008 ] QA done [ 10007 ]
          André Rømcke made changes -
          Assignee Pedro Resende [ pedro.resende@ez.no ]
          Status QA done [ 10007 ] Closed [ 6 ]
          Fix Version/s 5.0.0 [ 10300 ]
          Resolution Fixed [ 1 ]
          Pedro Resende (Inactive) logged work - 21/Nov/12 11:57 AM
          • Time Spent:
            2 hours
             

            Reviewed the documentation

          Pedro Resende (Inactive) made changes -
          Resolution Fixed [ 1 ]
          Status Closed [ 6 ] Reopened [ 4 ]
          Pedro Resende (Inactive) made changes -
          Time Spent 4 hours, 30 minutes [ 16200 ] 6 hours, 30 minutes [ 23400 ]
          Worklog Id 23726 [ 23726 ]
          Pedro Resende (Inactive) made changes -
          Status Reopened [ 4 ] Closed [ 6 ]
          Resolution Fixed [ 1 ]
          André Rømcke made changes -
          Workflow eZ Community Workflow [ 34402 ] eZ Engineering Scrumban Workflow [ 48724 ]
          André Rømcke made changes -
          Workflow eZ Engineering Scrumban Workflow [ 48724 ] EZ* Development Workflow [ 83228 ]
          Alex Schuster made changes -
          Workflow EZ* Development Workflow [ 83228 ] EZEE Development Workflow [ 121808 ]
          Transition Time In Source Status Execution Times Last Executer Last Execution Date
          Open Open Backlog Backlog
          4h 44m 1 André Rømcke 06/Nov/12 3:07 PM
          Backlog Backlog InputQ InputQ
          3s 1 André Rømcke 06/Nov/12 3:07 PM
          InputQ InputQ Development Development
          21h 38m 1 André Rømcke 07/Nov/12 12:45 PM
          Development Development Development Done Development Done
          4h 37m 1 André Rømcke 07/Nov/12 5:23 PM
          Development Done Development Done Documentation Documentation
          17h 59m 1 Andrea Melo (Inactive) 08/Nov/12 11:22 AM
          Documentation Review done Documentation Review done Documentation Documentation
          3d 22h 15m 1 André Rømcke 12/Nov/12 11:38 AM
          Documentation Documentation Documentation Review done Documentation Review done
          3h 17m 2 André Rømcke 12/Nov/12 12:55 PM
          Documentation Review done Documentation Review done QA QA
          7d 22h 37m 1 pedro.resende@ez.no 20/Nov/12 11:33 AM
          QA QA QA Done QA Done
          23h 51m 1 pedro.resende@ez.no 21/Nov/12 11:24 AM
          QA Done QA Done Closed Closed
          18m 59s 1 André Rømcke 21/Nov/12 11:43 AM
          Closed Closed Reopened Reopened
          14m 2s 1 pedro.resende@ez.no 21/Nov/12 11:57 AM
          Reopened Reopened Closed Closed
          1s 1 pedro.resende@ez.no 21/Nov/12 11:57 AM

            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