This topic article describes how to update an instance of 

Companyname

 to a newer version. To identify the versions of the application being upgraded, see Release Version Numbering. 

Note
If you are running a version of  Companyname with a release date prior to 2017_01 or 2019_01, you must install a minimum required version of  Companyname  before you can upgrade to the current version.

Process Overview

In general, the update process has the following steps:

1. Backup everything that should be backed up. This may include KBs, software code, database files, etc, depending on what is to be updated. See Set Up Knowledgebase Backups.
2. Obtain new licenses for the new release, if it is a major upgrade with a new main version number. See Licensing.
3. Run the Setup Assistant to replace installed software and/or data that should be updated. See Setup Assistant.
4. Roll back to pre-update state if something goes wrong. See Rolling Back.

Update Methods

There are three ways to run the update process:

• Online Update. This uses an online connection to download and install the newest version of 

  Companyname

  . This is the simplest method, provided you have a stable internet connection.
• Manual Update. You download the installation files and install them locally. This option is preferred if your connection is unstable, or if you want to minimize the potential for errors.Command Line Utility EWUpdate
• EWUpdate Command Line Utility. This option is generally not necessary, but it can be useful for advanced functions, or in situations where the online and manual methods are unsuccessful.

Preparing to Upgrade

Before you upgrade on a Windows server:

• Restart the

  Companyname

   services using the command prompt. This clears up any long-waiting threads in the application or database process that might affect the upgrade. Here is an example of the command to use: C:\Agiloft\bin\ew-control.exe -a restart
• Sign all other users out of that Windows server, aside from the user that runs the upgrade. This prevents other Windows users from interfering with the upgrade process, particularly while restarting services or accessing files and folders.

Anchor
minimum minimum

Minimum Required Versions

If you don't install every new version as it's released, you might need to upgrade to a minimum required version before proceeding to the current version of 

Companyname

. Review the list below and start by installing the earliest version of 

Companyname

 that you don't yet have. You might need to install multiple minimum versions before you can upgrade to the current version of 

Companyname

. For example, if you're running version 2016_02 and want to upgrade to 2019_02, you must install 2017_01, then 2019_01, then 2019_02.

Version 2019_01

If you're running a version of 

Companyname

 with a release date prior to 2019_01, you must upgrade to the 2019_01 release before installing a later version.

...

1. Run the Setup Assistant in your installation directory and select Software Update from the main menu, then click Check for updates online. 
   
2. Setup will automatically check to see if automatically checks for a new version of 

   Companyname

    is available, and if so, will download it and start . If a new version is available, the Setup Assistant downloads it and starts the update. 
   
3. The user can monitor and set update options using the web interface.

Manual Update

If an earlier release of you aren't installing

Companyname

 is already installed for the first time, you can update the software by simply downloading and installing the latest version. The latest official release of

Companyname

 can be found at https://www.agiloft.com/ewdownload/.

1. Run the downloaded installer. The installer

...

1. detects an existing 

   Companyname

    instance and

...

1. prompts the user about a possible update.
   

...

1. Image AddedSetup Installer detects installed version
2. Confirm the

...

1. selections on the Update Options screen

...

Update options

Update options allow the user to set certain update process details. When performing an update in web GUI mode, you can change the default options on the update options page, shown below:

Image Removed

...

1. . These options include whether to run a backup; whether to delete backup files after the update; and whether to preserve modified MySQL parameters. The update options are explained in more detail in Command

...

1. Line Options. If you aren't familiar with the commands, be cautious in changing the default selections, particularly if you are working

...

1. with a live system. 
2. Follow the steps in the installer to complete the upgrade. 

Anchor
ewupdate ewupdate

EWUpdate Command Line Utility

...

The ewupdate command line utility EWUpdate utility works the same way as the manual installer, but runs from the command line. If you run the utility with no options, it performs an update with all default options if run without any arguments.  Use the –help option to print a short help screen. If you wish to use the command line updater with non-default optionsselected. If you need to change the options for the utility, use the command line arguments options listed below.

Tip
Use the –help option (ewupdate --help) to see all the commands you can use with the utility.

Anchor
options options

Command

...

Line Options

These options are also available using the ewupdate available in the manual installer and in the EWUpdate command line utility. Default options can be changed using the command-line options listed, which correspond to the options presented in web GUI modethe installer. The list below consists of the most commonly and recommended options. 

Update option	Corresponding ewupdate command-line option	Description
Backup database data using OS-level backup	-k,--skiposlevel	This command only applies if the built-in MySQL server is used. Under normal circumstances a full OS-level backup is made.   Use this option to skip the default OS-level backup of the MySQL directory. No database restoration will be is possible if the upgrade fails.
Skip checkers unless any patchers were run	-p,--scup	When the application server starts, it performs data checks for consistency; data checking may take , which might take a long time. Use this option to skip data checking if no data was changed on update. This may can speed the time taken to start the application server starting.
Skip project backup if possible	-K,--skipprjbckp	At the very beginning of the update process all existing projects are saved to the backup directory. If this option is set then no project backup is performed, if allowed. Project backup is required in some update modesSome update modes require a project backup, in which case it isn't skipped.
Don't delete temporary files after update	-t,--keeptemp	Upon During the update, temporary files are normally stored on the hard drive. These may include data backups, unpacked new code, etc. By default, temporary files are removed after an update. If this option is set then , temporary files are left on the device and will only be deleted before the . The temporary files are automatically deleted before the next update.
Don't backup temporary files - logs etc	-i,--backuptemp	If this option is set then no temporary files such as log files are backed up before the update. This saves used disk space and shortens elapsed the update time.

For additional update options, use the –help command to print a full list of commands.

Code Block

Example: ewupdate --stable -s,--stable Download stable release version (Offical Release) -l,--latest Download latest release version (Beta) -d,--devel Download development version (Alpha) -C,--custom <host> Download from custom server -F,--file <file> Upgrade from a distribution that has already been downloaded to the local hard drive -f,--force Unattended update, all prompts are answered 'yes' -c,--caution Unattended update, all prompts are answered 'no' -k,--skiposlevel Skip OS level backup (avoid using this when skipping project backup) -K,--skipprjbckp Skip project backups (avoid using this when skipping OS level backup) -t,--keeptemp Keep temp files -p,--scup Skip checkers unless patchers were run -i,--backuptemp Backup temporary files such as logs (when unattended mode) -r,--requiredspace <Gb> Disk space (Gb) required for update (use with care) -w,--warn <MMM or MMM:NNN> Displays a warning message to customers about an impending update. Argument syntax is MMM or MMM:NNN, where MMM is the number of minutes before update and NNN is the estimated update duration in minutes -A,--allowsameversion Do update even if new version is same as old one -X,--forceincompat Forces an upgrade between releases that should not be compatible. Do not use this option. -v,--verbose Print error details -h,--help Prints this help

Rolling Back

If the upgrade fails due to any problem, the setup will halt with stops, shows an error message, and roll then rolls back to its former statethe pre-update version. It should retain retains all your settings. The error will provide you with message provides the installer logs, which you can use to trace the cause of the upgrade failure to and resolve it before trying the upgrade again. 

...