neatComponents is the hybrid-cloud database engine that powers clearString. | ||
Previous page | Techniques & KB Articles | Next page |
Site Upgrading |
Site UpgradingUpgrading a siteWith careful design, it can be possible to make changes to a live site without adversely impacting users. However, there are times when it is sensible to take a copy of a site, makes changes to that, and then apply the changes in a single ‘upgrade’ operation to the live site. The obvious challenge here is that you do not want to simply swap out the live site with the new one, since the live site will have recent transactions and data changes of its own that will want to be preserved and merged in with the update site. The upgrade process handles this, as described below:
Typical scenarios when this is useful include:
Understanding what gets upgradedThe important aspect of site upgrading is understanding how the system chooses which aspects to use from the live site, and which aspects to take from the updated site. In describing this we use the following terms:
The expectation is that the Live site is busy being used, and this is resulting in continuous changes to a range of data that must not be lost. These include:
Everything else that is changed in the Update site takes precedence over the Live site when an Update is made. This includes:
Method:
The Upgrade processWhen the Upgrade process is triggered, the system takes the Live site offline and makes a safety backup of it. It then compares the Live site to the Update site, and makes any modification necessary to the structure of the Tables (adding or removing fields, or changing field datatypes). A copy of the Update site is taken, which will become the new Live site at the end. The Tables, Users, Transaction data, log data and site properties are copied over to this, and the new site is set Live. After the Upgrade, you are left with the new site, set live, and a backup of the old live site, set Stopped, with the site name suffixed with "(Prior to upgrade at [date/time])". The new site will be left in the same active state as the prior live one . ie if the site was previously Stopped, the new live site will also be Stopped.
NotesIf the Live site is set to send scheduled emails, be sure to place the Update site in ‘demo mode’, which will prevent these from being sent out while you are working on the updates. (They will then go to the Site Owner, rather than the expected recipients) Normally the content on Page surfaces is updated with the content from the Update site, so if you need the content from the Live site to be retained instead, be sure to store this content in a Table, and use a Query to place it on the Page. If you are unsure whether an Upgrade will work as you expect, take a copy of the Live site, and Upgrade the copy first. If you have several sites based on the same template, you can update them all using a single Update site.
|
|