FAQ - Zero Downtime Upgrade

In this page you find answers to the most common questions concerning the Zero Downtime Upgrade (ZDU).

Important! When upgrading to versions 12.3 and higher, please check the new port definition for all types of server processes and check for incompatibilities.

More information:

FAQ

Q: Is there a lot of database load to be expected while the upgrade is in progress?

A: No

Q: Will the database contents be duplicated?

A: No

Q: Do I need a separate database for the compatibility mode?

A: No

Q: Can I rollback my database, if the upgrade is not successful?

A: A system rollback is possible, but a rollback of the database is not necessary, as all base version data will be retained. However, all database changes persist even if you use the rollback option.

Q: Are there performance impacts, while the Automation Engine system is being upgraded?

A: Yes, base version processes will slow down to about two-thirds of their normal performance.

Q: Are there possibilities to optimize load balancing during the upgrade?

A: With a completely duplicated infrastructure, see ZDU - Distributed Installation.

Q: How long do I have to stay in compatibility mode?

A: As long as you need to test the target version to feel comfortable with it and to free base version CPs from active connections.

Q: Do I need to duplicate my infrastructure during the upgrade (including ports for CPs, network connections, etc.)?

A: Possibly, depending on how you chose to setup the second environment, see ZDU - Distributed Installation.

Q: Can I install the target version onto the same infrastructure?

A: Yes, depending on how you chose to setup the upgraded environment, see ZDU - Distributed Installation.

Q: Are users forced to login again to the new system?

A: When in parallel mode, users still connected to the AWI instances of the base version must be disconnected, so that the CPs from the target version can take over. The users have to login to a new AWI instance to use target version features.

Q: What happens, if for example a new field or option gets added to an object type in a new product version?
How is that handled in each state of the compatibility mode during upgrade?

A: New fields or tabs are not visible as long as the user is connected to the base version. Default values are used for invisible options. New values are ignored in case of a rollback.

Q: Can I use the new features already during the compatibility mode?

A: Yes, if you are logged on in a new AWI instance and a new session after upgrade.

Q: What happens if the system is in compatibility mode, still running with the base version CPs/WPs as active environment, and a user logs on to a new Automic Web Interface. Will he see the new features already?

A: No, new features will not be visible before processing was upgraded to the target version and a re-login has been performed.

Q: If I am a user in the recently updated AWI during compatibility mode, would I be able to use the new feature already?

A: Yes, based on the assumption that the option UPGRADE was executed successfully beforehand, which starts the parallel mode.

Q: Can I see which WP/CP versions are connected?

A: Yes, in the Processes & Utilization page of the Automation Engine Management section of the Administration perspective, see Processes and Utilization.

Q: If I log on to the base version AWI during parallel mode, will I be able to see the jobs started in the target version AWI as well?

A: Yes.

Q: How do we know that jobs from the base version are completed?

A: You can check their status in the Process Monitoring perspective, in which you can also apply filter criteria to check the ZDU version, see Process Monitoring Perspective and Filtering Tasks.

Q: A job is started in the base version and the execution failed. Can I restart the job with the target version?

A: A Restart is possible at any point in time and will not differ across versions.

Q: What happens with my long running jobs, if I switch to the target version while the job is running? Will the target version WPs/CPs or the base version WPs/CPs continue the processing?

A: As far as possible target version WPs take over processing. If necessary for technical reasons, for example for a task in status Generating, base version processes are used.

Q: If I have an extremely long running job and I want to finalize the upgrade, what should I do with that job? Can I restart the job in the target version system?

A: It is not necessary to cancel active jobs, as they do not block the step FINALIZE.

Q: Can I delete the entries in the Database page of the upgrade wizard?

A: You can delete some of them.

When you reach the Database page in the upgrade wizard, the Automation Engine has already deleted old entries that were no longer required. The Automation Engine cannot or should not delete some of the remaining entries. Here is how you find out if you can delete them:

  • Entries with RunID

    In the Process Monitoring perspective, check if the base version still has tasks running. Check also for tasks that just ended. You could use a filter that checks all statuses in the base version. If there are tasks still running, you have to wait for them to end. If there are tasks that just ended, you have to deactivate them.

    If the Process Monitoring perspective does not list tasks from the base version, you have to check the RunIDs of the entries that are displayed in the Database page of the upgrade wizard, paying special attention to the status of those tasks. Sometimes, if the status of a task has been manually modified, the new status is displayed in the Process Monitoring perspective but not in the statistic. Therefore, the system does not recognize that the tasks ended. If the upgrade wizard has entries with an active status but the Process Monitoring perspective does not list them, you can delete them.

  • Entries without RunID

    Entries without RunID typically show connections between Users and the system. Check if there are Users that are still connected to old Communication Processes (CPs). You can do so by checking the list of server processes or the User connections. If there are Users still connected, you can either wait for them to disconnect themselves or you can disconnect them yourself.

    Once there are no more User connections to old Communication Processes (CPs), you can delete the entries from the Database page of the upgrade wizard.

See also: