Versions Compared

Key

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

...

  1. Run RedSchedulerInstaller.exe to start the upgrade process follow the interactive installer wizard

    Note
    titleNote

    For scripted upgrades, the Linux upgrade method described later can also be used on Windows.


  2. To upgrade the Azkaban metadata and Web Server on this machine, select Install Scheduler and un-check Add scheduler configuration to RED as this configuration has already been added to RED during the original install. If you want to upgrade an Executor on this machine, select Install Executor, as required.
  3. Choose the existing Azkaban installation location to upgrade.
  4. Provide the existing RED and Azkaban metadata databases. If you are unsure of the ports and users of your existing servers you can open the azkaban.local.properties file you backed up earlier and extract those details from it.
  5. Enter your existing server details into the Web Server Configuration and Exec Server Configuration screens ensure you have unchecked the options Install as Windows service as these were already put in place in the original installation.
  6. Proceed through the rest of the installation wizard and click Install at the end to complete the upgrade of the Azkaban metadata and the Web and Exec Servers.
  7. Post install you need to manually merge any customizations to the azkaban.local.properties and users file as required before starting up your services again.

...

Ensure the Web Server service or process is stopped.

Tip
titleTip

The original response file for each Web and Executor server should still exist in each server's install directory, this can be reused to reapply the same settings as before. If reusing this response file it is important to compare this with the latest version as occasionally new fields are added to the response file for new features, a change in response file fields should be signaled by the important upgrade messages in the release notes.

If you have removed or deleted this file then a new one will need to be reconstructed. See the Azkaban Installation section for answer file examples.

...

  1. In RED, open the Azkaban integration script in the script editor such as wsl_scheduler_publish under your Host Script objects.
  2. In notepad open the matching script located in the RED installation directory under <RED install directory>\Administrator\Scripts\wsl_scheduler_publish.ps1
  3. Copy the contents of the updated script into the RED script editor to overwrite the existing script and Savesave.
Note
titleNote
  • It is a good idea to version the script before the manual upgrade process, right click on the script in RED and select Version Control->New Version
  • If you have made any customizations to your wsl_scheduler_publish script these will need to be merged manually with the updated script changes.
  • Any changes to the Azkaban integration scripts will only take effect for new jobs or when editing an existing job causing a re-publish to Azkaban.

...

If you installed RED to a different folder than when the Windows Azkaban Web Server or Executors were created, then you need to update the ImagePath key in the registry for each Azkaban service.

...