Documentation and help portal

★ Home
regify Provider
Version 5.3
Upgrade Manual
Deutsch
Français
regify provider Upgrade Manual

Read Me

These are the upgrade instructions for the regify provider appliance to the next major version 6.0.

It is normally enough to perform upgrades simply by going to Check for updates and following the instructions there. Since this is a major upgrade, we cannot exclude the possibility of unforeseen circumstances at each customer installation. Therefore, we recommend extra precautions in this instance.

  • Follow the Normal Steps process

  • The whole update should only take about 5 minutes unless you have a huge database or slow disks.

  • If you have such an installation or simply want more progress information, you may also follow the Verbose Steps instead of the Normal Steps

  • Items suffixed with …​ like Decompressing system image…​ take a little longer

  • If it hangs at one of these steps too long, then this is a sign of a problem. Then follow these steps:

Normal Steps

It is recommended to have console access to the virtual machine to make snapshots and monitor the machine reboot after the upgrade!

This is not strictly needed, but only the local console provides feedback about the second part of the upgrade progress. But you can simply wait and periodically try to access the Appliance Menu or the regify provider administration web portal (note that the new administration portal is now located at https://<yourUrl>/admin/).

An upgrade should proceed in the following manner:

  1. Put the system in '''Maintenance mode''':

    1. Log into your regify provider administration web portal https://<yourUrl>/ADMINISTRATION/

    2. Go to Provider maintenance  Maintenance mode and click Enable maintenance mode.

  2. Make a snapshot of the virtual machine that your regify appliance runs on.

  3. Log into the Appliance Menu and press Check for updates.

  4. Unless you already were at version 5.3.5, do this a second time get the actual major update.

  5. Select Yes in the New Version Available dialog.

    newVer

  6. Let the upgrade run. Part one will end like this (colors depend on your system):

    finPart1

    Part 1 of the upgrade has finished now.

  7. Now continue with Finish up.

Verbose Steps

This is only recommended for advanced users or if the normal upgrade encountered a problem and the snapshot has been reverted. The idea is to collect information for regify technical staff to detect and rectify the problem.

An upgrade should proceed in the following manner:

  • Unless the system is still there from the Normal Steps procedure, put the system in Maintenance mode:

    • Log into your regify provider administration web portal https://<yourUrl>/ADMINISTRATION/

    • Go to Provider maintenance  Maintenance mode and click Enable maintenance mode.

    • Make a snapshot of the virtual machine that your regify appliance runs on.

  • Make sure you’re allowed to log in as root by ensuring Allow root login in SSH Settings is checked.

  • Log in as root and run the following:

RFDBG=1 providerConfig

  • When it runs all the way through, it looks like this:

finDbg

  • If your upgrade looks like the image above, continue with Finish up.

  • If it failed, then copy everything starting from the last

Installed:
  regify-provider-yumconf-mbr.x86_64 0:6.0-2649

down to the end of the output and send it to support@regify.com.

  • Then abort the upgrade operation:

    • Revert your snapshot

    • Remove the maintenance mode by going to https://<yourUrl>/ADMINISTRATION/ Provider maintenance  Maintenance mode and click Remove maintenance mode.

    • Delete the reverted snapshot

Finish up

This is the part that happens after the system has rebooted.

  1. If you have a local console to your VM, you will be able to see part 2 of the upgrade running:

    runPart2

    Please wait until the process is finished!

  2. Re-login to the appliance using SSH (PuTTY).

  3. Log into the Appliance Menu. and press Check for updates.

  4. Run any patch updates that are offered, but not major version updates.

  5. Log into the regify provider administration web portal using the new URL https://<yourUrl>/admin/

  6. Handle any To-do items that you encounter there.

  7. When everything seems done, go to Provider maintenance  Maintenance mode and click Remove maintenance mode to turn off maintenance mode again.

It is strongly recommended to delete the snapshot again. Reverting a regify provider appliance to a past snapshot has catastrophic consequences if it has been operating since.
The login to your web administration is now at https://<yourUrl>/admin/!