Page Comparison

...

If you are responsible for administering a Wise Owl Appliance or applying updates, you must read this page carefully, in its entirety.  While You must also familiarise yourself with the risks associated with updates. While Wise Owl has tried to make the update process as smooth as possible, some degree of planning and understanding is required for Appliance administrators. You can also read the technical detail of the update process, if you wish, however it is not required.

If Wise Owl is managing updates for you or is hosting your Appliance (ie: you do not have a physical Wise Owl Appliance in your office), you should read the Managed Updates page. You can read this page to know what happens behind the scenes (this is the same procedure Wise Owl Technicians follow).

Risks of Updates

Updates are an inherently risky process. They involve making significant and fundamental changes to files and components on your Wise Owl Appliance. As such, there is always a chance of something going wrong. 

The bottom line: things can and do go wrong during updates. However, Wise Owl takes a variety of precautions to ensure the safety of your data, and the Wise Owl Helpdesk can usually fix a bad update within 30 minutes. Administrators should always read Release Notes before installing updates.

REVIEW by KAREN: can we disclaim liability at this point????

Risk Reduction

Wise Owl Legal takes all reasonable precautions during updates including:

• Automated testing processes such as unit tests, regression tests and integration tests. These prevent old bugs from creeping back in.
• Staging and testing environments to test updates. Every version of Wise Owl Legal is installed and tested on our internal test Appliances before being released to you. 
  • Our test Appliances use the exact same update process as your Appliance.
  • Some Wise Owl releases are created just for testing purposes. Although you never see these, they are used to improve the quality of Wise Owl Legal behind the scenes.
• For major releases, beta versions are tested by select members of the Wise Owl community. This allows us to uncover more bugs and issues than we can test for internally. And to refine new features with real life feedback. 
  • We are deeply grateful to our beta testers for their work and improvements to Wise Owl Legal which would not have been possible without them.
• Updates are created in such a way they can be re-installed. If an update fails, it will be retried several times before the Appliance gives up altogether. Transitory glitches can cause updates to fail, but a simple retry will work.
• As part of every update, a full Appliance backup is made. In the extremely unlikely event of data corruption, we can always roll your Appliance back to exactly how it was before an update.
  • Wise Owl treats your data like gold, and will never make significant changes unless backups are available; if for any reason, the backup before an update fails, the update does not continue.
• After every update (successful or otherwise), your Appliance sends back detailed logs about exactly what happened. Wise Owl uses these logs to improve the quality of updates over time.
• Very infrequently, a serious error will get through our quality assurance procedures. This happens to the best of us. If we find a particular version of Wise Owl has particularly serious errors or bugs, we will, without hesitation, revoke the update, contact all users on the affected version and issue a hotfix. 
• The technical design of the updater is to fail gracefully and allow recovery from errors. It makes every possible effort to notify human beings if any error is detected.

As an Appliance administrator, there are several steps to reduce the impact and likelihood of update risks.

...

• Never install updates on Mondays or Fridays. The Wise Owl Helpdesk experiences higher volume of calls on Mondays. And unexpected errors may manifest themselves after a Friday update when the Helpdesk operates at reduced capacity.
• Contacting the Wise Owl Helpdesk beforehand is helpful and will ensure the fastest response time, but is not required.
• REVIEW: what are the helpdesk operating hours??

...

)

...

• You must contact the Wise Owl Helpdesk at least 7 business days before making network changes to ensure compatibility.

...

.

...

There are several different ways your Appliance may fail during an update; each has different consequences. When determining the impact of risks, you always need to know what the consequences are. These are listed in increasing order of severity.

...

• You should never change the system settings of your Appliance unless specifically directed by Wise Owl Technicians.
• You must notify the Wise Owl Helpdesk of network changes at least 7 business days before you make them.

...

• You should never change the system settings of your Appliance unless specifically directed by Wise Owl Technicians.
• You must notify the Wise Owl Helpdesk of network changes at least 7 business days before you make them.

...

• This is the worst case and by far the least likely outcome. 
• This can be caused by transitory problems (eg: a power outage or surge is the most likely) or underlying hardware faults (eg: hard drive failure). 
• Often, such failures are not directly connected with an update, but become visible when core components are modified.
• Due to the variety of reasons why data loss occurs, and the few real life cases when it has happened, it is hard to give even indicative times to resolve such errors.
• Restoration from backups and / or a replacement Appliance is the most common way to resolve this.

Update Process

Recommended Process For Updating Your Appliance.

...

1. An update is published by Wise Owl. 
2. Appliances automatically check for new updates each night. If a new version is found, it is automatically downloaded.
   1. You can trigger the same update check on the About page on demand.
   2. Notifications will appear on Appliances indicating a new version is available.
3. You should go to the About page and read the release notes for the update.
4. Based on the release notes, plan a time to install the update. You should allow a minimum of 30 minutes down time for minor updates and 1 hour for major updates.
5. Notify your users of the update time and expected down time.
6. At the appropriate time, go to the About page and install the update.
   1. You can only install updates when the Appliance has Internet access; updates will fail without Internet access.
   2. You will be required to read follow a check list (similar to this one) before installation, and state you understand the risks of updating your Appliance.
7. Wait while the update is applied. Typically, this will take 10-15 minutes.
   1. You will receive emails telling you the updater status; the Appliance will display a maintenance page while updates are applied.
8. When the update completes, log back into your Appliance and test it works correctly.
   1. You should test all day-to-day operations. Wise Owl recommends several contacts, matters and documents dedicated to testing purposes on any Appliance.
9. Notify your users the Appliance is available for use.

...

Critical updates contain fixes to bugs which affect prevent day-to-day operation of Wise Owl Legal, security vulnerabilities (which may allow unauthorised people to access your Appliance) or potential data loss bugs. You should apply critical updates as soon as possible due to the severity of the errors they fix.

Technical Detail