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.
    Image RemovedImage Added
    1. Tip
      titleService User vs Local System

      When you uncheck the 'Install as Windows Service' then entering Service User and Password becomes optional, this is to support backwards compatibility with services created by pre prior to RED 10.2 versions, but is considered less secure.

      If you already have a service user for your existing service then you should enter those credentials here to ensure the credentials and encryption secret the passwords stored in the Azkaban properties files are more secure.

      If you omit Service User and Password then the DPAPI encryption of passwords in Azkaban properties files will be machine wide, allowing for both Local System and any authenticated user on the machine or services running under the Local System account to decrypt. This is less secure than having a specific user for the service where only that user can decrypt the passwords.

      WhereScape recommends using a specific user for running your services for the additional level of security.

  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.

...

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

...

  • Registry location: Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\WsAzkabanExec_red1001_db

  • Key: ImagePath

  • Value: "C:\Program Files\WhereScape\RED\10001-230606-005456\WslSchedulerService.exe" --type="Exec" --scheduler-dir="C:\temp\azkaban\red1001_db" --start-service=true --service-name="WsAzkabanExec_red1001_db"