Redpoint Interaction v6.x Documentation
Redpoint Interaction v6.x Documentation
Breadcrumbs

Admin: Upgrading RPI Realtime

Upgrading RPI Realtime files is carried out using Server Workbench.

In the initial Server Workbench interface’s Welcome overlay, select the Upgrade RPI Realtime tab:

image-20250916-170538.png

Click the Upgrade button to display the Upgrade RPI Realtime API overlay:

image-20250916-170552.png

The overlay contains the following:

  • Choose Source Folder section:

    • Deployment Files Folder: mandatory.

  • Choose Components to Upgrade section:

    • Checkboxes:

      • RPI Realtime API Web Site: checking displays the Web Site Folder property.

      • RPI Web Client: checking displays the Web Client Folder property.

      • RPI Realtime Agent Service: checking displays the Service Folder property.

      • All checkboxes are unchecked by default, and it is mandatory to check at least one checkbox.

    • Web Site Folder property: this is displayed and enabled when the RPI Realtime website checkbox is checked.  It is mandatory when displayed.  It represents the physical address of the RPI Realtime website.

    • Web Client Folder property: this is displayed and enabled when the RPI Web Client checkbox is checked.  It is mandatory when displayed.  It represents the full path of the rpiwebclient folder.

    • Service Folder property: this is displayed and enabled when the RPI Realtime Agent Service checkbox is checked.  It is mandatory when displayed.  It represents the folder hosting the Realtime Agent service.

    • Error Details section: this section is displayed when errors occur during upgrade, and documents the issues found.

    • Buttons:

      • Upgrade: if you click this button when one or more validation errors are present, a warning message is displayed.  Invocation displays the Copy Log To Clipboard button and performs the upgrade.  A message is displayed upon its successful completion.

      • Copy Log To Clipboard: clicking this button copies log entries generated during upgrade to the clipboard.

      • Cancel: invocation of this option removes the overlay from display.

Please note the following:

  • Errors will occur if you attempt to upgrade the RPI Realtime application prior to its having been installed.

  • RPI Realtime will need to be upgraded separately at each cluster node exposing Realtime functionality.

  • If there are any custom plugins that you wish to retain in the RPI Realtime service’s bin folder following upgrade, please include within the same a text file called ‘plugins.txt’, in which are listed the name(s) of the .DLL(s) in question.  Filenames should include the extension, and each should be placed on a separate line within the file.  Failure to do so will see the plugin(s) deleted by the upgrade process.