#

Online Update |

The Online Update feature provides a convenient and secure method for updating and applying all program, library and file changes to the PxPlus Development Suite.

(The Online Update feature was added in PxPlus 2014.)

To access the Online Update feature, use one of the following methods:

Location | Method
From the PxPlus IDE Main Launcher | See Accessing from IDE Main Launcher.
From the Windows desktop | From the Windows Start menu, locate PVX Plus Technologies and select Online Update.
From the PxPlus Command line | See Accessing from PxPlus Command Line.

The easy-to-use Update Manager displays a list of the updates to be applied, along with a status message that informs you of the current update status. You can also view a detailed description of each update prior to applying the changes, as well as view an activity log for a selected update. In addition, you can reverse any updates that have been applied.

#### Important Note:
The Online Update should only be run after all users have exited the system; otherwise, errors can occur when the Online Update attempts to apply changes to one or more files already in use.

The Update Manager consists of the following:

[Status message area] | Displays a message about the current update status and the number of updates pending. The message text and background color displayed depends on the current status: - No updates have been applied. (red background) - All updates have not yet been applied. (yellow background) - All updates have been applied. (green background) (The Status message area was added in PxPlus 2017.)
ID | Number used to identify the update.
Title | Text that briefly describes the update.
Date | Date on which the update was released.
Status | Displays the current state of each update. For all statuses, except Pending, the user who performed activity on the update and the date on which the activity took place are also displayed. Possible statuses are:
Pending | New update to be applied.
Applied | Update successfully applied. No further action required.
Failed | Update not successful for the reason indicated. Action must be taken to resolve the issue before the update can be applied.
Removed | Update was reversed.
Details | Button used to view a detailed description of the changes associated with a particular update. Select a line from the update list using the mouse and/or the keyboard arrow keys. Click the Details button to display a window with a description of the change(s) to be applied. An alternate method is to right click on the line and select Show Details from the popup menu.
Show Log | Button used to view the historical activity of an update (with Applied, Failed or Removed status). Select the line for which you want to view the activity. Click the Show Log button to display a window showing the activity information for the selected update. #### Note: The Show Log button is not available when selecting a line with a Pending status.
Apply All | Button used to apply all listed updates. When selected, an Applying Updates window displays to indicate that the update process is running. Upon completion of this process, the following occurs: If all updates were successfully applied: The Update Manager displays a green dot next to each ID number, and the Status column changes to Applied. The Status message area changes to a green background and indicates that all updates have been applied. If an error was encountered during the update process: A message displays with the ID number of the update that encountered the error and a brief description of the issue. The Update Manager displays a yellow triangle with an exclamation point (!) next to this ID number, and the Status column changes to Failed. Any changes already applied for that particular update up to the point when the error occurred will be reverted. After resolving the error condition, you can attempt to apply the update either by clicking the Apply All button to apply all remaining updates or by selecting Apply up to this point from the right click popup menu. See Applying a Range of Updates. Example: If the Help window is open at the same time that changes to the Help file are being applied, then that particular update will fail.
Close | Closes the Update Manager. If any updates have been applied and/or reverted, you will first be prompted to complete the update process by exiting and restarting all PxPlus sessions.

## Applying a Range of Updates

To apply a range of updates in sequence up to and including a particular update, right click on the line that will be the stopping point for the update process and select Apply up to this point from the popup menu. The update process will apply all updates prior to and including the selected update, but not beyond. Updates not applied are displayed in bold text with a gray dot next to the ID number with the next update ID to be applied highlighted. The Status message area changes to a yellow background and indicates the number of updates pending.

Example:

Three updates are listed - #0001, #0002, #0003 - but you want to apply only updates #0001 and #0002. To do this, right click on update #0002 and select Apply up to this point from the popup menu. The result is that the updates for #0001 and #0002 are applied but not for #0003. Because update #0003 is the next one to be applied, that line would be highlighted, and the Status message area indicates that 1 update is pending.

## Reverting a Range of Applied Updates

To revert back to a point before a particular update was applied, right click on the line that will be the first update (in a sequential range of updates) to be reversed out and select Revert to before this point from the popup menu. A Removing Updates dialogue displays while this process is running. When this process is completed, all updates applied before the selected update are retained. The selected update and all updates after that are reverted.

Example:

Three updates have already been applied - #0001, #0002, #0003 - but you want to keep the changes only for update #0001 and reverse out the changes for updates #0002 and #0003. To do this, right click on update #0002 and select Revert to before this point from the popup menu. The result is that update #0001 is retained, and updates #0002 and #0003 are reverted. The Status message area changes to a yellow background and indicates that 2 updates are pending.

#### Note:
All updates for a release, as well as reverted corrections, are applied in sequential order to avoid any potential problems that could arise if an update is skipped.

## Accessing from IDE Main Launcher

The Online Update feature can be accessed from the IDE Main Launcher by selecting Update from the top menu bar to launch the Update Manager.

When an online update is ready to be applied, the Update menu bar item changes to *Update* (with asterisks) as a visual cue. Once the online update is successfully applied and no other updates are pending, the menu bar item changes back to Update (without asterisks).

(Displaying *Update* when an online update is available was added in PxPlus 2023.)

## Accessing from PxPlus Command Line

A text mode version of the Online Update feature is also available for entering commands that list, apply and revert updates.

From the Command window, you can enter the following commands after the - > prompt:

Command | Description
UPDATES LIST #### | This command lists the title, description and status of the Update ID specified (####). If no Update ID is supplied, the title and status details of all updates are listed.
UPDATES APPLY #### | This command applies all updates, up to and including the specified Update ID (####). If no Update ID is supplied, all pending updates will be applied.
UPDATES REMOVE #### | This command removes any updates that have been applied back to and including the specified Update ID (###). If no Update ID is supplied, all applied updates will be removed.
UPDATES | This command either launches the graphical update utility on a graphical device or displays Help information on a text mode device.