Versions Compared

Old Version 1

changes.mady.by.user Wara Hermosa

Saved on

compared with

New Version 2

changes.mady.by.user eric revollo

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note
  • Ensure that you have made a backup your metadata before performing the upgrade.
  • Ensure you also upgrade the WhereScapeRED Scheduler if the release notes indicates a Scheduler upgrade is required. See the Upgrading Azkaban section for more details.

...

  1. Allow any active jobs to complete. Halting active jobs will allow running tasks to complete with no new tasks starting. Aborting active jobs will kill any running tasks and stop running jobs.
  2. Stop all schedulers. Windows schedulers can be stopped via Windows Services. To stop a UNIX or Linux scheduler, kill the active scheduler process.
  3. Close any WhereScape programs that are running on your machine.
  4. Back up your metadata.
  5. Install the new version of RED on your machine.
  6. Run the RedMetadataValidate.exe found in the installation directory of RED. This function may re-compile existing or create new metadata procedures; metadata tables may be altered, or new tables created.
  7. When performing an upgrade of RED:
    • Click OK when prompted to validate metadata tables.
    • Click Yes when prompted to re-create metadata views.
    • Click Yes when prompted to re-compile metadata procedures.
      Warning

      If the above steps are not all completed during an upgrade, the metadata may be left in an inconsistent state.

  8. Restart all schedulers. Windows schedulers can be restarted via Windows Services. For any UNIX or Linux schedulers, these can be restarted by running the start-up script in the bin directory of each Azkaban Web Server or Executor.
  9. Restart any halted or aborted jobs.

    Note
    1. Metadata tables do not change between minor releases, but metadata procedure often and usually do change.
    2. RED will not let you sign into an old repository version using a newer version of RED.
    3. RED will let you sign into a new repository version using an older version of RED but it will warn you that this may potentially cause issues.
    4. Side by side installations are possible (two versions in two directories on the same machine), but be careful with schedulers. If you install the new version of RED in a new directory, you must update the registry for each service to use the new version of RED.See Azkaban Upgrade troubleshooting section.