Versions Compared

Key

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

...

  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 (Do not launch the setup wizard after installation).
  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
      iconfalse
      titleWarning

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

  8. Upgrade the Azkaban Scheduler if the release notes indicates a Scheduler upgrade is required. See the Upgrading Azkaban section for more details.
  9. 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.
  10. If authentication profiles were not used in the previous version of WhereScape RED, then login without a profile. An authentication Profile will then need to be created see Profiles and Authentication for details.
  11. Restart any halted or aborted jobs.

    Note
    iconfalse
    titleNote
    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.

...