Upgrading

Contents

Guillotine application

Guillotine version 7 is required if you need to modify graphql schema in your application.

Upgrading from v1.x

  1. Update env vars to:

    APP_NAME -> ENONIC_APP_NAME
    remove CONTENT_API_MASTER
    remove CONTENT_API_DRAFT
    add ENONIC_API
    API_TOKEN -> ENONIC_API_TOKEN
    remove SITE_KEY
    add ENONIC_PROJECTS=<repo-name>/site/path[,<lang>:<repo-name>/site/path,...]
  2. Add i18n config block to next.config.js

    i18n: {
        locales: ['en', 'no'],
        defaultLocale: 'en',
    }
  3. Remove lib-nextxp dependency from your Enonic XP app build.gradle file

  4. Install Next.XP application from Enonic Market

  5. Create config file named com.enonic.app.nextxp.cfg in <xp-home>/config/ folder to change default values and add more configurations:

    # uncomment to override default values
    # nextjs.default.secret=yourSecret
    # nextjs.default.url=http://127.0.0.1:4242
    #
    # config 'someName'
    nextjs.someName.secret=yourSecret
    nextjs.someName.url=https://your.next-site.com
    #
    # config 'anotherName'
    nextjs.anotherName.secret=yourOtherSecret
    nextjs.anotherName.url=https://your.other-next-site.com
    # ...
    Remember to update property values with your own data
  6. remove lib-guillotine dependency from build.gradle file of your Enonic XP app

  7. install Guillotine application from Enonic Market

    Use Guillotine 7 or higher if you need to extend the graphql schema
  8. Add Next.XP application to your site in every layer and save it

  9. Default configuration will be used automatically for each site. You can change it by going to Next.XP application config in each site and selecting named configurations.


Contents

Contents